For the complete documentation index, see llms.txt. This page is also available as Markdown.

Comment travailler avec l’API des domaines dynamiques AdBlock

Les outils AdBlock sont de plus en plus sophistiqués, ce qui pose d'importants défis aux éditeurs qui cherchent à maximiser leurs revenus publicitaires en ligne. Pour aider à atténuer ces défis, cette API permet aux éditeurs d'ajuster dynamiquement leurs scripts en fonction des domaines actifs, réduisant ainsi considérablement le risque que le contenu soit bloqué par un logiciel AdBlock.

En garantissant la diffusion des publicités via des domaines régulièrement renouvelés, les éditeurs peuvent :

  • Maintenir les flux de revenus : Empêcher les interruptions causées par des publicités bloquées.

  • Améliorer l'expérience utilisateur : Diffuser le contenu publicitaire de manière fluide sans déclencher la détection d'AdBlock.

  • Automatiser la gestion des domaines : Éliminer les mises à jour manuelles grâce à un cycle de vie automatisé de 7 jours pour les domaines.

De nouveaux domaines sont générés tous les 3 jours et sont disponibles via l'API. Les domaines auront un cycle de vie de 6 jours.

  • 3 jours actifs

  • 3 jours dépréciés

Une fois le cycle de vie expiré, le domaine sera désactivé. Pour des raisons de performance, il est recommandé de mettre en cache le domaine pendant 24 heures avant de demander un nouveau domaine à l'API.

Cette API est uniquement disponible pour script inline Popunders et Vidéo In-Stream zones.

Exigences

Pour utiliser cette API, les éditeurs doivent :

  • Effectuer une requête GET vers le point de terminaison : https://ads.exoclick.com/adblock-domains.php

  • Vous recevrez un nouveau domaine de diffusion publicitaire dans la réponse

  • Vous devez ensuite modifier le point de terminaison de syndication utilisé dans la balise de votre zone publicitaire afin de le remplacer par le nouveau fourni dans la réponse de l'API.

Étapes de mise en œuvre

1

Récupérer le domaine actif

Pour récupérer le domaine actif de manière dynamique, vous devez effectuer un appel API serveur à serveur. C’est crucial, car les appels API peuvent être bloqués s’ils sont effectués côté client.

Voici un exemple d'appel serveur à serveur en PHP :

Et voici la réponse attendue de l'API :

2

Mettre à jour votre script

Utilisez la domaine renvoyé par le point de terminaison pour mettre à jour le domaine utilisé dans votre zone publicitaire. Le domaine d'origine dépend du format publicitaire :

  • Pour Vidéo In-Stream zones, modifiez le balise VAST:

    • Avant : https://s.magsrv.com/v1/vast.php?t={random}&idzone={zoneId}

    • Après : https://newsub.newdomain.com/v1/vast.php?t={random}&idzone={zoneId}

  • Pour les zones Popunders, modifiez le syndication_host dans le script inline :

    • Avant : s.pemsrv.com

    • Après : newsub.newdomain.com

Détection d'AdBlock

Afin de détecter si l'utilisateur a activé une extension de blocage publicitaire, vous devez héberger ads.js côté éditeur (votre propre domaine/CDN) et l'inclure tout au début de votre body balise.

Ne pas demander https://www.exoclick.com/ads.js directement.

Créez votre propre ads.js fichier :

  1. Créez un fichier nommé ads.js dans un chemin public de votre site web (par exemple /js/ads.js).

  2. Ajoutez le contenu suivant à ce fichier.

  3. Chargez ce fichier depuis votre page avant la logique d'intégration publicitaire.

Contenu du fichier de référence :

Ajoutez ensuite la ligne suivante tout au début de votre body balise :

Ce script sera bloqué par AdBlock si le client l'utilise, en raison de la présence des mots-clés "exoclick" et "ads". Après le chargement de ce script, un extrait JS tentera de lire une variable spécifique. Si la variable est indéfinie ou inaccessible, nous pouvons déterminer que le script a été bloqué.

Exemples d'intégration

Dans ces deux exemples, nous utilisons fetchAdblockDomain.php comme nom de l'appel serveur à serveur pour récupérer le domaine Adblock.

In-Stream

Afin d'utiliser les domaines dynamiques avec In-Stream, veillez à inclure le lecteur VAST dans le script, sinon le lecteur chargera la zone publicitaire In-Stream par défaut au lieu d'utiliser le domaine mis à jour. Dans cet exemple, nous utilisons le lecteur HTML5 Fluidplayer.

Popunder

Dépannage

Aucun domaine renvoyé

Parfois, le point de terminaison peut renvoyer des domaines vides.

Journalisez toujours la réponse du point de terminaison pendant le débogage afin d’identifier les problèmes potentiels. Si success est false, contactez le support.

Domaine par défaut renvoyé malgré l'activation d'AdBlock

Voici quelques raisons courantes pour lesquelles votre script pourrait utiliser le domaine par défaut malgré l'activation d'AdBlock :

  • ads.js n'est pas hébergé côté éditeur. Cette intégration nécessite de servir ads.js depuis votre propre domaine (par exemple /js/ads.js). Une requête directe de https://www.exoclick.com/ads.js n'est pas prise en charge.

  • le domaine par défaut est rendu avant le domaine Adblock. Assurez-vous que le script qui insère la zone publicitaire sur votre site attend toujours l'appel serveur à serveur. Selon la chaîne d'exécution, le domaine par défaut peut être ajouté au site avant que le domaine Adblock ne soit renvoyé, ce qui empêchera votre site web d'insérer le domaine mis à jour.

Pour obtenir de l'aide supplémentaire, contactez l'équipe d'assistance ici.

Mis à jour

Ce contenu vous a-t-il été utile ?