Questa pagina è stata tradotta dall'API Cloud Translation.

Attribution Reporting: panoramica completa del sistema
bookmark_border Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Panoramica generale dei servizi collegati 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 esigenze della tua attività.

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 di riepilogo). Se trovi termini non familiari, 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'azienda di 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 architetto di sistema o un data scientist) che configurerà esperimenti con questa API e questo ambiente di servizio di aggregazione.

Questo articolo fornisce una spiegazione generale e completa del funzionamento dei servizi per l'API Attribution Reporting. Se sei un professionista tecnico, puoi eseguire esperimenti con questa API a livello locale.

Panoramica

L'API Attribution Reporting è composta da molti servizi che richiedono configurazioni lato client, implementazioni del server e configurazioni specifiche. Per determinare ciò di cui hai bisogno, innanzitutto:

Prendere decisioni di design. Definisci le informazioni che vuoi raccogliere, identifica le conversioni che prevedi 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 lavorano insieme per supportare i report:

Comunicazione tra sito web e browser. Nei sistemi basati su 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/alle visualizzazioni degli annunci in base alle tue istruzioni prima che vengano inviate per l'analisi. Pertanto, il codice di rendering degli annunci e il monitoraggio delle conversioni devono:
- Indica al browser quali conversioni devono essere attribuite a quali clic o impressioni degli annunci.
- Indica eventuali altri dati da includere nei report finali.
Raccolta dei dati. Per ricevere i report generati nei browser degli utenti, è necessario un endpoint del collector. L'output dei browser può essere uno di due possibili report: report a livello di evento e report aggregabili (che sono criptati e utilizzati per generare report di riepilogo).

Se hai raccolto report aggregabili, ti servirà un terzo componente:

Generare report di riepilogo. Raggruppa i report aggregabili e utilizza il Servizio di aggregazione per elaborarli e generare un report di riepilogo.

Decisioni di design

Un principio fondamentale di Attribution Reporting è prendere decisioni di progettazione iniziali. Sei tu a decidere quali dati raccogliere, in quali categorie e con quale frequenza elaborarli. 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 (lato annuncio) ai dati relativi alle conversioni. Per preservare la privacy degli utenti limitando l'unione dell'identità utente tra i siti, i dati lato conversione sono molto limitati e contengono molto rumore (ovvero, in una piccola percentuale di casi, vengono inviati dati casuali anziché report reali).
I report di riepilogo non sono associati a un evento specifico lato annuncio. Questi report offrono dati sulle conversioni più dettagliati e flessibilità per unire i dati su clic e visualizzazioni con i 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 il numero di conversioni che hanno generato un determinato valore di spesa totale, il tuo team potrebbe decidere il target della prossima campagna pubblicitaria per generare una spesa totale più elevata.

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

Comunicazione tra sito web e browser

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

Flusso di eventi di attribuzione

Immagina un sito del 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:

Sul sito del publisher, un elemento 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 sorgente dopo aver fatto clic:
```
<a href="https://shoes.example/landing" 
  attributionsrc="http://adtech.example/register-source?..."
  target="_blank">
Click me</a>
```
Ecco un esempio di immagine che causerà la registrazione di una sorgente quando viene visualizzata:
```
<img href="https://advertiser.example/landing" 
  attributionsrc="https://adtech.example/register-source?..."/>
```
In alternativa, anziché gli elementi HTML, è possibile utilizzare le chiamate JavaScript.

Ecco un esempio di codice 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});
```

Quando l'utente fa clic sull'annuncio o lo visualizza, il browser invia una richiesta GET a attributionsrc, in genere un endpoint di un inserzionista o di un fornitore di tecnologia pubblicitaria.
Una volta ricevuta questa richiesta, l'inserzionista o il fornitore di tecnologia pubblicitaria decide di indurre 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 questo header vengono associati dati personalizzati che forniscono informazioni sull'evento di origine (clic o visualizzazione dell'annuncio). Se alla fine si verifica una conversione per questo annuncio, questi dati personalizzati verranno visualizzati nel report sull'attribuzione.
In un secondo momento, 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 di prodotto, un pixel di conversione (elemento <img>) o una chiamata JavaScript invia una richiesta a https://adtech.example/conversion?param1=...&param2=....
Il servizio all'URL in questione, in genere l'inserzionista o il fornitore di tecnologia pubblicitaria, riceve la richiesta. Decide di classificarla 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.
Il browser sul dispositivo locale dell'utente riceve questa risposta e associa i dati di conversione all'evento di origine originale (clic o visualizzazione dell'annuncio). Scopri di più nella sezione Associare le sorgenti agli attivatori
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 associato all'evento sorgente nel passaggio 3.
2. Il set di dati sulle conversioni personalizzate nel passaggio 6.
Successivamente, il browser invia i report all'endpoint definito in attributionsrc, con un po' di ritardo e rumore. I report aggregabili sono criptati, mentre quelli a livello di evento no.

Attivatori di attribuzione (sito web dell'inserzionista)

L'attivatore dell'attribuzione è l'evento che indica al browser di acquisire le conversioni.

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

In questo modo, i risultati aggregati sono dettagliati e accurati per questi eventi.

Abbinare le origini agli attivatori

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 attivatore di attribuzione da adtech.example su shoes.example/shoes123, cerca una sorgente nello spazio di archiviazione locale che corrisponda sia a adtech.example sia a shoes.example.

I filtri (o le regole personalizzate) possono essere impostati 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 della priorità consentono di generare report sull'attribuzione più avanzati.

Se nello spazio di archiviazione locale vengono trovate più origini di attribuzione, il browser sceglie quella memorizzata 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 corrispondente a un'origine corrispondente, viene inviato dal browser sotto forma di report 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 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 publisher) e di 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 sono in ritardo di 2-30 giorni. I report aggregabili vengono inviati con un ritardo casuale entro un'ora e gli eventi devono rientrare nel budget dei contributi. Queste scelte tutelano la privacy e impediscono lo sfruttamento delle azioni di ciascun utente.

Se ti interessano solo i report a livello di evento, questo è l'ultimo componente di 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, 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.

I report aggregabili vengono raccolti, raggruppati e inviati all'ambiente ad tech. — Questo diagramma rappresenta il flusso asincrono dei dati dall'endpoint di raccolta, dai report aggregati, fino all'elaborazione nel Servizio di aggregazione 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. Il servizio di aggregazione decripta quindi i dati, li aggrega e aggiunge rumore prima di restituire i risultati sotto forma di report di riepilogo.

Report aggregabili raggruppati

Prima di essere elaborati, i report aggregabili devono essere raggruppati. Un batch è costituito da report aggregabili raggruppati in modo strategico. Molto probabilmente la tua strategia rifletterà un periodo di tempo specifico (ad esempio giornaliero o settimanale). Questa procedura può essere eseguita sullo stesso server che funge da endpoint per i report.

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

Periodi di tempo più lunghi generano risultati meno rumorosi. — Confronta l'attesa di 1 giorno e 1 settimana. Dopo un'ora, avrai un valore di riepilogo inferiore con risultati probabilmente più rumorosi. In un giorno, avrai un valore di riepilogo più elevato, quindi è probabile che sia meno "rumoroso".

I periodi di batch possono essere modificati in qualsiasi momento per assicurarti di acquisire eventi specifici in cui prevedi un volume più elevato, ad esempio per una svendita annuale. Il periodo di raggruppamento può essere modificato senza dover modificare le origini o gli attivatori 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 ambiente di esecuzione attendibile (TEE).

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

Gli addetti ai lavori possono generare report in testo normale aggregabili per testare il servizio di aggregazione in 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 sia adatta a tutti.

Discutere dell'API

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

Sperimenta con l'API

Puoi eseguire esperimenti e partecipare alla conversazione sull'API Attribution Reporting.