Guide pratique

Intégration JavaScript (Autonome) pour sites non-WordPress

Dernière mise à jour il y a quelques jours

Introduction

Se connecter à Ezoic via JavaScript (parfois appelé intégration « autonome ») est rapide et simple, offrant aux éditeurs un contrôle complet et des possibilités de personnalisation. Cette méthode d'intégration est compatible avec tous les types de sites et implique l'insertion d'un petit morceau de code JavaScript dans le HTML de votre site, permettant à Ezoic de gérer et d'optimiser les emplacements publicitaires de votre site. Dans cet article, nous fournirons un guide étape par étape sur la façon d'intégrer Ezoic en utilisant la méthode JavaScript.

Instructions

Remarque : Cet article s'applique aux sites qui souhaitent intégrer leur site en utilisant JavaScript et qui n'utilisent pas WordPress. Il est recommandé que les sites utilisant WordPress suivent plutôt les instructions ici.

Prérequis

Assurez-vous d'avoir créé un compte Ezoic. Si ce n'est pas encore fait, vous pouvez le faire ici.
Connectez-vous avec votre Spécialiste d'Intégration Ezoic si vous avez besoin d'aide pour configurer ads.txt ou accepter l'invitation Google MCM.

Configuration des Annonces

Connecter votre site à Ezoic est un processus simple qui implique d'ajouter quelques lignes de code à votre site. En attendant l'approbation de Google Ad Manager, nous recommandons de vous installer dans un environnement de pré-production ou de développement pour vous assurer que vos emplacements publicitaires sont correctement configurés et que le chargement des annonces est confirmé.

This guide will walk you through the steps to implement EzoicAds on your site.

Étape 1 : Créer des Emplacements Publicitaires

Pour implémenter EzoicAds, vous devez créer des emplacements publicitaires sur votre site. Ces emplacements publicitaires seront utilisés pour définir les emplacements des annonces sur votre site où les annonces Ezoic seront affichées.

Vous pouvez créer des emplacements publicitaires dans votre tableau de bord Ezoic, ou vous pouvez travailler avec votre Spécialiste d'Intégration Ezoic pour créer les emplacements publicitaires idéaux pour votre site.

Étape 2 : Ajouter des Scripts d'En-tête

Ajoutez le Script de Confidentialité Ezoic (cela présuppose que vous utilisez le module de consentement d'Ezoic. Si vous utilisez un module tiers, voyez https://support.ezoic.com/kb/article/javascript-standalone-integration) et le Script d'En-tête tout en haut de la balise <head> (pour une configuration et une livraison plus rapides des annonces, nous recommandons d'insérer ces scripts d'en-tête dans la balise <head>. Si cela n'est pas faisable, la meilleure option suivante est de les positionner tout en haut de la balise <body>). Veuillez vous assurer de charger le script de confidentialité avant le script d'en-tête.

Script de Confidentialité :

<script src="https://the.gatekeeperconsent.com/cmp.min.js" data-cfasync="false"></script>
<script src="https://cmp.gatekeeperconsent.com/min.js" data-cfasync="false"></script>

*Notez que les Scripts de Confidentialité ne doivent pas être retardés, sinon des informations personnelles pourraient être traitées avant que le consentement ne soit donné.

Le CMP Ezoic peut être personnalisé en visitant la section de confidentialité dans le tableau de bord Ezoic.

Ezoic détectera automatiquement le consentement des CMP tiers conformes à TCF 2.2 : https://iabeurope.eu/cmp-list/.

Script d'En-tête :

<script async src="//www.ezojs.com/ezoic/sa.min.js"></script>
<script>
  window.ezstandalone = window.ezstandalone || {};
  ezstandalone.cmd = ezstandalone.cmd || [];
</script>

Étape 3 : Insérer des Emplacements Publicitaires

Ce code sera appelé pour chaque emplacement publicitaire. Il est important de noter que l'ID à 3 chiffres 101 représente un emplacement publicitaire spécifique, et chaque emplacement publicitaire aura un ID à 3 chiffres différent. Les codes publicitaires seront générés dans votre tableau de bord EzoicAds.

Chaque emplacement publicitaire aura la structure suivante :

<div id="ezoic-pub-ad-placeholder-101"></div>
<script>
    ezstandalone.cmd.push(function() {
        ezstandalone.showAds(101)
    });
</script>

Insérez ce code pour chaque emplacement publicitaire sur votre site.

NE PAS ajouter de style au véritable div de l'espace réservé. Ajouter des styles ou réserver de l'espace pour la publicité peut entraîner des résultats indésirables (par exemple, si un espace réservé n'est pas choisi par notre système, il peut y avoir un espace vide sur la page).

Appeler ezstandalone.showAds() sans définir une valeur d'espace réservé appellera la fonction pour chaque espace réservé présent sur cette page.

Contenu Dynamique

Si le contenu de votre site se charge ou change dynamiquement, une configuration supplémentaire peut être requise. Voir ici pour des instructions supplémentaires : https://support.ezoic.com/kb/article/my-content-loads-or-changes-dynamically-can-i-still-use-ezoic

Intégration Hybride

L'Intégration Hybride est lorsque un site s'intègre via des serveurs de noms ou Cloudflare, tout en utilisant le code côté client pour appeler les annonces. Le bénéfice de l'intégration hybride est qu'elle permet aux autres produits d'Ezoic (par ex. Vitesse du Site, SEO) de charger des annonces de manière dynamique. Voir ici pour des instructions supplémentaires : https://support.ezoic.com/kb/article/hybrid-integration

Vidéos Humix

Le Générateur de Code d'Intégration de votre tableau de bord Humix peut être utilisé pour ajouter notre Lecteur Vidéo à votre site web.

Avancé

EzoicAds offre des fonctionnalités avancées qui permettent aux éditeurs de peaufiner le comportement de la bibliothèque de publicités. Ces fonctionnalités peuvent être utilisées pour personnaliser le comportement de la bibliothèque de publicités pour mieux répondre aux besoins de votre site. Voir ici pour des instructions supplémentaires : https://support.ezoic.com/kb/article/javascript-standalone-integration-advanced-features-for-non-wordpress-sites

Dépannage

Lors de la configuration des annonces EzoicAds sur votre site, il est important de s'assurer que tout fonctionne correctement. Nous fournissons un débogueur d'intégration JavaScript intégré qui vous permet de diagnostiquer rapidement les problèmes liés à la configuration de vos annonces. Voici un guide étape par étape sur la façon d'utiliser ce débogueur et d'interpréter ses résultats.

Étape 1 : Activer le Débogueur

Pour activer le débogueur, il suffit d'ajouter le paramètre de requête suivant à l'URL de la page où vos EzoicAds sont intégrées :

ez_js_debugger=1

Par exemple :

https://www.votresiteweb.com?ez_js_debugger=1

Une fois le paramètre de requête ajouté et la page chargée, une boite de dialogue modale verte apparaîtra en bas au centre de l'écran. C'est le débogueur d'intégration JavaScript.

Étape 2 : Comprendre les Résultats du Débogueur

Le modal du débogueur contient plusieurs informations clés qui vous aideront à résoudre les problèmes de votre configuration. Voici un aperçu des informations fournies :

Détection du Script : Le débogueur vérifiera si le script Ezoic est correctement inclus sur votre page. Si le script n'est pas trouvé, vous verrez un message d'erreur. Assurez-vous que la balise du script Ezoic est placée au bon endroit sur votre page.
Détection des Espaces Publicitaires : Le nombre d'espaces publicitaires définis sur votre page sera affiché. Cela permet de vérifier si les espaces publicitaires ont été correctement reconnus par le système Ezoic.
État des Annonces : Pour chaque espace publicitaire, le débogueur indiquera si une annonce a été affichée avec succès. Il montre :
- Si une annonce est attribuée à un espace publicitaire spécifique.
- Si une requête a été envoyée à Ezoic pour récupérer une annonce pour cet espace publicitaire.
Succès de la Requête : Le débogueur surveille également si la requête publicitaire a été envoyée avec succès. S'il y a un problème, le modal affichera les détails de l'erreur pour aider à identifier la cause racine (par exemple, problèmes de réseau, mauvaise configuration).

Étape 3 : Utiliser le Débogueur pour Dépanner

Les informations fournies dans le modal du débogueur sont précieuses pour diagnostiquer les problèmes courants tels que :

Annonces non Affichées : Vérifiez la détection des espaces publicitaires et l'état des annonces pour vous assurer que les espaces publicitaires sont définis et que les annonces sont attribuées.
Échec des Requêtes d'Annonces : Si les requêtes d'annonces ne sont pas envoyées ou échouent, le débogueur fournira des messages d'erreur indiquant des potentiels dysfonctionnements.
Problèmes de Chargement du Script : Si le script ne se charge pas correctement, vérifiez que la balise du script est présente dans votre code source et correctement configurée.

Coordonnées pour une assistance supplémentaire

Si vous avez besoin d'une assistance supplémentaire pour l'intégration JavaScript (Autonome), veuillez vous connecter via https://support.ezoic.com/ pour utiliser nos ressources dédiées à l'assistance. Nous sommes là pour vous aider !

Cet article vous a-t-il été utile ?