Code et intégration

AdSense dans une application monopage : relancer les emplacements à chaque changement de route sans enfreindre les règles

Mis à jour le Publié le Par la rédaction7 min6 sources

L'essentiel

  • Chaque appel adsbygoogle.push({}) demande à la bibliothèque AdSense de remplir un élément ins qui ne l'a pas encore été ; un ins déjà rempli n'est jamais rempli une seconde fois.
  • Quand il ne reste aucun emplacement vide, la bibliothèque lève l'erreur "All 'ins' elements in the DOM with class=adsbygoogle already have ads in them."
  • Dans une application monopage, un changement de route doit produire un nouvel élément ins (par exemple en lui donnant la route pour clé) avant un nouveau push.
  • Les règles de placement des annonces de Google interdisent d'actualiser une page ou un élément de page sans que l'utilisateur l'ait demandé : ne redemandez donc jamais des annonces sur un minuteur.
  • Google ne documente pas le comportement des annonces automatiques lors des changements de route côté client : ne comptez pas sur une nouvelle analyse de chaque page virtuelle.
Des personnes regardant leur smartphone sur le quai d'une gare
Image: Smartphone use at railway station,Rawpixel.com,CC0,via Wikimedia Commons.

Dans une application monopage, chargez le code AdSense une seule fois, puis après chaque changement de route affichez un nouvel élément <ins class="adsbygoogle"> et appelez adsbygoogle.push({}) une fois pour lui. Un <ins> rempli ne l’est jamais de nouveau : réutiliser l’ancien élément ne produit rien. Ne redemandez jamais d’annonces sans navigation de l’utilisateur, car la politique AdSense interdit d’actualiser des annonces que l’utilisateur n’a pas demandées.

Comment fonctionne adsbygoogle en interne ?

Le code d’unité publicitaire de Google comprend trois parties (Where to place ad unit code in your HTML) :

<script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-0000000000000000"
     crossorigin="anonymous"></script>
<ins class="adsbygoogle"
     style="display:block"
     data-ad-client="ca-pub-0000000000000000"
     data-ad-slot="1234567890"
     data-ad-format="auto"
     data-full-width-responsive="true"></ins>
<script>
     (adsbygoogle = window.adsbygoogle || []).push({});
</script>
  1. Le script de la bibliothèque se charge une fois par document.
  2. L’élément <ins> est l’emplacement.
  3. push({}) met une requête en file. Si la bibliothèque n’est pas encore chargée, window.adsbygoogle est un simple tableau que la bibliothèque traite à son arrivée.

Chaque push remplit un <ins> qui n’a pas été traité. Après traitement, la bibliothèque marque l’élément avec un attribut data-adsbygoogle-status (Google le mentionne comme utilisé « for ads processing purposes »). Si vous faites un push alors qu’aucun <ins> non traité ne reste, la bibliothèque lève l’erreur : “adsbygoogle.push() error: All ‘ins’ elements in the DOM with class=adsbygoogle already have ads in them.”

Sur un site multipage, cela n’a aucune importance : chaque chargement de page apporte des éléments neufs. Dans une application monopage, trois éléments faussent le modèle :

  • Les balises <script> en ligne dans les composants ne s’exécutent pas comme dans du HTML statique : le push doit donc se faire dans le code du composant.
  • Les changements de route ne rechargent pas le document. Les éléments des mises en page persistantes (en-tête, barre latérale) survivent à la navigation, déjà remplis.
  • Les outils de développement comme le mode strict de React exécutent les effets deux fois, ce qui fait deux push pour un seul emplacement.

Quel est le schéma générique ?

  1. Placez le code AdSense dans le <head> de la coque HTML (index.html), une seule fois.
  2. Affichez l’<ins> depuis un composant.
  3. Quand le composant est monté, faites un push une fois.
  4. Quand la route change et que vous voulez une nouvelle annonce dans une zone persistante, remplacez l’élément <ins> (et pas seulement ses attributs) et faites un push une fois pour le nouvel élément.
  5. Ne faites jamais de push sur des minuteurs, des événements de défilement, des changements de visibilité ou de focus.

Un utilitaire indépendant du framework qui ne fait de push que pour les emplacements qu’il n’a pas encore vus :

// ads.js
const seen = new WeakSet();

export function fillNewAdSlots(root = document) {
  root.querySelectorAll("ins.adsbygoogle").forEach((ins) => {
    if (seen.has(ins) || ins.hasAttribute("data-adsbygoogle-status")) return;
    seen.add(ins);
    try {
      (window.adsbygoogle = window.adsbygoogle || []).push({});
    } catch (err) {
      console.error(err);
    }
  });
}

Appelez-le après que le routeur a rendu la nouvelle vue. Le WeakSet protège des doubles push avant que la bibliothèque ait eu le temps de marquer l’élément.

React (avec React Router)

La documentation de useLocation de React Router montre exactement cet usage : exécuter un effet de bord chaque fois que l’emplacement change. Donnez au <ins> le chemin pour clé, afin qu’un nouvel élément soit créé à la navigation.

// AdUnit.jsx
import { useEffect, useRef } from "react";
import { useLocation } from "react-router";

export default function AdUnit({ adSlot }) {
  const { pathname } = useLocation();
  const pushedFor = useRef(null);

  useEffect(() => {
    if (pushedFor.current === pathname) return; // Strict Mode double run
    pushedFor.current = pathname;
    try {
      (window.adsbygoogle = window.adsbygoogle || []).push({});
    } catch (err) {
      console.error(err);
    }
  }, [pathname]);

  return (
    <div style={{ minHeight: 280 }}>
      <ins
        key={pathname}
        className="adsbygoogle"
        style={{ display: "block" }}
        data-ad-client="ca-pub-0000000000000000"
        data-ad-slot={adSlot}
        data-ad-format="auto"
        data-full-width-responsive="true"
      />
    </div>
  );
}

La référence de useEffect explique qu’en développement le mode strict exécute un cycle supplémentaire d’installation et de nettoyage réservé au développement (« one extra development-only setup+cleanup cycle ») ; la protection par ref l’absorbe. Pour les particularités de Next.js (mises en page, next/script), voyez AdSense dans Next.js.

Vue 3 (avec Vue Router)

L’attribut key de Vue peut forcer le remplacement d’un élément ou d’un composant au lieu de le réutiliser (attributs spéciaux intégrés de Vue). Donnez au composant la route pour clé et faites le push dans onMounted.

<!-- AdUnit.vue -->
<script setup>
import { onMounted } from "vue";
const props = defineProps({ adSlot: { type: String, required: true } });

onMounted(() => {
  try {
    (window.adsbygoogle = window.adsbygoogle || []).push({});
  } catch (err) {
    console.error(err);
  }
});
</script>

<template>
  <div style="min-height: 280px">
    <ins
      class="adsbygoogle"
      style="display: block"
      data-ad-client="ca-pub-0000000000000000"
      :data-ad-slot="props.adSlot"
      data-ad-format="auto"
      data-full-width-responsive="true"
    ></ins>
  </div>
</template>

Dans une mise en page persistante :

<AdUnit :key="$route.path" ad-slot="1234567890" />

Quand le chemin change, Vue détruit l’ancien composant et en monte un nouveau, qui crée un nouvel <ins> et fait un push une fois.

Svelte 5 (avec SvelteKit)

Le bloc {#key} de Svelte détruit et recrée son contenu quand la valeur d’une expression change (blocs key de Svelte). onMount s’exécute au montage du composant et pas pendant le rendu serveur.

<!-- AdUnit.svelte -->
<script>
  import { onMount } from "svelte";
  let { adSlot } = $props();

  onMount(() => {
    try {
      (window.adsbygoogle = window.adsbygoogle || []).push({});
    } catch (err) {
      console.error(err);
    }
  });
</script>

<div style="min-height: 280px">
  <ins
    class="adsbygoogle"
    style="display:block"
    data-ad-client="ca-pub-0000000000000000"
    data-ad-slot={adSlot}
    data-ad-format="auto"
    data-full-width-responsive="true"
  ></ins>
</div>

Dans +layout.svelte :

<script>
  import { page } from "$app/state";
  import AdUnit from "$lib/AdUnit.svelte";
  let { children } = $props();
</script>

{@render children()}

{#key page.url.pathname}
  <AdUnit adSlot="1234567890" />
{/key}

Si vous préférez un point d’entrée unique, afterNavigate de SvelteKit exécute la fonction fournie lorsque le composant courant est monté, et aussi à chaque navigation vers une URL : c’est un bon endroit pour appeler fillNewAdSlots().

Où se situe la limite fixée par les règles ?

Google ne publie pas de règles AdSense propres aux applications monopage : il faut donc appliquer les règles générales.

  • Pas d’actualisation non demandée. Les règles de placement des annonces indiquent que les éditeurs ne doivent pas actualiser une page ou un élément de page sans que l’utilisateur ait demandé l’actualisation. Faire un push pour un nouvel emplacement parce que l’utilisateur a navigué vers une nouvelle vue est une action déclenchée par l’utilisateur. Remplacer les annonces toutes les 30 secondes, au défilement ou quand un onglet retrouve le focus ne l’est pas.
  • Le contenu doit pouvoir être évalué. La même page de règles avertit que Google peut désactiver la diffusion d’annonces sur un contenu qu’elle ne peut pas évaluer, par exemple un contenu bloqué par robots.txt ou derrière une connexion. Donnez à chaque vue une vraie URL et privilégiez le rendu serveur ou le prérendu, pour que le contenu existe dans le HTML.
  • Pas d’annonces sur des écrans sans contenu. Les états de chargement, les résultats de recherche vides et les coques vides ne doivent pas porter d’emplacements publicitaires. N’affichez l’<ins> qu’une fois le contenu de la vue présent.
  • Gardez le code intact. La règle de modification du code interdit les changements qui gonflent artificiellement les performances publicitaires. Déplacer l’appel de push dans un hook de cycle de vie ne change pas la manière dont les annonces sont diffusées ; recharger des emplacements pour multiplier les impressions, si.

Et les annonces automatiques ?

Les annonces automatiques reposent sur un seul morceau de code et analysent votre site (« scan your site ») pour placer des annonces selon la structure de la page (About Auto ads). La documentation de Google décrit cela pour des pages et ne dit pas si les annonces automatiques réanalysent le DOM après un changement de route côté client. Considérez les annonces automatiques d’une application monopage comme une fonction valable pour la première vue, sauf si vos propres rapports montrent autre chose. Si les formats en superposition, comme les annonces ancrées et les annonces vignette, comptent pour vous, un mode de framework qui effectue de vrais chargements de page (rendu serveur avec des liens standard) est l’architecture la plus sûre. Le guide annonces automatiques ou unités manuelles compare les deux approches.

Les annonces vignette méritent un contrôle précis. Google indique que, par défaut, elles apparaissent lorsqu’un utilisateur clique sur un lien de votre site, entre deux chargements de page (« appear when a user clicks on a link on your site »). Un lien de routeur qui ne charge jamais de nouvelle page peut se comporter différemment d’un lien normal, et Google ne documente pas ce cas. Testez votre navigation avec les annonces vignette activées et, si un lien ne doit jamais en déclencher une (connexion, étape de paiement), ajoutez l’attribut documenté par Google data-google-vignette="false" à cet élément <a> ; voyez Prevent a link on your site from triggering vignette ads.

Dépannage

Symptôme Cause Correctif
“All ‘ins’ elements … already have ads in them.” Plus de push que de nouveaux emplacements Un push par nouvel <ins> ; protéger avec une ref ou un WeakSet
“No slot size for availableWidth=0” Push d’un emplacement masqué ou avant la mise en page (onglet fermé, fenêtre modale, display:none) Ne faire le push que lorsque l’emplacement est visible et a une largeur
Annonce visible à la première vue, vide après navigation Une mise en page persistante garde l’<ins> déjà rempli Donner une clé liée à la route à l’élément ou au composant
Cadres vides sans annonce Aucune annonce renvoyée Styler les emplacements non remplis avec data-ad-status ; voyez les emplacements publicitaires non remplis

Questions fréquentes

Est-il permis de charger de nouvelles annonces AdSense à chaque changement de route dans une application monopage ?

Les règles de Google ne mentionnent pas les applications monopage par leur nom. Ce qu'elles interdisent, c'est d'actualiser une page ou un élément de page sans que l'utilisateur l'ait demandé. Afficher un nouvel emplacement parce que l'utilisateur a cliqué vers un nouveau contenu se comporte comme une nouvelle page vue. Redemander des annonces sur un minuteur, au défilement ou pendant que le même contenu reste à l'écran n'est pas équivalent et risque une infraction.

Pourquoi ai-je l'erreur "All 'ins' elements in the DOM with class=adsbygoogle already have ads in them" ?

Vous avez appelé adsbygoogle.push plus de fois qu'il n'y a d'éléments ins vides. Les causes typiques sont le mode strict de React qui exécute les effets deux fois en développement, un composant qui se rend de nouveau et relance un push, ou une mise en page persistante dont l'élément ins a été rempli à la première route. Faites un seul push par ins nouvellement créé et donnez à l'élément une clé liée à la route.

Les annonces automatiques fonctionnent-elles dans une application monopage React ou Vue ?

Les annonces automatiques se chargent avec le code AdSense et analysent la page qu'elles trouvent. Google ne documente pas si elles réanalysent le contenu après une navigation côté client : leur comportement d'une page virtuelle à l'autre n'est donc pas garanti. Si elles comptent pour vous, envisagez des pages rendues côté serveur ou prérendues avec de vrais chargements de page, ou testez avec soin et jugez d'après vos rapports.

AdSense peut-il examiner un site dont tout le contenu est rendu en JavaScript ?

Les règles de placement de Google indiquent qu'elle peut désactiver la diffusion d'annonces sur un contenu qu'elle ne peut pas évaluer. Google ne publie pas le détail de la manière dont son robot d'examen rend les applications JavaScript. Pour réduire le risque, servez un HTML significatif pour chaque URL par rendu serveur ou prérendu, donnez à chaque vue sa propre URL et vérifiez que robots.txt ne bloque ni scripts ni contenu.

Sources

  1. Where to place ad unit code in your HTML · Google AdSense Help
  2. Ad placement policies · Google AdSense Help
  3. About Auto ads · Google AdSense Help
  4. useEffect · React
  5. Built-in Special Attributes (key) · Vue.js
  6. $app/navigation · SvelteKit Docs