Corrispondenza dei cookie

Corrispondenza dei cookie è una funzionalità che ti consente di trovare corrispondenze con il tuo cookie, ad esempio ad esempio l'ID di un utente che ha visitato il tuo sito web, con un l'ID utente Google specifico per lo strumento di offerta e creare elenchi di utenti che possono aiutarti scelte di offerta più efficaci. Questa guida descrive i concetti utilizzati in Cookie la corrispondenza, nonché i diversi flussi di lavoro della corrispondenza dei cookie ed eventuali varianti che potrebbe 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 navigano del proprio sito, utilizzati per identificare gli utenti all'interno di tale dominio. Anche se due proprietari dei domini accetterebbero di scambiare tali dati, il modello dei browser internet impedisce a uno di leggere i cookie impostati da un altro dominio.

Nel contesto della pubblicità digitale, Google identifica gli utenti mediante i cookie che appartengono al dominio doubleclick.net e gli offerenti che partecipano alle offerte in tempo reale possono avere un proprio dominio in cui identificare alcuni utenti a cui mostrare gli annunci. Corrispondenza dei cookie consente all'offerente di abbinare i suoi cookie a quelli di Google, in modo da poter determinare se un'impressione inviata in una richiesta di offerta è associata a uno degli gli utenti presi di mira, riceveranno i propri dati dei cookie o un L'ID utente Google specifico dell'offerente, che è una forma criptata doubleclick.net nella richiesta di offerta.

Il servizio di corrispondenza dei cookie descritto in questa guida facilita la creazione e il mantenimento dell'associazione tra il cookie di un offerente e il User-ID e consente inoltre 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'altra. Gli offerenti possono usare il Servizio di corrispondenza dei cookie per compilare il proprio alle tabelle delle corrispondenze, mappando il cookie per un determinato utente alla User-ID o per compilare una tabella delle corrispondenze ospitata da Google. Le tabelle delle corrispondenze sono necessaria affinché l'applicazione dell'offerente di un offerente possa accedere ai dati dei cookie per l'utente a cui mostrare l'impressione.

Tabelle delle corrispondenze ospitate da Google

Per semplificare la manutenzione, i miglioramenti della latenza e l'accesso ai dati corrispondenti per in determinate regioni, ti consigliamo di consentire a Google di ospitare i tuoi la tabella delle corrispondenze. Consente di specificare una stringa con codifica Base64 sicura per il web: da qui in poi denominati dati di corrispondenza ospitati, che verranno mappati ID utente Google di un determinato utente. Una volta stabilita una corrispondenza, è possibile utilizzati nei seguenti modi:

• Offerte in tempo reale: nelle richieste di offerta successive per le impressioni. associati all'utente, Google ti invierà i dati di corrispondenza ospitati che che corrispondano al suo ID utente Google. Se l'endpoint delle offerte è configurato per utilizzare il protocollo RTB di Google, lo riceverete come byte decodificati il campo BidRequest.hosted_match_data. In OpenRTB di Google implementazione, BidRequest.user.buyeruid restituirà questo come stringa sicura per il web con codifica Base64.

• Elenchi di utenti: è possibile compilare gli elenchi di utenti. 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. In questo modo puoi eliminare i contenuti meno pertinenti impressioni per gli utenti esterni allo 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 completare questi elenchi con i flussi di lavoro della corrispondenza dei cookie descritto di seguito 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ò abilitare flussi di lavoro specifici e aiutarti configurare quanto segue:

• ID rete per la corrispondenza dei cookie (NID): un ID stringa che identifica in modo univoco Un account offerente per la Corrispondenza dei cookie e altre operazioni correlate.
• URL di corrispondenza dei cookie: l'URL di base per un endpoint che accetta e gestire le richieste in entrata come parte dei flussi di lavoro per la corrispondenza dei cookie. Gli offerenti possono incorporare le macro in questo URL per controllare l'ordine dei parametri passati nei flussi di lavoro Corrispondenza dei cookie.
• Tag di corrispondenza: il tag che devi inserire nel browser di un utente per la Flusso di lavoro della corrispondenza dei cookie avviato dall'offerente. Può essere pubblicato insieme agli annunci, o posizionati in proprietà web al di fuori degli annunci.
• (Facoltativo) URL report sulla corrispondenza dei cookie: nella colonna unidirezionale Flusso di lavoro per la corrispondenza dei cookie. Si tratta di un URL facoltativo che può essere fornito specificare un endpoint che riceverà i dettagli dell'errore nel caso in cui il cookie la corrispondenza non riesce tramite un reindirizzamento HTTP 302. Per impostazione predefinita, le risposte saranno inviati a questo URL se si è verificato un errore con l'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 la macro flusso di lavoro di Cookie Match Assist, URL di base dell'endpoint destinato a rispondere alle richieste in arrivo.
• Quota di Cookie Match Assist: per le piattaforme di scambio che implementano il parametro flusso di lavoro di Cookie Match Assist, numero massimo di richieste che il suo URL con corrispondenza dei cookie può ricevere ogni secondo. Questo ha lo scopo di evitare che le richieste CMA sovraccarichino con i server dello scambio pubblicitario.

Macro di corrispondenza dei cookie

In uno dei flussi di lavoro di corrispondenza dei cookie supportati, l'URL con corrispondenza dei cookie di un offerente generalmente include parametri aggiunti in una nell'ordinamento non garantito. Offerenti con integrazioni che richiedono coerenza dell'ordine dei parametri possono inserire le macro nell'URL con corrispondenza dei cookie in ne garantiscono il posizionamento.

Macro supportate

Gli offerenti possono facoltativamente configurare l'URL con corrispondenza dei cookie in modo da includere uno o più macro nel formato %%GOOGLE_<PARAM_NAME>%% o %%GOOGLE_<PARAM_NAME>_PAIR%%. Le macro supportate e i relativi i valori espansi sono:

Esempio di macro

Uno strumento di offerta ha un'integrazione per la corrispondenza dei cookie con un endpoint ospitato su https://user.bidder.com.cookies e la sua implementazione richiede Parametri predefiniti definiti dagli offerenti oltre alla Corrispondenza dei pixel parametri nel seguente ordine: google_push, google_gid, google_cver e google_error. A questo scopo, l'offerente può impostare URL di corrispondenza dei cookie a:

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 invierà 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 al momento supporta tre flussi di lavoro per: diversi casi d'uso descritti di seguito.

Avviato dall'offerente: corrispondenza dei cookie bidirezionale

La corrispondenza bidirezionale dei cookie fa riferimento a un flusso di lavoro avviato dallo strumento di offerta, in cui inserisce nel browser dell'utente un tag di corrispondenza che lo indirizza a Google. Questo consente a Google e all'offerente di completare le tabelle delle corrispondenze. Di seguito è riportato un un semplice esempio di questo flusso di lavoro.

Passaggio 1: inserisci il tag di corrispondenza

Per avviare la procedura, l'offerente deve inserire il tag di corrispondenza come di cui viene eseguito il rendering nel browser dell'utente. Un semplice tag di corrispondenza che restituisce solo lo User-ID Google all'offerente può essere strutturato come segue:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />

Nel tag di corrispondenza puoi includere altri parametri da soddisfare. diversi casi d'uso. Per saperne di più su questi parametri, consulta Associa i parametri URL del tag.

Passaggio 2: Google risponde con un reindirizzamento che include i dati di corrispondenza

Il tag di corrispondenza farà sì che il servizio di corrispondenza dei cookie di Google riceva un da parte del browser dell'utente, che emetterà un HTTP 302 reindirizzano all'URL con corrispondenza dei cookie dell'offerente. Il reindirizzamento includerà la query parametri che specificano l'ID utente Google e il numero di versione nell'URL, e l'offerente riceverà anche il cookie incluso nelle intestazioni delle richieste. Nella per un URL con corrispondenza dei cookie specificato come https://ad.network.com/pixel, l'URL di reindirizzamento per il tag di corrispondenza semplice, come illustrato sopra, potrebbe essere simile al seguenti:

https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1

L'ID utente Google trasmesso tramite il parametro google_gid è una piattaforma con codifica Base64 e non riempita per il web stringa. Per gli offerenti che scelgono di ospitare una tabella delle corrispondenze, è consigliabile che e archiviare la stringa esatta restituita dal servizio di corrispondenza dei cookie. Nei successivi richieste di offerta, questo corrisponderà ai valori specificati tramite BidRequest.google_user_id nel protocollo RTB di Google o BidRequest.user.id nel protocollo Implementazione di OpenRTB.

La versione specificata in google_cver indica il valore il numero di versione per l'ID utente Google. L'ID utente Google di un determinato utente cambiano raramente, dopodiché verranno incrementati.

Se Google rileva un errore durante l'elaborazione della tua richiesta di corrispondenza, Verrà invece specificato il 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, che include i parametri specificati nel primo passaggio e quelli forniti da Google secondo passaggio. Inoltre, riceverà anche il proprio cookie nella cartella HTTP intestazioni. Se l'operazione è andata a buon fine, un offerente che ospita la propria tabella delle corrispondenze il proprio cookie potrebbe corrispondere allo User-ID Google incluso nella risposta. È ha consigliato agli offerenti di memorizzare la stringa esatta restituita dalla corrispondenza dei cookie assistenza.

Se l'operazione non è andata a buon fine, l'offerente riceverà un google_error nel reindirizzamento. Si tratta di un valore numerico che corrisponde a un diverso stati di errore che identificano l'errore specifico. Puoi apprendere Per ulteriori informazioni sui possibili valori di errore, fai clic qui. Se ricevi un errore, puoi tentare di trovare di nuovo una corrispondenza per quell'utente inserendo un nuovo tag di corrispondenza.

L'offerente deve sempre rispondere pubblicando un'immagine di pixel invisibile 1 x 1; oppure in alternativa restituiscono una risposta HTTP 204 Nessun contenuto.

Diagramma del flusso di lavoro della corrispondenza dei cookie

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

Associa i parametri URL del tag

Oltre ai parametri di cui sopra, gli offerenti possono specificare il proprio, che verranno aggiunti come parametri all'URL di reindirizzamento. Tieni presente che il valore i parametri denominati con il prefisso google_ verranno ignorati perché che sono riservate a Google per lo sviluppo futuro e la conservazione dei parametri l'ordine non è garantito. Un tag di corrispondenza che includa l'offerente definito possono 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 base della corrispondenza dei cookie configurato per L'account di un offerente, inclusi google_ e i parametri definiti dall'offerente in base a quelli specificati nel tag di corrispondenza. I seguenti google_ sono definiti i parametri di risposta:

Scenari di esempio del flusso di lavoro della corrispondenza dei cookie

I seguenti scenari 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

Gianna svuota la cache di tutti i cookie. Successivamente, visita la home page di ExampleNews.com.

Riportiamo di seguito le varie fasi:

1. ExampleNews.com esegue il rendering e richiama gli annunci da Google (Ad Manager).
2. Poiché l'unità pubblicitaria è idonea per l'allocazione dinamica, Google invia un'offerta richieste a FinestDSP e ad altri offerenti tramite il servizio di offerte in tempo reale.
3. L'applicazione dello strumento di offerta di FinestDSP riceve ed elabora la richiesta di offerta. e invia la sua risposta all'offerta.
4. Google riceve 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 abbinamento di FinestDSP a Jane.
6. Il tag di corrispondenza chiama Cookie Match Service di Google, specificando Parametri google_nid e google_cm.
7. Cookie Match Service legge il cookie Google di Giovanna e invia l'email browser un reindirizzamento all'URL di corrispondenza dei cookie di FinestDSP con Parametri google_user_id e google_cver impostati.
8. Il browser di Giulia carica il reindirizzamento all'URL con corrispondenza dei cookie di FinestDSP.
9. L'endpoint di corrispondenza dei cookie di FinestDSP elabora la richiesta di reindirizzamento. che include parametri URL impostati da Google e il relativo cookie per Jane nella Intestazioni HTTP. FinestDSP ora può memorizzare la mappatura del proprio cookie google_user_id nella tabella delle corrispondenze.
10. FinestDSP risponde al reindirizzamento con un pixel invisibile di 1 x 1.

Scenario 2: utente con mappatura esistente

Una settimana dopo lo scenario 1, Gianna visita di nuovo ExampleNews.com. Ora che Jane ha sia cookie dello strumento di offerta sia di Ad Manager sul proprio computer, ecco come funziona la corrispondenza funziona.

1. La pagina web viene visualizzata e Google (Ad Manager) richiede annunci che il rendering dell'immagine 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, compresi indicatori quali google_user_id.
4. FinestDSP cerca il google_user_id nella propria tabella delle corrispondenze, e trova il cookie associato a Jane e creato una settimana prima (nello scenario 1).
5. In base alle informazioni associate al cookie, lo strumento di offerta di FinestDSP logica fa un'offerta sull'impressione e vince l'asta.
6. Sara potrebbe vedere un annuncio personalizzato in base ai suoi interessi, in base alle informazioni di cui dispone FinestDSP.

Avviato dall'offerente: corrispondenza dei cookie unidirezionali

La corrispondenza dei cookie unidirezionali è simile al flusso di lavoro bidirezionale, tranne per il fatto che viene alterato in modo che solo Google ospiti e compili una corrispondenza . Questa opzione può essere utilizzata nei casi in cui l'offerente non è autorizzato a ospitare ID utente Google nella rispettiva tabella delle corrispondenze. Per usare questa procedura, gli offerenti deve consentire a Google di ospitare la tabella delle corrispondenze, non può più specificare google_cm nelle richieste al servizio di corrispondenza dei cookie di Google; e di conseguenza non riceverà google_gid per compilare la tabella delle corrispondenze. Dopo che Google ha stabilito una corrispondenza per un utente, gli offerenti possono aggiungere a elenchi di utenti utilizzando i loro dati dei cookie. Analogamente, per le richieste di offerta questi utenti escluderanno lo User-ID Google, ma includeranno i dati di corrispondenza ospitati. R un semplice esempio del flusso di lavoro rivisto è riassunto nei passaggi di seguito.

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

Per avviare la procedura, un offerente deve inserire un tag di corrispondenza viene eseguito nel browser dell'utente. A differenza del flusso di lavoro per gli utenti che non si trovano in uno stato USA con restrizioni sulla privacy, il tag di corrispondenza deve indirizzare il browser dell'utente al tuo cookie URL corrispondente. Ad esempio, con un URL con corrispondenza dei cookie configurato come https://ad.network.com/pixel, avrebbe il seguente aspetto:

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

Durante il caricamento nel browser dell'utente, verrà richiesto un pixel dalla URL con corrispondenza dei cookie. Questa richiesta conterrà il relativo cookie nell'intestazione HTTP che dovrebbe 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 cookie di Google Servizio corrispondente, incluso il parametro google_hm compilato con dei propri dati, sicuri per il web e con codifica Base64. L'URL di reindirizzamento potrebbe avere il seguente aspetto seguenti:

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 da te specificati, aggiunta al cookie di Google nelle intestazioni HTTP.

Passaggio 4: Google pubblica il pixel in caso di reindirizzamento riuscito o di errore se l'URL del report è stato specificato

Se l'operazione di corrispondenza dei cookie ha esito positivo o se non sono presenti cookie L'URL del report corrispondente è stato specificato 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 ospitati i dati di corrispondenza in BidRequest.hosted_match_data per la protocollo o BidRequest.user.buyeruid per OpenRTB di Google implementazione. Gli offerenti possono anche completare gli elenchi di utenti utilizzando i dati di corrispondenza ospitati come hanno specificato.

Altrimenti, se si è verificato un errore, Google invia un reindirizzamento all'URL URL del report sulla corrispondenza dei cookie con la causa dell'errore specificato nel Parametro google_error. Se l'URL del report sulla corrispondenza dei cookie dell'offerente erano https://ad.network.com/report, l'URL di reindirizzamento sarebbe come:

<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 reindirizzerà all'URL del report sulla corrispondenza dei cookie dell'offerente. incluso l'eventuale motivo dell'errore specificato da Google nei Parametro google_error. Per scoprire di più sull'interpretazione dell'errore consulta la descrizione del parametro.

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

L'offerente deve rispondere pubblicando un pixel 1 x 1 trasparente alla del browser.

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 restrizioni sulla privacy è illustrato nel diagramma di seguito, dove richieste e risposte sono rappresentate da una freccia e i dati gli elementi che li accompagnano sono elencati tra parentesi.

Parametri URL per il reindirizzamento dello strumento di offerta 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

Avviata da Google: corrispondenza bidirezionale dei pixel

La corrispondenza bidirezionale dei pixel è un flusso di lavoro per la corrispondenza dei cookie di Google Servizio in cui Google tenta di abbinare un ID utente Google a un algoritmo offerente selezionato diverso dal vincitore dell'asta Offerte in tempo reale. Quando un annuncio viene inserito, Google inserirà un tag di corrispondenza che indirizzi il browser dell'utente a caricare pixel trasparente dall'URL con corrispondenza dei cookie dell'offerente scelto. Questa operazione consentirà di sia Google sia l'offerente per compilare una tabella delle corrispondenze con un determinato utente. Di seguito 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, area annuncio in quella pagina è riempita da Google, può essere inserito un tag di corrispondenza richiede un pixel a un offerente selezionato tramite un algoritmo. L'abbinamento di Pixel inserito da Google combina l'URL con corrispondenza dei cookie dell'offerente con parametri aggiuntivi: lo strumento di offerta può usare per completare la tabella delle corrispondenze. Per un URL con corrispondenza dei cookie specificato come https://ad.network.com/pixel, è strutturato come che segue:

<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 una 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 nei di corrispondenza del flusso di lavoro per la corrispondenza dei cookie avviata dall'offerente. Nella corrispondenza dei pixel, il parametro google_cm viene sostituito dal google_push e il suo valore deve essere uguale al valore forniti da Google nella richiesta. Simile a quello avviato dall'offerente flusso di lavoro, parametri aggiuntivi per soddisfare altri casi d'uso.

Passaggio 3: Google elabora il reindirizzamento e risponde con il pixel

Google registra che è stata creata una corrispondenza per l'utente e gestisce qualsiasi le operazioni aggiuntive richieste tramite i parametri di query. Infine, Google risponde con un pixel trasparente 1 x 1.

Diagramma del flusso di lavoro della corrispondenza dei pixel

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

Parametri di richiesta del tag di corrispondenza di Google

Parametri di reindirizzamento corrispondenti Pixel offerente

Avviata da Google: corrispondenza unidirezionale dei pixel

La corrispondenza unidirezionale dei pixel è diversa dal flusso di lavoro bidirezionale in che il tag di corrispondenza di Google non includa un parametro che specifica il parametro ma continuerà a compilare una tabella delle corrispondenze ospitata da Google. Si può usare nei casi in cui l'offerente non è autorizzato a ospitare gli ID utente Google nei propri della tua tabella delle corrispondenze. Un semplice esempio del flusso di lavoro rivisto è riassunto nel i passaggi seguenti.

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 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 all'URL corrispondente di cucina dell'offerente

Il browser dell'utente richiede un pixel all'URL con 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 cookie di Google Servizio corrispondente, incluso il parametro google_hm compilato con dei propri dati, sicuri per il web e con codifica Base64. L'URL di reindirizzamento potrebbe avere il seguente aspetto seguenti:

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 da te specificati, aggiunta al cookie di Google nelle intestazioni HTTP. Se l'operazione fosse riusciti, le impressioni per questo utente nelle successive richieste di offerta includeranno i dati di corrispondenza ospitati dell'offerente in BidRequest.hosted_match_data per il protocollo Google o BidRequest.user.buyeruid per la Implementazione di OpenRTB. Gli offerenti possono anche completare gli elenchi di utenti utilizzando corrispondono ai dati specificati.

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

Cookie Match Assist

Open Bidding consente alle piattaforme di scambio pubblicitario di utilizzare la funzionalità iniziata dall'offerente e Google ha avviato flussi di lavoro di corrispondenza dei cookie, per associare uno User-ID Google al relativo cookie. Per biscotti Match Assist (CMA) è una funzionalità aggiuntiva per le piattaforme di scambio pubblicitario che consente loro di creano tabelle delle corrispondenze con i propri offerenti.

Come funziona Cookie Match Assist

1. Quando posiziona un annuncio, Google seleziona algoritmicamente scambia e inserisce un tag Cookie Match Assist con le seguenti caratteristiche 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 con corrispondenza dei cookie della piattaforma di scambio pubblicitario per ricevere una richiesta di pixel.

3. L'endpoint di corrispondenza dei cookie dello scambio riceve la richiesta, dove il proprio servizio di corrispondenza dei cookie è responsabile della corrispondenza tra ID utente e uno dei suoi offerenti. Nel diagramma seguente, la corrispondenza dei cookie della piattaforma di scambio risponde al browser dell'utente con un reindirizzamento a uno dei servizi endpoint.
4. L'offerente riceve la richiesta, insieme agli eventuali parametri specificati da lo scambio in modo che associa l'ID utente al cookie.

Restrizioni

Limite di frequenza delle richieste per corrispondenze nuove

Gli offerenti sono responsabili di limitare il numero di chiamate al cookie Servizio di corrispondenza per gli utenti che hanno una nuova voce nella corrispondenza ospitata da Google . Una voce nella tabella delle corrispondenze ospitata può essere considerata scaduta dopo 14 giorni. dopodiché potrà essere aggiornato.

Rispondere a tutte le richieste di corrispondenza dei pixel

Gli offerenti che usano il flusso di lavoro della corrispondenza dei pixel sono tenuti a rispondere a tutti richieste Pixel Match in arrivo con una risposta che include google_push . In questo modo Google può applicare i criteri monitorandone l'utilizzo. Se il tasso di risposta dell'offerente scende al di sotto del 90%, Google limiterà il numero di Richieste di corrispondenza di Pixel inviate al suo account.

Usa endpoint HTTPS

È necessario che gli endpoint utilizzati in tutti i flussi di lavoro di corrispondenza dei cookie utilizzino HTTPS.

Quando rispondi a una richiesta Pixel Match che ti viene inviata tramite HTTPS, necessaria per il reindirizzamento al servizio di corrispondenza dei cookie tramite HTTPS. Analogamente, anche un endpoint Cookie Match Assist che reindirizza agli offerenti deve usare 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

Richieste di corrispondenza dei cookie soggette a Utente UE di Google Norme relative al consenso devono indicare il consenso dell'utente finale. Queste richieste sono tenute a indicano che il consenso è stato raccolto in uno dei seguenti modi:

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

Esempi

I seguenti esempi illustrano come utilizzare il servizio Corrispondenza dei cookie per raggiungere obiettivi specifici. Tieni presente che, se non diversamente indicato, presuppone che l'utente su cui si agisce non provenga da Stato degli Stati Uniti con restrizioni sulla privacy.

Compilare una tabella delle corrispondenze ospitata dall'offerente

Un offerente può usare il flusso di lavoro Corrispondenza dei cookie per compilare la propria corrispondenza specificando solo i valori google_nid e google_cm nel loro 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 con corrispondenza dei cookie dell'offerente è impostato su https://ad.network.com/pixel?id=1, e l'operazione di corrispondenza dei cookie ha esito positivo, il reindirizzamento inviato da Google la 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 riesce perché l'utente non ha una cookie di Google, la risposta sarebbe:

https://ad.network.com/pixel?id=1&google_error=3

Il codice di errore dipende dalla causa dell'errore. Per ulteriori informazioni per ulteriori informazioni sui possibili codici di errore del flusso di lavoro Corrispondenza dei cookie, consulta parametri URL di reindirizzamento.

Aggiungi a elenco utenti singolo

Il parametro google_ula può essere specificato nella corrispondenza di un offerente per aggiungere l'utente a un elenco di utenti con l'ID specificato. Se Google o La tabella delle corrispondenze ospitata dallo strumento di offerta presenta una nuova voce per l'utente, che può inserire un tag di corrispondenza che includa google_nid e google_ula parametri per aggiungere l'utente all'elenco specificato senza avviare l'intero Flusso di lavoro della corrispondenza dei cookie. Consulta le limitazioni sul richiamo del servizio di abbinamento dei cookie per ulteriori dettagli. Il corrispondente il 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, in cui l'URL con 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 esiste un cookie di Google per l'utente: l'URL di reindirizzamento includerà Parametro google_error:

• https://ad.network.com/pixel?google_error=3

Se si verifica un errore specifico relativo all'aggiunta di un utente all'elenco, riceverai google_ula nel reindirizzamento. A differenza del parametro del tag di corrispondenza corrispondente, sostituisce il timestamp con uno stato per indicare l'esito positivo 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 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 tramite includendo più parametri google_ula nel tag di corrispondenza. Nella questo può 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

Dal reindirizzamento riportato sopra, possiamo vedere che l'operazione è riuscita per l'utente elenco con ID 45678, ma non riuscito per l'elenco utenti con ID 12345 perché l'offerente non disponeva dell'autorizzazione per accedervi.

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

Per eseguire la corrispondenza 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 includerà google_gid, google_cver e google_ula. Potrebbe avere un aspetto simile seguenti:

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 propri cookie in una tabella delle corrispondenze ospitata da Google, e non intende creare una corrispondenza tra negozio e User-ID Google nella propria corrispondenza il tag di corrispondenza deve includere il parametro google_hm in cui il suo valore deve essere una stringa sicura per il web con codifica Base64. Per un utente in cui I dati dei cookie non codificati dell'offerente sono Cookie number 1!, il formato codificato sarebbe Q29va2llIG51bWJlciAxIQ== e verrebbe utilizzato in una di corrispondenza in questo modo:

<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />

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 potrebbe essere:

https://cookie-monster.com/pixel

Il parametro google_gid non è nel reindirizzamento perché il tag di corrispondenza non ha incluso google_cm e google_hm è non incluse nelle risposte positive. Nelle richieste di offerta future per le impressioni per questo utente, l'offerente riceverà i dati sulle corrispondenze ospitate BidRequest.hosted_match_data per il protocollo RTB di Google oppure BidRequest.user.buyeruid per l'implementazione di OpenRTB di Google.

Se invece l'offerente ha utilizzato un tag di corrispondenza in cui il valore google_hm non era codificato in base64, ad esempio chocolate_chunk!: l'URL di reindirizzamento potrebbe avere il seguente aspetto seguenti:

https://cookie-monster.com/pixel?google_hm=2

L'URL di reindirizzamento riportato sopra include un valore google_hm di 2, suggerendo che l'operazione non sia riuscita perché il valore potrebbe non essere decodificati.

Tabelle delle corrispondenze ospitate da Google e dello strumento di offerta con elenchi di utenti

Se un offerente ospita il proprio elenco di utilizzo oltre a un utente ospitato da Google e desidera 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 google_cm, google_hm e google_ula. Se l'offerente il dato dei cookie è Cookie number 1!, il valore codificato sarebbe Q29va2llIG51bWJlciAxIQ==, che produrrebbe un tag di corrispondenza come seguenti:

<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 avrà il seguente aspetto:

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

Alla ricezione del reindirizzamento, l'offerente può corrispondere all'ID utente Google specificato in google_gid con i dati dei cookie nella tabella delle corrispondenze. Nella Inoltre, possono determinare che la tabella delle corrispondenze e l'elenco utenti operazioni sono riuscite. Di conseguenza, qualsiasi pretargeting dell'offerente configurato in modo da scegliere come target l'ID elenco utenti specificato ora farà sì che l'offerente ricevere richieste di offerta per impressioni dall'utente. Allo stesso modo, in queste offerte richieste, l'offerente riceverà i dati sulle corrispondenze ospitate BidRequest.hosted_match_data per il protocollo RTB di Google oppure BidRequest.user.buyeruid per l'implementazione di OpenRTB di Google.