Corrispondenza dei cookie

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.buyeruid come 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:

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

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_:

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:

1. ExampleNews.com esegue il rendering e chiama gli annunci di Google (Ad Manager).
2. 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.
3. L'applicazione dell'offerente di FinestDSP riceve ed elabora la richiesta di offerta e invia la risposta all'offerta.
4. Google riceve le risposte alle offerte dagli offerenti, inclusa la risposta di FinestDSP che specifica un annuncio con un tag di corrispondenza (pixel).
5. FinestDSP vince l'asta. Google pubblica l'annuncio e il tag di corrispondenza di FinestDSP per Jane.
6. Il tag di corrispondenza chiama il servizio di corrispondenza dei cookie di Google, specificando i parametri google_nid e google_cm.
7. 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_gid e google_cver impostati.
8. Il browser di Jane carica il reindirizzamento all'URL di corrispondenza dei cookie di FinestDSP.
9. 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_gid nella tabella delle corrispondenze.
10. 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.

1. La pagina web viene visualizzata, il che induce Google (Ad Manager) a richiedere annunci che verranno visualizzati sulla pagina.
2. Durante l'asta dell'annuncio, Google invia una richiesta di offerta agli offerenti applicabili, incluso FinestDSP.
3. FinestDSP riceve la richiesta di offerta, inclusi indicatori come google_gid.
4. FinestDSP cerca google_gid nella tabella delle corrispondenze e trova il cookie associato a Jane creato una settimana prima (Scenario 1).
5. In base alle informazioni associate al cookie, la logica di offerta di FinestDSP fa un'offerta per l'impressione e vince l'asta.
6. 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

Parametri URL per il reindirizzamento di Google all'URL del report sulla corrispondenza dei cookie dell'offerente