Sviluppo di tag publisher di Google

Caricare il codice creatività con una richiesta senza tag

Richiedere un codice creatività non elaborato per l'analisi e la visualizzazione personalizzate

È possibile utilizzare una richiesta senza tag al posto di un tag annuncio per richiedere il codice creatività non elaborato trasferito in Ad Manager. Le richieste senza tag vengono utilizzate di norma quando sono necessarie l'analisi e la visualizzazione personalizzate, come per i decoder o altri ambienti che non supportano l'SDK o il tagging di Google.

Quando crei una richiesta senza tag, Ad Manager restituisce solo il codice creatività non elaborato, esattamente come era stata indirizzata, senza eseguire e visualizzare l'annuncio. Se non si trova alcun annuncio, viene restituito uno stato 200/OK con una risposta vuota.

L'app, il player o il sito deve eseguire il codice per poter visualizzare l'annuncio e attivare il tracciamento delle impressioni.

Non utilizzare una richiesta senza tag per pubblicare annunci in email. Vedi tutte le funzionalità non supportate.

Creare una richiesta senza tag manualmente

Per creare una richiesta senza tag, inizia con l'URL di base, includi tutti i parametri obbligatori ed eventuali altri parametri facoltativi. Questi parametri specificano elementi quali unità pubblicitaria, dimensioni della creatività, coppie chiave-valore e altre informazioni sulla richiesta.

Le richieste senza tag devono essere effettuate in regime di sicurezza utilizzando il protocollo SSL (https://).

Iniziare con un URL di base

Usa questo URL di base: https://securepubads.g.doubleclick.net/gampad/adx?.

Specificare i parametri della richiesta di annuncio

Parametri obbligatori
Parametro Descrizione
iu

Il codice unità pubblicitaria di Google Ad Manager, incluso il codice di rete di Google Ad Manager. Per includere più livelli, utilizza la barra (/) come separatore.

Esempio

iu=/123/homepage
iu=/456/sports/baseball

Se utilizzi Gestione di più clienti (MCM) con le richieste senza tag, utilizza la struttura parent,child per il codice di rete.

Esempio (MCM)

iu=/123,456/homepage

sz

Dimensioni della creatività. Per includere più dimensioni, utilizza la barra verticale (|) come separatore.

Esempio

sz=320x50 per una singola dimensione
sz=320x50|300x50 per più dimensioni

Ti consigliamo di codificare il carattere barra verticale (|) nelle richieste senza tag con %7c.

Esempio

&sz=216x36|300x50|320x50 diventa &sz=216x36%7c300x50%7c320x50.

url

URL del dominio che ospita la richiesta di annuncio iniziale. Obbligatorio solo per le richieste MCM.

Esempio

url=www.example.com

c

Valore correlatore (o busting della cache). Deve essere un numero casuale (le lettere non sono consentite) generato da un publisher, per garantire che venga eseguita una nuova chiamata all'ad server a ogni caricamento della pagina, evitando discrepanze nei conteggi delle impressioni.

Esempio

c=8362527364

tile

Posizione del tag su una pagina web. Il valore deve essere un numero intero univoco. Per agevolare l'implementazione, consigliamo un valore da sommare.

Ciò è richiesto solo se più tag annuncio usano gli stessi valori di codice dell'unità pubblicitaria (iu=) e correlatore (c=) sulla stessa pagina.

Esempio

https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=1
https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=2

Parametri facoltativi
Parametro Descrizione
d_imp

Attivazione/disattivazione delle impressioni ritardate. Se il parametro viene incluso, il conteggio delle impressioni su richiesta è disattivato e per registrare un'impressione vengono usate la macro delle impressioni visualizzate nella creatività restituita o le informazioni del parametro d_imp_hdr.

Esempio

d_imp=1
d_imp=0 (Questo è il valore predefinito per il conteggio delle impressioni di Google Ad Manager).

d_imp_hdr

Attivazione/disattivazione delle informazioni di intestazione delle impressioni ritardate. Se il parametro viene incluso, l'URL di visualizzazione da usare per il conteggio delle impressioni è restituito nell'intestazione HTTP. Per impostazione predefinita, le informazioni dell'intestazione non sono definite. Un publisher deve quindi inviare manualmente il ping di questo URL di visualizzazione per conteggiare un'impressione. Scopri di più sul conteggio delle impressioni e sulle richieste senza tag.

  • L'intestazione Google-Delayed-Impression contiene l'URL impressione di Google Ad Manager.
  • L'intestazione Google-3rdParty-Delayed-Impression contiene l'URL impressione di terze parti, se presente nella creatività.

Esempio

d_imp_hdr=1
d_imp_hdr=0 (Disabilita esplicitamente le informazioni dell'intestazione dell'impressione ritardata).

t

Coppie chiave-valore a livello di area annuncio. Tutte le chiavi e i valori sono separati dal segno di uguale =; le coppie chiave-valore sono separate dalla e commerciale &. Tutte le chiavi e i valori devono essere codificati nell'URL individualmente e poi l'intera stringa deve essere codificata nell'URL. Ogni chiave di un insieme di coppie chiave-valore deve essere unica; se fornisci la stessa chiave più di una volta, verrà considerato solo uno dei valori associati.

Esempio

Il parametro t=genre%3Daction%26movie%3DMr+%2526+Mrs+Smith assegna la chiave "genre" al valore "action" e la chiave "movie" a "Mr & Mrs Smith".
Tieni presente che la "&" fra le assegnazioni della coppia chiave-valore è codificata una volta come (%26) e due volte come (%2526) quando è presente all'interno di un valore.

Utilizza excl_cat come chiave speciale per esclusioni competitive.

Esempio

t=excl_cat%3Dairlines
t=interest%3Dsports%2Cnews%26excl_cat%3Dairlines

I seguenti caratteri non sono consentiti in chiavi o valori: " ' ! + # * ~ ; ^ ( ) < > [ ] = . Gli spazi sono ammessi nei valori, con escape come %20 o +), ma non nelle chiavi.

Esempio

Impostare il valore "b+c" per la chiave "a" con t=a%3Db%252Bc non funziona.

m

Valore tipo mime sull'intestazione HTTP.

Esempio

m=text/wml

mob

Indicatore richiesta di annuncio per dispositivi mobili.

Esempio

mob=js (Questo è l'unico valore accettato).

ppid

Il parametro identificatore fornito dal publisher (PPID) ti consente di inviare a Google Ad Manager un identificatore da utilizzare per la quota limite, la segmentazione del pubblico, il targeting per pubblico, la rotazione degli annunci sequenziale e altre impostazioni di pubblicazione degli annunci basate sul pubblico su tutti i dispositivi.

Esempio

ppid=12JD92JD8078S8J29SDOAKC0EF230337

u_w

Larghezza dello schermo del dispositivo mobile, che sostituisce il rilevamento automatico eseguito dall'ad server.

Esempio

u_w=1024

u_h

Altezza dello schermo del dispositivo mobile che sostituisce il rilevamento automatico eseguito dall'ad server.

Esempio

u_h=768

submodel

Informazione sull'hardware del dispositivo mobile, che sostituisce il rilevamento automatico eseguito dall'ad server.

Esempio

submodel=iPhone4%2C1 (La virgola per delimitare il valore di submodel è codificata).

Valori di submodel:

  • iPhone (prima gen.): iphone1,1
  • iPhone 3G: iphone1,2
  • iPhone 3GS: iphone2,1
  • iPhone 4 (GSM): iphone3,1
  • iPhone 4 (GSM): iphone3,2
  • iPhone 4 (CDMA): iphone3,3
  • iPhone 4S: iPhone4,1
  • iPhone 5 (GSM e LTE): iPhone5,1
  • iPhone 5 (CDMAe LTE): iPhone5,2
  • iPhone 5c: (GSM and CDMA): iPhone5,3
  • iPhone 5c (GSM e CDMA): iPhone5,4
  • iPhone 5s (GSM e CDMA): iPhone6,1
  • iPhone 5s (GSM e CDMA): iPhone6,2
  • iPhone 6 : iPhone7,2
  • iPhone 6 Plus: iPhone7,1
  • iPhone 6s: iPhone8,1
  • iPhone 6s Plus: iPhone8,2
  • iPhone SE: iPhone8,4
  • iPhone 7: iPhone9,1
  • iPhone 7 Plus: iPhone9,2 
  • iPod di prima generazione: iPod1,1
  • iPod di seconda generazione: iPod2,1
  • iPod di terza generazione: iPod3,1
  • iPod di quarta generazione: iPod4,1
  • iPod di quinta generazione: iPod5,1
  • iPad di prima generazione (Wi-Fi): iPad1,1
  • iPad di prima generazione (AT&T): iPad1,2
  • iPad di seconda generazione (Wi-Fi): iPad2,1
  • iPad di seconda generazione (AT&T): iPad2,2
  • iPad di seconda generazione (Verizon): iPad2,3
  • iPad di seconda generazione (Wi-Fi): iPad2,4
  • iPad di terza generazione (Wi-Fi): iPad3,1
  • iPad di terza generazione (Verizon): iPad3,2
  • iPad di terza generazione (AT&T): iPad3,3
  • iPad di quarta generazione (Wi-Fi): iPad3,4
  • iPad di quarta generazione (AT&T): iPad3,5
  • iPad di quarta generazione (Verizon): iPad3,6
  • iPad Mini (Wi-Fi): iPad2,5
  • iPad Mini (AT&T-US; GSM e LTE 4, 17): iPad2,6
  • iPad Mini (Verizon-World; GSM, DMA e LTE 1,3,5,13,25): iPad2,7
  • iPad Mini Retina (Wi-Fi): iPad4,4
  • iPad Mini Retina (LTE): iPad4,5
  • iPad Air (Wi-Fi): iPad4,1
  • iPad Air (LTE): iPad4,2
 
Puoi utilizzare ID dispositivo reimpostabili (RDID) per la quota limite e il targeting per pubblico. Scopri di più sulla configurazione di RDID per le richieste senza tag.

Attivare il monitoraggio delle impressioni

Ad Manager può monitorare le impressioni scaricate, anche note come impressioni "ritardate", per le richieste senza tag. Utilizza una delle opzioni di seguito, ma non tutte contemporaneamente. Se utilizzi tutte le opzioni in una volta, le impressioni potrebbero essere conteggiate due o tre volte.

Ti consigliamo di usare la prima opzione, ma, in tal caso, devi essere in grado di accedere alle intestazioni delle risposte HTTP e implementare un protocollo basato su intestazioni.

Opzione 1: leggi l'intestazione della risposta HTTP per controllare il conteggio delle impressioni

Aggiungi i parametri d_imp=1 e d_imp_hdr=1 alla tua richiesta senza tag per impedire a Google Ad Manager di registrare un'impressione o un'impressione scaricata prima che tu abbia attivato manualmente un ping di impressione con l'URL di intestazione HTTP Google-Delayed-Impression. Quando il ping di impressione è attivato, Google Ad Manager registra una "impressione ad server" e una "impressione scaricata ad server".

Non includere la macro delle impressioni visualizzate per le creatività restituite dalle richieste senza tag per evitare di conteggiare due volte un'impressione.

Opzione 2: utilizza la macro delle impressioni visualizzate

Se non riesci ad accedere alle intestazioni delle risposte HTTP, segmenta l'inventario e aggiungi la macro delle impressioni visualizzate allo snippet di codice di ogni creatività restituita da una richiesta senza tag. Questa macro si espande in un URL che deve essere inviato dalla creatività durante il rendering.

Creare una richiesta senza tag per recuperare il codice creatività

Contenuti web

Le richieste senza tag vengono generalmente utilizzate in ambienti che non supportano l'SDK o il tagging di Google. Se effettui una richiesta senza tag sul web, è necessario caricarla in un <iframe> per poter eseguire il codice non elaborato restituito.

Ambienti personalizzati senza un SDK di Google

Per recuperare il codice creatività non elaborato in ambienti senza il tagging o il supporto SDK di Google (ad esempio, un decoder non Google), consulta le seguenti linee guida:

  • Imposta un agente utente valido nell'intestazione della richiesta User-Agent per garantire che il targeting funzioni correttamente.
  • Assicurati che il tuo ambiente sia in grado di gestire i comportamenti rich media, incluso JavaScript e l'espansione di creatività.
  • Fai una richiesta HTTPS a Google Ad Manager.
  • Controlla lo stato della risposta per verificare se è presente "HTTP 200/OK", che indica che la richiesta è stata formulata correttamente.

Funzionalità non supportate con richieste senza tag

Le richieste senza tag che utilizzano gampad/ad nei tag immagine HTML (<img>) non supportano il codice di monitoraggio JavaScript e non sono supportate per il conteggio delle impressioni scaricate.

Per creare rapporti su questi annunci, utilizza la metrica "Conteggio totale pubblicazione del codice" nei rapporti di Ad Manager.

È stato utile?

Come possiamo migliorare l'articolo?
Ricerca
Cancella ricerca
Chiudi ricerca
Menu principale
4119495272998757237
true
Cerca nel Centro assistenza
true
true
true
true
true
148
false
false