chevron_right
chevron_right
Comment s'intégrer à Ezoic en utilisant JavaScript
How-To/Instructional

Comment s'intégrer à Ezoic en utilisant JavaScript

Last Updated over a month ago
Article Navigation
Introduction
Instructions
Dépannage
Informations de contact pour une assistance supplémentaire

Introduction

La connexion à Ezoic via JavaScript (parfois appelée intégration « autonome ») est rapide et simple, offrant aux éditeurs un contrôle et une personnalisation complets. Cette méthode d'intégration est compatible avec toutes les constructions de sites et consiste à insérer un petit morceau de code JavaScript dans le HTML de votre site web, permettant à Ezoic de gérer et d'optimiser les placements publicitaires sur votre site. Dans cet article, nous vous fournirons un guide étape par étape sur la façon d'intégrer Ezoic en utilisant la méthode JavaScript.

Instructions

  1. Assurez-vous d'avoir créé un compte Ezoic. Si ce n'est pas déjà fait, vous pouvez le faire ici.
  2. Contactez votre spécialiste d'intégration Ezoic si vous avez besoin d'aide pour configurer ads.txt ou accepter l'invitation Google MCM.


Mise en Place 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 configurer dans un environnement de développement ou de test pour s'assurer que vos emplacements publicitaires sont correctement configurés et que le chargement des annonces est confirmé.

Ce guide vous guidera à travers les étapes pour implémenter EzoicAds sur votre site.

Pour implémenter EzoicAds, vous devrez créer des emplacements publicitaires sur votre site. Ces emplacements 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.

Ajoutez le Script de Confidentialité Ezoic (cela suppose que vous utilisez le module de consentement d'Ezoic. Si vous utilisez un module tiers, suivez les étapes décrites ici) et le Script d'En-tête tout en haut de la balise <head> (pour une configuration et une diffusion des annonces plus rapides, nous recommandons d'insérer ces scripts d'en-tête dans la balise <head>. Si cela n'est pas possible, la meilleure option suivante est de les placer tout en haut de la balise <body>). Veuillez vous assurer de charger le script de confidentialité avant le script d'en-tête.

<script src="https://the.gatekeeperconsent.com/cmp.min.js" data-cfasync="false"></script>
<script async src="//www.ezojs.com/ezoic/sa.min.js"></script>
<script>
  window.ezstandalone = window.ezstandalone || {};
  ezstandalone.cmd = ezstandalone.cmd || [];
</script>

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 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 div de l'emplacement. Ajouter des styles ou réserver de l'espace pour l'annonce peut entraîner des résultats indésirables (par exemple, si un emplacement 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'emplacement fera appel à la fonction pour tous les emplacements existants sur cette page.


Contenu Dynamique

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

L'intégration hybride est lorsque un site s'intègre via des serveurs de noms ou Cloudflare, tout en utilisant le fragment de code côté client pour appeler les annonces. L'avantage de l'intégration hybride est qu'elle permet aux autres produits Ezoic (par exemple, Site SpeedSEO) de charger les annonces dynamiquement. Voir ici pour plus d'instructions : 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 propose des fonctionnalités avancées qui permettent aux éditeurs d'affiner le comportement de la bibliothèque d'annonces. Ces fonctionnalités peuvent être utilisées pour personnaliser le comportement de la bibliothèque d'annonces pour mieux répondre aux besoins de votre site. Voir ici pour plus d'instructions : https://support.ezoic.com/kb/article/javascript-standalone-integration-advanced-features

Dépannage

Lors de la configuration des 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 à votre configuration publicitaire. Voici un guide étape par étape sur la façon d'utiliser ce débogueur et d'interpréter ses résultats.

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és :

ez_js_debugger=1

Par exemple :

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

Une fois le paramètre de requête ajouté et la page chargée, une boîte de dialogue modale verte apparaîtra en bas au centre de l'écran. Il s'agit du Débogueur d'Intégration JavaScript.

Le débogueur modale contient plusieurs informations clés qui vous aideront à résoudre 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é, un message d'erreur s'affichera. Assurez-vous que la balise script Ezoic est placée au bon endroit sur votre page.

  • Détection des Emplacements : Le nombre d'emplacements définis sur votre page sera affiché. Cela aide à vérifier si les emplacements ont été correctement reconnus par le système Ezoic.

  • Statut des Annonces : Pour chaque emplacement, le débogueur indiquera si une annonce a été correctement affichée. Il montre :

    • Si une annonce est assignée à un emplacement spécifique.
    • Si une requête a été envoyée à Ezoic pour récupérer une annonce pour cet emplacement.
  • 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, la boîte modale affichera les détails de l'erreur pour aider à identifier la cause (par exemple, problèmes de réseau, mauvaise configuration).

Les informations fournies dans le débogueur modale sont inestimables pour diagnostiquer des problèmes courants tels que :

  • Annonces Non Affichées : Vérifiez la détection des emplacements et le statut des annonces pour vous assurer que les emplacements sont définis et les annonces assignées.

  • Échec des Requêtes d'Annonce : Si les requêtes publicitaires ne sont pas envoyées ou échouent, le débogueur fournira des messages d'erreur indiquant des configurations possibles erronées.

  • Problèmes de Chargement du Script : Si le script n'est pas correctement chargé, vérifiez que la balise script est présente dans votre code source et correctement configurée.

Informations de contact 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 au support. Nous sommes là pour vous aider !

× Enlarged Image

Loading ...