Documentation

Vérifier un site

Un site se vérifie par l’une de trois méthodes : un enregistrement DNS TXT, une balise meta sur la page d’accueil, ou un fichier déposé à la racine du site. Ce sont les trois mêmes méthodes que celles de Google Search Console : la plupart des propriétaires de sites en ont donc déjà utilisé une. C’est la vérification qui permet d’explorer un site ; l’exploration indique lesquels de ses mots peuvent actuellement être vendus.

Ajouter le script d’intégration

Le script d’intégration est un unique élément script, ajouté une seule fois de façon à figurer sur chaque page qui doit porter des bulles. La plupart des plateformes documentent un emplacement unique pour cela. Sur WordPress, il s’agit de la partie de modèle d’en-tête du thème ou d’un bloc HTML personnalisé appliqué à tout le site ; sur Squarespace, Ghost et Webflow, il s’agit du champ d’injection de code au niveau du site dans les paramètres, et non du champ propre à chaque page. Une extension WordPress est prévue ; d’ici là, ces deux emplacements documentés sont ce que propose la plateforme.

Le script se charge une fois le DOM de la page prêt et n’a aucune dépendance. Il envoie ses balises de mesure (beacons) à l’aide de l’API Beacon du navigateur, qui ne retarde pas la page lorsqu’elle se décharge.

Choisir le périmètre

Le périmètre est la partie d’une page que le script d’intégration peut analyser, indiquée par un sélecteur tel que l’élément article, le conteneur entry-content, ou tout élément portant data-adbubbles-scope. Le périmètre est le réglage le plus déterminant, car il décide quels mots d’un site peuvent être vendus.

À l’intérieur du périmètre, le script d’intégration ignore déjà les titres, les liens, le code, le texte préformaté, les contrôles de formulaire, la navigation, l’en-tête et le pied de page. Tout autre élément qui ne doit jamais porter de bulle peut être marqué data-noads : le script d’intégration le laissera alors intact, ainsi que tout ce qu’il contient.

Le plafond par page et les exclusions de catégories

Le nombre maximal de bulles par page est le réglage de densité. Quelle que soit sa valeur, le script d’intégration ne souligne que la première occurrence de chaque mot acheté, ouvre au plus une bulle par mot, et n’en place jamais deux dans le même paragraphe.

Les exclusions de catégories se choisissent par compte, en plus des catégories qu’AdBubbles interdit partout : les jeux d’argent, les contenus pour adultes, les armes, les cryptomonnaies, les compléments alimentaires et la politique. Les créations d’une catégorie exclue n’atteignent jamais le site.

Vérifier que tout fonctionne

Le tableau de bord affiche « waiting for first page view » (en attente de la première page vue) jusqu’à l’arrivée de la première balise de mesure d’affichage, puis « live » (en ligne). Par site et par jour, il présente les pages vues qui portaient des bulles, les ouvertures, les clics et les gains cumulés, avec un panneau des problèmes pour un site devenu silencieux ou ayant perdu sa vérification.