Panoramica generale dei servizi connessi per Attribution Reporting, rivolta ai responsabili delle decisioni tecniche.
L'API Attribution Reporting consente alle tecnologie pubblicitarie e agli inserzionisti di misurare quando un il clic o la visualizzazione su un annuncio genera una conversione, come un acquisto. Questa API si basa su una combinazione di integrazioni lato client e lato server, a seconda del esigenze aziendali.
Prima di continuare, assicurati di leggere Panoramica di Attribution Reporting. Questo ti aiuterà a comprendere lo scopo dell'API e il flusso dei diversi report di output. (report a livello di evento) e report di riepilogo). Se ti imbatti in termini poco familiari, consulta Glossario di Privacy Sandbox.
A chi è destinato questo articolo?
Dovresti leggere questo articolo se:
- Sei il responsabile delle decisioni tecniche di un inserzionista o di tecnologia pubblicitaria. Puoi lavorare in operazioni, DevOps, data science, IT, marketing o altri ruoli in cui prendi decisioni tecniche sull'implementazione. Ti stai chiedendo come funzionano le API per una misurazione incentrata sulla tutela della privacy.
- Sei un professionista tecnico (ad esempio uno sviluppatore, un operatore di sistema, system architect o data scientist) che configurerà gli esperimenti con questo ambiente API e servizio di aggregazione.
Questo articolo fornisce una spiegazione generale di come funzionano per l'API Attribution Reporting. Se sei un tecnico di Google, puoi sperimenta con questa API a livello locale.
Panoramica
L'API Attribution Reporting è composta da molti servizi, che richiedono requisiti specifici le configurazioni lato client e le implementazioni dei server. Per determinare cosa per iniziare:
- Prendi decisioni relative alla progettazione. Definisci le informazioni che vuoi raccogliere, identifica le conversioni che ti aspetti da una determinata campagna e determina il tipo di report da raccogliere. L'output finale è uno o entrambi i tipi di report: report a livello di evento e report di riepilogo.
Ci sono sempre due (e talvolta tre) componenti che funzionano insieme per supportare i report:
- Comunicazione dal sito web al browser. Nella
basati sui cookie, le informazioni per le conversioni
e i coinvolgimenti degli annunci sono
associato a un identificatore che consente a te o a un servizio di analisi di partecipare
questi eventi in un secondo momento. Con questa API, il browser associa le conversioni a
clic/visualizzazioni sugli annunci in base alle tue istruzioni, prima che vengano pubblicati
e analisi. Di conseguenza, il codice di rendering dell'annuncio e il monitoraggio delle conversioni devono:
- Indicare al browser le conversioni da attribuire a un determinato annuncio clic o impressioni.
- Segnala qualsiasi altro dato da includere nei report finali.
- Raccolta dei dati: È necessario un endpoint del raccoglitore ricevere i report, generati nell'interfaccia utente browser. L'output dei browser potrebbe essere uno dei due possibili report: aggregabili (criptati, utilizzati per generare report di riepilogo).
Se hai raccolto report aggregabili, è necessario un terzo componente:
- Generazione di report di riepilogo: Batch i report aggregabili e usare il servizio di aggregazione per elaborare i report per generare un report di riepilogo.
Decisioni di progettazione
Un principio chiave di Attribution Reporting sono le decisioni di progettazione iniziali. Sei tu a decidere quali dati raccogliere, in quali categorie e con quale frequenza elaborarli e i dati di Google Cloud. I report di output forniscono approfondimenti sulle tue campagne o attività.
Il report di output può essere:
- I report a livello di evento associano un determinato clic sull'annuncio o una determinata visualizzazione (sul lato annuncio) ai dati sul lato conversione. Per tutelare la privacy degli utenti limitando l'unione dell'identità utente su più siti, i dati dal lato delle conversioni sono molto limitati e i dati sono poco affidabili, il che significa che per una piccola percentuale di casi vengono inviati dati casuali anziché report reali.
- I report di riepilogo non sono legati a un evento specifico sul lato annunci. Questi report offrono dati sulle conversioni più dettagliati e la flessibilità per unire i dati su clic e visualizzazioni ai dati sulle conversioni.
La selezione del report determina i dati che dovrai raccogliere.
Puoi anche considerare l'output finale come un input per gli strumenti che utilizzi per prendere decisioni. Ad esempio, se generi report di riepilogo per determinare come molte conversioni hanno generato un valore di spesa totale, il che può aiutare il team a decidere il target della tua prossima campagna pubblicitaria per generare una spesa totale più elevata.
Una volta deciso cosa misurare, puoi impostare il lato client per l'API Attribution Reporting.
Comunicazione dal sito web al browser
![Le origini dell'attribuzione sul sito web di un publisher si collegano agli attivatori sul sito web di un inserzionista.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/attribution-sources-a-pu-b04d5ed143672.png?authuser=19&hl=it)
Flusso degli eventi di attribuzione
Supponiamo che il sito di un publisher pubblichi annunci. Ogni inserzionista o fornitore di tecnologia pubblicitaria vuole conoscere le interazioni con i propri annunci e attribuire le conversioni all'annuncio corretto. I report (entrambi a livello di evento e aggregabili) verrebbero generati nel seguente modo:
Sul sito del publisher, un elemento dell'annuncio (tag
<a>
o<img>
) è configurato con un attributo specialeattributionsrc
. Il suo valore è un URL, ad esempiohttps://adtech.example/register-source/ad_id=...
.Ecco un esempio di link che registrerà una sorgente dopo aver fatto clic:
<a href="https://shoes.example/landing" attributionsrc="http://adtech.example/register-source?..." target="_blank"> Click me</a>
Di seguito è riportato un esempio di immagine che causerà la registrazione di una fonte quando viene visualizzata:
<img href="https://advertiser.example/landing" attributionsrc="https://adtech.example/register-source?..."/>
In alternativa, invece degli elementi HTML, è possibile utilizzare le chiamate JavaScript.
Ecco un esempio di JavaScript in cui viene utilizzato
window.open()
. Tieni presente che l'URL utilizza la codifica URL per evitare problemi con i caratteri speciali.const encodedUrl = encodeURIComponent( 'https://adtech.example/attribution_source?ad_id=...'); window.open( "https://shoes.example/landing", "_blank", attributionsrc=${encodedUrl});
- Quando l'utente fa clic o visualizza l'annuncio, il browser invia una richiesta
GET
aattributionsrc
, in genere un endpoint di un inserzionista o di un fornitore di tecnologia pubblicitaria. Dopo aver ricevuto questa richiesta, l'inserzionista o il fornitore di tecnologia pubblicitaria decide di indicare al browser di registrare gli eventi di origine per le interazioni con l'annuncio, in modo che le conversioni possano essere attribuite a questo annuncio in un secondo momento. Per farlo, l'inserzionista o il fornitore di tecnologia pubblicitaria include nella risposta un'intestazione HTTP speciale. Vengono aggiunti a questi dati personalizzati dell'intestazione che forniscono informazioni sull'evento di origine (la visualizzazione o il clic sull'annuncio). Se si verifica una conversione per l'annuncio, questi dati personalizzati verranno visualizzati nel report sull'attribuzione.
In seguito, l'utente visita il sito dell'inserzionista.
In ogni pagina pertinente del sito dell'inserzionista, ad esempio una pagina di conferma dell'acquisto o una pagina del prodotto, un pixel di conversione (elemento
<img>
) o una chiamata JavaScript invia una richiesta ahttps://adtech.example/conversion?param1=...¶m2=...
.Il servizio a questo URL (in genere, l'inserzionista o il fornitore di tecnologia pubblicitaria) riceve la richiesta. Decide di categorizzarla come conversione, quindi deve chiedere al browser di registrare una conversione, ovvero di attivare un'attribuzione. Per farlo, l'inserzionista o il fornitore di tecnologia pubblicitaria include nella risposta alla richiesta di pixel un'intestazione HTTP speciale che include i dati personalizzati sulla conversione.
Il browser, sul dispositivo locale dell'utente, riceve questa risposta e associa i dati sulle conversioni all'evento sorgente originale (clic o visualizzazione sull'annuncio). Per saperne di più, consulta Associare le origini agli attivatori
Il browser pianifica l'invio di un report a
attributionsrc
. Questo report include:- I dati di configurazione dell'attribuzione personalizzata che il fornitore di tecnologia pubblicitaria o l'inserzionista ha allegato all'evento di origine nel passaggio 3.
- Il set di dati sulle conversioni personalizzati al passaggio 6.
Successivamente, il browser invia i report all'endpoint definito in
attributionsrc
, con un certo ritardo e rumore. I report aggregati sono criptati, mentre quelli a livello di evento non lo sono.
Attivatori di attribuzione (sito web dell'inserzionista)
L'attivatore di attribuzione è l'evento che indica al browser di acquisire le conversioni.
Consigliamo di acquisire le conversioni più importanti per il inserzionista, come gli acquisti. È possibile specificare più tipi di conversioni e metadati acquisiti nei report di riepilogo.
Ciò garantisce che i risultati aggregati siano dettagliati e accurati per questi eventi.
Associa le origini agli attivatori
Quando un browser riceve una risposta di attivazione di attribuzione, il browser accede spazio di archiviazione locale per trovare un'origine che corrisponda a quella dell'attivatore di attribuzione e l'URL della pagina eTLD+1.
Ad esempio, quando il browser riceve un attivatore di attribuzione
adtech.example
in shoes.example/shoes123
, il browser cerca una fonte in
spazio di archiviazione locale che corrisponde sia a adtech.example
sia a shoes.example
.
È possibile impostare filtri (o regole personalizzate) per determinare quando viene trovata una corrispondenza a un attivatore a una fonte specifica. Ad esempio, imposta un filtro per conteggiare solo le conversioni per una categoria di prodotto specifica e ignora tutte le altre categorie. Filtri e modelli di prioritizzazione consentono report sull'attribuzione più avanzati.
Se nello spazio di archiviazione locale vengono trovate più origini di attribuzione, il browser sceglie ovvero quello archiviato più di recente. In alcuni casi in cui le origini dell'attribuzione viene assegnata una priorità, il browser seleziona l'origine con il valore la priorità.
Raccolta dei dati
Insieme, un attivatore di attribuzione associato a un'origine corrispondente viene inviato come un report del browser a un endpoint di reporting su un server di proprietà della tecnologia pubblicitaria (a volte indicato come endpoint di raccolta o servizio di raccolta). Questi I report possono essere report a livello di evento o aggregabili.
Report aggregati vengono utilizzati per generare report di riepilogo. Un report aggregabile è una combinazione di dati raccolti dall'annuncio (sul sito di un publisher) e dati sulle conversioni (da sito dell'inserzionista), che viene generato e criptato dal browser su una dispositivo dell'utente prima che vengano raccolti dalla tecnologia pubblicitaria.
I report a livello di evento hanno un ritardo di 2-30 giorni. I report aggregati sono inviati con un ritardo casuale entro un'ora e gli eventi devono rientrare budget per il contributo. Queste scelte proteggono la privacy e impediscono lo sfruttamento delle azioni di qualsiasi singolo utente.
Se ti interessano solo i report a livello di evento, questa è l'ultima l'infrastruttura di cui hai bisogno. Tuttavia, se vuoi generare report di riepilogo, dovrai elaborare i report aggregabili con un servizio aggiuntivo.
Generazione di report di riepilogo
Per generare report di riepilogo, utilizza Servizio di aggregazione (gestite dalla tecnologia pubblicitaria) per elaborare i report aggregabili. The Aggregation Il servizio aggiunge rumore per proteggere la privacy degli utenti e restituisce il report di riepilogo finale.
![I report aggregati vengono raccolti, raggruppati e inviati all'ambiente di tecnologia pubblicitaria.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/aggregatable-reports-are-a0830fd543e6f.png?authuser=19&hl=it)
Dopo aver raggruppato in batch i report aggregabili, il batch viene elaborato dal Servizio di aggregazione. R coordinatore fornisce le chiavi di decrittografia solo alle versioni attestate dell'aggregazione assistenza. Il servizio di aggregazione quindi decripta i dati, aggrega e aggiungere rumore prima di restituire i risultati come report di riepilogo.
Report aggregabili in batch
Prima di elaborare i report aggregabili, questi devono essere raggruppati. Un gruppo è composta da report aggregabili strategicamente. La tua strategia riflettono probabilmente un periodo di tempo specifico (ad esempio, giornaliero o settimanale). Questo Il processo può avvenire sullo stesso server che funge da endpoint di reporting.
I batch devono contenere molti report per garantire che il rapporto tra indicatori e rumore sia elevato.
![Periodi di tempo più lunghi determinano risultati meno rumorosi.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/larger-periods-lead-les-4d4edffb3d2d6.png?authuser=19&hl=it)
I periodi di batch possono cambiare in qualsiasi momento per garantire l'acquisizione di eventi specifici in cui prevedi un volume più elevato, ad esempio una svendita annuale. Il periodo di raggruppamento può essere modificato senza dover cambiare le origini di attribuzione o gli attivatori.
Servizio di aggregazione
Il Servizio di aggregazione è responsabile dell'elaborazione dei report aggregabili per generare un report di riepilogo. I report aggregati sono criptati e possono essere letto dal servizio di aggregazione, che viene eseguito in un ambiente di esecuzione attendibile (TEE).
Il servizio di aggregazione richiede le chiavi di decriptazione al coordinator per decriptare e aggregare i dati. Una volta decriptati e aggregati, i risultati sono rumore di fondo per preservare la privacy e vengono restituiti come un report di riepilogo.
I professionisti possono generare report di testo aggregabili in chiaro testare il servizio di aggregazione in locale. In alternativa, puoi eseguire test con report criptati su AWS con Nitro Enclaves.
Passaggi successivi
Vogliamo avviare conversazioni con te per assicurarci di creare un'API che è adatto a tutti.
Parla dell'API
Come altre API Privacy Sandbox, questa API è documentata discusso pubblicamente.
Sperimenta con l'API
Puoi sperimentare e partecipare in conversazione sull'API Attribution Reporting.