Intégrez Google AdSense via les layouts Astro et les fichiers statiques de votre site. Cette approche utilise le code du site et ne nécessite pas de plugin EmDash. Vous avez besoin d’un accès au code source et au déploiement du site, ainsi qu’au code de vérification et à l’identifiant d’éditeur de votre compte AdSense.
Google contrôle l’approbation du site, la diffusion des annonces et les exigences de consentement. Suivez les instructions de Google pour connecter un site pour votre compte. Les exemples ci-dessous montrent où ce code se place dans EmDash ; ils ne garantissent pas l’approbation par AdSense.
Ajouter le code de vérification et le code publicitaire
-
Ouvrez le layout partagé utilisé par les pages publiques que vous souhaitez monétiser. Dans le modèle de blog, il s’agit de
src/layouts/Base.astro. Conservez son<EmDashHead>existant et le reste du contenu du head. -
Collez le code AdSense dans le
<head>du layout. L’exemple de chargeur suivant utilise un identifiant d’éditeur fictif ; remplacez toute la valeurca-pub-0000000000000000par la vôtre.<script is:inline async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-0000000000000000" crossorigin="anonymous" ></script>L’attribut
is:inlined’Astro conserve le script tel qu’il est écrit au lieu de l’inclure dans le bundle. Chargez-le une seule fois par page, même lorsque plusieurs blocs d’annonces se partagent la page. Consultez la documentation d’Astro sur le traitement des scripts.Si vous choisissez la méthode de vérification par balise meta d’AdSense, placez la balise exacte fournie par Google dans le même
<head>. L’exemple suivant montre la balise de compte AdSense avec un identifiant fictif.<meta name="google-adsense-account" content="ca-pub-0000000000000000" />Le champ Google Verification dans Settings > SEO d’EmDash émet
google-site-verification, et nongoogle-adsense-account. Ne saisissez pas l’identifiant d’éditeur AdSense dans ce champ. -
Pour les annonces automatiques, configurez les emplacements dans AdSense. Pour les blocs d’annonces manuels, collez le balisage du bloc d’annonces et le script d’initialisation de Google dans un composant ou une page Astro à l’endroit où l’annonce doit apparaître. Ajoutez
is:inlineà tout<script>d’initialisation pour qu’Astro le conserve. Gardez le chargeur partagé dans le layout plutôt que de le répéter pour chaque bloc.
Conservez le code publicitaire exécutable dans le code source de confiance du site, et non dans le contenu des articles. Appliquez les exigences de consentement avant d’activer les scripts publicitaires ; cet exemple n’implémente pas de gestionnaire de consentement. Si le site définit une Content Security Policy, configurez-la pour les ressources requises par les instructions actuelles de Google.
Servir ads.txt à la racine
Créez public/ads.txt dans le projet de votre site Astro, à côté du répertoire src/ du site. Astro copie les fichiers publics sans les modifier, de sorte que le fichier est servi à l’adresse /ads.txt.
Copiez dans le fichier, en texte brut, la ligne fournie par AdSense. L’exemple suivant utilise un identifiant d’éditeur fictif ; utilisez la ligne exacte de Google pour votre compte.
google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0
Si ads.txt existe déjà, ajoutez la ligne AdSense en conservant les entrées des autres fournisseurs publicitaires. Suivez les consignes de Google sur ads.txt pour le domaine et le contenu de fichier requis. Stockez ce fichier dans le projet du site, et non dans la médiathèque d’EmDash.
Déployer et vérifier
Déployez le site après avoir modifié son layout ou les fichiers de public/. Sur le domaine public enregistré auprès d’AdSense, vérifiez que :
- Le code source de la page contient la balise de vérification ou le script choisi dans
<head>, avec votre identifiant d’éditeur, et un seul chargeur AdSense partagé. https://your-domain.example/ads.txtrenvoie le texte brut attendu plutôt qu’une erreur 404 ou une page HTML.- Les panneaux réseau et console du navigateur n’affichent aucune erreur de script ni requête bloquée par la politique de sécurité du site. Les bloqueurs de publicités peuvent empêcher le chargement des annonces lors des vérifications locales.
Retournez dans AdSense pour demander la vérification et l’examen. Le chargement réussi du script ou un fichier ads.txt accessible ne signifie pas en soi que le site est approuvé ni que des annonces s’afficheront.
Réutiliser l’intégration dans un plugin
Pour une intégration partagée entre plusieurs sites, un plugin natif de confiance peut fournir des scripts via page:fragments. Le layout hôte doit rendre les composants d’insertion EmDash correspondants. Les plugins sandboxés ne peuvent pas injecter de scripts ni de HTML brut. Un fichier statique public/ads.txt reste une question de déploiement au niveau du site.