Caricare il codice creatività con una richiesta senza tag

È possibile utilizzare una richiesta senza tag al posto di un tag annuncio per richiedere il codice creatività non elaborato trasferito in Google Ad Manager. Le richieste senza tag vengono utilizzate di norma quando sono necessarie l'analisi e la visualizzazione personalizzate, come per i set-top box 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 monitoraggio delle impressioni.

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?.

Specifica i parametri della richiesta di annuncio

Per informazioni dettagliate sui parametri obbligatori e facoltativi, consulta le tabelle seguenti. Per ulteriori dettagli sui parametri GDPR, visita la pagina Integrazione del publisher con il TCF di IAB Europe.

Parametri obbligatori

Parametro	Descrizione
iu	Il codice unità pubblicitaria di Google Ad Manager, incluso il codice di rete 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 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 Tutte le richieste con i valori tile incrementati (tile=) devono essere attivate entro 30 secondi per garantire che la stessa creatività non venga selezionata nuovamente per lo stesso correlatore (c=).

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 dell'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), ma 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 è 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 esegue l'override del 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 (1ª 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 un ID dispositivo reimpostabile (RDID) per la quota limite e il targeting per pubblico. Scopri di più sulla configurazione di un RDID per le richieste senza tag.

Attiva il monitoraggio delle impressioni

Le richieste senza tag supportano un solo pixel di monitoraggio delle impressioni di terze parti. Se in una creatività sono configurati più pixel, viene utilizzato solo il primo pixel visualizzato.

Google Ad Manager può monitorare le impressioni, 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 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".

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 set-top box 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

• Visualizzazione attiva
• Ad Exchange
• Cookie o identificatori di app per dispositivi mobili utilizzati per il monitoraggio
• Wrapper creatività
• Allocazione dinamica con AdSense, Ad Exchange o AdMob
• Inventario nativo
• Preferred deal
• Anteprime delle creatività
• AdChoices

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.

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

I badge annuncio non sono supportati per le creatività pubblicate su Richieste senza tag. L'annuncio deve rispettare i requisiti normativi vigenti per gli annunci pubblicati nel SEE (Spazio economico europeo). Questo include un meccanismo che consente agli utenti di segnalare contenuti illegali. I publisher devono comunicare a Google eventuali segnalazioni di contenuti illegali utilizzando l'apposito modulo.