La corrispondenza dei cookie è una funzionalità che ti consente di abbinare il tuo cookie, ad esempio un ID per un utente che ha visitato il tuo sito web, a un ID utente Google specifico per l'offerente corrispondente e di creare elenchi di utenti che ti aiutino a prendere decisioni più efficaci in merito alle offerte. Questa guida descrive i concetti utilizzati in Cookie Matching, nonché i diversi flussi di lavoro di Cookie Matching e le eventuali variazioni che possono presentarsi per determinati casi d'uso.
Concetti
Che cos'è la corrispondenza dei cookie?
I proprietari dei domini in genere impostano i contenuti dei cookie per gli utenti che navigano nel loro sito, che vengono utilizzati per identificare gli utenti all'interno di quel dominio. Anche se due proprietari di domini accetterebbero altrimenti di scambiare questi dati, il modello di sicurezza dei browser internet impedisce a uno di leggere un cookie impostato da un altro dominio.
Nel contesto della pubblicità digitale, Google identifica gli utenti con cookie
appartenenti al dominio doubleclick.net e gli offerenti
che partecipano alle offerte in tempo reale potrebbero avere un proprio dominio in cui
identificano un insieme di utenti a cui mostrare gli annunci. La corrispondenza dei cookie
consente all'offerente di abbinare i propri cookie a quelli di Google, in modo da
determinare se un'impressione inviata in una richiesta di offerta è associata a uno degli
utenti di destinazione. L'offerente riceverà i propri dati dei cookie o un
ID utente Google specifico per l'offerente, ovvero una forma criptata del
cookie doubleclick.net nella richiesta di offerta.
Il servizio di corrispondenza dei cookie descritto in questa guida facilita la creazione e la manutenzione dell'associazione tra il cookie di un offerente e l'ID utente Google e consente anche di compilare gli elenchi utenti.
Tabelle delle corrispondenze
Una tabella di corrispondenza può essere utilizzata per mappare un ID o altri dati da un dominio a un altro. Gli offerenti possono utilizzare il servizio di corrispondenza dei cookie per compilare le proprie tabelle delle corrispondenze mappando il proprio cookie per un determinato utente con l'ID utente Google dell'utente o per compilare una tabella delle corrispondenze ospitata da Google. Le tabelle di corrispondenza sono necessarie per consentire all'applicazione di un offerente di accedere ai dati dei cookie dell'utente a cui viene mostrata l'impressione.
Tabelle delle corrispondenze ospitate da Google
Per semplificare la manutenzione, migliorare la latenza e accedere ai dati delle corrispondenze per gli utenti di determinate regioni, ti consigliamo di consentire a Google di ospitare la tabella delle corrispondenze. In questo modo puoi specificare una stringa sicura per il web codificata con Base64, di seguito denominata dati di corrispondenza ospitati, che verrà mappata all'ID utente Google per un determinato utente. Una volta stabilita una corrispondenza, questa può essere utilizzata nei seguenti modi:
Offerte in tempo reale: nelle successive richieste di offerta per le impressioni associate all'utente, Google ti invierà i dati di corrispondenza ospitati che corrispondono al suo ID utente Google. Google specificherà
BidRequest.user.buyeruidcome stringa sicura per il web con codifica Base64.Elenchi utenti: gli elenchi utenti possono essere compilati con ID utente Google o dati di corrispondenza ospitati.
- Pretargeting: Puoi configurare il pretargeting in modo da ricevere solo richieste di offerta contenenti dati di corrispondenza ospitati. Può essere utilizzato per eliminare le impressioni meno pertinenti per gli utenti al di fuori dello spazio dei cookie.
Elenchi di utenti
Gli elenchi di utenti possono essere creati e gestiti con l'API Real-Time Bidding. Una volta creati, puoi compilare questi elenchi con i seguenti flussi di lavoro di corrispondenza dei cookie o tramite il servizio di caricamento collettivo.
Per iniziare
Per iniziare a utilizzare la corrispondenza dei cookie, devi contattare il tuo Technical Account Manager, che può attivare flussi di lavoro specifici e aiutarti a configurare quanto segue:
- ID rete di corrispondenza dei cookie (NID): un ID stringa che identifica in modo univoco l'account di un offerente per la corrispondenza dei cookie e altre operazioni correlate.
- URL di corrispondenza dei cookie: l'URL di base per un endpoint che accetterà e gestirà le richieste in arrivo nell'ambito dei flussi di lavoro di corrispondenza dei cookie. Gli offerenti possono incorporare macro in questo URL per controllare l'ordine dei parametri che gli vengono trasmessi nei flussi di lavoro di Corrispondenza dei cookie.
- Tag di corrispondenza: il tag che devi inserire nel browser di un utente per il flusso di lavoro di corrispondenza dei cookie avviato dall'offerente. Può essere pubblicato insieme agli annunci o inserito in proprietà web al di fuori degli annunci.
- URL segnalazione corrispondenza dei cookie (facoltativo): nel flusso di lavoro Corrispondenza dei cookie unidirezionali, questo è un URL facoltativo che può essere fornito per specificare un endpoint che riceverà dettagli relativi agli errori nell'evento della corrispondenza dei cookie tramite un reindirizzamento HTTP 302. Per impostazione predefinita, le risposte verranno inviate a questo URL solo se si è verificato un errore nell'operazione di corrispondenza dei cookie, ma gli offerenti possono richiedere che il reindirizzamento venga sempre inviato.
- URL di assistenza per la corrispondenza dei cookie: per gli scambi che implementano il flusso di lavoro di assistenza per la corrispondenza dei cookie, questo è l' URL di base dell'endpoint destinato a rispondere alle richieste in arrivo.
- Quota di Cookie Match Assist: per gli exchange che implementano il flusso di lavoro di Cookie Match Assist, questo è il numero massimo di richieste che il loro URL di corrispondenza dei cookie può ricevere ogni secondo. Lo scopo è impedire che le richieste CMA sovraccarichino i server dell'exchange.
Macro di corrispondenza dei cookie
In uno qualsiasi dei flussi di lavoro di corrispondenza dei cookie supportati, l'URL di corrispondenza dei cookie di un offerente in genere ha parametri aggiunti in un ordine non garantito. Gli offerenti con integrazioni che richiedono un ordine coerente dei parametri possono inserire macro nell'URL di corrispondenza dei cookie per indicare il loro posizionamento.
Macro supportate
Gli offerenti possono facoltativamente configurare l'URL di corrispondenza dei cookie in modo da includere una o più macro nel formato %%GOOGLE_<PARAM_NAME>%% o %%GOOGLE_<PARAM_NAME>_PAIR%%. Le macro supportate e i relativi
valori espansi sono:
| Macro | Valore espanso |
|---|---|
| GOOGLE_GID | GOOGLE_USER_ID |
| GOOGLE_GID_PAIR | &google_gid=GOOGLE_USER_ID |
| GOOGLE_CVER | COOKIE_VERSION_NUMBER |
| GOOGLE_CVER_PAIR | &cver=COOKIE_VERSION_NUMBER |
| GOOGLE_ERROR | ERROR_ID |
| GOOGLE_ERROR_PAIR | &google_error=ERROR_ID |
| GOOGLE_PUSH | PIXEL_MATCH_DATA |
| GOOGLE_PUSH_PAIR | &google_push=PIXEL_MATCH_DATA |
| GOOGLE_ALL_PARAMS | google_gid=GOOGLE_USER_ID&cver=COOKIE_VERSION_NUMBER&google_error=ERROR_ID |
Esempio di macro
Un offerente ha un'integrazione di corrispondenza dei cookie con un endpoint ospitato all'indirizzo
https://user.bidder.com/cookies e la sua implementazione richiede
parametri preimpostati definiti dall'offerente, oltre ai parametri di corrispondenza dei pixel
nel seguente ordine: google_push,
google_gid, google_cver e
google_error. L'offerente può farlo impostando l'URL di corrispondenza dei cookie su:
https://user.bidder.com/cookies?w=0%%GOOGLE_PUSH_PAIR%%&x=1%%GOOGLE_GID_PAIR%%&y=2%%GOOGLE_CVER_PAIR%%&z=3%%GOOGLE_ERROR_PAIR%%
Quando Google invia successivamente una richiesta di corrispondenza a questo offerente, la richiesta verrà espansa in modo simile al seguente:
https://user.bidder.com/cookies?w=0&google_push=PUSH_DATA&x=1&google_gid=GOOGLE_GID&y=2&google_cver=1&z=3
Flussi di lavoro del servizio di corrispondenza dei cookie
Il servizio di corrispondenza dei cookie di Google supporta i seguenti tre flussi di lavoro.
Avviata dall'inserzionista: corrispondenza dei cookie bidirezionale
La corrispondenza dei cookie bidirezionale si riferisce a un flusso di lavoro avviato da un offerente, in cui viene inserito un tag di corrispondenza nel browser dell'utente che lo indirizza a Google. Questo workflow consente sia a Google che all'offerente di compilare le tabelle di corrispondenza. Di seguito è riportato un esempio di questo flusso di lavoro.
Passaggio 1: posiziona il tag di corrispondenza
Per avviare questo flusso, l'offerente deve inserire il tag di corrispondenza in modo che venga visualizzato nel browser dell'utente. Un tag di corrispondenza che restituisce solo l'ID utente Google all'offerente può essere strutturato nel seguente modo:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />
Esistono parametri aggiuntivi che puoi includere nel tag di corrispondenza per soddisfare diversi casi d'uso. Per scoprire di più su questi parametri, consulta Parametri URL tag corrispondenza.
Passaggio 2: Google risponde con il reindirizzamento, inclusi i dati di corrispondenza
Il tag di corrispondenza farà in modo che il servizio di corrispondenza dei cookie di Google riceva una
richiesta dal browser dell'utente, che emetterà un HTTP 302
reindirizzamento all'URL di corrispondenza dei cookie dell'offerente. Il reindirizzamento includerà parametri di query che specificano l'ID utente Google e il relativo numero di versione nell'URL e l'offerente riceverà anche il proprio cookie incluso nelle intestazioni della richiesta. In
pratica, per un URL di corrispondenza dei cookie specificato come https://ad.network.com/pixel,
l'URL di reindirizzamento per il tag di corrispondenza precedente potrebbe avere il seguente aspetto:
https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
L'ID utente Google trasmesso tramite il parametro google_gid è
una stringa con codifica Base64
sicura per il web e senza padding. Per gli offerenti che scelgono di ospitare una tabella di corrispondenza, è consigliabile memorizzare la stringa esatta restituita dal servizio di corrispondenza dei cookie. Nelle successive
richieste di offerta, questo corrisponderà ai valori specificati tramite
BidRequest.user.id.
La versione specificata in google_cver indica il numero di versione numerico
per l'ID utente Google. L'ID utente Google per un determinato utente
cambierà di rado, dopodiché verrà incrementato.
Se Google rileva un errore durante l'elaborazione della richiesta di corrispondenza, verrà specificato un parametro google_error.
Passaggio 3: il processo di reindirizzamento del bidder e la risposta con il pixel
L'offerente riceve un reindirizzamento al proprio URL di corrispondenza dei cookie, inclusi i parametri specificati nel primo passaggio e quelli forniti da Google nel secondo passaggio. Inoltre, riceveranno anche il cookie nelle intestazioni HTTP. Se l'operazione è andata a buon fine, un offerente che ospita la propria tabella di corrispondenza potrebbe abbinare il proprio cookie all'ID utente Google incluso nella risposta. È consigliabile che gli offerenti memorizzino la stringa esatta restituita dal servizio di corrispondenza dei cookie.
Se l'operazione non è andata a buon fine, l'offerente riceverà un
parametro google_error nel reindirizzamento. Si tratta di un valore numerico
corrispondente a diversi stati di errore che identificano l'errore specifico
che si è verificato. Puoi scoprire di più sui possibili valori di errore nella
descrizione del
parametro URL google_error. Se ricevi un errore, puoi
tentare di trovare una corrispondenza per l'utente inserendo un nuovo tag di corrispondenza.
Lo strumento di offerta deve sempre rispondere pubblicando un'immagine pixel invisibile 1 x 1 oppure restituendo una risposta HTTP 204 Nessun contenuto.
Diagramma del flusso di lavoro della corrispondenza dei cookie
Questo flusso di lavoro è illustrato nel seguente diagramma, in cui le richieste e le risposte sono rappresentate da una freccia e gli elementi di dati che le accompagnano sono elencati tra parentesi.
Parametri URL del tag di corrispondenza
| Parametro | Descrizione |
|---|---|
google_nid |
ID rete (NID) per l'account offerente. Questo ID può essere recuperato tramite la risorsa Offerenti. |
google_cm |
Indica al servizio di corrispondenza dei cookie di Google che deve eseguire la corrispondenza dei cookie. Il valore del parametro viene ignorato e può essere omesso. |
google_sc |
Questo parametro è stato ritirato. Imposta il cookie di Google per l'utente se non è presente. Il valore del parametro viene ignorato e può essere omesso. L'omissione del parametro genera un errore se non esiste alcun cookie. |
google_no_sc |
Questo parametro è stato ritirato. Indica al servizio di corrispondenza dei cookie di Google che non deve impostare un cookie per l'utente se non è presente. Il valore del parametro viene ignorato e può essere omesso. |
google_hm |
Dati che l'offerente vuole archiviare in una tabella di corrispondenza ospitata da Google. Il valore è una stringa sicura per il web codificata in base64 (il padding è facoltativo). I
dati non elaborati devono avere una dimensione massima di 40 byte. Ad esempio,
|
google_redir |
Una stringa codificata come URL che un offerente può specificare se vuole indirizzare
Google a inviare il reindirizzamento HTTP 302 all'URL codificato per
questo tag di corrispondenza. In questo modo, Google viene posizionato all'inizio di una chiamata concatenata
ai partner. Se specificato senza google_hm o con google_cm, verrà generato un errore. |
google_ula |
Una stringa utilizzata per aggiungere l'utente a un elenco utenti esistente. Il formato previsto
per il valore è userlistid[,timestamp]:
Questo parametro URL può essere ripetuto per aggiungere l'utente a più elenchi. |
gdpr |
Indica che la richiesta è soggetta alle limitazioni del GDPR sull'utilizzo dei dati. Per maggiori dettagli, consulta
Requisiti per il consenso degli utenti dell'UE o Impatto sull'idoneità
della corrispondenza dei cookie nella
documentazione relativa alla versione 2.0 del TCF di IAB per Authorized Buyers.
Esempio: |
gdpr_consent |
Una stringa TC che rappresenta il consenso dell'utente finale. Per maggiori dettagli, consulta Requisiti per il consenso degli utenti dell'UE o Come verrà trasmessa la stringa TC? nella documentazione relativa alla versione 2.0 del TCF di IAB di Authorized Buyers. |
process_consent |
Indica che l'offerente ha ottenuto il consenso dell'utente finale per gli utilizzi dei dati specificati nelle
Norme relative al consenso degli utenti dell'UE di Google.
Se la richiesta non è soggetta alle Norme relative al consenso degli utenti dell'UE o se
sono disponibili altri parametri di consenso nella richiesta
( Esempio: |
Oltre ai parametri precedenti, gli offerenti possono specificare i propri, che
verranno aggiunti come parametri all'URL di reindirizzamento. Tieni presente che i parametri definiti dall'offerente con il prefisso google_ verranno ignorati perché sono riservati a Google per lo sviluppo futuro e l'ordine dei parametri non è garantito. Un tag di corrispondenza che include parametri
definiti dall'offerente potrebbe avere questo aspetto:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />
Parametri URL di reindirizzamento
L'URL di reindirizzamento viene creato a partire dall'URL di corrispondenza dei cookie di base configurato per
l'account di un offerente, inclusi google_ e i parametri definiti dall'offerente
a seconda di quelli specificati nel tag di corrispondenza. Sono definiti i seguenti parametri di risposta google_:
| Parametro | Descrizione |
|---|---|
google_gid |
ID utente Google. Imposta se google_cm è specificato nella richiesta e la richiesta è stata eseguita correttamente. |
google_cver |
Versione del cookie. Imposta se google_cm è specificato nella richiesta e la richiesta è stata eseguita correttamente. |
google_error |
Un valore intero che indica l'errore complessivo della richiesta. Quando
ricevuto, indica che non sono state eseguite operazioni e non verranno impostati altri
parametri di risposta
|
google_hm |
Viene visualizzato solo se il tentativo di scrittura nella tabella delle corrispondenze ospitata da Google non va a buon fine. In questo caso, il valore è uno dei seguenti codici di stato:
|
google_ula |
Stato dell'operazione di aggiunta dell'elenco utenti, ripetuto se nella richiesta sono stati specificati più Esempio: L'operazione
|
Scenari di esempio del flusso di lavoro di corrispondenza dei cookie
Gli scenari seguenti descrivono come potrebbe apparire la corrispondenza dei cookie per un utente tipico che naviga in una pagina web.
Scenario 1: l'utente cancella i cookie e naviga su un sito
Jane svuota la cache di tutti i cookie. Poi visita la home page di ExampleNews.com.
Riportiamo di seguito le varie fasi:
- ExampleNews.com esegue il rendering e chiama gli annunci di Google (Ad Manager).
- Poiché l'unità pubblicitaria è idonea per l'allocazione dinamica, Google invia richieste di offerta a FinestDSP e ad altri offerenti tramite il servizio di offerte in tempo reale.
- L'applicazione dell'offerente di FinestDSP riceve ed elabora la richiesta di offerta e invia la risposta all'offerta.
- Google riceve le risposte alle offerte dagli offerenti, inclusa la risposta di FinestDSP che specifica un annuncio con un tag di corrispondenza (pixel).
- FinestDSP vince l'asta. Google pubblica l'annuncio e il tag di corrispondenza di FinestDSP per Jane.
- Il tag di corrispondenza chiama il servizio di corrispondenza dei cookie di Google, specificando i parametri
google_nidegoogle_cm. - Il servizio di corrispondenza dei cookie legge il cookie di Google di Jane e invia al browser di Jane un reindirizzamento all'URL di corrispondenza dei cookie di FinestDSP con i parametri
google_gidegoogle_cverimpostati. - Il browser di Jane carica il reindirizzamento all'URL di corrispondenza dei cookie di FinestDSP.
- L'endpoint di corrispondenza dei cookie di FinestDSP elabora la richiesta di reindirizzamento,
che include i parametri URL impostati da Google e il cookie per Jane nelle
intestazioni HTTP. FinestDSP ora può memorizzare la mappatura del proprio cookie nel
google_gidnella tabella delle corrispondenze. - FinestDSP risponde al reindirizzamento con un pixel invisibile 1 x 1.
Scenario 2: utente con mappatura esistente
Una settimana dopo lo scenario 1, Jane visita di nuovo ExampleNews.com. Ora che Jane ha sia i cookie dell'offerente sia quelli di Ad Manager sul suo computer, ecco come funziona la corrispondenza.
- La pagina web viene visualizzata, il che induce Google (Ad Manager) a richiedere annunci che verranno visualizzati sulla pagina.
- Durante l'asta dell'annuncio, Google invia una richiesta di offerta agli offerenti applicabili, incluso FinestDSP.
- FinestDSP riceve la richiesta di offerta, inclusi indicatori come
google_gid. - FinestDSP cerca
google_gidnella tabella delle corrispondenze e trova il cookie associato a Jane creato una settimana prima (Scenario 1). - In base alle informazioni associate al cookie, la logica di offerta di FinestDSP fa un'offerta per l'impressione e vince l'asta.
- Jane potrebbe visualizzare un annuncio personalizzato in base ai suoi interessi, in base alle informazioni in possesso di FinestDSP.
Avviata dall'offerente: corrispondenza dei cookie unidirezionale
La corrispondenza dei cookie unidirezionale è simile al flusso di lavoro bidirezionale,
tranne per il fatto che viene modificata in modo che solo Google ospiti e compili una tabella di corrispondenza. Può essere utilizzato nei casi in cui all'offerente non è consentito ospitare
gli ID utente Google nella propria tabella di corrispondenza. Per utilizzare questo flusso, gli offerenti
devono consentire a Google di ospitare la tabella delle corrispondenze, non possono più specificare
google_cm nelle richieste al servizio di corrispondenza dei cookie di Google e
di conseguenza non riceveranno google_gid per compilare la propria
tabella delle corrispondenze. Una volta che Google ha stabilito una corrispondenza per un utente, gli offerenti possono aggiungerlo agli elenchi di utenti utilizzando i propri dati dei cookie. Analogamente, le richieste di offerta per
questi utenti escluderanno l'ID utente Google, ma includeranno i dati di corrispondenza ospitati. Un
esempio del flusso di lavoro rivisto è riassunto nei seguenti passaggi.
Passaggio 1: inserisci il tag di corrispondenza indirizzato all'URL di corrispondenza dei cookie dell'offerente
Per avviare questo flusso, un inserzionista deve inserire un tag di corrispondenza in modo che
venga visualizzato nel browser dell'utente. A differenza del flusso di lavoro per gli utenti che non provengono da uno stato degli Stati Uniti con limitazioni della privacy,
il tag di corrispondenza deve indirizzare il browser dell'utente all'URL
di corrispondenza dei cookie. Ad esempio, con un URL di corrispondenza dei cookie configurato come
https://ad.network.com/pixel, l'URL apparirà così:
<img src="https://ad.network.com/pixel" />
Quando viene caricato nel browser dell'utente, richiede un pixel dall'URL di corrispondenza dei cookie dell'offerente. Questa richiesta conterrà il cookie nell'intestazione HTTP, che deve essere estratto per il passaggio successivo.
Passaggio 2: reindirizza al servizio di corrispondenza dei cookie di Google
L'endpoint di corrispondenza dei cookie dell'offerente deve reindirizzare al servizio di corrispondenza dei cookie di Google, incluso il parametro google_hm compilato con i dati dei cookie con codifica Base64 sicura per il web. L'URL di reindirizzamento potrebbe avere il seguente aspetto:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA
Passaggio 3: il browser dell'utente viene reindirizzato al servizio di corrispondenza dei cookie di Google
Google riceverà un reindirizzamento contenente i parametri specificati, oltre al cookie di Google nelle intestazioni HTTP.
Passaggio 4: Google pubblica il pixel in caso di reindirizzamento riuscito o di errore se è stato specificato l'URL del report
Se l'operazione di corrispondenza dei cookie va a buon fine o se non è stato specificato alcun URL report sulla corrispondenza dei cookie per l'account dell'offerente, Google pubblicherà un pixel trasparente 1x1 per impostazione predefinita e il flusso di lavoro terminerà qui.
Le impressioni per questo utente nelle successive richieste di offerta includeranno i dati di corrispondenza ospitati dell'inserzionista in BidRequest.user.buyeruid. Gli offerenti possono anche
compilare gli elenchi di utenti utilizzando i dati di corrispondenza ospitati che hanno specificato.
In caso contrario, se si è verificato un errore, Google invierà un reindirizzamento all'URL del report sulla corrispondenza dei cookie dell'offerente con la causa dell'errore specificata nel parametro google_error. Se l'URL segnalazione corrispondenza dei cookie dell'offerente
fosse https://ad.network.com/report, l'URL di reindirizzamento sarebbe
il seguente:
<img src="https://ad.network.com/report?google_error=ERROR_ID" />
Passaggio 5: il browser dell'utente reindirizza all'URL del report sulla corrispondenza dei cookie dell'offerente
Il browser dell'utente verrà reindirizzato all'URL del report sulla corrispondenza dei cookie dell'offerente,
incluso il motivo dell'errore (se presente) specificato da Google nel
parametro google_error. Per scoprire di più sull'interpretazione del codice di errore, consulta la descrizione del parametro.
Passaggio 6: l'offerente pubblica un pixel trasparente 1x1
L'offerente deve rispondere pubblicando un pixel trasparente 1 x 1 nel browser dell'utente.
Diagramma del flusso di lavoro di corrispondenza dei cookie per gli utenti degli stati degli Stati Uniti con limitazioni della privacy
Il flusso di lavoro predefinito per gli utenti negli stati degli Stati Uniti con limitazioni della privacy è illustrato dal seguente diagramma, in cui richieste e risposte sono rappresentate da una freccia e gli elementi di dati che le accompagnano sono elencati tra parentesi.
Parametri URL per il reindirizzamento dell'offerente al servizio di corrispondenza dei cookie di Google
| Parametro | Descrizione |
|---|---|
google_nid |
ID rete (NID) per l'account offerente. Questo ID può essere recuperato tramite la risorsa Offerenti. |
google_sc |
Questo parametro è stato ritirato. Imposta il cookie di Google per l'utente se non è presente. Il valore del parametro viene ignorato e può essere omesso. L'omissione del parametro genera un errore se non esiste alcun cookie. |
google_no_sc |
Questo parametro è stato ritirato. Indica al servizio di corrispondenza dei cookie di Google che non deve impostare un cookie per l'utente se non è presente. Il valore del parametro viene ignorato e può essere omesso. |
google_hm |
Contiene i dati che l'offerente vuole archiviare in una tabella di corrispondenza ospitata da Google. |
google_redir |
Un URL codificato a cui vuoi che Google invii un reindirizzamento HTTP 302. L'URL
specificato riceverà reindirizzamenti con il parametro google_error
sia per gli errori che per le operazioni riuscite. |
google_ula |
Una stringa utilizzata per aggiungere l'utente a un elenco utenti esistente. Il formato previsto
per il valore è userlistid[,timestamp]:
Questo parametro URL può essere ripetuto per aggiungere l'utente a più elenchi. |
gdpr |
Indica che la richiesta è soggetta alle limitazioni del GDPR sull'utilizzo dei dati. Per maggiori dettagli, consulta
Requisiti per il consenso degli utenti dell'UE o Impatto sull'idoneità
della corrispondenza dei cookie nella
documentazione relativa alla versione 2.0 del TCF di IAB per Authorized Buyers.
Esempio: |
gdpr_consent |
Una stringa TC che rappresenta il consenso dell'utente finale. Per maggiori dettagli, consulta Requisiti per il consenso degli utenti dell'UE o Come verrà trasmessa la stringa TC? nella documentazione relativa alla versione 2.0 del TCF di IAB di Authorized Buyers. |
process_consent |
Indica che l'offerente ha ottenuto il consenso dell'utente finale per gli utilizzi dei dati specificati nelle
Norme relative al consenso degli utenti dell'UE di Google.
Se la richiesta non è soggetta alle Norme relative al consenso degli utenti dell'UE o se
sono disponibili altri parametri di consenso nella richiesta
( Esempio: |
Parametri URL per il reindirizzamento di Google all'URL del report sulla corrispondenza dei cookie dell'offerente
| Parametro | Descrizione |
|---|---|
google_error |
Un valore intero che indica l'errore complessivo della richiesta. Quando
ricevuto, indica che non sono state eseguite operazioni e non verranno impostati altri
parametri di risposta
|
Avviato da Google: corrispondenza dei pixel bidirezionale
La corrispondenza dei pixel bidirezionale è un flusso di lavoro per il servizio di corrispondenza dei cookie di Google in cui Google tenta di abbinare un ID utente Google a un offerente selezionato in modo algoritmico diverso dal vincitore dell'asta di offerte in tempo reale. Quando viene pubblicato un annuncio, Google inserisce un tag di corrispondenza che indirizza il browser dell'utente al caricamento di un pixel trasparente dall'URL di corrispondenza dei cookie dell'offerente scelto. In questo modo, sia Google che l'offerente potranno compilare una tabella delle corrispondenze con un determinato utente. Di seguito è riportato un esempio di questo flusso di lavoro.
Passaggio 1: Google inserisce un tag di corrispondenza
Quando la pagina di un editore partecipante viene caricata nel browser dell'utente e uno
spazio pubblicitario in quella pagina viene riempito da Google, potrebbe essere inserito un tag di corrispondenza che
richiede un pixel a un offerente selezionato in modo algoritmico. Il tag di corrispondenza dei pixel
inserito da Google combina l'URL di corrispondenza dei cookie dell'offerente con
parametri aggiuntivi che
l'offerente può utilizzare per compilare la tabella delle corrispondenze. Per un URL di corrispondenza dei cookie
specificato come https://ad.network.com/pixel, la struttura è la
seguente:
<img src="https://ad.network.com/pixel?google_gid=GOOGLE_GID&google_cver=1&google_push=PUSH_DATA" />
Passaggio 2: l'offerente deve rispondere con il reindirizzamento all'URL del servizio di corrispondenza dei cookie di Google
Gli offerenti che ricevono richieste di corrispondenza dei pixel devono rispondere con un reindirizzamento al servizio di corrispondenza dei cookie di Google strutturato nel seguente modo:
https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA
Tieni presente che l'URL di reindirizzamento precedente è simile a quello utilizzato nel
tag di corrispondenza per il workflow di corrispondenza dei cookie avviato dall'offerente.
Nella corrispondenza dei pixel, il parametro google_cm viene sostituito dal parametro google_push e il suo valore deve essere uguale al valore fornito da Google nella richiesta. Analogamente al flusso di lavoro avviato dall'offerente, è possibile specificare parametri aggiuntivi per soddisfare casi d'uso aggiuntivi.
Passaggio 3: Google elabora il reindirizzamento e risponde con il pixel
Google registra la creazione di una corrispondenza per l'utente e gestisce eventuali operazioni aggiuntive richieste tramite i parametri di query. Infine, Google risponde con un pixel trasparente 1x1.
Diagramma del flusso di lavoro della corrispondenza dei pixel
Questo flusso di lavoro è illustrato nel seguente diagramma, in cui le richieste e le risposte sono rappresentate da una freccia e gli elementi di dati che le accompagnano sono elencati tra parentesi.
Parametri della richiesta di tag di corrispondenza Google
| Parametro | Descrizione |
|---|---|
google_gid |
ID utente Google. Per gli utenti che non provengono da uno stato degli Stati Uniti con limitazioni della privacy, questo valore sarà sempre specificato nel tag di corrispondenza di Google. |
google_cver |
La versione del cookie. Questo valore sarà sempre specificato nel tag di corrispondenza di Google. |
google_push |
Indica che questa richiesta sta avviando il flusso di lavoro di corrispondenza dei pixel. Il valore deve essere restituito tramite il parametro corrispondente nella risposta di reindirizzamento dell'offerente. |
gdpr_consent |
Una stringa TC che rappresenta il consenso dell'utente finale. Per maggiori dettagli, consulta [Requisiti per il consenso degli utenti dell'UE](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements), o **Come verrà trasmessa la stringa TC?** nella [documentazione di Authorized Buyers IAB TCF v2.0](//support.google.com/authorizedbuyers/answer/9789378). |
Parametri di reindirizzamento della corrispondenza dei pixel dell'offerente
| Parametro | Descrizione |
|---|---|
google_nid |
ID rete (NID) per l'account offerente. Questo ID può essere recuperato tramite la risorsa Offerenti. |
google_push |
Indica che questo reindirizzamento sta completando il flusso di lavoro di corrispondenza dei pixel. Il valore del tag di corrispondenza Google corrispondente deve essere specificato qui. |
google_hm |
Contiene i dati che l'offerente vuole archiviare in una tabella di corrispondenza ospitata da Google. |
google_ula |
Una stringa utilizzata per aggiungere l'utente a un elenco utenti esistente. Il formato previsto
per il valore è userlistid[,timestamp]:
Questo parametro URL può essere ripetuto per aggiungere l'utente a più elenchi. |
gdpr_consent |
Una stringa TC che rappresenta il consenso dell'utente finale. Per maggiori dettagli, consulta [Requisiti per il consenso degli utenti dell'UE](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) o **Come verrà trasmessa la stringa TC?** nella [documentazione di Authorized Buyers relativa al TCF v2.0 di IAB](//support.google.com/authorizedbuyers/answer/9789378). |
Avviato da Google: corrispondenza dei pixel unidirezionale
La corrispondenza dei pixel unidirezionale differisce dal flusso di lavoro bidirezionale in quanto il tag di corrispondenza di Google non include un parametro che specifica l'ID utente Google, ma continuerà a compilare una tabella delle corrispondenze ospitata da Google. Può essere utilizzato nei casi in cui lo strumento di offerta non è autorizzato a ospitare ID utente Google nella propria tabella delle corrispondenze. Un esempio del flusso di lavoro rivisto è riassunto nei passaggi seguenti.
Passaggio 1: Google inserisce un tag di corrispondenza
Google inserisce un tag di corrispondenza per un offerente selezionato in modo algoritmico. Il tag di corrispondenza include il parametro google_push. Ecco un esempio:
<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />
Passaggio 2: il browser dell'utente richiede il pixel dall'URL di corrispondenza dei cookie dell'offerente
Il browser dell'utente richiede un pixel dall'URL di corrispondenza dei cookie dell'offerente, incluso il cookie dell'offerente nelle intestazioni HTTP.
Passaggio 3: reindirizza al servizio di corrispondenza dei cookie di Google
L'endpoint di corrispondenza dei cookie dell'offerente deve reindirizzare al servizio di corrispondenza dei cookie di Google, incluso il parametro google_hm compilato con i dati dei cookie con codifica Base64 sicura per il web. L'URL di reindirizzamento potrebbe avere il seguente aspetto:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA&google_push=PUSH_DATA
Passaggio 4: il browser dell'utente viene reindirizzato al servizio di corrispondenza dei cookie di Google
Google riceverà un reindirizzamento contenente i parametri specificati, oltre al cookie di Google nelle intestazioni HTTP. Se l'operazione è andata a buon fine, le impressioni per questo utente nelle successive richieste di offerta includeranno i dati di corrispondenza ospitati dell'offerente in BidRequest.user.buyeruid.
Gli offerenti possono anche compilare gli elenchi di utenti utilizzando i dati di corrispondenza ospitati che hanno specificato.
Infine, Google restituisce un pixel trasparente 1x1 al browser dell'utente.
Assistente per la corrispondenza dei cookie
Open Bidding consente alle piattaforme di utilizzare flussi di lavoro di corrispondenza dei cookie avviati dall'offerente e avviati da Google per associare un ID utente Google al relativo cookie. Cookie Match Assist (CMA) è una funzionalità aggiuntiva per gli exchange che consente loro di creare tabelle di corrispondenza con i propri offerenti.
Come funziona Cookie Match Assist
Quando posiziona un annuncio, l'algoritmo di Google seleziona un exchange partecipante e inserisce un tag Assistenza corrispondenza cookie con la seguente struttura:
<img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
Il tag di corrispondenza CMA di Google fa sì che l'URL di corrispondenza dei cookie dell'exchange riceva una richiesta di pixel.
- L'endpoint di cookie matching dell'exchange riceve la richiesta, in cui il proprio servizio di cookie matching è responsabile dell'abbinamento dell'ID utente a uno dei suoi offerenti. Nel seguente diagramma, il servizio di cookie matching dell'exchange risponde al browser dell'utente con un reindirizzamento a uno degli endpoint dei suoi offerenti.
- L'offerente riceve la richiesta, insieme a tutti i parametri specificati dalla piattaforma di scambio per abbinare l'ID utente al suo cookie.
Restrizioni
Limitare la frequenza delle richieste di nuove corrispondenze
Gli offerenti sono responsabili della limitazione del numero di chiamate al servizio con corrispondenza dei cookie per gli utenti che hanno una nuova voce nella tabella di corrispondenza ospitata da Google. Una voce nella tabella delle corrispondenze ospitata può essere considerata scaduta dopo 14 giorni, dopodiché può essere aggiornata.
Rispondere a tutte le richieste di corrispondenza dei pixel
Gli offerenti che utilizzano il flusso di lavoro di corrispondenza dei pixel devono rispondere a tutte le richieste di corrispondenza dei pixel in entrata con una risposta che includa il parametro google_push. Ciò consente a Google di applicare i criteri monitorando l'utilizzo. Se il tasso di risposta di un
offerente è inferiore al 90%, Google limiterà il numero di
richieste di corrispondenza pixel inviate al suo account.
Utilizzare endpoint HTTPS
È necessario che gli endpoint utilizzati in tutti i flussi di lavoro di Corrispondenza dei cookie utilizzino HTTPS.
Quando rispondi a una richiesta di corrispondenza dei pixel inviata tramite HTTPS, devi reindirizzare al servizio di corrispondenza dei cookie tramite HTTPS. Allo stesso modo, anche un endpoint di assistenza per la corrispondenza dei cookie che reindirizza gli offerenti deve utilizzare HTTPS. Se invii richieste a Google tramite HTTP più di una volta ogni 2 minuti, il numero di richieste di corrispondenza inviate al tuo account verrà limitato.
Requisiti per il consenso degli utenti dell'UE
Le richieste di corrispondenza dei cookie soggette alle Norme relative al consenso degli utenti dell'UE di Google devono indicare il consenso degli utenti finali. Queste richieste devono indicare che il consenso è stato raccolto utilizzando uno dei seguenti metodi:
- TCFv2: include i parametri
gdpregdpr_consent. Per i dettagli, consulta la documentazione sulla versione 2.0 del TCF di IAB di Authorized Buyers. process_consent: una dichiarazione in cui viene attestato che l'offerente ha ottenuto il consenso necessario dell'utente.
Esempi
Gli esempi riportati di seguito illustrano come utilizzare il servizio di corrispondenza dei cookie per raggiungere obiettivi specifici. Tieni presente che, se non diversamente specificato, si presume che l'utente su cui viene eseguita l'azione non provenga da uno stato degli Stati Uniti con limitazioni della privacy.
Compilare una tabella delle corrispondenze ospitata dall'offerente
Un offerente può utilizzare il flusso di lavoro di corrispondenza dei cookie per compilare la propria tabella delle corrispondenze fornendo solo i parametri google_nid e google_cm nel tag di corrispondenza. Potrebbe avere questo aspetto:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_cm" />
Se l'URL di corrispondenza dei cookie dell'offerente è impostato su https://ad.network.com/pixel?id=1,
e l'operazione di corrispondenza dei cookie va a buon fine, il reindirizzamento inviato da Google
in risposta al tag di corrispondenza dell'offerente potrebbe avere il seguente aspetto:
https://ad.network.com/pixel?id=1&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
Se l'operazione di corrispondenza dei cookie non va a buon fine perché l'utente non ha un cookie Google, la risposta sarà:
https://ad.network.com/pixel?id=1&google_error=3
Il codice di errore dipende dalla causa sottostante dell'errore. Per scoprire di più sui possibili codici di errore per il flusso di lavoro Corrispondenza dei cookie, consulta i parametri URL di reindirizzamento.
Aggiungi a un elenco di singoli utenti
Il parametro google_ula può essere specificato in un tag di corrispondenza
di un offerente per aggiungere l'utente a un elenco utenti con l'ID specificato. Se la tabella di corrispondenza ospitata da Google o dall'offerente contiene una nuova voce per l'utente, l'offerente può inserire un tag di corrispondenza che includa i parametri google_nid e google_ula per aggiungere l'utente all'elenco specificato senza avviare il flusso di lavoro completo di cookie matching. Per ulteriori dettagli, consulta le limitazioni
relative all'invocazione del servizio di corrispondenza dei cookie. Il tag
corrispondenza potrebbe avere il seguente aspetto:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />
Per una risposta corretta, in cui l'URL di corrispondenza dei cookie dell'offerente è
https://ad.network.com/pixel, l'URL di reindirizzamento di Google sarebbe:
https://ad.network.com/pixel?google_ula=12345,0
Se si verifica un errore generale, ad esempio non è presente alcun cookie Google
per l'utente, l'URL di reindirizzamento includerà il
parametro google_error:
https://ad.network.com/pixel?google_error=3
Se si verifica un errore specifico relativo all'aggiunta dell'utente all'elenco,
riceverai google_ula nel reindirizzamento. A differenza del parametro
del tag di corrispondenza corrispondente, questo sostituisce il timestamp con un codice di stato
per indicare l'esito positivo dell'operazione. Ad esempio, se la richiesta non è andata a buon fine
perché l'account offerente non aveva accesso all'elenco utenti specificato, l'URL di reindirizzamento sarebbe:
https://ad.network.com/pixel?google_ula=12345,2
Aggiungere a più elenchi di utenti
Gli offerenti possono specificare che un utente deve essere aggiunto a più elenchi di utenti includendo più parametri google_ula nel tag di corrispondenza. In
pratica, potrebbe avere il seguente aspetto:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />
Lo stato dell'operazione per ogni elenco utenti viene segnalato in modo simile tramite
parametri google_ula distinti nel reindirizzamento:
https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0
Nel reindirizzamento precedente, possiamo vedere che l'operazione è riuscita per l'elenco utenti con ID 45678, ma non per l'elenco utenti con ID 12345 perché l'offerente non aveva l'autorizzazione per accedervi.
Esegui il flusso di lavoro di cookie matching e aggiungi l'utente all'elenco utenti
Per eseguire il cookie matching e aggiungere l'utente a un elenco di utenti in un'unica
richiesta, il tag di corrispondenza di un offerente deve includere google_cm e
google_ula:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345&google_cm" />
L'URL di reindirizzamento specificato da Google includerebbe google_gid,
google_cver e google_ula. Potrebbe avere il seguente aspetto:
https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0
Memorizzare una corrispondenza in una tabella delle corrispondenze ospitata da Google
Se un offerente vuole memorizzare i dati dei cookie in una tabella delle corrispondenze ospitata da Google e non intende memorizzare la corrispondenza con l'ID utente Google nella propria tabella delle corrispondenze, il tag di corrispondenza deve includere il parametro google_hm, il cui valore deve essere una stringa con codifica Base64 sicura per il web. Per un utente in cui i dati dei cookie non codificati dell'offerente sono Cookie number 1!, il valore codificato sarebbe Q29va2llIG51bWJlciAxIQ==, che verrebbe utilizzato in un tag di corrispondenza come il seguente:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />
Per una risposta corretta, in cui l'URL di corrispondenza dei cookie dell'offerente è
https://cookie-monster.com/pixel, l'URL di reindirizzamento di Google
sarebbe:
https://cookie-monster.com/pixel
Il parametro google_gid non è presente nel reindirizzamento perché il
tag di corrispondenza non includeva google_cm e google_hm non è
incluso nelle risposte riuscite. Nelle future richieste di offerta per le impressioni
per questo utente, l'offerente riceverà i dati di corrispondenza ospitati in
BidRequest.user.buyeruid.
Se l'offerente ha utilizzato un tag di corrispondenza in cui il valore di
google_hm non era codificato in base64, ad esempio
chocolate_chunk!, l'URL di reindirizzamento potrebbe avere il seguente aspetto:
https://cookie-monster.com/pixel?google_hm=2
L'URL di reindirizzamento precedente include un valore google_hm di
2, il che suggerisce che l'operazione non è riuscita perché il valore non è stato
decodificato.
Tabelle di corrispondenza ospitate da offerenti e Google con elenchi di utenti
Se un offerente ospita il proprio elenco di utilizzo oltre a un elenco di utenti ospitato da Google e vuole che un singolo tag di corrispondenza corrisponda a entrambe le tabelle e aggiunga l'utente a un determinato elenco di utenti, il tag di corrispondenza deve includere i parametri google_cm, google_hm e google_ula. Se i dati dei cookie dell'offerente sono Cookie number 1!, il valore codificato sarebbe Q29va2llIG51bWJlciAxIQ==, che genererebbe un tag di corrispondenza come il seguente:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />
Per una risposta corretta, in cui l'URL di corrispondenza dei cookie dell'offerente è
https://cookie-monster.com/pixel, l'URL di reindirizzamento di Google
avrebbe il seguente aspetto:
https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0
Una volta ricevuto il reindirizzamento, l'offerente può abbinare l'ID utente Google specificato
in google_gid ai dati dei cookie nella tabella delle corrispondenze. Inoltre, possono determinare che le operazioni sulla tabella delle corrispondenze ospitata da Google e sull'elenco degli utenti sono andate a buon fine. Di conseguenza, qualsiasi pretargeting configurato dall'offerente per il targeting dell'ID elenco utenti specificato ora farà sì che l'offerente riceva richieste di offerta per le impressioni dell'utente. Allo stesso modo, in queste richieste di offerta, l'offerente riceverà i dati di corrispondenza ospitati in BidRequest.user.buyeruid.