Attribution Reporting: panoramica completa del sistema

Panoramica di alto livello dei servizi connessi per i report sull'attribuzione, rivolta ai responsabili delle decisioni tecniche.

L'API Attribution Reporting consente alle tecnologie pubblicitarie e agli inserzionisti di misurare quando un clic o una visualizzazione dell'annuncio genera una conversione, ad esempio un acquisto. Questa API si basa su una combinazione di integrazioni lato client e lato server, a seconda delle tue esigenze aziendali.

Prima di continuare, assicurati di leggere la panoramica dei report sull'attribuzione. In questo modo, potrai comprendere lo scopo dell'API e il flusso dei diversi report di output (report a livello di evento e report riepilogativi). Se incontri termini sconosciuti, consulta il glossario di Privacy Sandbox.

A chi è rivolto questo documento?

Devi leggere questo documento se:

• Sei il responsabile delle decisioni tecniche di una tecnologia pubblicitaria o di un inserzionista. Potresti lavorare in operazioni, DevOps, data science, IT, marketing o in un altro ruolo in cui prendi decisioni di implementazione tecnica. Ti stai chiedendo come funzionano le API per la misurazione nel rispetto della privacy.
• Sei un professionista tecnico (ad esempio uno sviluppatore, un operatore di sistema, un system architect o un data scientist) che configurerà gli esperimenti con questo ambiente API e del servizio di aggregazione.

In questo documento troverai una spiegazione generale e completa del funzionamento dei servizi per l'API Attribution Reporting. Se sei un professionista tecnico, puoi sperimentare con questa API a livello locale.

Panoramica

L'API Attribution Reporting è composta da molti servizi che richiedono configurazioni specifiche lato client e deployment del server. Per determinare di cosa hai bisogno, per prima cosa:

• Prendere decisioni di design. Definisci le informazioni da 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.

Esistono sempre due (e a volte tre) componenti che collaborano per supportare la generazione di report:

• Comunicazione tra sito web e browser. Nei sistemi basati sui cookie, le informazioni relative alle conversioni e ai coinvolgimenti con gli annunci vengono associate a un identificatore che consente a te o a un servizio di analisi di unire questi eventi in un secondo momento. Con questa API, il browser associa le conversioni ai clic/visualizzazioni degli annunci, in base alle tue istruzioni, prima che vengano inviate per l'analisi. Pertanto, il codice di rendering dell'annuncio e il monitoraggio delle conversioni devono:
  • Indica al browser quali conversioni devono essere attribuite a quali clic o impressioni degli annunci.
  • Segnala eventuali altri dati da includere nei report finali.
• Raccolta dei dati. Per ricevere i report generati nei browser degli utenti, è necessario un endpoint del raccoglitore. L'output dei browser potrebbe essere uno dei due report possibili: report a livello di evento e report aggregabili (criptati, utilizzati per generare report di riepilogo).

Se hai raccolto report aggregabili, avrai bisogno di un terzo componente:

• Generazione di report di riepilogo. Elabora i report aggregabili in batch e utilizza il servizio di aggregazione per elaborarli e generare un report di riepilogo.

Decisioni di progettazione

Un principio fondamentale di Attribution Reporting sono le decisioni di progettazione iniziali. Decidi quali dati raccogliere in quali categorie e con quale frequenza trattarli. I report di output forniscono approfondimenti sulle tue campagne o sulla tua attività.

Il report di output può essere:

• I report a livello di evento associano un determinato clic o visualizzazione dell'annuncio (sul lato annuncio) ai dati sul lato conversione. Per preservare la privacy degli utenti limitando l'unione dell'identità utente tra i siti, i dati lato conversione sono molto limitati e rumorosi (il che significa che per una piccola percentuale di casi vengono inviati dati casuali anziché report reali).
• I report di riepilogo non sono associati a un evento specifico sul lato annuncio. Questi report offrono dati sulle conversioni più dettagliati e flessibilità per unire i dati sui clic e sulle visualizzazioni con i dati sulle conversioni.

La selezione del report determina i dati che dovrai raccogliere.

Puoi anche considerare l'output finale come input per gli strumenti che utilizzi per prendere decisioni. Ad esempio, se generi report di riepilogo per determinare il numero di conversioni che hanno portato a un determinato valore di spesa totale, ciò può aiutare il tuo team a decidere a cosa deve puntare la prossima campagna pubblicitaria per generare una spesa totale più elevata.

Una volta deciso cosa vuoi misurare, puoi configurare il lato client per l'API Attribution Reporting.

Comunicazione tra sito web e browser

Flusso di eventi di attribuzione

Immagina un sito publisher che mostra 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 (sia a livello di evento che aggregabili) verranno generati come segue:

1. Sul sito del publisher, un elemento pubblicitario (tag <a> o <img>) è configurato con un attributo speciale attributionsrc. Il suo valore è un URL, ad esempio https://adtech.example/register-source/ad_id=....

   Ecco un esempio di link che registrerà una sorgente una volta cliccato:

   <a href="https://shoes.example/landing"
     attributionsrc="http://adtech.example/register-source?..."
     target="_blank">
   Click me</a>
   

   Ecco un esempio di immagine che, una volta visualizzata, causerà la registrazione di una fonte:

   <img href="https://advertiser.example/landing"
     attributionsrc="https://adtech.example/register-source?..."/>
   

   In alternativa, anziché elementi HTML, è possibile utilizzare chiamate JavaScript.

   Ecco un esempio di JavaScript che utilizza window.open(). Tieni presente che l'URL è codificato 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}`);
   

2. Quando l'utente fa clic o visualizza l'annuncio, il browser invia una richiesta GET a attributionsrc, in genere un endpoint di un inserzionista o di un fornitore di tecnologia pubblicitaria.

3. Una volta ricevuta questa richiesta, l'inserzionista o il fornitore di tecnologia pubblicitaria decide di istruire il browser a registrare gli eventi di origine per le interazioni con l'annuncio, in modo che le conversioni possano essere attribuite in un secondo momento a questo annuncio. A questo scopo, l'inserzionista o il fornitore di tecnologia pubblicitaria include nella risposta un'intestazione HTTP speciale. A questa intestazione vengono allegati dati personalizzati che forniscono informazioni sull'evento di origine (il clic o la visualizzazione dell'annuncio). Se alla fine si verifica una conversione per questo annuncio, questi dati personalizzati verranno visualizzati nel report sull'attribuzione.

   

4. Successivamente, l'utente visita il sito dell'inserzionista.

5. Su ogni pagina pertinente del sito dell'inserzionista, ad esempio una pagina di conferma dell'acquisto o una pagina di prodotto, un pixel di conversione (elemento <img>) o una chiamata JavaScript invia una richiesta a https://adtech.example/conversion?param1=...&param2=....

6. Il servizio all'URL, in genere l'inserzionista o il fornitore di tecnologia pubblicitaria, riceve la richiesta. Decide di classificarlo come conversione, quindi deve indicare al browser di registrare una conversione, ovvero di attivare un'attribuzione. A questo scopo, l'inserzionista o il fornitore di tecnologia pubblicitaria include nella risposta alla richiesta del pixel un'intestazione HTTP speciale che include dati personalizzati sulla conversione.

7. Il browser sul dispositivo locale dell'utente riceve questa risposta e abbina i dati di conversione all'evento di origine originale (clic o visualizzazione dell'annuncio).

8. Il browser pianifica l'invio di un report a attributionsrc. Questo report include:

   1. I dati di configurazione dell'attribuzione personalizzata che il fornitore di tecnologia pubblicitaria o l'inserzionista ha allegato all'evento sorgente nel passaggio 3.
   2. Il set di dati sulle conversioni personalizzate al passaggio 6.

   

9. Successivamente, il browser invia i report all'endpoint definito in attributionsrc, con un po' di ritardo e rumore. I report aggregabili sono criptati, mentre i report a livello di evento non lo sono.

Attivatori dell'attribuzione (sito web dell'inserzionista)

Il trigger di attribuzione è l'evento che indica al browser di acquisire le conversioni.

Ti consigliamo di acquisire le conversioni più importanti per l'inserzionista, ad esempio gli acquisti. Nei report di riepilogo possono essere acquisiti più tipi di conversione e metadati.

In questo modo si verifica che i risultati aggregati siano dettagliati e accurati per questi eventi.

Abbinare le origini ai trigger

Quando un browser riceve una risposta all'attivatore dell'attribuzione, accede allo spazio di archiviazione locale per trovare una sorgente che corrisponda sia all'origine dell'attivatore dell'attribuzione sia all'eTLD+1 dell'URL della pagina.

Ad esempio, quando il browser riceve un trigger di attribuzione da adtech.example il giorno shoes.example/shoes123, cerca un'origine nello storage locale che corrisponda sia a adtech.example che a shoes.example.

È possibile impostare filtri (o regole personalizzate) per determinare quando un attivatore corrisponde a un'origine specifica. Ad esempio, imposta un filtro per conteggiare solo le conversioni per una categoria di prodotto specifica e ignorare tutte le altre categorie. I filtri e i modelli di assegnazione delle priorità consentono di generare report sull'attribuzione più avanzati.

Se nello spazio di archiviazione locale vengono trovate più origini dell'attribuzione, il browser sceglie quella memorizzata più di recente. In alcuni casi in cui alle origini dell'attribuzione viene assegnata una priorità, il browser selezionerà l'origine con la priorità più alta.

Raccolta dei dati

Insieme, un trigger di attribuzione abbinato a un'origine corrispondente vengono inviati come report dal browser a un endpoint di reporting su un server di proprietà di una tecnologia pubblicitaria (a volte chiamato endpoint di raccolta o servizio di raccolta). Questi report possono essere report a livello di evento o aggregabili.

I report aggregabili vengono utilizzati per generare report di riepilogo. Un report aggregabile è una combinazione di dati raccolti dall'annuncio (sul sito di un editore) e dati sulle conversioni (dal sito dell'inserzionista) che viene generata e criptata dal browser sul dispositivo di un utente prima di essere raccolta dalla tecnologia pubblicitaria.

I report a livello di evento vengono ritardati di 2-30 giorni. I report aggregabili vengono inviati con un ritardo casuale entro un'ora e gli eventi devono rientrare nel budget di 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, questo è l'ultimo elemento dell'infrastruttura di cui hai bisogno. Tuttavia, se vuoi generare report di riepilogo, dovrai elaborare i report aggregabili con un servizio aggiuntivo.

Generazione del report di riepilogo

Per generare report di riepilogo, utilizzerai il servizio di aggregazione (gestito dalla tecnologia pubblicitaria) per elaborare i report aggregabili. Il servizio di aggregazione aggiunge rumore per proteggere la privacy degli utenti e restituisce il report di riepilogo finale.

Report aggregabili batch

Prima di essere elaborati, i report aggregabili devono essere raggruppati in batch. Un batch è costituito da report aggregabili raggruppati in modo strategico. La tua strategia rifletterà molto probabilmente un periodo di tempo specifico (ad esempio giornaliero o settimanale). Questo processo può avvenire sullo stesso server che funge da endpoint di reporting.

I batch devono contenere molti report per garantire un rapporto segnale/rumore elevato.

I periodi dei batch possono cambiare in qualsiasi momento per assicurarti di acquisire eventi specifici in cui prevedi un volume più elevato, ad esempio per una vendita annuale. Il periodo di raggruppamento può essere modificato senza dover cambiare le origini o i trigger dell'attribuzione.

Servizio di aggregazione

Il servizio di aggregazione è responsabile dell'elaborazione dei report aggregabili per generare un report di riepilogo. I report aggregabili sono criptati e possono essere letti solo dal servizio di aggregazione, che viene eseguito in un Trusted Execution Environment (TEE).

Il servizio di aggregazione richiede le chiavi di decrittografia al coordinatore per decrittografare e aggregare i dati. Una volta decriptati e aggregati, i risultati vengono resi rumorosi per preservare la privacy e restituiti come report di riepilogo.

I professionisti possono generare report in formato cleartext aggregabili per testare il servizio di aggregazione localmente. In alternativa, puoi eseguire test con report criptati su AWS con Nitro Enclaves.

Passaggi successivi

Vogliamo interagire con te per assicurarci di creare un'API che funzioni per tutti.

Discutere dell'API

Come altre API Privacy Sandbox, questa API è documentata e discussa pubblicamente.

Sperimenta con l'API

Puoi sperimentare e partecipare alla conversazione sull'API Attribution Reporting.