Si vous êtes inquiet à propos de l'utilisation d'Ezoic avec des sites plus complexes qui contiennent un mélange de contenu statique et dynamique, ne vous inquiétez pas ! Cet article vous donnera 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.
L'intégration hybride concerne les sites plus complexes qui ont un mélange de contenu statique et dynamique, leur permettant d'utiliser le cache d'Ezoic tout en utilisant le snippet de code côté client pour appeler les publicités.
Toutes les architectures de site peuvent bénéficier de cette méthode d'intégration. Cependant, les sites qui n'utilisent pas de contenu dynamique et/ou ne souhaitent pas apporter de modifications à leur DNS ont la possibilité d'utiliser l'intégration JavaScript (autonome) à la place. Les sites qui utilisent du contenu dynamique et ne souhaitent pas apporter de modifications à leur DNS peuvent également s'intégrer à Ezoic via cette méthode, bien qu'une configuration supplémentaire puisse être nécessaire. Consultez https://support.ezoic.com/kb/article/my-content-loads-or-changes-dynamically-can-i-still-use-ezoic pour des instructions supplémentaires.
Les sites doivent d'abord être intégrés via l'intégration cloud ou l'intégration Cloudflare pour activer le cache d'Ezoic.
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 que 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 identifiants 103 et 104, le HTML ressemblerait à ceci :
<body>
<div id="ezoic-pub-ad-placeholder-103">
</div>
<!-- Contenu -->
<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 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 à la place : Commencer avec EzoicAds.
Les espaces réservés statiques sont des espaces réservés qui sont ajoutés au HTML lors du passage par notre proxy, plutôt que d'être ajoutés via JavaScript.Similar to traffic splitting on a site using the client-side code snippet option, you can add the same function without passing any parameters:
<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'ajuster finement 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 afin de mieux répondre aux besoins de votre site. Consultez 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 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 l'utilisation de ce débogueur et l'interprétation de 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 le paramètre de requête ajouté et la page chargée, une boîte de dialogue modale verte apparaîtra au centre en bas de l'écran. Il s'agit du débogueur d'intégration JavaScript.
La boîte de dialogue du débogueur contient plusieurs informations clés qui vous aideront à résoudre 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 s'affichera. 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é correctement reconnus par le système Ezoic.
Statut des Annonces : Pour chaque placeholder, le débogueur indiquera si une annonce a été affichée avec succès. Il montre :
Succès de la Requête : Le débogueur surveille également si la requête pour l'annonce a été envoyée avec succès. S'il y a un problème, la boîte de dialogue affichera des détails d'erreur pour aider à identifier la cause racine (par ex., 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 ne s'affichant pas : Vérifiez la détection des placeholders et le statut des annonces pour vous assurer que les placeholders sont définis et que des annonces y sont assigné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 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 correctement configurée.
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 !