Si vous vous inquiétez de l'utilisation d'Ezoic avec des sites plus complexes qui comportent un mélange de contenu statique et dynamique, ne vous inquiétez pas ! Cet article vous fournira des conseils sur la manière de s'intégrer efficacement avec Ezoic via l'Intégration Hybride, permettant à votre site de bénéficier de toutes les puissantes fonctionnalités d'Ezoic.
Les comptes d'intégration hybride sont destinés aux sites plus complexes qui comportent un mélange de contenu statique et dynamique, leur permettant d'utiliser toutes les fonctionnalités d'Ezoic (par exemple, Vitesse du site, SEO), tout en utilisant le code client pour appeler les publicités.
Toutes les constructions de sites peuvent bénéficier de cette méthode d'intégration. Cependant, les sites qui n'utilisent pas de contenu dynamique et/ou qui ne souhaitent pas modifier leur DNS ont la possibilité d'utiliser l'intégration JavaScript (Autonome) à la place : https://support.ezoic.com/kb/article/javascript-standalone-integration. Les sites qui utilisent du contenu dynamique et ne souhaitent pas modifier leur DNS peuvent également s'intégrer à Ezoic via cette méthode, bien qu'une configuration supplémentaire puisse être nécessaire. Voir https://support.ezoic.com/kb/article/my-content-loads-or-changes-dynamically-can-i-still-use-ezoic pour plus d'instructions.
Assurez-vous que les espaces réservés sont créés via le tableau de bord. Consultez cet article pour en savoir plus sur les espaces réservés et comment les créer.
Chargez la bibliothèque de code en ajoutant ce script dans le <head> de la page. Certaines fonctionnalités d'Ezoic nécessitent que le HTML existe de manière statique plutôt qu'il ne soit chargé via JavaScript.
<script async src="https://www.ezojs.com/ezoic/sa.min.js"></script>
Pour ajouter un espace réservé à la page, créez un élément div à l'endroit où la publicité doit être. L'attribut id de l'élément doit être l'ID de l'espace réservé avec le préfixe ezoic-pub-ad-placeholder-.
Par exemple, pour ajouter des espaces réservés avec les id 103 et 104, le HTML ressemblerait à ceci :
<body>
<div id="ezoic-pub-ad-placeholder-103">
</div>
<!-- Content -->
<div id="ezoic-pub-ad-placeholder-104">
</div>
</body>
Une fois que les espaces réservés ont été ajoutés au HTML, appelez le code publicitaire d'Ezoic en utilisant ezstandalone.displayMore().
<script type="text/javascript">
window.ezstandalone = window.ezstandalone || {};
ezstandalone.cmd = ezstandalone.cmd || [];
ezstandalone.cmd.push(function() {
ezstandalone.showAds(103, 104);
});
</script>
Pour les sites intégrés sans espaces réservés statiques qui souhaitent charger tous les espaces réservés dynamiquement en utilisant notre configuration publicitaire côté client, veuillez utiliser le guide suivant : Commencer avec EzoicAds.
Espaces réservés statiques sont des espaces qui sont ajoutés au HTML lors du passage par notre proxy, plutôt que d'être ajoutés via JavaScript.Similaire à la division du trafic sur un site utilisant l'option de code client, vous pouvez ajouter la même fonction sans passer de paramètres :
<script type="text/javascript">
ezstandalone.cmd = ezstandalone.cmd || [];
ezstandalone.cmd.push(function() {
if(ezstandalone.isEzoicUser()) {
ezstandalone.showAds(100,101);
} else {
// Exécution normale du code publicitaireEzoicAds offre des fonctionnalités avancées qui permettent aux éditeurs d'affiner le comportement de la bibliothèque publicitaire. Ces fonctionnalités peuvent être utilisées pour personnaliser le comportement de la bibliothèque publicitaire afin de mieux répondre aux besoins de votre site. Voir ici pour plus d'instructions : https://docs.ezoic.com/docs/ezoicads/advanced/
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, ajoutez simplement le paramètre de requête suivant à l'URL de la page où vos EzoicAds sont intégrés :
ez_js_debugger=1Par exemple :
https://www.votresite.com?ez_js_debugger=1Une fois que le paramètre de requête est ajouté et que la page se charge, une boîte de dialogue modale verte apparaîtra au centre inférieur de l'écran. Ceci est le débogueur d'intégration JavaScript.
La boîte modale 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é, 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 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é rendue avec succès. Il montre :
Succès de la Requête : Le débogueur surveille également si la requête d'annonce 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 principale (par exemple, problèmes de réseau, mauvaise configuration).
Les informations fournies dans la boîte modale du débogueur sont précieuses 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 d'Annonce : Si les requêtes d'annonce ne sont pas envoyées ou échouent, le débogueur fournira des messages d'erreur qui indiquent de potentielles mauvaises configurations.
Problèmes de Chargement de Script : Si le script ne se charge pas correctement, vérifiez que la balise du script est présente dans votre code source et configurée correctement.
Si vous avez besoin d'une assistance supplémentaire avec l'Intégration Hybride, veuillez vous connecter via https://support.ezoic.com/ pour utiliser nos ressources dédiées au support. Nous sommes là pour vous aider !