Google AdSense

In questa pagina

Integra Google AdSense tramite i layout Astro e i file statici del tuo sito. Questo approccio usa il codice del sito e non richiede un plugin EmDash. Ti servono l’accesso al codice sorgente e al deployment del sito, oltre al codice di verifica e all’ID editore del tuo account AdSense.

Google controlla l’approvazione del sito, la pubblicazione degli annunci e i requisiti di consenso. Segui le istruzioni di Google per collegare un sito per il tuo account. Gli esempi seguenti mostrano dove va questo codice in EmDash e non garantiscono l’approvazione da parte di AdSense.

Aggiungere il codice di verifica e degli annunci

  1. Apri il layout condiviso usato dalle pagine pubbliche che vuoi monetizzare. Nel template del blog è src/layouts/Base.astro. Mantieni il suo <EmDashHead> esistente e il resto del contenuto dell’head.

  2. Incolla il codice AdSense nel <head> del layout. Il seguente esempio di loader usa un ID editore segnaposto; sostituisci l’intero valore ca-pub-0000000000000000 con il tuo.

    <script
        is:inline
        async
        src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-0000000000000000"
        crossorigin="anonymous"
    ></script>

    L’attributo is:inline di Astro mantiene lo script così com’è scritto invece di includerlo nel bundle. Caricalo una sola volta per pagina, anche quando più unità pubblicitarie condividono la pagina. Consulta la documentazione di Astro sulla gestione degli script.

    Se scegli il metodo di verifica con meta tag di AdSense, inserisci il tag esatto fornito da Google nello stesso <head>. L’esempio seguente mostra il tag dell’account AdSense con un ID segnaposto.

    <meta name="google-adsense-account" content="ca-pub-0000000000000000" />

    Il campo Google Verification in Settings > SEO di EmDash emette google-site-verification, non google-adsense-account. Non inserire l’ID editore AdSense in quel campo.

  3. Per gli annunci automatici, configura i posizionamenti in AdSense. Per le unità pubblicitarie manuali, incolla il markup dell’unità pubblicitaria e lo script di inizializzazione di Google in un componente o in una pagina Astro nel punto in cui deve comparire l’annuncio. Aggiungi is:inline a qualsiasi <script> di inizializzazione in modo che Astro lo mantenga. Lascia il loader condiviso nel layout invece di ripeterlo per ogni unità.

Mantieni il codice eseguibile degli annunci nel codice sorgente attendibile del sito, non nei contenuti dei post. Applica i requisiti di consenso prima di abilitare gli script degli annunci; questo esempio non implementa un gestore del consenso. Se il sito imposta una Content Security Policy, configurala per le risorse richieste dalle istruzioni attuali di Google.

Servire ads.txt nella radice

Crea public/ads.txt nel progetto del tuo sito Astro, accanto alla directory src/ del sito. Astro copia i file pubblici senza modificarli, quindi il file viene servito in /ads.txt.

Copia nel file, come testo semplice, la riga fornita da AdSense. L’esempio seguente usa un ID editore segnaposto; usa la riga esatta di Google per il tuo account.

google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0

Se ads.txt esiste già, aggiungi la riga AdSense mantenendo le voci degli altri fornitori di annunci. Segui le indicazioni di Google su ads.txt per il dominio e il contenuto del file richiesti. Conserva questo file nel progetto del sito, non nella libreria multimediale di EmDash.

Distribuire e verificare

Distribuisci il sito dopo aver modificato il suo layout o i file in public/. Sul dominio pubblico registrato in AdSense, verifica che:

  • Il sorgente della pagina contenga il tag di verifica o lo script scelto in <head>, con il tuo ID editore, e un solo loader AdSense condiviso.
  • https://your-domain.example/ads.txt restituisca il testo semplice previsto invece di un errore 404 o di una pagina HTML.
  • I pannelli di rete e console del browser non mostrino errori di script né richieste bloccate dalla policy di sicurezza del sito. Gli ad blocker possono impedire il caricamento degli annunci nei controlli locali.

Torna in AdSense per richiedere la verifica e la revisione. Il caricamento riuscito dello script o un file ads.txt raggiungibile non significa di per sé che il sito sia approvato o che gli annunci verranno mostrati.

Riutilizzare l’integrazione in un plugin

Per un’integrazione condivisa tra più siti, un plugin nativo attendibile può fornire script tramite page:fragments. Il layout host deve renderizzare i corrispondenti componenti di inserimento di EmDash. I plugin in sandbox non possono inserire script o HTML grezzo. Un file statico public/ads.txt resta una questione di deployment a livello di sito.