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.buyeruidlo 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 campoBidRequest.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:
| Macro | Valore espanso |
|---|---|
| GOOGLE_GID | GOOGLE_USER_ID |
| GOOGLE_GID_PAIR | &google_gid=GOOGLE_USER_ID |
| GOOGLE_CVER | COOKIE_VERSION_NUMBER |
| GOOGLE_CVER_PAIR | &cver=COOKIE_VERSION_NUMBER |
| GOOGLE_ERROR | ERROR_ID |
| GOOGLE_ERROR_PAIR | &google_error=ERROR_ID |
| GOOGLE_PUSH | PIXEL_MATCH_DATA |
| GOOGLE_PUSH_PAIR | &google_push=PIXEL_MATCH_DATA |
| GOOGLE_ALL_PARAMS | google_gid=GOOGLE_USER_ID&cver=COOKIE_VERSION_NUMBER&google_error=ERROR_ID |
Esempio di macro
Un offerente ha un'integrazione 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
| Parametro | Descrizione |
|---|---|
google_nid |
ID rete (NID) per l'account dell'offerente. Questo ID può essere recuperato tramite la risorsa Offerenti. |
google_cm |
Indica al Servizio di corrispondenza dei cookie di Google che deve eseguire la corrispondenza dei cookie. Il valore del parametro viene ignorato e può essere omesso. |
google_sc |
Questo parametro è obsoleto. Imposta il cookie di Google per l'utente se non è presente. Il valore del parametro viene ignorato e può essere omesso. L'omissione del parametro genera un errore se non esiste alcun cookie. |
google_no_sc |
Questo parametro è deprecato. Questo indica al servizio di corrispondenza dei cookie di Google di non impostare un cookie per l'utente se non è presente. Il valore del parametro viene ignorato e può essere omesso. |
google_hm |
I dati che l'offerente vuole memorizzare in una tabella delle corrispondenze ospitata da Google.
Il valore è una stringa sicura per il web codificata in base64 (spaziatura interna facoltativa). I dati non elaborati devono avere
una dimensione massima di 40 byte. Ad esempio, |
google_redir |
Una stringa con codifica URL che un offerente può specificare se vuole indirizzare
Google a inviare il reindirizzamento HTTP 302 all'URL codificato per
questo tag di corrispondenza. In questo modo, Google viene posizionato in primo piano in una chiamata ai partner concatenata. Verrà generato un errore se viene specificato senza
google_hm o con google_cm. |
google_ula |
Una stringa utilizzata per aggiungere l'utente a un elenco di utenti esistente. Il formato previsto del valore è userlistid[,timestamp]:
Questo parametro URL può essere ripetuto per aggiungere l'utente a più elenchi. |
gdpr |
Indica che la richiesta è soggetta alle limitazioni del GDPR sull'utilizzo dei dati. Per maggiori dettagli, consulta la sezione
Requisiti per il consenso degli utenti dell'UE di seguito o Impatto sull'idoneità
della corrispondenza dei cookie nella
documentazione della versione 2.0 del TCF di IAB di Authorized Buyers.
Esempio: |
gdpr_consent |
Una stringa TC che rappresenta il consenso dell'utente finale. Per maggiori dettagli, consulta i requisiti relativi al consenso degli utenti dell'UE di seguito o la sezione Come viene trasmessa la stringa TC? nella documentazione della versione 2.0 del TCF di IAB di Authorized Buyers. |
process_consent |
Indica che l'offerente ha ottenuto il consenso dell'utente finale per gli utilizzi dei dati specificati nelle
Norme relative al consenso degli utenti dell'UE di Google.
Se la richiesta non è soggetta alle Norme relative al consenso degli utenti dell'UE o se esistono
altri parametri di consenso disponibili nella richiesta
( Esempio: |
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_:
| Parametro | Descrizione |
|---|---|
google_gid |
ID utente Google. Imposta se google_cm è specificato nella richiesta e la richiesta è andata a buon fine. |
google_cver |
Versione del cookie. Imposta se google_cm è specificato nella richiesta e la richiesta è andata a buon fine. |
google_error |
Un valore intero che indica l'errore complessivo della richiesta. Quando viene ricevuto, indica che non sono state eseguite operazioni e che non verranno impostati altri parametri di risposta
|
google_hm |
Viene visualizzato solo se il tentativo di scrittura nella tabella delle corrispondenze ospitata da Google non va a buon fine. In questo caso, il valore è uno dei seguenti codici di stato:
|
google_ula |
Stato dell'operazione di aggiunta dell'elenco utenti, ripetuta se nella richiesta sono stati specificati più Esempio: L'operazione
|
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:
- ExampleNews.com esegue il rendering e chiama gli annunci di Google (Ad Manager).
- Poiché l'unità pubblicitaria è idonea per l'allocazione dinamica, Google invia richieste di offerta a FinestDSP e ad altri offerenti tramite il servizio di offerte in tempo reale.
- L'applicazione di offerta di FinestDSP riceve ed elabora la richiesta di offerta, e invia la risposta all'offerta.
- Google riceve le risposte alle offerte dagli offerenti, inclusa la risposta di FinestDSP che specifica un annuncio con un tag di corrispondenza (pixel).
- FinestDSP vince l'asta. Google pubblica il tag annuncio e di corrispondenza di FinestDSP per Jane.
- Il tag di corrispondenza chiama Cookie Match Service di Google, specificando i parametri
google_nidegoogle_cm. - 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_gidegoogle_cverimpostati. - Il browser di Jane carica il reindirizzamento all'URL di corrispondenza dei cookie di FinestDSP.
- L'endpoint di corrispondenza dei cookie di FinestDSP elabora la richiesta di reindirizzamento, che include i parametri URL impostati da Google e il relativo cookie per Jane nelle intestazioni HTTP. FinestDSP ora può memorizzare la mappatura del proprio cookie a
google_gidnella propria tabella delle corrispondenze. - 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.
- Viene visualizzata la pagina web, di conseguenza Google (Ad Manager) richiede gli annunci da visualizzare sulla pagina.
- Durante l'asta di annunci, Google invia una richiesta di offerta agli offerenti applicabili, tra cui FinestDSP.
- FinestDSP riceve la richiesta di offerta, inclusi indicatori come
google_gid. - FinestDSP cerca
google_gidnella tabella delle corrispondenze e trova il cookie associato a Jane creato una settimana prima (nello scenario 1). - In base alle informazioni associate al cookie, la logica di offerta di FinestDSP fa un'offerta per l'impressione e vince l'asta.
- Jane potrebbe 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
| Parametro | Descrizione |
|---|---|
google_nid |
ID rete (NID) per l'account dell'offerente. Questo ID può essere recuperato tramite la risorsa Offerenti. |
google_sc |
Questo parametro è obsoleto. Imposta il cookie di Google per l'utente se non ne è presente uno. Il valore del parametro viene ignorato e può essere omesso. L'omissione del parametro genera un errore se non esiste alcun cookie. |
google_no_sc |
Questo parametro è deprecato. Questo indica al servizio di corrispondenza dei cookie di Google di non impostare un cookie per l'utente se non è presente. Il valore del parametro viene ignorato e può essere omesso. |
google_hm |
Contiene i dati che l'offerente vuole memorizzare in una tabella delle corrispondenze ospitata da Google. |
google_redir |
Un URL codificato per cui vuoi che Google invii un reindirizzamento HTTP 302. L'URL
specificato riceverà i reindirizzamenti con il parametro google_error
sia per gli errori sia per le operazioni riuscite. |
google_ula |
Una stringa utilizzata per aggiungere l'utente a un elenco di utenti esistente. Il formato previsto del valore è userlistid[,timestamp]:
Questo parametro URL può essere ripetuto per aggiungere l'utente a più elenchi. |
gdpr |
Indica che la richiesta è soggetta alle restrizioni GDPR relative all'utilizzo dei dati. Per maggiori dettagli, consulta i
requisiti relativi al consenso degli utenti dell'UE di seguito o la sezione Impatto sull'idoneità alla corrispondenza dei cookie della
documentazione del TCF v2.0 di IAB di Authorized Buyers.
Esempio: |
gdpr_consent |
Una stringa TC che rappresenta il consenso dell'utente finale. Per maggiori dettagli, consulta i requisiti relativi al consenso degli utenti dell'UE di seguito o la sezione Come viene trasmessa la stringa TC? nella documentazione della versione 2.0 del TCF di IAB di Authorized Buyers. |
process_consent |
Indica che l'offerente ha ottenuto il consenso dell'utente finale per gli utilizzi dei dati specificati nelle
Norme relative al consenso degli utenti dell'UE di Google.
Se la richiesta non è soggetta alle Norme relative al consenso degli utenti dell'UE o se esistono altri parametri di consenso disponibili nella richiesta ( Esempio: |
Parametri URL per il reindirizzamento di Google all'URL del report sulla corrispondenza dei cookie dell'offerente
| Parametro | Descrizione |
|---|---|
google_error |
Un valore intero che indica l'errore complessivo della richiesta. Quando viene ricevuto, indica che non sono state eseguite operazioni e che non verranno impostati altri parametri di risposta
|
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
| Parametro | Descrizione |
|---|---|
google_gid |
ID utente Google. Per gli utenti che non risiedono in uno stato USA con limitazioni relative alla privacy, questo valore verrà sempre specificato nel tag di corrispondenza di Google. |
google_cver |
La versione del cookie. Questo valore verrà sempre specificato nel tag di corrispondenza di Google. |
google_push |
Indica che questa richiesta avvia il flusso di lavoro di corrispondenza dei pixel. Il valore deve essere restituito tramite il parametro corrispondente nella risposta di reindirizzamento dell'offerente. |
gdpr_consent |
Una stringa TC che rappresenta il consenso dell'utente finale. Per maggiori dettagli, consulta [Requisiti per il consenso degli utenti dell'UE](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) di seguito oppure la sezione **Come viene trasmessa la stringa TC?** nella [documentazione della versione 2.0 del TCF di IAB di Authorized Buyers](//support.google.com/authorizedbuyers/answer/9789378). |
Parametri di reindirizzamento della corrispondenza dei pixel dell'offerente
| Parametro | Descrizione |
|---|---|
google_nid |
ID rete (NID) per l'account dell'offerente. Questo ID può essere recuperato tramite la risorsa Offerenti. |
google_push |
Indica che questo reindirizzamento sta completando il workflow di corrispondenza di Pixel. Il valore del tag di corrispondenza Google corrispondente deve essere specificato qui. |
google_hm |
Contiene i dati che l'offerente vuole memorizzare in una tabella delle corrispondenze ospitata da Google. |
google_ula |
Una stringa utilizzata per aggiungere l'utente a un elenco di utenti esistente. Il formato previsto del valore è userlistid[,timestamp]:
Questo parametro URL può essere ripetuto per aggiungere l'utente a più elenchi. |
gdpr_consent |
Una stringa TC che rappresenta il consenso dell'utente finale. Per maggiori dettagli, consulta i [Requisiti per il consenso degli utenti dell'UE](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) di seguito o **Come verrà trasmessa la stringa TC?** nella [documentazione relativa alla versione 2.0 del TCF di IAB di Authorized Buyers](//support.google.com/authorizedbuyers/answer/9789378). |
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
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"/>
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.
- 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.
- 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
gdpregdpr_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.