Si vous êtes préoccupé par l'utilisation d'Ezoic avec un contenu se chargeant ou se modifiant dynamiquement, ne vous inquiétez pas ! Cet article vous guidera sur la façon de prendre cela en compte avec l'intégration JavaScript (autonome), permettant à votre site de bénéficier des puissantes fonctionnalités d'Ezoic.

L'intégration JavaScript (autonome) prend en compte le contenu qui se charge ou change dynamiquement. Tous les types de sites peuvent bénéficier de cette méthode d'intégration, cependant une configuration supplémentaire est requise pour les sites qui utilisent du contenu dynamique par rapport à ceux qui ne le font pas. Cet article détaille certaines des étapes de configuration supplémentaires nécessaires pour afficher des annonces sur les sites qui contiennent ce type de contenu. Cependant, veuillez noter qu'il est requis de suivre d'abord les étapes trouvées sur https://support.ezoic.com/kb/article/javascript-standalone-integration, sinon les étapes ci-dessous ne fonctionneront pas (veuillez noter que les sites qui ont un mélange de contenu statique et dynamique, et qui souhaitent utiliser toutes les fonctionnalités d'Ezoic (par ex. Vitesse du site, SEO), tout en utilisant le code client pour appeler les annonces, peuvent préférer utiliser l'intégration hybride à la place. Voir https://support.ezoic.com/kb/article/hybrid-integration pour plus d'instructions).

Changement de pages

Lors du passage entre des vues de page de manière dynamique, il est important de rappeler :

ezstandalone.showAds()

Appeler cette fonction après un changement d'URL forcera le rafraîchissement des annonces sur la nouvelle page.

Nouveau contenu

Pour les positions supplémentaires au sein de la même vue de page, vous pouvez utiliser la fonction ezstandalone.showAds.

Si un utilisateur fait défiler la page, le nouveau contenu se charge, et les positions 104 et 105 sont ajoutées, ezstandalone.showAds doit être utilisé pour les afficher.

<script>
    ezstandalone.cmd.push(function() {
        // appeler de nouvelles positions
        ezstandalone.showAds(104, 105);
    });
</script>

Changement de contenu

Si le contenu change dans la même vue de page et qu'une position n'est plus nécessaire ou visible, il est nécessaire de nettoyer correctement la position en utilisant ezstandalone.destroyPlaceholders. Cela permet de recharger la position via ezstandalone.showAds si nécessaire.

<script>
    window.ezstandalone.cmd.push(function() {
        // détruire les positions
        ezstandalone.destroyPlaceholders(104, 105);
    });
</script>

Pour les sites qui mettent en œuvre un défilement infini, une combinaison de l'appel de ezstandalone.destroyPlaceholders suivi de ezstandalone.showAds peut être nécessaire pour réutiliser les positions si dans la même vue de page.

Exemple

L'exemple ci-dessous montre à quoi ressemblerait le flux d'un défilement infini sur un site avec plusieurs articles.

Commencez par appeler la position pour le premier article au chargement de la page.

<script>
    window.ezstandalone = window.ezstandalone || {};
    ezstandalone.cmd = ezstandalone.cmd || [];
    ezstandalone.cmd.push(function() {
        ezstandalone.showAds(102, 103, 104);
    });
</script>

L'utilisateur fait ensuite défiler jusqu'à l'article suivant, de sorte que le prochain ensemble d'annonces est chargé.

<script>
    window.ezstandalone.cmd.push(function() {
        // appeler de nouvelles positions
        ezstandalone.showAds(105, 106);
    });
</script>

<script>
    window.ezstandalone.cmd.push(function() {
        // détruire les positions initiales
        ezstandalone.destroyPlaceholders(102, 103, 104);
        // appeler de nouvelles positions
        ezstandalone.showAds(102, 103, 104);
    });
</script>

Suppression de toutes les positions

Supprimez toutes les positions sur la page en utilisant la fonction destroyAll

<script>
    window.ezstandalone.cmd.push(function() {
        ezstandalone.destroyAll();
    });
</script>

Afficher toutes les positions

Vous pouvez appeler des annonces dans chaque position sur une page donnée en utilisant la fonction showAds, sans définir de valeur.

<script>
    window.ezstandalone.cmd.push(function() {
        ezstandalone.showAds();
    });
</script>

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 à 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 : Déclencher 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é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 au centre inférieur de l'écran. C'est le Débogueur d'Intégration JavaScript.

Étape 2 : Comprendre le Résultat du Débogueur

Le modal du débogueur contient plusieurs informations clés qui vous aideront à résoudre votre configuration. Voici une répartition 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 du script Ezoic est placée au bon endroit sur votre page.

• Détection des Espaces Réservés : Le nombre d'espaces réservés définis sur votre page sera affiché. Cela permet de vérifier si les espaces réservés ont été reconnus avec succès par le système Ezoic.

• Statut des Annonces : Pour chaque espace réservé, le débogueur indiquera si une annonce a été rendue avec succès. Cela montre :

  • Si une annonce est attribuée à un espace réservé spécifique.
  • Si une requête a été envoyée à Ezoic pour récupérer une annonce pour cet espace réservé.

• 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, 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 le Dépannage

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

• Annonces Non Affichées : Vérifiez la détection des espaces réservés et le statut des annonces pour vous assurer que les espaces réservés sont définis et que les annonces sont attribuées.

• Échec 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 indiquant des configurations potentiellement incorrectes.

• 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.

Si vous avez besoin d'une assistance supplémentaire avec l'intégration JavaScript (autonome) pour gérer le contenu qui se charge ou change dynamiquement, veuillez vous connecter via https://support.ezoic.com/ pour utiliser nos ressources dédiées à l'assistance. Nous sommes là pour vous aider !