Corrispondenza dei cookie

La corrispondenza dei cookie è una funzionalità che ti consente di associare il tuo cookie, ad esempio un ID per un utente che ha visitato il tuo sito web, a un ID utente Google di un offerente specifico corrispondente, nonché di creare elenchi di utenti che ti aiutino a fare scelte più efficaci in merito alle offerte. Questa guida descrive i concetti utilizzati nella corrispondenza dei cookie, nonché i diversi flussi di lavoro di corrispondenza dei cookie e le eventuali variazioni che possono avere per determinati casi d'uso.

Concetti

Che cos'è la corrispondenza dei cookie?

I proprietari di domini in genere impostano i contenuti dei cookie per gli utenti che visitano il loro sito, che vengono utilizzati per identificare gli utenti all'interno di quel dominio. Anche se due proprietari di dominio accettano di scambiare questi dati, il modello di sicurezza dei browser internet impedisce a uno dei due proprietari di leggere i cookie impostati da un altro dominio.

Nel contesto della pubblicità digitale, Google identifica gli utenti con cookie che appartengono al dominio doubleclick.net e gli offerenti che partecipano all'asta in tempo reale possono avere un proprio dominio in cui identificano un insieme di utenti a cui mostrare gli annunci. La corrispondenza dei cookie consente all'offerente di associare i propri cookie a quelli di Google, in modo da poter determinare se un'impressione inviata in una richiesta di offerta è associata a uno degli utenti scelti come target. L'offerente riceverà i dati dei propri cookie o un ID utente Google specifico dell'offerente, che è una forma criptata del cookie doubleclick.net nella richiesta di offerta.

Il servizio di corrispondenza dei cookie descritto in questa guida semplifica la creazione e la gestione dell'associazione tra il cookie di un offerente e l'ID utente di Google e consente anche di compilare gli elenchi di utenti.

Tabelle delle corrispondenze

Una tabella delle corrispondenze può essere utilizzata per mappare un ID o altri dati da un dominio a un altro. Gli offerenti possono usare il servizio di corrispondenza dei cookie per compilare le proprie tabelle delle corrispondenze mappando il cookie per un determinato utente all'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 dell'offerente di accedere ai dati dei cookie dell'utente a cui viene mostrata l'impressione.

Tabelle delle corrispondenze ospitate da Google

Per una manutenzione più facile, miglioramenti della latenza e accesso 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 codificata in Base64 sicura per il web, indicata di seguito come dati corrispondenti ospitati, che verrà mappata all'ID utente Google di un determinato utente. Una volta stabilita una corrispondenza, può essere utilizzata nei seguenti modi:

• Real-Time Bidding: nelle richieste di offerta successive per le impressioni associate all'utente, Google ti invierà i dati delle corrispondenze ospitate che hai associato al suo ID utente Google. Nell'implementazione OpenRTB di Google, BidRequest.user.buyeruid lo specificherà come stringa sicura per il web con codifica Base64. Se l'endpoint per le offerte è configurato per utilizzare il protocollo Google RTB deprecato, lo riceverai come byte decodificati tramite il campo BidRequest.hosted_match_data.

• Elenchi di utenti: gli elenchi di utenti possono essere compilati con gli ID utente di Google o con i dati delle corrispondenze ospitate.

• Pretargeting: puoi configurare il pretargeting in modo da ricevere solo richieste di offerta contenenti dati corrispondenti ospitati. Questo può essere utilizzato per eliminare le impressioni meno pertinenti per gli utenti esterni al tuo 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 flussi di lavoro di corrispondenza dei cookie descritti di seguito o tramite il servizio Bulk Uploader.

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 un account di 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 vengono trasmessi nei flussi di lavoro di Corrispondenza dei cookie.
• Tag di corrispondenza: il tag da inserire nel browser di un utente per il flusso di lavoro di corrispondenza dei cookie avviato dall'offerente. Possono essere pubblicati insieme agli annunci o posizionati su proprietà web al di fuori degli annunci.
• (Facoltativo) URL report sulla corrispondenza dei cookie: nel flusso di lavoro della corrispondenza dei cookie unidirezionale, si tratta di un URL facoltativo che può essere fornito per specificare un endpoint che riceverà i dettagli dell'errore nel caso in cui la corrispondenza dei cookie non vada a buon fine tramite un reindirizzamento HTTP 302. Per impostazione predefinita, le risposte verranno inviate a questo URL solo in caso di errore nell'operazione di corrispondenza dei cookie, ma gli offerenti possono richiedere che il reindirizzamento venga sempre inviato.
• URL Cookie Match Assist: per le piattaforme di scambio che implementano il flusso di lavoro di Cookie Match Assist, si tratta dell'URL di base dell'endpoint per rispondere alle richieste in arrivo.
• Quota Cookie Match Assist: per le piattaforme di scambio pubblicitario che implementano il flusso di lavoro Cookie Match Assist, si tratta del numero massimo di richieste che l'URL di corrispondenza dei cookie può ricevere ogni secondo. Lo scopo è evitare che le richieste CMA sovraccarichino di richieste i server dello scambio.

Macro di corrispondenza dei cookie

In uno dei flussi di lavoro della corrispondenza dei cookie supportati, all'URL con corrispondenza dei cookie di un offerente in genere vengono aggiunti parametri in un ordine non garantito. Gli offerenti con integrazioni che richiedono un ordine coerente dei parametri possono inserire macro nell'URL della corrispondenza dei cookie per garantirne il posizionamento.

Macro supportate

Facoltativamente, gli offerenti possono configurare l'URL di corrispondenza dei cookie in modo da includere una o più macro sotto forma di %%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 della corrispondenza dei cookie con un endpoint ospitato su https://user.bidder.com.cookies e la relativa 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 il proprio 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 in un secondo momento Google invia 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 attualmente supporta tre flussi di lavoro per diversi casi d'uso, descritti di seguito.

Iniziata dall'offerente: corrispondenza dei cookie bidirezionale

La corrispondenza dei cookie bidirezionale si riferisce a un flusso di lavoro avviato dall'offerente, che inserisce un tag di corrispondenza nel browser dell'utente per indirizzarlo a Google. Questo flusso di lavoro consente sia a Google sia all'offerente di compilare le tabelle delle corrispondenze. Di seguito è riportato un semplice esempio di questo flusso di lavoro.

Passaggio 1: inserisci il tag di corrispondenza

Per avviare questo flusso, l'offerente deve posizionare il tag di corrispondenza in modo che venga visualizzato nel browser dell'utente. Un tag di corrispondenza semplice che restituisce solo l'ID utente Google all'offerente può essere strutturato come segue:

<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 ulteriori informazioni su questi parametri, consulta Adatta ai parametri URL del tag.

Passaggio 2: Google risponde con un reindirizzamento che include i dati delle corrispondenze

Il tag di corrispondenza fa sì che il Servizio di corrispondenza dei cookie di Google riceva una richiesta dal browser dell'utente, che emette un HTTP 302 reindirizzamento all'URL del Servizio 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 il offerente riceverà anche il proprio cookie incluso negli header 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 semplice mostrato sopra 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 non riempita e sicura per il web. Per gli offerenti che scelgono di ospitare una tabella delle corrispondenze, è consigliabile memorizzare la stringa esatta restituita dal servizio di corrispondenza dei cookie. Nelle richieste di offerta successive, corrisponderà ai valori specificati tramite BidRequest.user.id in OpenRTB o BidRequest.user.id nel protocollo Google RTB ritirato.BidRequest.google_user_id

La versione specificata in google_cver indica il numero di versione numerico per l'ID utente Google. L'ID utente Google di un determinato utente subirà raramente delle modifiche, dopodiché verrà incrementato.

Se Google rileva un errore durante l'elaborazione della richiesta di corrispondenza, verrà specificato un parametro google_error.

Passaggio 3: l'offerente elabora il reindirizzamento e risponde con il pixel

L'offerente riceve un reindirizzamento all'URL di corrispondenza dei cookie, inclusi i parametri specificati nel primo passaggio e quelli forniti da Google nel secondo passaggio. Inoltre, riceveranno il proprio cookie anche negli header HTTP. Se l'operazione è andata a buon fine, un offerente che ospita la propria tabella di corrispondenza potrebbe associare il proprio cookie all'ID utente Google incluso nella risposta. Consigliamo che gli offerenti memorizzino la stringa esatta restituita dal servizio di corrispondenza dei cookie.

Se l'operazione non va a buon fine, l'offerente riceverà un parametro google_error nel reindirizzamento. È un valore numerico corrispondente ai diversi stati di errore che identificano l'errore specifico. Puoi scoprire di più sui possibili valori di errore qui. Se ricevi un messaggio di errore, puoi provare a trovare una corrispondenza per l'utente in questione inserendo un nuovo tag di corrispondenza.

L'offerente deve sempre rispondere pubblicando un'immagine di pixel invisibili 1 x 1 oppure, in alternativa, restituire una risposta HTTP 204 Nessun contenuto.

Diagramma del flusso di lavoro della corrispondenza dei cookie

Questo flusso di lavoro è illustrato dal diagramma seguente, in cui le richieste e le risposte sono rappresentate da una freccia e gli elementi di dati che le accompagnano sono elencati tra parentesi.

Associa i parametri URL del tag

Oltre ai parametri sopra indicati, gli offerenti possono specificare i propri, che verranno aggiunti come parametri all'URL di reindirizzamento. Tieni presente che i parametri definiti dall'offerente e denominati con il prefisso google_ verranno ignorati perché quelli sono riservati da Google per lo sviluppo futuro e la conservazione dell'ordine dei parametri non è garantita. Un tag di corrispondenza che include parametri definiti dall'offerente potrebbe avere il seguente 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 in base a quelli specificati nel tag di corrispondenza. Sono definiti i seguenti parametri di risposta google_:

Scenari di esempio del flusso di lavoro della corrispondenza dei cookie

Gli scenari riportati di seguito descrivono come potrebbe essere la corrispondenza dei cookie per un utente tipico che naviga in una pagina web.

Scenario 1: l'utente cancella i cookie e naviga in 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 di offerta 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 il tag annuncio e di corrispondenza di FinestDSP per Jane.
6. Il tag di corrispondenza chiama Cookie Match Service di Google, specificando i parametri google_nid e google_cm.
7. Il servizio Cookie Match legge il cookie Google di Jane e invia al suo browser 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 relativo cookie per Jane nelle intestazioni HTTP. FinestDSP ora può memorizzare la mappatura del proprio cookie a google_gid nella propria tabella delle corrispondenze.
10. FinestDSP risponde al reindirizzamento con un pixel 1 x 1 invisibile.

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 proprio computer, ecco come funziona la corrispondenza.

1. Viene visualizzata la pagina web, di conseguenza Google (Ad Manager) richiede gli annunci da visualizzare sulla pagina.
2. Durante l'asta di annunci, Google invia una richiesta di offerta agli offerenti applicabili, tra cui 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 (nello 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 vedere un annuncio personalizzato in base ai suoi interessi, in base alle informazioni in possesso di FinestDSP.

Iniziata dall'offerente: corrispondenza dei cookie unidirezionale

La corrispondenza dei cookie unidirezionale è simile al flusso di lavoro bidirezionale, ma è modificata in modo che solo Google ospiti e compili una tabella delle corrispondenze. Questo può essere utilizzato nei casi in cui l'offerente non è autorizzato a ospitare 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. Dopo che Google ha stabilito una corrispondenza per un utente, gli offerenti possono aggiungerlo agli elenchi di utenti utilizzando i propri dati dei cookie. Allo stesso modo, le richieste di offerta per questi utenti escluderanno lo User-ID Google, ma includeranno i dati di corrispondenza ospitati. Un semplice esempio del flusso di lavoro rivisto è riassunto nei passaggi riportati di seguito.

Passaggio 1: inserisci il tag di corrispondenza diretto all'URL con corrispondenza dei cookie dell'offerente

Per avviare questo flusso, un offerente 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 risiedono in uno stato degli Stati Uniti con limitazioni relative alla 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 comehttps://ad.network.com/pixel, avrà il seguente aspetto:

<img src="https://ad.network.com/pixel" />

Al caricamento nel browser dell'utente, richiederà un pixel dall'URL della 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 codificati in base64 sicuri 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 di successo o errore se è specificato l'URL del report

Se l'operazione di corrispondenza dei cookie ha esito positivo o se non è stato specificato alcun URL del report con corrispondenza dei cookie per l'account dell'offerente, Google pubblicherà un pixel trasparente 1 x 1 per impostazione predefinita e il flusso di lavoro terminerà qui. Le impressioni per questo utente nelle richieste di offerta successive includeranno i dati di corrispondenza ospitati dell'offerente in BidRequest.user.buyeruid per OpenRTB o BidRequest.hosted_match_data per il protocollo RTB di Google ritirato. Gli offerenti possono anche completare 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 del report sulla corrispondenza dei cookie dell'offerente era https://ad.network.com/report, l'URL di reindirizzamento sarebbe simile al 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 saperne di più sull'interpretazione del codice di errore, consulta la descrizione del parametro.

Passaggio 6: l'offerente pubblica un pixel trasparente 1 x 1

L'offerente deve rispondere pubblicando un pixel trasparente 1 x 1 nel browser dell'utente.

Diagramma del flusso di lavoro della corrispondenza dei cookie per gli utenti degli Stati Uniti con restrizioni sulla privacy

Il flusso di lavoro predefinito per gli utenti negli stati degli Stati Uniti con limitazioni relative alla privacy è illustrato dal diagramma riportato di seguito, 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 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

Iniziata da Google: corrispondenza bidirezionale dei pixel

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 Real-Time Bidding. Quando viene inserito un annuncio, Google inserisce un tag di corrispondenza che indica al browser dell'utente di caricare un pixel trasparente dall'URL di corrispondenza dei cookie dell'offerente scelto. In questo modo, sia Google sia l'offerente potranno compilare una tabella delle corrispondenze con un determinato utente. Di seguito è riportato un semplice esempio di questo flusso di lavoro.

Passaggio 1: Google inserisce un tag di corrispondenza

Quando la pagina di un publisher partecipante viene caricata nel browser dell'utente e uno spazio annuncio su quella pagina viene completato da Google, può essere inserito un tag di corrispondenza che richiede un pixel da 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 un reindirizzamento all'URL del servizio di corrispondenza dei cookie di Google

Gli offerenti che ricevono richieste di corrispondenza dei pixel sono tenuti a rispondere con un reindirizzamento al Servizio di corrispondenza dei cookie di Google strutturato come segue:

https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA

Tieni presente che l'URL di reindirizzamento riportato sopra è simile a quello utilizzato nel tag match per il Flusso di lavoro di corrispondenza dei cookie avviato dall'offerente. In Pixel Matching, il parametro google_cm viene sostituito dal parametro google_push e il relativo valore deve essere uguale al valore fornito da Google nella richiesta. Anche in questo caso, come per il 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 1 x 1.

Diagramma del flusso di lavoro di Pixel Matching

Questo flusso di lavoro è illustrato dal diagramma seguente, 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 di richiesta del tag di corrispondenza Google

Parametri di reindirizzamento della corrispondenza dei pixel dell'offerente

Avviata da Google: corrispondenza unidirezionale dei pixel

La corrispondenza unidirezionale dei pixel differisce dal flusso di lavoro bidirezionale per il fatto che il tag di corrispondenza di Google non include un parametro che specifica lo User-ID di Google, ma continuerà a completare una tabella delle corrispondenze ospitata da Google. Questo può essere utilizzato nei casi in cui l'offerente non è autorizzato a ospitare gli ID utente di Google nella sua propria tabella di corrispondenza. Un semplice esempio del flusso di lavoro rivisto è riportato nei passaggi riportati di seguito.

Passaggio 1: Google inserisce un tag di corrispondenza

Google inserisce un tag di corrispondenza per un offerente selezionato tramite un algoritmo. 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 di Cooking dell'offerente

Il browser dell'utente richiede un pixel dall'URL di corrispondenza dei cookie dell'offerente, includendo 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 codificati in base64 sicuri 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 richieste di offerta successive includeranno i dati di corrispondenza ospitati dell'offerente in BidRequest.user.buyeruid per OpenRTB o BidRequest.hosted_match_data per il protocollo Google RTB ritirato. Gli offerenti possono anche compilare gli elenchi di utenti utilizzando i dati delle corrispondenze ospitate da loro specificati.

Infine, Google restituisce un pixel trasparente 1 x 1 al browser dell'utente.

Cookie Match Assist

Open Bidding consente alle piattaforme di scambio 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 le piattaforme di scambio pubblicitario che consente loro di creare tabelle di corrispondenza con i propri offerenti.

Come funziona Cookie Match Assist

1. Quando inserisci un annuncio, Google seleziona in modo algoritmico una piattaforma di scambio pubblicitario partecipante e inserisce un tag Cookie Match Assist con la seguente struttura:

   <img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>

2. Il tag di corrispondenza CMA di Google fa sì che l'URL di corrispondenza dei cookie della piattaforma di scambio pubblicitario riceva una richiesta di pixel.

3. L'endpoint di corrispondenza dei cookie della piattaforma di scambio pubblicitario riceve la richiesta, dove il suo servizio di corrispondenza dei cookie è responsabile della corrispondenza dell'ID utente con uno dei suoi offerenti. Nel diagramma seguente, il servizio di corrispondenza dei cookie della piattaforma di scambio pubblicitario risponde al browser dell'utente con un reindirizzamento a uno degli endpoint degli offerenti.
4. L'offerente riceve la richiesta, insieme agli eventuali parametri specificati dalla piattaforma di scambio pubblicitario per abbinare l'ID utente al relativo cookie.

Restrizioni

Impostare una quota limite per le richieste di corrispondenze aggiornate

Gli offerenti sono responsabili di limitare il numero di chiamate al servizio di corrispondenza dei cookie per gli utenti che hanno una nuova voce nella tabella delle corrispondenze 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 di Pixel devono rispondere a tutte le richieste di corrispondenza di Pixel in arrivo con una risposta che includa il parametro google_push. In questo modo Google può applicare i criteri monitorando l'utilizzo. Se il tasso di risposta di un offerente scende al di sotto del 90%, Google limiterà il numero di richieste Pixel Match inviate al suo account.

Utilizzare gli endpoint HTTPS

È obbligatorio 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 che ti è stata inviata tramite HTTPS, devi eseguire il reindirizzamento al Servizio di corrispondenza dei cookie tramite HTTPS. Analogamente, anche un endpoint Cookie Match Assist che reindirizza agli 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 dell'utente finale. Queste richieste devono indicare che il consenso è stato raccolto utilizzando uno dei seguenti metodi:

• TCFv2: include i parametri gdpr e gdpr_consent. Per maggiori dettagli, consulta la documentazione della versione 2.0 del TCF di IAB di Authorized Buyers.
• process_consent: una dichiarazione che attesta che l'offerente ha ottenuto il consenso necessario degli utenti.

Esempi

Gli esempi riportati di seguito illustrano come utilizzare il servizio di corrispondenza dei cookie per ottenere obiettivi specifici. Tieni presente che, se non diversamente specificato, si assume che l'utente in questione non risieda in uno stato degli Stati Uniti con limitazioni relative alla 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 il seguente 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 dispone di un cookie di Google, la risposta è:

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 di corrispondenza dei cookie, consulta i parametri URL di reindirizzamento.

Aggiungere un singolo utente all'elenco

Il parametro google_ula può essere specificato nel tag di corrispondenza di un offerente per aggiungere l'utente a un elenco di utenti con l'ID specificato. Se la tabella delle corrispondenze ospitata da Google o dall'offerente contiene una voce aggiornata 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 corrispondenza dei cookie. Per ulteriori dettagli, consulta le limitazioni sull'utilizzo del Servizio di corrispondenza dei cookie. Il corrispondente tag di 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 positiva, se l'URL di corrispondenza dei cookie dell'offerente è https://ad.network.com/pixel, l'URL di reindirizzamento di Google sarà:

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, nel reindirizzamento riceverai google_ula. A differenza del parametro del tag di corrispondenza corrispondente, questo sostituisce il timestamp con un codice di stato per indicare il buon esito dell'operazione. Ad esempio, se la richiesta non è andata a buon fine perché l'account dell'offerente non aveva accesso all'elenco di utenti specificato, l'URL di reindirizzamento sarà:

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 di utenti viene registrato 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 riportato sopra, possiamo vedere che l'operazione è riuscita per l'elenco di utenti con ID 45678, ma non è riuscita per l'elenco di utenti con ID 12345 perché l'offerente non aveva l'autorizzazione per accedervi.

Esegui i passaggi del flusso di lavoro della corrispondenza dei cookie e aggiungi all'elenco di utenti

Per eseguire il matching dei cookie e aggiungere l'utente a un elenco di utenti in una singola 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 include 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

Memorizzazione di 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 codificata in base64 sicura per il web. Per un utente per il quale i dati del cookie non codificati dell'offerente sono Cookie number 1!, il valore codificato sarà Q29va2llIG51bWJlciAxIQ==, che verrà 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 positiva, se l'URL di corrispondenza dei cookie dell'offerente è https://cookie-monster.com/pixel, l'URL di reindirizzamento di Google sarà:

https://cookie-monster.com/pixel

Il parametro google_gid non è presente nel reindirizzamento perché il tag match non includeva google_cm e google_hm non è incluso nelle risposte di successo. Nelle future richieste di offerta per le impressioni per questo utente, l'offerente riceverà i dati di corrispondenza ospitati in BidRequest.user.buyeruid per OpenRTB o BidRequest.hosted_match_data per il protocollo Google RTB ormai ritirato.

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 riportato sopra 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 Google e dall'offerente 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 produrrà 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 positiva, in cui l'URL con corrispondenza dei cookie dell'offerente è https://cookie-monster.com/pixel, l'URL di reindirizzamento di Google sarà il seguente:

https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0

Dopo aver ricevuto il reindirizzamento, l'offerente può abbinare lo User-ID Google specificato in google_gid ai dati dei cookie nella tabella delle corrispondenze. Inoltre, possono verificare che le operazioni sulla tabella delle corrispondenze e sull'elenco di utenti ospitate da Google siano andate a buon fine. Di conseguenza, qualsiasi pretargeting dell'offerente configurato per scegliere come target l'ID elenco utenti specificato ora farà sì che l'offerente riceva richieste di offerta per le impressioni generate dall'utente. Analogamente, in queste richieste di offerta, l'offerente riceverà i dati di corrispondenza ospitati in BidRequest.user.buyeruid per OpenRTB o in BidRequest.hosted_match_data per il protocollo Google RTB deprecato.