Attribution Reporting: panoramica completa del sistema

Panoramica generale dei servizi connessi per Attribution Reporting, rivolta ai responsabili delle decisioni tecniche.

L'API Attribution Reporting consente agli inserzionisti e alle tecnologie pubblicitarie di misurare quando un clic o una visualizzazione sull'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 esigenze aziendali.

Prima di continuare, assicurati di leggere la panoramica dei report sull'attribuzione. Ciò 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 che non conosci, consulta il glossario di Privacy Sandbox.

A chi è rivolto questo articolo?

Ti consigliamo di leggere questo articolo se:

  • Sei un responsabile delle decisioni tecniche di un inserzionista o di una tecnologia pubblicitaria. Puoi occuparti di operazioni, DevOps, data science, IT, marketing o un altro ruolo in cui prendi decisioni di implementazione tecnica. Ti stai chiedendo come funzionano le API per una misurazione incentrata sulla tutela della privacy.
  • Sei un professionista tecnico (ad es. sviluppatore, operatore di sistema, architetto di sistema o data scientist) che configurerà gli esperimenti con questa API e questo ambiente di Aggregation Service.

In questo articolo, 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 una configurazione specifica, configurazioni lato client e deployment dei server. Per determinare cosa ti serve, innanzitutto:

  • Prendi decisioni in materia di progettazione. Definisci le informazioni che vuoi raccogliere, identifica le conversioni che ti aspetti da una determinata campagna e determina quale tipo di report raccogliere. L'output finale è uno o entrambi i tipi di report: report a livello di evento e report di riepilogo.

Esistono sempre due (e talvolta tre) componenti che supportano i report:

  • Comunicazioni dal sito web al browser. Nei sistemi basati sui cookie, le informazioni per le conversioni e il coinvolgimento degli annunci sono associate a un identificatore che consente a te o a un servizio di analisi di partecipare a questi eventi in un secondo momento. Con questa API, il browser associa le conversioni ai clic/visualizzazioni sugli annunci, in base alle tue istruzioni, prima che vengano inviate per l'analisi. Di conseguenza, il codice di rendering dell'annuncio e il monitoraggio delle conversioni devono:
    • Indica al browser quali conversioni attribuire a quali clic sugli annunci o impressioni.
    • Segnala eventuali altri dati da includere nei report finali.
  • Raccolta dati. Avrai bisogno di un endpoint raccoglitore per ricevere i report generati nei browser degli utenti. L'output dai browser potrebbe essere uno dei due possibili report: report a livello di evento e report aggregabili (che sono criptati, utilizzati per generare report di riepilogo).

Se raccogli report aggregabili, avrai bisogno di un terzo componente:

Decisioni di progettazione

Un principio chiave dei report sull'attribuzione sono le decisioni di progettazione iniziali. Sei tu a decidere quali dati raccogliere, in quali categorie e con quale frequenza trattarli. I report di output forniscono informazioni sulle campagne o sull'attività.

Il report di output può essere:

  • I report a livello di evento associano una determinata visualizzazione o clic sull'annuncio (sul lato annuncio) ai dati sul lato conversione. Per preservare la privacy degli utenti limitando l'unione delle identità degli utenti tra i siti, i dati sul lato delle conversioni sono molto limitati e non sono attendibili, vale a dire che per una piccola percentuale di casi vengono inviati dati casuali invece di report reali.
  • I report di riepilogo non sono collegati a un evento specifico sul lato annuncio. 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 dei report determina i dati da raccogliere.

Puoi anche pensare all'output finale come a un input per gli strumenti che utilizzi per prendere decisioni. Ad esempio, se generi report di riepilogo per determinare quante conversioni hanno generato un valore di spesa totale, questo può aiutare il tuo team a decidere quale targeting per la tua prossima campagna pubblicitaria per generare una spesa totale più elevata.

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

Comunicazione dal sito web al browser

Le origini di attribuzione sul sito web di un publisher si connettono agli attivatori sul sito web di un inserzionista.
Le origini dell'attribuzione sul sito web di un publisher si connettono agli attivatori sul sito di un inserzionista.

Flusso degli eventi di attribuzione

Immagina il sito di un publisher che mostra annunci. Ogni inserzionista o fornitore di tecnologia pubblicitaria vuole ottenere informazioni sulle interazioni con i propri annunci e attribuire le conversioni all'annuncio corretto. I report (sia a livello di evento che aggregabili) saranno generati come segue:

  1. Sul sito del publisher, un elemento dell'annuncio (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 registra una fonte una volta selezionato:

    <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, al posto degli elementi HTML, possono essere utilizzate chiamate JavaScript.

    Ecco un esempio di JavaScript che utilizza window.open(). Tieni presente che l'URL è codificato in modo da 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});
  1. Quando un utente fa clic o visualizza l'annuncio, il browser invia una richiesta GET a attributionsrc, in genere un endpoint dell'inserzionista o del fornitore di tecnologia pubblicitaria.

  2. 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 sua risposta un'intestazione HTTP speciale. Vengono associati a questa intestazione i dati personalizzati che forniscono informazioni sull'evento di origine (visualizzazione o clic sull'annuncio). Se si verifica una conversione per l'annuncio in questione, questi dati personalizzati verranno mostrati nel report sull'attribuzione.

    Visualizza o fai clic su un annuncio.

  3. In seguito, l'utente visita il sito dell'inserzionista.

  4. 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=....

  5. Il servizio a questo URL, che in genere è l'inserzionista o il fornitore di tecnologia pubblicitaria, riceve la richiesta. Decide di classificare questa conversione come conversione, quindi deve indicare al browser di registrare una conversione allo scopo 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 dati personalizzati sulla conversione.

  6. Il browser, sul dispositivo locale dell'utente, riceve questa risposta e abbina i dati sulle conversioni all'evento di origine originale (visualizzazione o clic sull'annuncio). Scopri di più nella pagina Abbinare le origini agli attivatori

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

    1. I dati sulla configurazione dell'attribuzione personalizzata che il fornitore di tecnologia pubblicitaria o l'inserzionista ha associato all'evento di origine nel passaggio 3.
    2. Il set di dati sulle conversioni personalizzati al passaggio 6.
    Una conversione.

  8. In seguito, il browser invia i report all'endpoint definito in attributionsrc, con un certo ritardo e rumore. I report aggregati sono criptati, mentre i report a livello di evento no.

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 l'inserzionista, come gli acquisti. Nei report di riepilogo è possibile acquisire più tipi di conversione e metadati.

Ciò garantisce che i risultati aggregati siano dettagliati e accurati per questi eventi.

Associa le origini agli attivatori

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

Ad esempio, quando il browser riceve un attivatore di attribuzione da adtech.example su shoes.example/shoes123, cerca un'origine nello spazio di archiviazione locale che corrisponda sia a adtech.example sia a shoes.example.

Puoi impostare filtri (o regole personalizzate) per determinare quando un trigger viene associato a una sorgente 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 report sull'attribuzione più avanzati.

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

Raccolta dei dati

Insieme, un attivatore di attribuzione abbinato a un'origine corrispondente vengono inviati come report dal browser a un endpoint di reporting su un server di proprietà dell'ad tech (talvolta indicato come endpoint di raccolta o servizio di raccolta). Questi report possono essere report a livello di evento o report aggregabili.

I 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 (dal sito dell'inserzionista) che vengono generati e criptati dal browser sul dispositivo di un utente prima di essere raccolti dalla tecnologia pubblicitaria.

I report a livello di evento vengono ritardati da 2 a 30 giorni. I report aggregati vengono inviati con un ritardo casuale entro un'ora e gli eventi devono rientrare nel budget per il contributo. Queste scelte proteggono la privacy e impediscono lo sfruttamento delle azioni di singoli utenti.

Se ti interessano solo i report a livello di evento, questa è l'ultima 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 dell'utente e restituisce il report di riepilogo finale.

I report aggregati vengono raccolti, raggruppati e inviati all&#39;ambiente ad tech.
Questo diagramma rappresenta il flusso asincrono di dati dall'endpoint di raccolta, il raggruppamento dei report in batch, l'elaborazione su Aggregation Service di proprietà della tecnologia pubblicitaria.

Dopo aver raggruppato i report aggregabili raccolti, il batch viene elaborato dal servizio di aggregazione. Un coordinatore fornisce le chiavi di decrittografia solo alle versioni attestate del servizio di aggregazione. Aggregation Service poi decripta i dati, li aggrega e aggiunge rumore prima di restituire i risultati come report di riepilogo.

Report aggregabili raggruppati

Prima di essere elaborati, i report aggregabili devono essere raggruppati. Un batch è costituito da report aggregabili strategicamente raggruppati. È molto probabile che la strategia rifletta un periodo di tempo specifico (ad esempio giornaliero o settimanale). Questa procedura può avvenire sullo stesso server che funge da endpoint di reporting.

I batch devono contenere molti report per garantire che il rapporto segnale-rumore sia elevato.

Periodi di tempo più lunghi portano a risultati meno rumorosi.
Confronta l'attesa di 1 giorno e 1 settimana. In 1 ora avrai un valore di riepilogo più basso e probabilmente risultati più "con rumore". In un giorno riceverai un valore di riepilogo più elevato, che quindi è probabile che sia meno rumoroso.

I periodi batch possono cambiare in qualsiasi momento per garantire l'acquisizione di eventi specifici a cui prevedi un volume più elevato, ad esempio una svendita annuale. Il periodo di raggruppamento in batch può essere modificato senza dover cambiare le origini o gli attivatori di attribuzione.

Servizio di aggregazione

Il servizio di aggregazione si occupa dell'elaborazione dei report aggregabili per generare un report di riepilogo. I report aggregati sono criptati e possono essere letti solo da Aggregation Service, che viene eseguito in un ambiente di esecuzione affidabile (TEE, Trusted Execution Environment).

Aggregation Service richiede chiavi di decrittografia al coordinatore per decriptare e aggregare i dati. Una volta decriptati e aggregati, i risultati vengono inclusi con il rumore per preservare la privacy e restituiti come report di riepilogo.

I professionisti possono generare report aggregabili in chiaro per testare il servizio di aggregazione a livello locale. 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.

Discuti 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.