La corrispondenza dei cookie è una funzionalità che consente di associare i cookie, ad esempio l'ID di un utente che ha visitato il tuo sito web, a uno User-ID di Google specifico dell'offerente e di creare elenchi di utenti che possono aiutarti a effettuare scelte di offerta più efficaci. La presente guida descrive i concetti utilizzati nella corrispondenza dei cookie, nonché i diversi flussi di lavoro per la corrispondenza dei cookie e le eventuali varianti presenti 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 limita la lettura del cookie impostato 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 alle offerte in tempo reale potrebbero avere il proprio dominio in cui
identificano un insieme di utenti che vorrebbero mostrare 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. Gli utenti riceveranno i propri dati dei cookie o
un ID utente Google specifico dell'offerente, in 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 lo User-ID di Google e consente inoltre di compilare gli elenchi di utenti.
Tabelle delle corrispondenze
È possibile utilizzare una tabella delle corrispondenze per mappare un ID o altri dati da un dominio a un altro. Gli offerenti possono usare il servizio di corrispondenza dei cookie per completare le proprie tabelle delle corrispondenze mappando i cookie di un determinato utente allo User-ID Google dell'utente oppure per completare una tabella delle corrispondenze ospitata da Google. Le tabelle delle corrispondenze sono necessarie affinché l'applicazione dello strumento di offerta di un offerente possa accedere ai dati dei cookie per l'utente a cui viene mostrata l'impressione.
Tabelle delle corrispondenze ospitate da Google
Per semplificare la manutenzione, i miglioramenti della latenza e l'accesso ai dati di corrispondenza per gli utenti in determinate regioni, è consigliabile consentire a Google di ospitare la tabella delle corrispondenze. Ciò ti consente di specificare una stringa sicura per il web con codifica Base64, di seguito denominata dati di corrispondenza ospitati, che verrà mappata allo User ID di Google per un determinato utente. Una volta stabilita una corrispondenza, può essere utilizzata nei seguenti modi:
Offerte in tempo reale: nelle successive richieste di offerta per le impressioni associate all'utente, Google ti invierà i dati sulle corrispondenze ospitate che hai abbinato al suo User-ID Google. Se il tuo endpoint di offerta è configurato per utilizzare il protocollo RTB di Google, lo riceverai come byte decodificati tramite il campo
BidRequest.hosted_match_data
. Nell'implementazione OpenRTB di Google,BidRequest.user.buyeruid
restituirà questi dati come stringa sicura per il web con codifica Base64.Elenchi di utenti: gli elenchi di utenti possono essere completati con gli ID utente Google o i dati di corrispondenza ospitati.
- Pretargeting. Puoi configurare il tuo pretargeting in modo da ricevere solo richieste di offerta contenenti dati sulle corrispondenze ospitate. Questo può essere utilizzato per eliminare le impressioni meno pertinenti per gli utenti al di fuori dello spazio dei cookie.
Elenchi di utenti
Gli elenchi di utenti possono essere creati e gestiti con l'API Real-Time Bidding. Una volta creati, puoi completare questi elenchi con i flussi di lavoro per la corrispondenza dei cookie descritti 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ò attivare flussi di lavoro specifici e aiutarti a configurare quanto segue:
- NID (Cookie Matching Network ID): un ID stringa che identifica in modo univoco l'account di un offerente per la corrispondenza dei cookie e altre operazioni correlate.
- URL di corrispondenza dei cookie: l'URL di base di un endpoint che accetterà e gestirà le richieste in entrata nell'ambito dei flussi di lavoro di corrispondenza dei cookie. Gli offerenti possono incorporare macro in questo URL per controllare l'ordine dei parametri che gli vengono passati 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 per la corrispondenza dei cookie avviato dallo strumento di offerta. Può essere pubblicata insieme agli annunci o inserita nelle proprietà web al di fuori degli annunci.
- URL del report sulla corrispondenza dei cookie (facoltativo): 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 potrebbero richiedere che il reindirizzamento venga sempre inviato.
- URL di 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 destinato a rispondere alle richieste in arrivo.
- Quota di Cookie Match Assist: per le piattaforme di scambio che implementano il flusso di lavoro di Cookie Match Assist, questo è il numero massimo di richieste che il loro URL di corrispondenza dei cookie può ricevere ogni secondo. Questo ha lo scopo di evitare che le richieste CMA sovraccarichino con le richieste i server dello scambio.
Macro di corrispondenza dei cookie
In uno qualsiasi dei flussi di lavoro della corrispondenza dei cookie supportati, di solito l'URL di corrispondenza dei cookie di un offerente presenta parametri aggiunti in un ordine non garantito. Gli offerenti con integrazioni che richiedono un ordine coerente dei parametri possono inserire macro nell'URL di corrispondenza dei cookie per garantirne il posizionamento.
Macro supportate
Gli offerenti possono facoltativamente 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 dispone di un'integrazione di corrispondenza dei cookie con un endpoint ospitato in
https://user.bidder.com.cookies
e la sua implementazione richiede
parametri definiti dallo strumento di offerta preimpostati oltre ai parametri di corrispondenza dei pixel
nel seguente ordine: google_push
,
google_gid
, google_cver
e
google_error
. A questo scopo, l'offerente può impostare
l'URL di corrispondenza dei cookie su:
https://user.bidder.com/cookies?w=0%%GOOGLE_PUSH_PAIR%%&x=1%%GOOGLE_GID_PAIR%%&y=2%%GOOGLE_CVER_PAIR%%&z=3%%GOOGLE_ERROR_PAIR%%
Quando in un secondo momento Google invia una richiesta di corrispondenza a questo offerente, questa 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 casi d'uso diversi descritti di seguito.
Avviato dallo strumento di offerta: corrispondenza bidirezionale dei cookie
La corrispondenza bidirezionale dei cookie fa riferimento a un flusso di lavoro avviato dallo strumento di offerta, in cui viene inserito nel browser dell'utente un tag di corrispondenza che lo indirizza a Google. Questo flusso di lavoro consente sia a Google che all'offerente di completare le tabelle delle corrispondenze. Di seguito è riportato un semplice esempio di questo flusso di lavoro.
Passaggio 1. Inserisci il tag di corrispondenza
Per avviare questa procedura, l'offerente deve posizionare il tag di corrispondenza in modo che venga visualizzato nel browser dell'utente. Un semplice tag di corrispondenza che restituisce solo lo User-ID Google all'offerente potrebbe 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 scoprire di più su questi parametri, consulta Parametri URL tag di corrispondenza.
Passaggio 2: Google risponde con reindirizzamento che include i dati di corrispondenza
A causa del tag di corrispondenza, il servizio di corrispondenza dei cookie di Google riceverà una richiesta dal browser dell'utente, che invierà un reindirizzamento HTTP 302
all'URL di corrispondenza dei cookie dell'offerente. Il reindirizzamento includerà parametri di query che specificano lo User-ID Google e il relativo numero di versione nell'URL e l'offerente riceverà anche il cookie incluso nelle intestazioni delle richieste. 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
Lo User-ID di Google trasmesso tramite il parametro google_gid
è una stringa senza riempimenti sicura per il web con codifica Base64. Agli offerenti che scelgono di ospitare una tabella delle corrispondenze, consigliamo di archiviare la stringa esatta restituita dal servizio di corrispondenza dei cookie. Nelle richieste di offerta successive, corrisponderà ai valori specificati tramite BidRequest.google_user_id
nel protocollo RTB di Google o BidRequest.user.id
nell'implementazione OpenRTB di Google.
La versione specificata in google_cver
indica il numero di versione numerico per lo User-ID Google. L'ID utente Google per un determinato utente
non cambierà di rado, dopodiché verrà incrementato.
Se Google rileva un errore durante l'elaborazione della richiesta di corrispondenza, verrà specificato un parametro google_error
.
Passaggio 3: 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. Riceveranno inoltre il cookie nelle intestazioni HTTP. Se l'operazione ha esito positivo, un offerente che ospita la propria tabella delle corrispondenze potrebbe associare il cookie allo User-ID Google incluso nella risposta. Consigliamo agli offerenti di archiviare 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. Si tratta di un valore numerico corrispondente a diversi stati di errore che identificano l'errore specifico che si è verificato. Puoi scoprire di più sui possibili valori di errore qui.
Se ricevi un messaggio di errore, puoi tentare di trovare una nuova corrispondenza per l'utente inserendo un nuovo tag di corrispondenza.
L'offerente deve sempre rispondere pubblicando un'immagine pixel invisibile 1 x 1 oppure
in alternativa restituire una risposta HTTP 204
Nessun contenuto.
Diagramma del flusso di lavoro di corrispondenza dei cookie
Questo flusso di lavoro è illustrato dal diagramma seguente, in cui le richieste e le risposte sono rappresentate da una freccia, mentre gli elementi di dati che le accompagnano sono elencati tra parentesi.
![](https://developers.google.cn/static/authorized-buyers/rtb/images/cookie_matching.png?authuser=7&hl=it)
Parametri URL tag di corrispondenza
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 uno non è presente. Il valore del parametro viene ignorato e può essere omesso. L'omissione del parametro determina un errore se non esiste alcun cookie. |
google_no_sc |
Questo parametro è obsoleto. Questo indica al servizio di corrispondenza dei cookie di Google che non deve impostare un cookie per l'utente se non ne è presente uno. Il valore del parametro viene ignorato e può essere omesso. |
google_hm |
Dati che l'offerente vuole memorizzare in una tabella delle corrispondenze ospitata da Google.
Il valore è una stringa sicura per il web con codifica 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 può essere messa in primo piano in una chiamata concatenata ai partner. Questo comporterà un errore se 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 GDPR relative all'utilizzo dei dati. Per maggiori dettagli, consulta la sezione
Requisiti per il consenso degli utenti dell'UE di seguito o Impatto sull'idoneità
alla corrispondenza dei cookie nella
documentazione relativa alla 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 la sezione Requisiti per il consenso degli utenti dell'UE di seguito o Come verrà 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 degli utenti finali per gli utilizzi dei dati specificati nelle
Norme relative al consenso degli utenti dell'UE di Google.
Se la richiesta non è soggetta alle Norme relative al consenso degli utenti dell'UE o se sono disponibili altri parametri per il consenso ( Esempio: |
Oltre ai parametri sopra indicati, gli offerenti possono specificare un proprio parametro, che verrà aggiunto come parametro all'URL di reindirizzamento. Tieni presente che i parametri definiti dall'offerente denominati con il prefisso google_
verranno ignorati perché vengono riservati da Google per lo sviluppo futuro e il mantenimento dell'ordine dei parametri non è garantito. Un tag di corrispondenza che include parametri definiti
dall'offerente può 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 i parametri google_
e 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. Da impostare se google_cm è specificato nella richiesta e la richiesta è andata a buon fine. |
google_cver |
Versione del cookie. Da impostare 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
ricevuto, indica che non è stata eseguita alcuna operazione 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 ha esito negativo. In questo caso, il valore corrisponde a uno dei seguenti codici di stato:
|
google_ula |
Stato dell'operazione di aggiunta elenco utenti, ripetuto se nella richiesta sono stati specificati più Esempio: L'operazione
|
Scenari di esempio del flusso di lavoro di corrispondenza dei cookie
Gli scenari riportati di seguito descrivono l'aspetto che potrebbe avere la corrispondenza dei cookie per un utente tipico che naviga su una pagina web.
Scenario 1: l'utente cancella i cookie e naviga su un sito
Jane svuota la cache di tutti i cookie. Quindi visitano la home page di ExampleNews.com.
Riportiamo di seguito le varie fasi:
- Esegue il rendering di ExampleNews.com e chiama gli annunci da Google (Ad Manager).
- Poiché l'unità pubblicitaria è idonea per l'allocazione dinamica, Google invia richieste di offerta a FinestDSP e altri offerenti tramite il servizio delle offerte in tempo reale.
- L'applicazione dello strumento di offerta di FinestDSP riceve ed elabora la richiesta di offerta e invia la risposta all'offerta.
- Google riceve risposte all'offerta dagli offerenti, inclusa la risposta di FinestDSP che specifica un annuncio con un tag di corrispondenza (pixel).
- FinestDSP vince l'asta. Google mostra a Jane l'annuncio e il tag di corrispondenza di FinestDSP.
- Il tag di corrispondenza chiama il Cookie Match Service di Google e specifica i parametri
google_nid
egoogle_cm
. - Il Cookie Match Service legge il cookie Google di Giulia e invia al browser di Giulia un reindirizzamento all'URL di corrispondenza dei cookie di FinestDSP con i parametri
google_user_id
egoogle_cver
impostati. - Il browser di Giulia carica il reindirizzamento all'URL per la 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 può ora archiviare la mappatura del cookie su
google_user_id
nella tabella delle corrispondenze. - FinestDSP risponde al reindirizzamento con un pixel invisibile di 1 x 1.
![](https://developers.google.cn/static/authorized-buyers/rtb/images/cookie-matching-schematic.png?authuser=7&hl=it)
Scenario 2: utente con mappatura esistente
Una settimana dopo lo scenario 1, Giovanna visita di nuovo ExampleNews.com. Ora che Jane ha sia cookie dello strumento di offerta sia cookie di Ad Manager sul proprio computer, ecco come funziona la corrispondenza.
- La pagina web viene visualizzata e, di conseguenza, Google (Ad Manager) richiede gli annunci da visualizzare nella pagina.
- Durante l'asta dell'annuncio, Google invia una richiesta di offerta agli offerenti applicabili, tra cui FinestDSP.
- FinestDSP riceve la richiesta di offerta, inclusi indicatori come
google_user_id
. - FinestDSP cerca il valore
google_user_id
nella 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 sull'impressione e vince l'asta.
- Jane potrebbe vedere un annuncio personalizzato in base ai suoi interessi, in base alle informazioni in possesso di FinestDSP.
Avviato dallo strumento di offerta: corrispondenza dei cookie unidirezionale
La corrispondenza unidirezionale dei cookie è simile al flusso di lavoro bidirezionale, ma è stata modificata in modo che solo Google ospiti e completi una tabella delle corrispondenze. Questa opzione può essere utilizzata nei casi in cui l'offerente non è autorizzato a ospitare
gli ID utente Google nella propria tabella delle corrispondenze. Per utilizzare questo flusso, gli offerenti devono consentire a Google di ospitare la tabella delle corrispondenze, non possono più specificare google_cm
nelle richieste al servizio di corrispondenza dei cookie di Google e di conseguenza non riceveranno google_gid
per compilare la propria tabella delle corrispondenze. Una volta che Google ha stabilito una corrispondenza per un utente, gli offerenti possono aggiungerla 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 indirizzato all'URL corrispondente dei cookie dell'offerente
Per avviare questa procedura, un offerente deve inserire un tag di corrispondenza in modo che venga visualizzato nel browser dell'utente. A differenza del flusso di lavoro per utenti che non si trovano in uno stato degli Stati Uniti con restrizioni sulla privacy, il tag di corrispondenza deve indirizzare il browser dell'utente al tuo URL di corrispondenza dei cookie. Ad esempio, un URL di corrispondenza dei cookie configurato come https://ad.network.com/pixel
, sarebbe:
<img src="https://ad.network.com/pixel" />
Durante il caricamento nel browser dell'utente, verrà richiesto un pixel dall'URL di corrispondenza dei cookie dell'offerente. Questa richiesta conterrà il cookie nell'intestazione HTTP, che dovrebbe essere estratta 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 Cookie
Matching di Google, comprensivo del parametro google_hm
compilato con i
dati dei cookie sicuri per il web con codifica Base64. 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 da te specificati, oltre al cookie di Google nelle intestazioni HTTP.
Passaggio 4: Google pubblica il pixel in caso di esito positivo o di reindirizzamento di errore se l'URL del report è specificato
Se l'operazione di corrispondenza dei cookie ha esito positivo o se non è stato specificato alcun URL del report sulla corrispondenza dei cookie per l'account dell'offerente, per impostazione predefinita Google pubblicherà un pixel trasparente 1 x 1 e il flusso di lavoro terminerà qui.
Le impressioni per questo utente nelle richieste di offerta successive includeranno i dati sulla corrispondenza ospitati dall'offerente in BidRequest.hosted_match_data
per il protocollo Google o in BidRequest.user.buyeruid
per l'implementazione OpenRTB di Google. 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 fosse https://ad.network.com/report
, l'URL di reindirizzamento sarebbe simile a:
<img src="https://ad.network.com/report?google_error=ERROR_ID" />
Passaggio 5: il browser dell'utente reindirizza all'URL del report sulle corrispondenze 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 nel
parametro google_error
. Per scoprire di più sull'interpretazione del codice di errore, consulta la descrizione dei parametri.
Passaggio 6: l'offerente pubblica un pixel trasparente 1 x 1
L'offerente deve rispondere pubblicando un pixel trasparente 1 x 1 sul browser dell'utente.
Diagramma del flusso di lavoro della corrispondenza dei cookie per gli utenti degli stati USA con restrizioni sulla privacy
Il flusso di lavoro predefinito per gli utenti negli stati degli Stati Uniti con restrizioni 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.
![](https://developers.google.cn/static/authorized-buyers/rtb/images/cookie_matching_ca.png?authuser=7&hl=it)
I parametri URL per lo strumento di offerta reindirizzano 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 uno non è presente. Il valore del parametro viene ignorato e può essere omesso. L'omissione del parametro determina un errore se non esiste alcun cookie. |
google_no_sc |
Questo parametro è obsoleto. Questo indica al servizio di corrispondenza dei cookie di Google che non deve impostare un cookie per l'utente se non ne è presente uno. Il valore del parametro viene ignorato e può essere omesso. |
google_hm |
Contiene dati che l'offerente vuole memorizzare in una tabella delle corrispondenze ospitata da Google. |
google_redir |
Un URL codificato che vuoi che Google invii un reindirizzamento HTTP 302. L'URL specificato riceverà 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 limitazioni GDPR relative all'utilizzo dei dati. Per maggiori dettagli, consulta la sezione
Requisiti per il consenso degli utenti dell'UE di seguito o Impatto sull'idoneità
alla corrispondenza dei cookie nella
documentazione relativa alla 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 la sezione Requisiti per il consenso degli utenti dell'UE di seguito o Come verrà 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 degli utenti finali per gli utilizzi dei dati specificati nelle
Norme relative al consenso degli utenti dell'UE di Google.
Se la richiesta non è soggetta alle Norme relative al consenso degli utenti dell'UE o se sono disponibili altri parametri per il consenso ( Esempio: |
I parametri URL per Google reindirizzano all'URL del report sulla corrispondenza dei cookie dell'offerente
Parametro | Descrizione |
---|---|
google_error |
Un valore intero che indica l'errore complessivo della richiesta. Quando
ricevuto, indica che non è stata eseguita alcuna operazione e che non verranno impostati altri
parametri di risposta
|
Avviata da Google: corrispondenza bidirezionale di pixel
La corrispondenza bidirezionale dei pixel è 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 per le offerte in tempo reale. Quando viene inserito un annuncio, Google inserisce un tag di corrispondenza che indirizza il browser dell'utente a caricare un pixel trasparente dall'URL di corrispondenza dei cookie dell'offerente scelto. In questo modo, sia Google che l'offerente potranno completare 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 un'area annuncio su tale pagina viene riempita 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 completare la tabella delle corrispondenze. Per un URL di corrispondenza dei cookie
specificato come https://ad.network.com/pixel
, la struttura è strutturata come
seguente:
<img src="https://ad.network.com/pixel?google_gid=GOOGLE_GID&google_cver=1&google_push=PUSH_DATA" />
Passaggio 2: l'offerente deve rispondere con il reindirizzamento all'URL del servizio di corrispondenza dei cookie di Google
Gli offerenti che ricevono richieste di corrispondenza dei pixel devono rispondere con un reindirizzamento al servizio di corrispondenza dei cookie di Google strutturato come segue:
https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA
Tieni presente che il suddetto URL di reindirizzamento è simile a quello utilizzato nel tag di corrispondenza del flusso di lavoro per la corrispondenza dei cookie attivata dallo strumento di offerta.
Nella corrispondenza dei pixel, il parametro google_cm
viene sostituito dal parametro google_push
e il suo valore deve essere uguale a quello fornito da Google nella richiesta. Analogamente al flusso di lavoro avviato dallo strumento di offerta, è possibile specificare parametri aggiuntivi per soddisfare ulteriori casi d'uso.
Passaggio 3: Google elabora il reindirizzamento e risponde con Pixel
Google registra 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 per la corrispondenza dei pixel
Questo flusso di lavoro è illustrato dal diagramma seguente, in cui le richieste e le risposte sono rappresentate da una freccia, mentre gli elementi di dati che le accompagnano sono elencati tra parentesi.
![](https://developers.google.cn/static/authorized-buyers/rtb/images/pixel_matching.png?authuser=7&hl=it)
Parametri della richiesta di tag di Google Match
Parametro | Descrizione |
---|---|
google_gid |
ID utente Google. Per gli utenti che non si trovano in uno stato degli Stati Uniti con limitazioni relative alla privacy, questo verrà sempre specificato nel tag di corrispondenza di Google. |
google_cver |
La versione dei cookie. Questo verrà sempre specificato nel tag di corrispondenza di Google. |
google_push |
Indica che questa richiesta sta avviando il flusso di lavoro per la corrispondenza dei pixel. Il valore deve essere restituito tramite il parametro corrispondente nella risposta di reindirizzamento dell'offerente. |
Parametri di reindirizzamento per la 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 flusso di lavoro per la corrispondenza dei pixel. Qui deve essere specificato il valore del tag di corrispondenza di Google corrispondente. |
google_hm |
Contiene 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. |
Avviata da Google: corrispondenza unidirezionale dei pixel
La corrispondenza dei pixel unidirezionale differisce dal flusso di lavoro bidirezionale poiché il tag di corrispondenza di Google non include un parametro che specifica lo User-ID Google, ma continuerà a compilare una tabella delle corrispondenze ospitata da Google. Questa opzione può essere utilizzata nei casi in cui l'offerente non è autorizzato a ospitare ID utente Google nella propria tabella delle corrispondenze. Un semplice esempio del flusso di lavoro rivisto è riassunto nei passaggi riportati di seguito.
Passaggio 1: Google inserisce un tag di corrispondenza
Google inserisce un tag di corrispondenza per un offerente selezionato in modo algoritmico. Il tag di corrispondenza include il
parametro google_push
. Esempio:
<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />
Passaggio 2: il browser dell'utente richiede il pixel dall'URL di cucina dell'offerente
Il browser dell'utente richiede un pixel dall'URL di corrispondenza dei cookie dell'offerente, incluso il cookie dell'offerente nelle intestazioni HTTP.
Passaggio 3: reindirizza al servizio di corrispondenza dei cookie di Google
L'endpoint di corrispondenza dei cookie dell'offerente deve reindirizzare al servizio Cookie
Matching di Google, comprensivo del parametro google_hm
compilato con i
dati dei cookie sicuri per il web con codifica Base64. 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 da te 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 sulle corrispondenze ospitate dell'offerente in BidRequest.hosted_match_data
per il Protocollo Google o in BidRequest.user.buyeruid
per l'implementazione OpenRTB di Google. Gli offerenti possono anche completare gli elenchi di utenti utilizzando i dati sulle corrispondenze ospitate che hanno specificato.
Infine, Google restituisce al browser dell'utente un pixel 1 x 1 trasparente.
Cookie Match Assist
Open Bidding consente alle piattaforme di scambio pubblicitario di utilizzare flussi di lavoro per la corrispondenza dei cookie avviati dall'offerente e da Google per associare uno User-ID di Google al relativo cookie. Cookie Match Assist (CMA) è una funzionalità aggiuntiva per le piattaforme di scambio che consente di creare tabelle delle corrispondenze con i propri offerenti.
Come funziona Cookie Match Assist
Quando inserisce 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 riceva una richiesta di pixel.
- L'endpoint di corrispondenza dei cookie della piattaforma di scambio riceve la richiesta, dove il proprio servizio di corrispondenza dei cookie è responsabile della corrispondenza tra lo User-ID e uno dei suoi offerenti. Nel diagramma seguente, il servizio di corrispondenza dei cookie della piattaforma di scambio risponde al browser dell'utente con un reindirizzamento a uno degli endpoint del suo strumento di offerta.
- L'offerente riceve la richiesta, insieme a eventuali parametri specificati dalla piattaforma di scambio pubblicitario per associare lo User-ID al cookie.
![](https://developers.google.cn/static/authorized-buyers/rtb/images/cookie_match_assist_diagram.png?authuser=7&hl=it)
Restrizioni
Limita la frequenza delle richieste per nuove corrispondenze
Gli offerenti sono responsabili di limitare il numero di chiamate al servizio Cookie Matching per gli utenti che dispongono di una nuova voce nella tabella delle corrispondenze ospitata da Google. Una voce nella tabella delle corrispondenze ospitata potrebbe essere considerata scaduta dopo 14 giorni, trascorsi i quali può essere aggiornata.
Rispondere a tutte le richieste di corrispondenza dei pixel
Gli offerenti che utilizzano il flusso di lavoro della corrispondenza di pixel devono rispondere a tutte le richieste di corrispondenza di pixel in arrivo con una risposta che includa il parametro google_push
. Ciò consente a Google di applicare i criteri monitorando l'utilizzo. Se il tasso di risposta di un offerente 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 per la corrispondenza dei cookie utilizzino il protocollo HTTPS.
Quando rispondi a una richiesta di corrispondenza di Pixel inviata tramite HTTPS, devi reindirizzare 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 due minuti, il numero di richieste con corrispondenza inviate al tuo account verrà limitato.
Requisiti relativi al 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 modi:
- Versione 2.0 del TCF: include i parametri
gdpr
egdpr_consent
. Per informazioni dettagliate, consulta la documentazione della versione 2.0 del TCF di IAB di Authorized Buyers. process_consent
: una dichiarazione secondo cui l'offerente ha ottenuto il necessario consenso degli utenti.
Esempi
Gli esempi riportati di seguito mostrano come utilizzare il servizio di corrispondenza dei cookie per raggiungere obiettivi specifici. Tieni presente che, se non diversamente indicato, si presume che l'utente interessato non provenga da 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 della corrispondenza dei cookie per completare la propria tabella delle corrispondenze fornendo solo i parametri google_nid
e google_cm
nel tag di corrispondenza. L'URL 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 ha esito positivo, il reindirizzamento che Google invia in risposta al tag di corrispondenza dell'offerente potrebbe avere il seguente aspetto:
https://ad.network.com/pixel?id=1&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
Se l'operazione di corrispondenza dei cookie non va a buon fine perché l'utente non ha un cookie di Google, la risposta sarebbe:
https://ad.network.com/pixel?id=1&google_error=3
Il codice di errore dipende dalla causa. Per scoprire di più sui possibili codici di errore per il flusso di lavoro della corrispondenza dei cookie, consulta la sezione Parametri URL di reindirizzamento.
Aggiungi all'elenco di utenti singoli
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 ospitata dall'offerente contiene una nuova voce per l'utente, lo strumento di offerta può inserire un tag di corrispondenza che includa i parametri google_nid
e google_ula
per aggiungere l'utente all'elenco specificato senza avviare l'intero flusso di lavoro della corrispondenza dei cookie. Consulta le limitazioni relative alla richiesta del servizio di corrispondenza dei cookie per ulteriori dettagli. Il tag di corrispondenza corrispondente può avere il seguente aspetto:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />
Per una risposta corretta, dove l'URL di corrispondenza dei cookie dell'offerente è
https://ad.network.com/pixel
, l'URL di reindirizzamento di Google sarebbe:
https://ad.network.com/pixel?google_ula=12345,0
Se si verifica un errore generale, ad esempio non esiste un cookie di 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 riguardante nello specifico l'aggiunta dell'utente all'elenco,
riceverai google_ula
nel reindirizzamento. A differenza del parametro tag di corrispondenza corrispondente, questo sostituisce il timestamp con un codice di stato per indicare il successo 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
Aggiungi 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, questo potrebbe avere il seguente aspetto:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />
Lo stato dell'operazione per ogni elenco utenti viene segnalato in modo simile tramite parametri google_ula
distinti nel reindirizzamento:
https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0
Nel reindirizzamento sopra riportato, l'operazione è riuscita per l'elenco utenti con ID 45678
, ma non è riuscita per l'ID elenco utenti 12345
perché l'offerente non disponeva dell'autorizzazione per accedervi.
Segui il flusso di lavoro della corrispondenza dei cookie e aggiungi all'elenco 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 includerebbe google_gid
,
google_cver
e google_ula
. Potrebbe avere il seguente aspetto:
https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0
Memorizzare una corrispondenza in una tabella delle corrispondenze ospitata da Google
Se uno strumento di offerta vuole memorizzare i dati dei cookie in una tabella delle corrispondenze ospitata da Google e non intende memorizzare le corrispondenze con lo User-ID di Google nella propria tabella delle corrispondenze, il tag di corrispondenza deve includere il parametro google_hm
, il cui 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 valore codificato è Q29va2llIG51bWJlciAxIQ==
, che viene utilizzato in un tag di corrispondenza come il seguente:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />
Per una risposta corretta, se l'URL di corrispondenza dei cookie dell'offerente è https://cookie-monster.com/pixel
, l'URL di reindirizzamento di Google sarebbe:
https://cookie-monster.com/pixel
Il parametro google_gid
non è incluso nel reindirizzamento perché il tag di corrispondenza non includeva google_cm
e google_hm
non è incluso nelle risposte riuscite. Nelle richieste di offerta future per le impressioni
di questo utente, l'offerente riceverà i dati di corrispondenza ospitati in
BidRequest.hosted_match_data
per il protocollo RTB di Google o
BidRequest.user.buyeruid
per l'implementazione OpenRTB di Google.
Se lo strumento di offerta ha utilizzato invece 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
pari a 2
, che indica che l'operazione non è riuscita perché non è stato possibile decodificare il valore.
Tabelle delle corrispondenze ospitate da offerenti e da Google con elenchi di utenti
Se un offerente ospita il proprio elenco di utenti 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 è 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 corretta, dove l'URL di corrispondenza dei cookie dell'offerente è https://cookie-monster.com/pixel
, l'URL di reindirizzamento di Google avrebbe il seguente aspetto:
https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0
Quando riceve il reindirizzamento, l'offerente può associare lo User-ID Google specificato
in google_gid
ai dati dei cookie nella tabella delle corrispondenze. Inoltre, è possibile determinare che le operazioni relative alla tabella delle corrispondenze e all'elenco utenti ospitata da Google sono riuscite. Di conseguenza, qualsiasi pretargeting che l'offerente ha configurato per scegliere come target l'ID elenco utenti specificato ora farà sì che l'offerente riceva richieste di offerta per le impressioni dall'utente. Analogamente, in queste richieste di offerta, l'offerente riceverà i dati sulla corrispondenza ospitata in
BidRequest.hosted_match_data
per il protocollo RTB di Google o
BidRequest.user.buyeruid
per l'implementazione OpenRTB di Google.