Annunci newsletter (beta)

Gli annunci per newsletter possono essere utilizzati per pubblicare annunci con prenotazione e pubblicità programmatica garantita di Google Ad Manager nelle newsletter via email. Questa guida descrive come implementare gli annunci della newsletter nelle tue newsletter via email.

Panoramica

Ecco il flusso di lavoro di alto livello per l'implementazione di un annuncio della newsletter:

  1. Crea o seleziona un'unità pubblicitaria di Ad Manager.
  2. Crea o seleziona un elemento pubblicitario Ad Manager. Tieni presente le seguenti linee guida:
    • Creatività previste deve contenere tutte le dimensioni degli annunci delle creatività che prevedi di visualizzare nelle newsletter.
    • Il targeting deve includere l'unità pubblicitaria del passaggio 1.
    • Per gli annunci della newsletter sono supportate solo le creatività immagine.
  3. (Consigliato) Configura un elemento pubblicitario autopromozionale da pubblicare come backup, nel caso in cui un annuncio non venga pubblicato.
  4. Crea un tag annuncio newsletter.
  5. Inserisci il tag newsletter nel punto in cui vuoi che l'annuncio venga visualizzato nella newsletter.

Formato del tag annuncio della newsletter

Un tag annuncio della newsletter è costituito da un elemento immagine HTML (img) nidificato all'interno di un elemento ancora HTML (a). Ogni tag annuncio newsletter deve essere seguito da un link "Informazioni su questo annuncio" per fornire informazioni agli utenti sullo stesso.

<!-- Newsletter ad tag -->
<a href="JUMP_URL?AD_PARAMETERS" target="_blank">
  <img src="AD_URL?AD_PARAMETERS">
</a>

<!-- "About this ad" link -->
<a href="JUMP_URL?AD_PARAMETERS&click_type=wta">About this ad</a>

I formati degli URL di ancoraggi href e delle immagini src sono i seguenti:

JUMP_URL https://securepubads.g.doubleclick.net/gampad/jump
AD_URL https://securepubads.g.doubleclick.net/gampad/ad
AD_PARAMETERS ptt=21&iu=AD_UNIT_PATH&sz=CREATIVE_SIZES&clkk=CLKK_VALUE&clkp=CLKP_VALUE&url=URL&t=TARGETING_KEY_VALUES

Consulta la sezione degli esempi per un esempio completo di tag annuncio newsletter che utilizza valori fittizi.

Ecco una spiegazione dettagliata dei parametri degli annunci della newsletter supportati:

Parametri
ptt

Deve essere sempre impostato su 21 per indicare che si tratta di una richiesta di annuncio per la newsletter.

Obbligatorio
iu

Un percorso unità pubblicitaria che identifica l'unità pubblicitaria di Ad Manager da visualizzare.

I percorsi delle unità pubblicitarie devono avere il seguente formato:

/network-code/[parent-ad-unit-code/.../]ad-unit-code

  • network-code è un identificatore univoco della rete Ad Manager a cui appartiene l'unità pubblicitaria. Quando utilizzi Gestione di più clienti (MCM), devono essere forniti entrambi gli identificatori di rete principali e secondari come parent,child.
  • parent-ad-unit-code sono i codici di tutte le unità pubblicitarie principali (si applica solo alle unità pubblicitarie di livello diverso dal primo).
  • ad-unit-code è il codice dell'unità pubblicitaria da visualizzare.
Tutti i codici unità pubblicitarie inclusi nel percorso dell'unità pubblicitaria devono rispettare le regole di formattazione specificate da Ad Manager.

Esempio Unità pubblicitaria di primo livello: /123/homepage
Unità pubblicitaria a più livelli: /123/sports/baseball
MCM: /123,456/homepage
Obbligatorio
sz

Le dimensioni delle creatività degli annunci idonee a essere visualizzate in quest'area annuncio.

Assicurati che le dimensioni elencate qui corrispondano a quelle selezionate nel campo Creatività previste dell'elemento pubblicitario selezionato.

È possibile specificare più dimensioni, separate da un carattere barra verticale (|). L'intero valore di questo parametro deve essere codificato in URL.

Esempio Dimensioni: 216 x 36, 300 x 50 o 320 x 50
Stringa dimensione: 216x36|300x50|320x50
Valore parametro: 216x36%7c300x50%7c320x50
Obbligatorio
clkk

Una stringa univoca per destinatario e per campagna email.

Ogni annuncio della newsletter incluso nell'email deve specificare un valore clkk univoco. Tuttavia, ogni singolo tag annuncio della newsletter deve specificare lo stesso valore clkk sia negli URL di ancoraggio href sia in quelli delle immagini src.

Per generare il valore clkk, devi utilizzare la funzionalità del tag di unione fornita dal tuo fornitore di servizi email. I "tag di unione" sono variabili dinamiche e personalizzabili nelle email, ad esempio *|DATE:d/m/y|*. Il nome esatto della funzionalità del tag di unione varia in base al fornitore di servizi email.

In breve, il valore clkk è una concatenazione di più variabili del tag di unione e avrà un aspetto simile a *|UNIQID|*_*|CAMPAIGN_UID|*_*|DATE:d/m/y|*. Le variabili e la sintassi disponibili dipendono dall'ESP, pertanto il valore clkk potrebbe non seguire esattamente questo formato.

Per generare un valore clkk:

  1. Individua la documentazione del tuo fornitore di servizi email relativa ai "tag di unione".
  2. Determina la combinazione di variabili del tag di unione che, se concatenate, producono una stringa univoca per utente e per campagna email.
  3. Concatena queste variabili per formare il valore clkk.

Obbligatorio
clkp

Una stringa che identifica in modo univoco un singolo posizionamento dell'annuncio newsletter.

Questo parametro è obbligatorio quando in un'email sono inclusi più annunci della newsletter. Se la tua newsletter contiene un solo posizionamento dell'annuncio, questo parametro può essere omesso.

Esempio 1, 2, top, middle e bottom
Obbligatorio Sì, se sono presenti più posizionamenti degli annunci
url

L'URL "Visualizza nel browser" per la newsletter corrente.

Il valore url deve essere compilato dal tag di unione degli URL "Visualizza nel browser" fornito dal tuo fornitore di servizi email. I "tag di unione" sono variabili dinamiche e personalizzabili nelle email, ad esempio *|ARCHIVE|*. Il nome esatto del tag di unione degli URL "Visualizza nel browser" varia in base al fornitore di servizi email.

Obbligatorio
t

Targeting delle coppie chiave-valore.

Le chiavi e i valori sono separati da un carattere di uguale (=) e più coppie chiave-valore sono separate da un carattere e commerciale (&). Ogni chiave e valore, nonché la stringa di targeting completa, deve essere codificata nell'URL.

Alle coppie chiave-valore degli annunci della newsletter si applicano le restrizioni esistenti. Per maggiori dettagli, consulta la guida introduttiva alle coppie chiave-valore.

Esempio
Chiave Valore
genre comedy
movie Lilo & Stitch
Stringa di targeting: genre=comedy&movie=Lilo%20%26%20Stitch
Valore parametro: genre%3Dcomedy%26movie%3DLilo%2520%2526%2520Stitch
Obbligatorio No

Esempio

Ecco un esempio di tag annuncio newsletter completo per un insieme di valori fittizi.

Percorso unità pubblicitaria (iu) /1/example_ad_unit
Dimensioni della creatività (sz) 216x36|300x50|320x50
Stringa univoca per email (clkk) *|UNIQID|*_*|CAMPAIGN_UID|*_*|DATE:d/m/y|*
Posizione dell'annuncio (clkp) top
Targeting (t) genre=comedy&movie=Lilo & Stitch
URL Visualizza nel browser (url) *|ARCHIVE|*
<!-- Newsletter ad tag -->
<a
  href="https://securepubads.g.doubleclick.net/gampad/jump?ptt=21&iu=/1/example_ad_unit&sz=216x36%7c300x50%7c320x50&clkk=*|UNIQID|*_*|CAMPAIGN_UID|*_*|DATE:d/m/y|*&clkp=top&url=*|ARCHIVE|*&t=genre%3Dcomedy%26movie%3DLilo%2520%2526%2520Stitch"
  target="_blank">
  <img
    src="https://securepubads.g.doubleclick.net/gampad/ad?ptt=21&iu=/1/example_ad_unit&sz=216x36%7c300x50%7c320x50&clkk=*|UNIQID|*_*|CAMPAIGN_UID|*_*|DATE:d/m/y|*&clkp=top&url=*|ARCHIVE|*&t=genre%3Dcomedy%26movie%3DLilo%2520%2526%2520Stitch">
</a>

<!-- "About this ad" link -->
<a
  href="https://securepubads.g.doubleclick.net/gampad/jump?ptt=21&iu=/1/example_ad_unit&sz=216x36%7c300x50%7c320x50&clkk=*|UNIQID|*_*|CAMPAIGN_UID|*_*|DATE:d/m/y|*&clkp=top&url=*|ARCHIVE|*&t=genre%3Dcomedy%26movie%3DLilo%2520%2526%2520Stitch&click_type=wta">
  About this ad
</a>

Domande frequenti

Come faccio a generare un valore clkk valido?

Consulta il riferimento al parametro clkk.

Quale combinazione di variabili del tag di unione devo utilizzare per formare il valore clkk?

Poiché le variabili dei tag di unione disponibili e la sintassi appropriata variano in base al fornitore di servizi email (ESP), non possiamo consigliarti o verificare i valori clkk. Ti consigliamo di consultare la documentazione del tuo fornitore di servizi email per identificare una combinazione di variabili che ti fornisca una stringa univoca per utente e per campagna email.

Di seguito è riportata la documentazione di alcuni ESP di uso comune:

Come faccio a sapere se il mio valore clkk è corretto?

Se il valore clkk è corretto, viene generata una stringa univoca per utente e per campagna email. Per verificare, devi generare email di prova, fare clic sugli annunci al loro interno, assicurarti di essere reindirizzato all'URL di destinazione corretto e che i clic vengano registrati in Google Ad Manager.

Se non l'hai ancora fatto, ti consigliamo vivamente di consultare la pagina Informazioni di riferimento sul tag annuncio della newsletter per scoprire di più su come generare valori clkk corretti. Ecco alcuni requisiti importanti:

  • La combinazione di "tag di unione" che compongono un valore clkk deve essere univoca per utente e per campagna email. Se il valore clkk contiene una sola variabile (ad esempio clkk=%UMF_MD5), molto probabilmente non è sufficientemente univoco.
  • Un singolo posizionamento dell'annuncio deve specificare lo stesso valore clkk sia negli URL href di ancoraggio sia negli URL src delle immagini. Se href e src per un determinato annunci della newsletter non hanno lo stesso valore clkk, l'annuncio non verrà pubblicato correttamente e potrebbe avere comportamenti imprevisti.

Perché gli annunci non vengono visualizzati nelle mie newsletter?

Di seguito sono riportati alcuni problemi comuni che potrebbero causare l'errore di inserimento degli annunci nelle newsletter:

  • Il tag annuncio della newsletter non è corretto.
    • I parametri href di ancoraggio HTML e src di immagine non corrispondono.
    • L'URL dell'annuncio non include il parametro ptt=21.
    • Il tag contiene spazi vuoti.
    • Sono presenti errori ortografici o parametri non concatenati con una e commerciale (&).
    • I tag di unione introducono caratteri non validi quando vengono visualizzati dal tuo ESP.
    • Contiene PII come indirizzo email o numero di carta di credito.
  • Il percorso dell'unità pubblicitaria non è corretto.
  • L'elemento pubblicitario non è attivo.

Perché gli utenti arrivano a una pagina errata dopo aver fatto clic su un annuncio?

Ciò è probabilmente dovuto a un valore clkk non univoco. Per informazioni dettagliate, consulta la pagina Parametro di riferimento clkk.

Perché i clic non vengono registrati nei report di Ad Manager?

Ecco due possibili motivi:

  1. La funzionalità di monitoraggio dei clic del tuo ESP è stata attivata, il che influisce sulla capacità di Google di registrare i clic.
  2. Il valore clkk non è corretto. Per informazioni dettagliate, consulta la pagina Parametro di riferimento clkk.

Come faccio a sapere se la funzionalità di monitoraggio dei clic della mia ESP è attivata?

Per maggiori informazioni, consulta la documentazione del tuo fornitore di servizi email o contatta l'assistenza clienti.

Come faccio a mostrare dimensioni della creatività diverse a seconda del tipo di dispositivo o delle dimensioni dello schermo?

Puoi utilizzare le query @media CSS per ridimensionare dinamicamente le creatività in base alle dimensioni dell'area visibile del browser. Nell'esempio seguente, quando la larghezza della viewport è al massimo 480 px, l'elemento annuncio img (identificato da "class="ad") occupa il 100% della larghezza del contenitore principale. Quando la larghezza della viewport è di almeno 480 px, occupa solo il 50% della larghezza del contenitore principale. Il formato dell'annuncio rimane invariato in entrambi i casi, a condizione che non venga specificata un'altra dimensione per l'elemento HTML img.

<html>
  <head>
    <meta http-equiv="content-type" content="text/html; charset=UTF-8" />
    <meta name="viewport" content="width=device-width,initial-scale=1" />
    <style>
      @media only screen and (max-width: 480px) {
        .ad {
          width: 100%;
        }
      }
      @media only screen and (min-width: 480px) {
        .ad {
          width: 50%;
        }
      }
    </style>
  </head>
  <body></body>
</html>