Code et intégration

Comment ajouter Google AdSense à un site Astro (avec ou sans transitions de vue)

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

L'essentiel

  • Dans Astro, une balise script portant un attribut autre que src n'est ni traitée ni empaquetée : le code AdSense avec async et crossorigin est donc produit exactement tel qu'il est écrit.
  • Le code AdSense se place dans le head de la mise en page commune, entre les balises head, comme Google le demande pour chaque page.
  • Avec le ClientRouter d'Astro, les scripts de module empaquetés ne s'exécutent qu'une fois et le body est remplacé à chaque navigation : les nouveaux emplacements publicitaires doivent donc être relancés par un écouteur astro:page-load.
  • Les fichiers du dossier public d'Astro sont copiés tels quels dans le résultat du build, ce qui fait de public/ads.txt le moyen le plus simple de servir ads.txt à la racine du site.
  • import.meta.env.PROD vaut true uniquement dans les builds de production, ce qui permet d'écarter les requêtes publicitaires du développement local.
Du code source HTML, PHP et Java affiché sur un écran d'ordinateur
Image: Html php java source code (38891650224),Markus Spiske from Forchheim, Bavaria Upper Franconia,CC0,via Wikimedia Commons.

Pour ajouter AdSense à Astro, affichez le code AdSense sans transformation dans le <head> de votre mise en page commune, créez un petit composant qui produit l’unité <ins> et son appel push, puis servez ads.txt depuis public/. Si vous utilisez <ClientRouter /> pour les transitions de vue, relancez les emplacements sur l’événement astro:page-load, car le body est remplacé sans rechargement complet de la page.

De quoi avez-vous besoin avant de commencer ?

  • Un compte AdSense avec votre site ajouté, et votre identifiant d’éditeur (ca-pub-...).
  • Pour les emplacements manuels, une unité publicitaire créée dans la page Annonces et l’identifiant de son emplacement (slot).
  • Un projet Astro avec une mise en page commune (par exemple src/layouts/Base.astro).

Les extraits ci-dessous utilisent ca-pub-0000000000000000 et l’emplacement 1234567890 comme valeurs fictives.

Comment ajouter le code AdSense au head d’Astro ?

Google demande de coller le code AdSense entre <head> et </head>, sur chaque page (Where to place AdSense code in your HTML). Dans Astro, cela revient à la mise en page utilisée par toutes les pages.

Par défaut, Astro empaquette et transforme les balises <script> (TypeScript, imports, type="module", dédoublonnage). Le guide des scripts d’Astro précise qu’Astro ne traite pas une balise <script> qui porte un attribut autre que src, et que is:inline permet de s’exclure explicitement du traitement. Le code publicitaire tiers doit rester exactement tel que Google le fournit : utilisez donc is:inline.

---
// src/layouts/Base.astro
const { title } = Astro.props;
const showAds = import.meta.env.PROD;
---
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>{title}</title>
    {showAds && (
      <script
        is:inline
        async
        src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-0000000000000000"
        crossorigin="anonymous"
      ></script>
    )}
  </head>
  <body>
    <slot />
  </body>
</html>

import.meta.env.PROD vaut true dans les builds de production et false dans astro dev, d’après le guide des variables d’environnement d’Astro. Écarter les requêtes publicitaires du développement évite de remplir vos rapports avec vos propres impressions de test. Si un déploiement de prévisualisation est construit en mode production, protégez-le avec votre propre variable (par exemple un indicateur PUBLIC_ADS_ENABLED).

Cet extrait du head suffit aux annonces automatiques. Activez les annonces automatiques pour le site dans AdSense et c’est terminé ; la suite de ce guide concerne les unités manuelles.

Comment construire un composant d’unité publicitaire réutilisable ?

Créez un composant qui produit l’élément <ins> et l’appel push. Comme le script de push porte is:inline, Astro le produit une fois par instance de composant, ce qui correspond exactement au besoin : un push par emplacement.

---
// src/components/AdUnit.astro
interface Props {
  adSlot: string;
  format?: string;
  fullWidth?: boolean;
}
const { adSlot, format = "auto", fullWidth = true } = Astro.props;
const showAds = import.meta.env.PROD;
---
{showAds && (
  <div class="ad-slot">
    <ins
      class="adsbygoogle"
      style="display:block"
      data-ad-client="ca-pub-0000000000000000"
      data-ad-slot={adSlot}
      data-ad-format={format}
      data-full-width-responsive={fullWidth ? "true" : "false"}
    ></ins>
    <script is:inline>
      (adsbygoogle = window.adsbygoogle || []).push({});
    </script>
  </div>
)}

<style>
  .ad-slot { min-height: 280px; }
</style>

Utilisation dans une page ou une autre mise en page :

---
import Base from "../layouts/Base.astro";
import AdUnit from "../components/AdUnit.astro";
---
<Base title="My article">
  <article>
    <p>Intro paragraph...</p>
    <AdUnit adSlot="1234567890" />
    <p>More content...</p>
  </article>
</Base>

Remarques sur ce composant :

  • Les valeurs d’attributs (data-ad-format, data-full-width-responsive) sont celles que Google documente pour les unités responsives. Les valeurs autorisées sont détaillées dans le guide sur les unités publicitaires responsives.
  • Le min-height du conteneur réserve de l’espace pour que l’annonce ne repousse pas le contenu à son chargement. Choisissez une valeur adaptée à la taille attendue dans votre mise en page ; le guide sur la réservation d’espace pour les annonces en explique les compromis.
  • Astro limite la portée du <style> au composant : .ad-slot ne déborde donc pas sur d’autres éléments.
  • Ne mettez pas display:none sur le <ins> pour le masquer sous condition. La règle de modification du code de Google range le masquage des unités publicitaires à tout moment parmi les pratiques non autorisées, avec une exception distincte pour les unités responsives masquées par des media queries.

Comment les annonces AdSense se comportent-elles avec les transitions de vue d’Astro ?

Par défaut, Astro utilise la navigation classique en pleine page et la configuration ci-dessus fonctionne sans changement. Tout change quand vous ajoutez <ClientRouter /> depuis astro:transitions, qui transforme le site en application routée côté client. La documentation des transitions de vue décrit ce qui se passe à la navigation :

  • Le <head> est échangé, mais les scripts déjà présents sur la nouvelle page sont laissés en place. La bibliothèque AdSense n’est donc pas chargée deux fois.
  • Le <body> est entièrement remplacé par celui de la nouvelle page. Vos anciens emplacements publicitaires disparaissent et la nouvelle page arrive avec de nouveaux éléments <ins> vides.
  • Les scripts de module empaquetés ne sont exécutés qu’une seule fois (« are only ever executed once »). Les scripts en ligne peuvent ou non être réexécutés, selon l’historique de la page.
  • astro:page-load se déclenche à la fois lors de la navigation initiale vers une page pré-rendue et lors de toute navigation ultérieure.

La méthode robuste consiste à ne plus compter sur des scripts en ligne propres à chaque emplacement et à lancer les push depuis un seul écouteur. Retirez le <script> en ligne de AdUnit.astro et ajoutez ce script empaqueté à la mise en page :

<script>
  document.addEventListener("astro:page-load", () => {
    const slots = document.querySelectorAll(
      "ins.adsbygoogle:not([data-adsbygoogle-status])"
    );
    slots.forEach(() => {
      (window.adsbygoogle = window.adsbygoogle || []).push({});
    });
  });
</script>

data-adsbygoogle-status est l’attribut que le code publicitaire place sur les emplacements qu’il a traités (l’article de Google sur data-ad-status le mentionne comme utilisé « for ads processing purposes »). Le sélecteur ne retient donc que les nouveaux emplacements. Chaque push({}) remplit le prochain <ins> vide.

Si vous préférez conserver les scripts en ligne, Astro propose aussi data-astro-rerun pour forcer l’exécution d’un script en ligne après chaque transition. Cela fonctionne, mais un seul écouteur est plus facile à comprendre que de multiples scripts en ligne.

Qu’en est-il des annonces automatiques avec ClientRouter ?

Google ne documente pas la manière dont les annonces automatiques réagissent à la navigation côté client dans un routeur de framework. Les annonces automatiques analysent une page lors de son chargement. Avec ClientRouter, le navigateur ne charge jamais de nouveau document : ne supposez donc pas que les annonces automatiques réanalysent chaque page échangée. Si les annonces automatiques comptent plus que les animations pour vous, les options les plus simples sont de renoncer à <ClientRouter />, d’utiliser les transitions de vue natives entre documents du navigateur (dont la documentation d’Astro précise qu’elles ne modifient pas le chargement des scripts d’un site multipage), ou de forcer une navigation complète sur certains liens avec data-astro-reload. Le guide sur les applications monopage traite le même problème pour React, Vue et Svelte.

Comment servir ads.txt depuis Astro ?

Placez le fichier à l’emplacement public/ads.txt :

google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0

La documentation sur la structure de projet d’Astro indique que les fichiers de public/ sont copiés dans le dossier de build sans modification (« will be copied into the build folder untouched »), ce qui convient à robots.txt et aux fichiers similaires placés à la racine. Après le déploiement, ouvrez https://votre-domaine/ads.txt et vérifiez que vous obtenez la ligne de texte brut, et non une page HTML. Les particularités propres à chaque hébergeur (redirections, barres obliques finales, cache) sont traitées dans ads.txt sur les hébergeurs statiques et les CDN.

Dépannage

Symptôme Cause probable Correctif
La balise script apparaît avec type="module" ou un nom de fichier à empreinte Astro l’a traitée Ajouter is:inline et conserver les attributs d’origine
Les annonces s’affichent sur la première page, puis disparaissent après un clic sur un lien ClientRouter a remplacé le body et personne n’a relancé les nouveaux emplacements Utiliser l’écouteur astro:page-load ci-dessus
Console : “adsbygoogle.push() error: All ‘ins’ elements in the DOM with class=adsbygoogle already have ads in them.” Plus d’appels push() que d’emplacements vides, souvent un script de push en ligne exécuté de nouveau Ne lancer le push que pour les emplacements non traités, ou supprimer les scripts en ligne en double
Console : “No slot size for availableWidth=0” Le conteneur de l’emplacement n’a aucune largeur au moment du push (masqué, replié, dans un onglet fermé) S’assurer que le conteneur est visible et a une largeur au moment du push
Annonces dans astro dev mais pas en production, ou l’inverse Condition sur l’environnement Vérifier import.meta.env.PROD et tout indicateur personnalisé
/ads.txt renvoie votre page 404 Fichier absent de public/, ou réécriture de l’hébergeur Le déplacer vers public/ads.txt et vérifier les redirections de l’hébergeur

Cette approche est-elle conforme aux règles ?

Oui, tant que vous conservez le code tel que Google le fournit. Les extraits ci-dessus se contentent de déplacer le code AdSense dans une mise en page, d’envelopper le <ins> dans un conteneur et d’utiliser le même appel push que celui généré par Google. La règle de modification du code autorise les changements nécessaires à une expérience utilisateur propre et au dimensionnement responsive par CSS ; elle interdit les changements qui gonflent artificiellement les performances publicitaires, le masquage d’unités et le recouvrement de contenu. Pour une vue d’ensemble de l’approbation avec des sites statiques, lisez AdSense sur les sites statiques et Jamstack.

Questions fréquentes

Faut-il is:inline sur le script AdSense dans Astro ?

Pas strictement. La documentation d'Astro indique qu'une balise script portant un attribut autre que src n'est pas traitée, et le code AdSense porte déjà async et crossorigin. Ajouter is:inline rend l'intention explicite et vous protège si quelqu'un retire un jour des attributs. Dans les deux cas, la balise est produite exactement telle qu'écrite, ce qui est souhaitable pour du code publicitaire tiers.

Pourquoi mes annonces AdSense disparaissent-elles après une navigation avec transitions de vue ?

Avec le ClientRouter d'Astro, le body est remplacé à chaque navigation et les scripts empaquetés ne s'exécutent qu'une fois. La nouvelle page contient des éléments ins neufs que personne n'a relancés. Écoutez l'événement astro:page-load, déclenché au premier chargement et après chaque navigation, et appelez adsbygoogle.push une fois pour chaque élément ins que la bibliothèque publicitaire n'a pas encore traité.

Où placer ads.txt dans un projet Astro ?

Placez-le dans le dossier public sous le nom public/ads.txt. Astro copie tout le contenu de public dans le résultat du build sans le modifier : le fichier est alors servi à l'adresse /ads.txt de votre domaine. Après le déploiement, ouvrez https://votredomaine/ads.txt dans un navigateur et vérifiez que la ligne de texte brut s'affiche, et non votre page 404.

Peut-on encapsuler le script AdSense dans un composant Astro ou l'empaqueter ?

Vous pouvez l'afficher depuis un composant, mais ne l'empaquetez pas et ne le réécrivez pas. Chargez adsbygoogle.js depuis l'URL de Google, exactement comme fournie. La règle de modification du code AdSense interdit les changements qui gonflent artificiellement les performances publicitaires : conservez les attributs fournis et ne faites que les modifications documentées par Google, comme le dimensionnement CSS des unités responsives.

Sources

  1. Scripts and event handling · Astro Docs
  2. View transitions · Astro Docs
  3. Project structure · Astro Docs
  4. Where to place AdSense code in your HTML · Google AdSense Help
  5. Modifications of AdSense ad code · Google AdSense Help