Corrispondenza dei cookie è una funzionalità che ti consente di trovare corrispondenze con il tuo cookie, ad esempio ad esempio l'ID di un utente che ha visitato il tuo sito web, con un l'ID utente Google specifico per lo strumento di offerta e creare elenchi di utenti che possono aiutarti scelte di offerta più efficaci. Questa guida descrive i concetti utilizzati in Cookie la corrispondenza, nonché i diversi flussi di lavoro della corrispondenza dei cookie ed eventuali varianti che potrebbe avere per determinati casi d'uso.
Concetti
Che cos'è la corrispondenza dei cookie?
I proprietari di domini in genere impostano i contenuti dei cookie per gli utenti che navigano del proprio sito, utilizzati per identificare gli utenti all'interno di tale dominio. Anche se due proprietari dei domini accetterebbero di scambiare tali dati, il modello dei browser internet impedisce a uno di leggere i cookie impostati da un altro dominio.
Nel contesto della pubblicità digitale, Google identifica gli utenti mediante i cookie
che appartengono al dominio doubleclick.net
e gli offerenti
che partecipano alle offerte in tempo reale possono avere un proprio dominio in cui
identificare alcuni utenti a cui mostrare gli annunci. Corrispondenza dei cookie
consente all'offerente di abbinare i suoi cookie a quelli di Google, in modo da poter
determinare se un'impressione inviata in una richiesta di offerta è associata a uno degli
gli utenti presi di mira, riceveranno i propri dati dei cookie o un
L'ID utente Google specifico dell'offerente, che è una forma criptata
doubleclick.net
nella richiesta di offerta.
Il servizio di corrispondenza dei cookie descritto in questa guida facilita la creazione e il mantenimento dell'associazione tra il cookie di un offerente e il User-ID e consente inoltre di compilare gli elenchi di utenti.
Tabelle delle corrispondenze
Una tabella delle corrispondenze può essere utilizzata per mappare un ID o altri dati da un dominio a un'altra. Gli offerenti possono usare il Servizio di corrispondenza dei cookie per compilare il proprio alle tabelle delle corrispondenze, mappando il cookie per un determinato utente alla User-ID o per compilare una tabella delle corrispondenze ospitata da Google. Le tabelle delle corrispondenze sono necessaria affinché l'applicazione dell'offerente di un offerente possa accedere ai dati dei cookie per l'utente a cui mostrare l'impressione.
Tabelle delle corrispondenze ospitate da Google
Per semplificare la manutenzione, i miglioramenti della latenza e l'accesso ai dati corrispondenti per in determinate regioni, ti consigliamo di consentire a Google di ospitare i tuoi la tabella delle corrispondenze. Consente di specificare una stringa con codifica Base64 sicura per il web: da qui in poi denominati dati di corrispondenza ospitati, che verranno mappati ID utente Google di un determinato utente. Una volta stabilita una corrispondenza, è possibile utilizzati nei seguenti modi:
Offerte in tempo reale: nelle richieste di offerta successive per le impressioni. associati all'utente, Google ti invierà i dati di corrispondenza ospitati che che corrispondano al suo ID utente Google. Se l'endpoint delle offerte è configurato per utilizzare il protocollo RTB di Google, lo riceverete come byte decodificati il campo
BidRequest.hosted_match_data
. In OpenRTB di Google implementazione,BidRequest.user.buyeruid
restituirà questo come stringa sicura per il web con codifica Base64.Elenchi di utenti: è possibile compilare gli elenchi di utenti. con ID utente Google o dati di corrispondenza ospitati.
- Pretargeting: Puoi configurare il pretargeting in modo da ricevere solo richieste di offerta contenenti dati di corrispondenza ospitati. In questo modo puoi eliminare i contenuti meno pertinenti impressioni per gli utenti esterni allo spazio dei cookie.
Elenchi di utenti
Gli elenchi di utenti possono essere creati e gestiti con l'API Real-Time Bidding. Una volta creati, puoi completare questi elenchi con i flussi di lavoro della corrispondenza dei cookie descritto di seguito o tramite il Servizio di caricamento collettivo.
Per iniziare
Per iniziare a utilizzare la corrispondenza dei cookie, devi contattare il tuo Technical Account Manager, che può abilitare flussi di lavoro specifici e aiutarti configurare quanto segue:
- ID rete per la corrispondenza dei cookie (NID): un ID stringa che identifica in modo univoco Un account offerente per la Corrispondenza dei cookie e altre operazioni correlate.
- URL di corrispondenza dei cookie: l'URL di base per un endpoint che accetta e gestire le richieste in entrata come parte dei flussi di lavoro per la corrispondenza dei cookie. Gli offerenti possono incorporare le macro in questo URL per controllare l'ordine dei parametri passati nei flussi di lavoro Corrispondenza dei cookie.
- Tag di corrispondenza: il tag che devi inserire nel browser di un utente per la Flusso di lavoro della corrispondenza dei cookie avviato dall'offerente. Può essere pubblicato insieme agli annunci, o posizionati in proprietà web al di fuori degli annunci.
- (Facoltativo) URL report sulla corrispondenza dei cookie: nella colonna unidirezionale Flusso di lavoro per la corrispondenza dei cookie. Si tratta di un URL facoltativo che può essere fornito specificare un endpoint che riceverà i dettagli dell'errore nel caso in cui il cookie la corrispondenza non riesce tramite un reindirizzamento HTTP 302. Per impostazione predefinita, le risposte saranno inviati a questo URL se si è verificato un errore con l'operazione di corrispondenza dei cookie. ma gli offerenti possono richiedere che il reindirizzamento venga sempre inviato.
- URL Cookie Match Assist: per le piattaforme di scambio che implementano la macro flusso di lavoro di Cookie Match Assist, URL di base dell'endpoint destinato a rispondere alle richieste in arrivo.
- Quota di Cookie Match Assist: per le piattaforme di scambio che implementano il parametro flusso di lavoro di Cookie Match Assist, numero massimo di richieste che il suo URL con corrispondenza dei cookie può ricevere ogni secondo. Questo ha lo scopo di evitare che le richieste CMA sovraccarichino con i server dello scambio pubblicitario.
Macro di corrispondenza dei cookie
In uno dei flussi di lavoro di corrispondenza dei cookie supportati, l'URL con corrispondenza dei cookie di un offerente generalmente include parametri aggiunti in una nell'ordinamento non garantito. Offerenti con integrazioni che richiedono coerenza dell'ordine dei parametri possono inserire le macro nell'URL con corrispondenza dei cookie in ne garantiscono il posizionamento.
Macro supportate
Gli offerenti possono facoltativamente configurare l'URL con corrispondenza dei cookie in modo da includere uno o
più macro nel formato %%GOOGLE_<PARAM_NAME>%%
o
%%GOOGLE_<PARAM_NAME>_PAIR%%
. Le macro supportate e i relativi
i valori espansi sono:
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
Uno strumento di offerta ha un'integrazione per la corrispondenza dei cookie con un endpoint ospitato su
https://user.bidder.com.cookies
e la sua implementazione richiede
Parametri predefiniti definiti dagli offerenti oltre alla Corrispondenza dei pixel
parametri nel seguente ordine: google_push
,
google_gid
, google_cver
e
google_error
. A questo scopo, l'offerente può impostare
URL di corrispondenza dei cookie a:
https://user.bidder.com/cookies?w=0%%GOOGLE_PUSH_PAIR%%&x=1%%GOOGLE_GID_PAIR%%&y=2%%GOOGLE_CVER_PAIR%%&z=3%%GOOGLE_ERROR_PAIR%%
Quando in un secondo momento Google invierà una richiesta di corrispondenza a questo offerente, la richiesta verrà espansa in modo simile al seguente:
https://user.bidder.com/cookies?w=0&google_push=PUSH_DATA&x=1&google_gid=GOOGLE_GID&y=2&google_cver=1&z=3
Flussi di lavoro del servizio di corrispondenza dei cookie
Il servizio di corrispondenza dei cookie di Google al momento supporta tre flussi di lavoro per: diversi casi d'uso descritti di seguito.
Avviato dall'offerente: corrispondenza dei cookie bidirezionale
La corrispondenza bidirezionale dei cookie fa riferimento a un flusso di lavoro avviato dallo strumento di offerta, in cui inserisce nel browser dell'utente un tag di corrispondenza che lo indirizza a Google. Questo consente a Google e all'offerente di completare le tabelle delle corrispondenze. Di seguito è riportato un un semplice esempio di questo flusso di lavoro.
Passaggio 1: inserisci il tag di corrispondenza
Per avviare la procedura, l'offerente deve inserire il tag di corrispondenza come di cui viene eseguito il rendering nel browser dell'utente. Un semplice tag di corrispondenza che restituisce solo lo User-ID Google all'offerente può essere strutturato come segue:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />
Nel tag di corrispondenza puoi includere altri parametri da soddisfare. diversi casi d'uso. Per saperne di più su questi parametri, consulta Associa i parametri URL del tag.
Passaggio 2: Google risponde con un reindirizzamento che include i dati di corrispondenza
Il tag di corrispondenza farà sì che il servizio di corrispondenza dei cookie di Google riceva un
da parte del browser dell'utente, che emetterà un HTTP 302
reindirizzano all'URL con corrispondenza dei cookie dell'offerente. Il reindirizzamento includerà la query
parametri che specificano l'ID utente Google e il numero di versione nell'URL, e
l'offerente riceverà anche il cookie incluso nelle intestazioni delle richieste. Nella
per un URL con corrispondenza dei cookie specificato come https://ad.network.com/pixel
,
l'URL di reindirizzamento per il tag di corrispondenza semplice, come illustrato sopra, potrebbe essere simile al
seguenti:
https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
L'ID utente Google trasmesso tramite il parametro google_gid
è
una piattaforma con codifica Base64 e non riempita per il web
stringa. Per gli offerenti che scelgono di ospitare una tabella delle corrispondenze, è consigliabile che
e archiviare la stringa esatta restituita dal servizio di corrispondenza dei cookie. Nei successivi
richieste di offerta, questo corrisponderà ai valori specificati tramite BidRequest.google_user_id
nel protocollo RTB di Google o BidRequest.user.id
nel protocollo
Implementazione di OpenRTB.
La versione specificata in google_cver
indica il valore
il numero di versione per l'ID utente Google. L'ID utente Google di un determinato utente
cambiano raramente, dopodiché verranno incrementati.
Se Google rileva un errore durante l'elaborazione della tua richiesta di corrispondenza,
Verrà invece specificato il parametro google_error
.
Passaggio 3: l'offerente elabora il reindirizzamento e risponde con il pixel
L'offerente riceve un reindirizzamento all'URL di corrispondenza dei cookie, che include i parametri specificati nel primo passaggio e quelli forniti da Google secondo passaggio. Inoltre, riceverà anche il proprio cookie nella cartella HTTP intestazioni. Se l'operazione è andata a buon fine, un offerente che ospita la propria tabella delle corrispondenze il proprio cookie potrebbe corrispondere allo User-ID Google incluso nella risposta. È ha consigliato agli offerenti di memorizzare la stringa esatta restituita dalla corrispondenza dei cookie assistenza.
Se l'operazione non è andata a buon fine, l'offerente riceverà un google_error
nel reindirizzamento. Si tratta di un valore numerico che corrisponde a un diverso
stati di errore che identificano l'errore specifico. Puoi apprendere
Per ulteriori informazioni sui possibili valori di errore, fai clic qui.
Se ricevi un errore, puoi tentare di trovare di nuovo una corrispondenza per quell'utente
inserendo un nuovo tag di corrispondenza.
L'offerente deve sempre rispondere pubblicando un'immagine di pixel invisibile 1 x 1; oppure
in alternativa restituiscono una risposta HTTP 204
Nessun contenuto.
Diagramma del flusso di lavoro della corrispondenza dei cookie
Questo flusso di lavoro è illustrato nel diagramma seguente, in cui le richieste e risposte sono rappresentate da una freccia e gli elementi di dati che le accompagnano sono elencate tra parentesi.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching.png?authuser=19&hl=it)
Associa i parametri URL del tag
Parametro | Descrizione |
---|---|
google_nid |
ID rete (NID) per l'account offerente. Questo ID può essere recuperato tramite gli Offerenti risorsa. |
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 se non è presente. Il valore del parametro viene ignorato e può omettere. L'omissione del parametro genera un errore se non sono presenti cookie esiste già. |
google_no_sc |
Questo parametro è obsoleto. Questo indica all'amministratore di Google servizio di corrispondenza dei cookie che non deve impostare un cookie per l'utente se uno 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 essere 40
byte o meno. Ad esempio, |
google_redir |
Una stringa con codifica URL che un offerente può specificare se vuole indirizzare
Google deve inviare il reindirizzamento HTTP 302 all'URL codificato per
questo tag di corrispondenza. In questo modo Google può essere collocata nella parte anteriore di una
per chiamare i partner. Ciò comporterà 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 valore
il formato previsto è userlistid[,timestamp] :
Questo parametro URL può essere ripetuto per aggiungere l'utente a più elenchi. |
gdpr |
Indica che la richiesta è soggetta alle restrizioni relative ai dati GDPR
all'utilizzo delle risorse. Per ulteriori dettagli, vedi
Requisiti per il consenso degli utenti dell'UE di seguito o Impatto sulla corrispondenza dei cookie
di idoneità nel
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 ulteriori dettagli, Consulta i requisiti per il consenso degli utenti dell'UE. di seguito o Come verrà passata la stringa TC? nel 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 in
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
Sono disponibili altri parametri per il consenso nella richiesta
( Esempio: |
Oltre ai parametri di cui sopra, gli offerenti possono specificare il proprio, che
verranno aggiunti come parametri all'URL di reindirizzamento. Tieni presente che il valore
i parametri denominati con il prefisso google_
verranno ignorati perché
che sono riservate a Google per lo sviluppo futuro e la conservazione dei
parametri l'ordine non è garantito. Un tag di corrispondenza che includa l'offerente definito
possono avere il seguente aspetto:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />
Parametri URL di reindirizzamento
L'URL di reindirizzamento viene creato a partire dall'URL di base della corrispondenza dei cookie configurato per
L'account di un offerente, inclusi google_
e i parametri definiti dall'offerente
in base a quelli
specificati nel tag di corrispondenza. I seguenti google_
sono definiti i parametri di risposta:
Parametro | Descrizione |
---|---|
google_gid |
ID utente Google. Impostalo se google_cm è specificato nella richiesta e la richiesta è andata a buon fine. |
google_cver |
Versione del cookie. Impostalo 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
ricevute, significa che non sono state eseguite operazioni e che
Verranno impostati
|
google_hm |
Viene visualizzato solo se si è verificato un tentativo di scrittura nella tabella delle corrispondenze ospitata da Google non riesce. In questo caso, il valore corrisponde a uno dei seguenti codici di stato:
|
google_ula |
Stato dell'operazione di aggiunta dell'elenco utenti, ripetuta in caso di più Esempio: L'operazione
|
Scenari di esempio del flusso di lavoro della corrispondenza dei cookie
I seguenti scenari descrivono come potrebbe essere la corrispondenza dei cookie per un utente tipico che naviga in una pagina web.
Scenario 1: l'utente cancella i cookie e naviga in un sito
Gianna svuota la cache di tutti i cookie. Successivamente, visita la home page di ExampleNews.com.
Riportiamo di seguito le varie fasi:
- ExampleNews.com esegue il rendering e richiama gli annunci da Google (Ad Manager).
- Poiché l'unità pubblicitaria è idonea per l'allocazione dinamica, Google invia un'offerta richieste a FinestDSP e ad altri offerenti tramite il servizio di offerte in tempo reale.
- L'applicazione dello strumento di offerta di FinestDSP riceve ed elabora la richiesta di offerta. e invia la sua risposta all'offerta.
- Google riceve 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 l'annuncio e il tag di abbinamento di FinestDSP a Jane.
- Il tag di corrispondenza chiama Cookie Match Service di Google, specificando
Parametri
google_nid
egoogle_cm
. - Cookie Match Service legge il cookie Google di Giovanna e invia l'email
browser un reindirizzamento all'URL di corrispondenza dei cookie di FinestDSP con
Parametri
google_user_id
egoogle_cver
impostati. - Il browser di Giulia carica il reindirizzamento all'URL con corrispondenza dei cookie di FinestDSP.
- L'endpoint di corrispondenza dei cookie di FinestDSP elabora la richiesta di reindirizzamento.
che include parametri URL impostati da Google e il relativo cookie per Jane nella
Intestazioni HTTP. FinestDSP ora può memorizzare la mappatura del proprio cookie
google_user_id
nella tabella delle corrispondenze. - FinestDSP risponde al reindirizzamento con un pixel invisibile di 1 x 1.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie-matching-schematic.png?authuser=19&hl=it)
Scenario 2: utente con mappatura esistente
Una settimana dopo lo scenario 1, Gianna visita di nuovo ExampleNews.com. Ora che Jane ha sia cookie dello strumento di offerta sia di Ad Manager sul proprio computer, ecco come funziona la corrispondenza funziona.
- La pagina web viene visualizzata e Google (Ad Manager) richiede annunci che il rendering dell'immagine sulla pagina.
- Durante l'asta dell'annuncio, Google invia una richiesta di offerta agli offerenti applicabili, incluso FinestDSP.
- FinestDSP riceve la richiesta di offerta, compresi indicatori quali
google_user_id
. - FinestDSP cerca il
google_user_id
nella propria tabella delle corrispondenze, e trova il cookie associato a Jane e creato una settimana prima (nello scenario 1). - In base alle informazioni associate al cookie, lo strumento di offerta di FinestDSP logica fa un'offerta sull'impressione e vince l'asta.
- Sara potrebbe vedere un annuncio personalizzato in base ai suoi interessi, in base alle informazioni di cui dispone FinestDSP.
Avviato dall'offerente: corrispondenza dei cookie unidirezionali
La corrispondenza dei cookie unidirezionali è simile al flusso di lavoro bidirezionale,
tranne per il fatto che viene alterato in modo che solo Google ospiti e compili una corrispondenza
. Questa opzione può essere utilizzata nei casi in cui l'offerente non è autorizzato a ospitare
ID utente Google nella rispettiva tabella delle corrispondenze. Per usare questa procedura, gli offerenti
deve consentire a Google di ospitare la tabella delle corrispondenze, non può più specificare
google_cm
nelle richieste al servizio di corrispondenza dei cookie di Google; e
di conseguenza non riceverà google_gid
per compilare
la tabella delle corrispondenze. Dopo che Google ha stabilito una corrispondenza per un utente, gli offerenti possono aggiungere
a elenchi di utenti utilizzando i loro dati dei cookie. Analogamente, per le richieste di offerta
questi utenti escluderanno lo User-ID Google, ma includeranno i dati di corrispondenza ospitati. R
un semplice esempio del flusso di lavoro rivisto è riassunto nei passaggi di seguito.
Passaggio 1: inserisci il tag di corrispondenza diretto all'URL con corrispondenza dei cookie dell'offerente
Per avviare la procedura, un offerente deve inserire un tag di corrispondenza
viene eseguito nel browser dell'utente. A differenza del flusso di lavoro per gli utenti
che non si trovano in uno stato USA con restrizioni sulla privacy,
il tag di corrispondenza deve indirizzare il browser dell'utente al tuo cookie
URL corrispondente. Ad esempio, con un URL con corrispondenza dei cookie configurato come
https://ad.network.com/pixel
, avrebbe il seguente aspetto:
<img src="https://ad.network.com/pixel" />
Durante il caricamento nel browser dell'utente, verrà richiesto un pixel dalla URL con corrispondenza dei cookie. Questa richiesta conterrà il relativo cookie nell'intestazione HTTP che dovrebbe essere estratto per il passaggio successivo.
Passaggio 2: reindirizza al servizio di corrispondenza dei cookie di Google
L'endpoint di corrispondenza dei cookie dell'offerente deve reindirizzare al cookie di Google
Servizio corrispondente, incluso il parametro google_hm
compilato con
dei propri dati, sicuri per il web e con codifica Base64. L'URL di reindirizzamento potrebbe avere il seguente aspetto
seguenti:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA
Passaggio 3: il browser dell'utente viene reindirizzato al servizio di corrispondenza dei cookie di Google
Google riceverà un reindirizzamento contenente i parametri da te specificati, aggiunta al cookie di Google nelle intestazioni HTTP.
Passaggio 4: Google pubblica il pixel in caso di reindirizzamento riuscito o di errore se l'URL del report è stato specificato
Se l'operazione di corrispondenza dei cookie ha esito positivo o se non sono presenti cookie
L'URL del report corrispondente è stato specificato per l'account dell'offerente: Google
pubblicherà un pixel trasparente 1 x 1 per impostazione predefinita e il flusso di lavoro terminerà qui.
Le impressioni per questo utente nelle richieste di offerta successive includeranno
ospitati i dati di corrispondenza in BidRequest.hosted_match_data
per la
protocollo o BidRequest.user.buyeruid
per OpenRTB di Google
implementazione. Gli offerenti possono anche completare gli elenchi di utenti utilizzando i dati di corrispondenza ospitati
come hanno specificato.
Altrimenti, se si è verificato un errore, Google invia un reindirizzamento all'URL
URL del report sulla corrispondenza dei cookie con la causa dell'errore specificato nel
Parametro google_error
. Se l'URL del report sulla corrispondenza dei cookie dell'offerente
erano https://ad.network.com/report
, l'URL di reindirizzamento sarebbe
come:
<img src="https://ad.network.com/report?google_error=ERROR_ID" />
Passaggio 5. Il browser dell'utente reindirizza all'URL del report sulla corrispondenza dei cookie dell'offerente
Il browser dell'utente reindirizzerà all'URL del report sulla corrispondenza dei cookie dell'offerente.
incluso l'eventuale motivo dell'errore specificato da Google nei
Parametro google_error
. Per scoprire di più sull'interpretazione dell'errore
consulta la descrizione del parametro.
Passaggio 6: l'offerente pubblica un pixel trasparente 1 x 1
L'offerente deve rispondere pubblicando un pixel 1 x 1 trasparente alla del browser.
Diagramma del flusso di lavoro della corrispondenza dei cookie per gli utenti degli Stati Uniti con restrizioni sulla privacy
Il flusso di lavoro predefinito per gli utenti negli stati degli Stati Uniti con restrizioni sulla privacy è illustrato nel diagramma di seguito, dove richieste e risposte sono rappresentate da una freccia e i dati gli elementi che li accompagnano sono elencati tra parentesi.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_matching_ca.png?authuser=19&hl=it)
Parametri URL per il reindirizzamento dello strumento di offerta al servizio di corrispondenza dei cookie di Google
Parametro | Descrizione |
---|---|
google_nid |
ID rete (NID) per l'account offerente. Questo ID può essere recuperato tramite gli Offerenti risorsa. |
google_sc |
Questo parametro è obsoleto. Imposta il cookie di Google per se non è presente. Il valore del parametro viene ignorato e può omettere. L'omissione del parametro genera un errore se non sono presenti cookie esiste già. |
google_no_sc |
Questo parametro è obsoleto. Questo indica all'amministratore di Google servizio di corrispondenza dei cookie che non deve impostare un cookie per l'utente se uno non presente. Il valore del parametro viene ignorato e può essere omesso. |
google_hm |
Contiene i dati che l'offerente vuole memorizzare in una corrispondenza ospitata da Google . |
google_redir |
Un URL codificato per il quale vuoi che Google invii un reindirizzamento HTTP 302. La
l'URL specificato riceverà i reindirizzamenti con 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 valore
il formato previsto è userlistid[,timestamp] :
Questo parametro URL può essere ripetuto per aggiungere l'utente a più elenchi. |
gdpr |
Indica che la richiesta è soggetta alle restrizioni relative ai dati GDPR
all'utilizzo delle risorse. Per ulteriori dettagli, vedi
Requisiti per il consenso degli utenti dell'UE di seguito o Impatto sulla corrispondenza dei cookie
di idoneità nel
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 ulteriori dettagli, Consulta i requisiti per il consenso degli utenti dell'UE. di seguito o Come verrà passata la stringa TC? nel 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 in
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
Sono disponibili altri parametri per il consenso 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
ricevute, significa che non sono state eseguite operazioni e che
Verranno impostati
|
Avviata da Google: corrispondenza bidirezionale dei pixel
La corrispondenza bidirezionale dei pixel è un flusso di lavoro per la corrispondenza dei cookie di Google Servizio in cui Google tenta di abbinare un ID utente Google a un algoritmo offerente selezionato diverso dal vincitore dell'asta Offerte in tempo reale. Quando un annuncio viene inserito, Google inserirà un tag di corrispondenza che indirizzi il browser dell'utente a caricare pixel trasparente dall'URL con corrispondenza dei cookie dell'offerente scelto. Questa operazione consentirà di sia Google sia l'offerente per compilare una tabella delle corrispondenze con un determinato utente. Di seguito un semplice esempio di questo flusso di lavoro.
Passaggio 1: Google inserisce un tag di corrispondenza
Quando la pagina di un publisher partecipante viene caricata nel browser dell'utente,
area annuncio in quella pagina è riempita da Google, può essere inserito un tag di corrispondenza
richiede un pixel a un offerente selezionato tramite un algoritmo. L'abbinamento di Pixel
inserito da Google combina l'URL con corrispondenza dei cookie dell'offerente con
parametri aggiuntivi:
lo strumento di offerta può
usare per completare la tabella delle corrispondenze. Per un URL con corrispondenza dei cookie
specificato come https://ad.network.com/pixel
, è strutturato come
che segue:
<img src="https://ad.network.com/pixel?google_gid=GOOGLE_GID&google_cver=1&google_push=PUSH_DATA" />
Passaggio 2: l'offerente deve rispondere con un reindirizzamento all'URL del servizio di corrispondenza dei cookie di Google
Gli offerenti che ricevono richieste di corrispondenza dei pixel sono tenuti a rispondere con una al servizio di corrispondenza dei cookie di Google, strutturato come segue:
https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA
Tieni presente che l'URL di reindirizzamento riportato sopra è simile a quello utilizzato nei
di corrispondenza del flusso di lavoro per la corrispondenza dei cookie avviata dall'offerente.
Nella corrispondenza dei pixel, il parametro google_cm
viene sostituito dal
google_push
e il suo valore deve essere uguale al valore
forniti da Google nella richiesta. Simile a quello avviato dall'offerente
flusso di lavoro, parametri aggiuntivi
per soddisfare altri casi d'uso.
Passaggio 3: Google elabora il reindirizzamento e risponde con il pixel
Google registra che è stata creata una corrispondenza per l'utente e gestisce qualsiasi le operazioni aggiuntive richieste tramite i parametri di query. Infine, Google risponde con un pixel trasparente 1 x 1.
Diagramma del flusso di lavoro della corrispondenza dei pixel
Questo flusso di lavoro è illustrato nel diagramma seguente, in cui le richieste e risposte sono rappresentate da una freccia e gli elementi di dati che le accompagnano sono elencate tra parentesi.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/pixel_matching.png?authuser=19&hl=it)
Parametri di richiesta del tag di corrispondenza di Google
Parametro | Descrizione |
---|---|
google_gid |
ID utente Google. Per gli utenti che non si trovano in uno stato degli Stati Uniti con limitazioni sulla privacy, verrà sempre applicata questa specificato nel tag di corrispondenza di Google. |
google_cver |
La versione del cookie. Verrà sempre specificato nella corrispondenza di Google del tag. |
google_push |
Indica che questa richiesta sta avviando il flusso di lavoro della corrispondenza dei pixel. Il valore deve essere restituito tramite il parametro corrispondente nel campo risposta di reindirizzamento. |
Parametri di reindirizzamento corrispondenti Pixel offerente
Parametro | Descrizione |
---|---|
google_nid |
ID rete (NID) per l'account offerente. Questo ID può essere recuperato tramite gli Offerenti risorsa. |
google_push |
Indica che questo reindirizzamento sta completando la corrispondenza dei pixel nel tuo flusso di lavoro. Il valore del tag di corrispondenza Google corrispondente deve essere specificato qui. |
google_hm |
Contiene i dati che l'offerente vuole memorizzare in una corrispondenza ospitata da Google . |
google_ula |
Una stringa utilizzata per aggiungere l'utente a un elenco di utenti esistente. Il valore
il formato previsto è userlistid[,timestamp] :
Questo parametro URL può essere ripetuto per aggiungere l'utente a più elenchi. |
Avviata da Google: corrispondenza unidirezionale dei pixel
La corrispondenza unidirezionale dei pixel è diversa dal flusso di lavoro bidirezionale in che il tag di corrispondenza di Google non includa un parametro che specifica il parametro ma continuerà a compilare una tabella delle corrispondenze ospitata da Google. Si può usare nei casi in cui l'offerente non è autorizzato a ospitare gli ID utente Google nei propri della tua tabella delle corrispondenze. Un semplice esempio del flusso di lavoro rivisto è riassunto nel i passaggi seguenti.
Passaggio 1: Google inserisce un tag di corrispondenza
Google inserisce un tag di corrispondenza per un offerente selezionato tramite un algoritmo. Il tag di corrispondenza include
Parametro google_push
. Ecco un esempio:
<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />
Passaggio 2: il browser dell'utente richiede il pixel all'URL corrispondente di cucina dell'offerente
Il browser dell'utente richiede un pixel all'URL con corrispondenza dei cookie dell'offerente. incluso il cookie dell'offerente nelle intestazioni HTTP.
Passaggio 3: reindirizza al servizio di corrispondenza dei cookie di Google
L'endpoint di corrispondenza dei cookie dell'offerente deve reindirizzare al cookie di Google
Servizio corrispondente, incluso il parametro google_hm
compilato con
dei propri dati, sicuri per il web e con codifica Base64. L'URL di reindirizzamento potrebbe avere il seguente aspetto
seguenti:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA&google_push=PUSH_DATA
Passaggio 4: il browser dell'utente viene reindirizzato al servizio di corrispondenza dei cookie di Google
Google riceverà un reindirizzamento contenente i parametri da te specificati,
aggiunta al cookie di Google nelle intestazioni HTTP. Se l'operazione fosse
riusciti, le impressioni per questo utente nelle successive richieste di offerta includeranno
i dati di corrispondenza ospitati dell'offerente in BidRequest.hosted_match_data
per
il protocollo Google o BidRequest.user.buyeruid
per la
Implementazione di OpenRTB. Gli offerenti possono anche completare gli elenchi di utenti utilizzando
corrispondono ai dati specificati.
Infine, Google restituisce un pixel trasparente 1 x 1 al browser dell'utente.
Cookie Match Assist
Open Bidding consente alle piattaforme di scambio pubblicitario di utilizzare la funzionalità iniziata dall'offerente e Google ha avviato flussi di lavoro di corrispondenza dei cookie, per associare uno User-ID Google al relativo cookie. Per biscotti Match Assist (CMA) è una funzionalità aggiuntiva per le piattaforme di scambio pubblicitario che consente loro di creano tabelle delle corrispondenze con i propri offerenti.
Come funziona Cookie Match Assist
Quando posiziona un annuncio, Google seleziona algoritmicamente scambia e inserisce un tag Cookie Match Assist con le seguenti caratteristiche struttura:
<img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
Il tag di corrispondenza CMA di Google fa sì che l'URL con corrispondenza dei cookie della piattaforma di scambio pubblicitario per ricevere una richiesta di pixel.
- L'endpoint di corrispondenza dei cookie dello scambio riceve la richiesta, dove il proprio servizio di corrispondenza dei cookie è responsabile della corrispondenza tra ID utente e uno dei suoi offerenti. Nel diagramma seguente, la corrispondenza dei cookie della piattaforma di scambio risponde al browser dell'utente con un reindirizzamento a uno dei servizi endpoint.
- L'offerente riceve la richiesta, insieme agli eventuali parametri specificati da lo scambio in modo che associa l'ID utente al cookie.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/authorized-buyers/rtb/images/cookie_match_assist_diagram.png?authuser=19&hl=it)
Restrizioni
Limite di frequenza delle richieste per corrispondenze nuove
Gli offerenti sono responsabili di limitare il numero di chiamate al cookie Servizio di corrispondenza per gli utenti che hanno una nuova voce nella corrispondenza ospitata da Google . Una voce nella tabella delle corrispondenze ospitata può essere considerata scaduta dopo 14 giorni. dopodiché potrà essere aggiornato.
Rispondere a tutte le richieste di corrispondenza dei pixel
Gli offerenti che usano il flusso di lavoro della corrispondenza dei pixel sono tenuti a rispondere a tutti
richieste Pixel Match in arrivo con una risposta che include google_push
. In questo modo Google può applicare i criteri monitorandone l'utilizzo. Se
il tasso di risposta dell'offerente scende al di sotto del 90%, Google limiterà il numero di
Richieste di corrispondenza di Pixel inviate al suo account.
Usa endpoint HTTPS
È necessario che gli endpoint utilizzati in tutti i flussi di lavoro di corrispondenza dei cookie utilizzino HTTPS.
Quando rispondi a una richiesta Pixel Match che ti viene inviata tramite HTTPS, necessaria per il reindirizzamento al servizio di corrispondenza dei cookie tramite HTTPS. Analogamente, anche un endpoint Cookie Match Assist che reindirizza agli offerenti deve usare HTTPS. Se invii richieste a Google tramite HTTP più di una volta ogni 2 minuti, il numero di richieste di corrispondenza inviate al tuo account verrà limitato.
Requisiti per il consenso degli utenti dell'UE
Richieste di corrispondenza dei cookie soggette a Utente UE di Google Norme relative al consenso devono indicare il consenso dell'utente finale. Queste richieste sono tenute a indicano che il consenso è stato raccolto in uno dei seguenti modi:
- TCFv2: include
gdpr
egdpr_consent
parametri. Per maggiori dettagli, consulta Documentazione della versione 2.0 del TCF di IAB di Authorized Buyers. process_consent
: una dichiarazione che l'offerente ha ottenuto il consenso degli utenti necessario.
Esempi
I seguenti esempi illustrano come utilizzare il servizio Corrispondenza dei cookie per raggiungere obiettivi specifici. Tieni presente che, se non diversamente indicato, presuppone che l'utente su cui si agisce non provenga da Stato degli Stati Uniti con restrizioni sulla privacy.
Compilare una tabella delle corrispondenze ospitata dall'offerente
Un offerente può usare il flusso di lavoro Corrispondenza dei cookie per compilare la propria corrispondenza
specificando solo i valori google_nid
e google_cm
nel loro tag di corrispondenza. Potrebbe avere il seguente aspetto:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_cm" />
Se l'URL con corrispondenza dei cookie dell'offerente è impostato su https://ad.network.com/pixel?id=1
,
e l'operazione di corrispondenza dei cookie ha esito positivo, il reindirizzamento inviato da Google
la risposta al tag di corrispondenza dell'offerente potrebbe avere il seguente aspetto:
https://ad.network.com/pixel?id=1&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
Se l'operazione di corrispondenza dei cookie non riesce perché l'utente non ha una cookie di Google, la risposta sarebbe:
https://ad.network.com/pixel?id=1&google_error=3
Il codice di errore dipende dalla causa dell'errore. Per ulteriori informazioni per ulteriori informazioni sui possibili codici di errore del flusso di lavoro Corrispondenza dei cookie, consulta parametri URL di reindirizzamento.
Aggiungi a elenco utenti singolo
Il parametro google_ula
può essere specificato nella corrispondenza di un offerente
per aggiungere l'utente a un elenco di utenti con l'ID specificato. Se Google o
La tabella delle corrispondenze ospitata dallo strumento di offerta presenta una nuova voce per l'utente, che può inserire
un tag di corrispondenza che includa google_nid
e google_ula
parametri per aggiungere l'utente all'elenco specificato senza avviare l'intero
Flusso di lavoro della corrispondenza dei cookie. Consulta le limitazioni
sul richiamo del servizio di abbinamento dei cookie per ulteriori dettagli. Il corrispondente
il tag di corrispondenza potrebbe avere il seguente aspetto:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />
Per una risposta positiva, in cui l'URL con corrispondenza dei cookie dell'offerente è
https://ad.network.com/pixel
, l'URL di reindirizzamento di Google sarebbe:
https://ad.network.com/pixel?google_ula=12345,0
Se si verifica un errore generale, ad esempio, non esiste un cookie di Google
per l'utente: l'URL di reindirizzamento includerà
Parametro google_error
:
https://ad.network.com/pixel?google_error=3
Se si verifica un errore specifico relativo all'aggiunta di un utente all'elenco,
riceverai google_ula
nel reindirizzamento. A differenza del
parametro del tag di corrispondenza corrispondente, sostituisce il timestamp con uno stato
per indicare l'esito positivo dell'operazione. Ad esempio, se la richiesta non è andata a buon fine
perché l'account dell'offerente non aveva accesso all'elenco di utenti specificato,
l'URL di reindirizzamento sarebbe:
https://ad.network.com/pixel?google_ula=12345,2
Aggiungere a più elenchi di utenti
Gli offerenti possono specificare che un utente deve essere aggiunto a più elenchi di utenti tramite
includendo più parametri google_ula
nel tag di corrispondenza. Nella
questo può avere il seguente aspetto:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />
Lo stato dell'operazione per ogni elenco di utenti viene registrato in modo simile tramite
parametri google_ula
distinti nel reindirizzamento:
https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0
Dal reindirizzamento riportato sopra, possiamo vedere che l'operazione è riuscita per l'utente
elenco con ID 45678
, ma non riuscito per l'elenco utenti con ID 12345
perché l'offerente non disponeva dell'autorizzazione per accedervi.
Esegui i passaggi del flusso di lavoro della corrispondenza dei cookie e aggiungi all'elenco di utenti
Per eseguire la corrispondenza dei cookie e aggiungere l'utente a un elenco di utenti in una singola
richiesta, il tag di corrispondenza di un offerente deve includere google_cm
e
google_ula
:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345&google_cm" />
L'URL di reindirizzamento specificato da Google includerà google_gid
,
google_cver
e google_ula
. Potrebbe avere un aspetto simile
seguenti:
https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0
Memorizzare una corrispondenza in una tabella delle corrispondenze ospitata da Google
Se un offerente vuole memorizzare i dati dei propri cookie in una tabella delle corrispondenze ospitata da Google,
e non intende creare una corrispondenza tra negozio e User-ID Google nella propria corrispondenza
il tag di corrispondenza deve includere il parametro google_hm
in cui
il suo valore deve essere una stringa sicura per il web con codifica Base64. Per un utente in cui
I dati dei cookie non codificati dell'offerente sono Cookie number 1!
, il formato codificato
sarebbe Q29va2llIG51bWJlciAxIQ==
e verrebbe utilizzato in una
di corrispondenza in questo modo:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />
Per una risposta positiva, in cui l'URL con corrispondenza dei cookie dell'offerente è
https://cookie-monster.com/pixel
, l'URL di reindirizzamento di Google
potrebbe essere:
https://cookie-monster.com/pixel
Il parametro google_gid
non è nel reindirizzamento perché
il tag di corrispondenza non ha incluso google_cm
e google_hm
è
non incluse nelle risposte positive. Nelle richieste di offerta future per le impressioni
per questo utente, l'offerente riceverà i dati sulle corrispondenze ospitate
BidRequest.hosted_match_data
per il protocollo RTB di Google oppure
BidRequest.user.buyeruid
per l'implementazione di OpenRTB di Google.
Se invece l'offerente ha utilizzato un tag di corrispondenza in cui il valore
google_hm
non era codificato in base64, ad esempio
chocolate_chunk!
: l'URL di reindirizzamento potrebbe avere il seguente aspetto
seguenti:
https://cookie-monster.com/pixel?google_hm=2
L'URL di reindirizzamento riportato sopra include un valore google_hm
di
2
, suggerendo che l'operazione non sia riuscita perché il valore potrebbe
non essere decodificati.
Tabelle delle corrispondenze ospitate da Google e dello strumento di offerta con elenchi di utenti
Se un offerente ospita il proprio elenco di utilizzo oltre a un utente ospitato da Google
e desidera che un singolo tag di corrispondenza corrisponda a entrambe le tabelle e aggiunga l'utente a
un determinato elenco di utenti, il tag di corrispondenza deve includere google_cm
,
google_hm
e google_ula
. Se l'offerente
il dato dei cookie è Cookie number 1!
, il valore codificato sarebbe
Q29va2llIG51bWJlciAxIQ==
, che produrrebbe un tag di corrispondenza come
seguenti:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />
Per una risposta positiva, in cui l'URL con corrispondenza dei cookie dell'offerente è
https://cookie-monster.com/pixel
, l'URL di reindirizzamento di Google
avrà il seguente aspetto:
https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0
Alla ricezione del reindirizzamento, l'offerente può corrispondere all'ID utente Google specificato
in google_gid
con i dati dei cookie nella tabella delle corrispondenze. Nella
Inoltre, possono determinare che la tabella delle corrispondenze e l'elenco utenti
operazioni sono riuscite. Di conseguenza, qualsiasi pretargeting dell'offerente
configurato in modo da scegliere come target l'ID elenco utenti specificato ora farà sì che l'offerente
ricevere richieste di offerta per impressioni dall'utente. Allo stesso modo, in queste offerte
richieste, l'offerente riceverà i dati sulle corrispondenze ospitate
BidRequest.hosted_match_data
per il protocollo RTB di Google oppure
BidRequest.user.buyeruid
per l'implementazione di OpenRTB di Google.