chevron_right
chevron_right
Intégration JavaScript (Autonome)
How-To/Instructional

Intégration JavaScript (Autonome)

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

Introduction

Se connecter à Ezoic via JavaScript (parfois appelé 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 implique l'insertion d'un petit morceau de code JavaScript dans le HTML de votre site, ce qui permet à Ezoic de gérer et d'optimiser l'emplacement des annonces sur votre site. Dans cet article, nous fournirons un guide étape par étape sur la manière d'intégrer Ezoic en utilisant la méthode JavaScript.

Instructions

```html
  1. Assurez-vous d'avoir créé un compte Ezoic. Si ce n'est pas déjà fait, vous pouvez le faire ici.
  2. 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 vous recommandons de configurer dans un environnement de test ou de développement pour vous assurer que vos emplacements publicitaires sont correctement configurés et 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 publicitaires serviront à 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 présume 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 livraison plus rapides des annonces, nous recommandons d'insérer ces scripts dans la balise <head>. Si ce n'est pas faisable, la meilleure option suivante est de les placer 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 publicitaire aura un ID différent à 3 chiffres. Les codes des annonces 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 réel de l'emplacement. L'ajout de styles ou la réservation d'espace pour l'annonce peut produire 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 de valeur de remplacement appellera la fonction pour chaque emplacement existant sur cette page.


Contenu Dynamique

Si le contenu de votre site Web se charge ou change dynamiquement, une configuration supplémentaire peut être nécessaire. 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 code client pour appeler les publicités. L'avantage de l'intégration hybride est qu'elle permet aux autres produits d'Ezoic (par exemple, Vitesse du siteSEO) 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 offre 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 afin de 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 proposons 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, ajoutez simplement 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.votresiteweb.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. C'est le Débogueur d'Intégration JavaScript.

La boîte de dialogue 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 de 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 apparaîtra. Assurez-vous que la balise du script Ezoic est placée au bon endroit sur votre page.

  • Détection de Placeholder : Le nombre de placeholders définis sur votre page sera affiché. Cela aide à vérifier si les placeholders ont été reconnus avec succès par le système Ezoic.

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

    • Si une annonce est assignée à un placeholder spécifique.
    • Si une requête a été envoyée à Ezoic pour récupérer une annonce pour ce placeholder.
  • Succès de la Requête : Le débogueur surveille également si la requête publicitaire a été envoyée avec succès. En cas de problème, la boîte modale affichera des détails sur les erreurs pour aider à identifier la cause principale (par exemple, problèmes de réseau, mauvaise configuration).

Les informations fournies dans la boîte de dialogue du débogueur sont inestimables pour diagnostiquer des problèmes courants tels que :

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

  • Échecs des Requêtes Publicitaires : Si les requêtes publicitaires ne sont pas envoyées ou échouent, le débogueur fournira des messages d'erreur indiquant des mauvaises configurations potentielles.

  • Problèmes de Chargement des Scripts : Si le script n'est pas correctement chargé, vérifiez que la balise de 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 à l'assistance. Nous sommes là pour vous aider !

× Enlarged Image

Loading ...