Attiva la misurazione delle conversioni

La misurazione dell'attribuzione delle conversioni può coinvolgere più parti, ad esempio il publisher, l'inserzionista, la tecnologia pubblicitaria per la pubblicazione dell'annuncio (l'entità che pubblica l'annuncio), il fornitore di servizi di misurazione e altro ancora. In questo documento illustriamo scenari comuni di misurazione delle conversioni, ma in generale chiunque voglia ricevere un report sull'attribuzione dall'API Attribution Reporting (ARA) deve assicurarsi di seguire i passaggi di integrazione descritti in questo documento.

Ad esempio, è normale che un publisher abbia una o più tecniche pubblicitarie responsabili della pubblicazione dell'annuncio. Queste potrebbero includere le parti responsabili della fornitura del markup per la creatività, le parti che forniscono l'impressione o il pixel di monitoraggio sulla creatività e quelle che forniscono l'SDK o il tag per l'area annuncio sulla pagina del publisher. Questi tecnici pubblicitari potrebbero volere o meno ricevere report sull'attribuzione dall'ARA, ma sono posizionati per garantire che i tecnici pubblicitari downstream possano ricevere questi report.

Inoltre, l'inserzionista potrebbe utilizzare anche un fornitore di servizi di misurazione delle conversioni di terze parti per l'attribuzione su più reti e per altre funzionalità di generazione di report. Gli inserzionisti utilizzano questi dati per valutare il ritorno sull'investimento pubblicitario di più publisher e canali unici, pertanto è importante che le DSP o gli ad server capiscano come abilitare l'API Attribution Reporting per supportare questi casi d'uso. Gli inserzionisti che vogliono avvalersi di terze parti possono continuare a farlo utilizzando un fornitore di servizi di misurazione di terze parti o configurando un server interno per registrare e ricevere report dall'API.

L'API Attribution Reporting consente a più tecnologie pubblicitarie di registrare le origini dell'attribuzione e gli attivatori per la stessa impressione o conversione e ricevere report separati dall'API. Ad esempio, una DSP può ricevere i propri report sull'attribuzione dall'API Attribution Reporting, nonché consentire report separati per il fornitore di servizi di misurazione di terze parti dell'inserzionista. Per ricevere report dall'API, un ad tech deve registrare sia le origini di attribuzione sia gli attivatori. L'attribuzione avviene tra le origini dell'attribuzione e gli attivatori che la tecnologia pubblicitaria ha registrato singolarmente con l'API.

Scenari comuni di misurazione delle conversioni

In questa sezione, esamineremo due scenari comuni per la misurazione delle conversioni.

Scenario 1: sia la tecnologia pubblicitaria che pubblica gli annunci che il fornitore di servizi di misurazione di terze parti devono ricevere report dall'API Attribution Reporting

Un inserzionista vuole attribuire le conversioni all'inventario pubblicitario utilizzando un fornitore di servizi di misurazione di terze parti, mentre la tecnologia pubblicitaria che ospita la creatività intende attribuire le conversioni sull'inventario pubblicitario. Questo è comune per le DSP o gli ad server degli inserzionisti (ad server di terze parti 3PAS) che forniscono il markup per le creatività degli annunci, eseguono i propri report sull'attribuzione e collaborano con inserzionisti che si integrano con fornitori di servizi di misurazione o analisi di terze parti.

In questo caso, la tecnologia pubblicitaria per la pubblicazione è anche la parte responsabile dell'attivazione degli eventi di clic e impressioni nella configurazione corrente. La tecnologia pubblicitaria per la pubblicazione deve impostare il nuovo attributionsrc nelle posizioni appropriate e assicurarsi che i reindirizzamenti siano configurati correttamente. Inoltre, sia la tecnologia pubblicitaria per la pubblicazione che il fornitore di servizi di misurazione di terze parti devono assicurarsi di essere registrati e che i loro server siano pronti a ricevere e rispondere alle richieste dell'API Attribution Reporting.

Una configurazione tipica di una campagna potrebbe avere il seguente aspetto:

1. L'ad server dell'inserzionista (3PAS) fornisce il markup per la creatività dell'annuncio al DSP, che include i pixel di monitoraggio delle impressioni e dei clic del fornitore di servizi di misurazione di terze parti. L'ad server deve garantire che attributionsrc sia incluso nel markup della creatività dell'annuncio.

2. La DSP offre la possibilità di aggiungere ulteriori pixel di monitoraggio dei clic e impressioni di misurazione e deve assicurarsi che attributionsrc sia incluso nel markup finale della creatività dell'annuncio con cui sta facendo offerte.

Scenario 2: solo il fornitore di servizi di misurazione di terze parti deve ricevere i report dall'API Attribution Reporting

Un inserzionista vuole attribuire le conversioni all'inventario pubblicitario utilizzando un fornitore di servizi di misurazione di terze parti, ma la tecnologia pubblicitaria che ospita la creatività non prevede requisiti di misurazione dell'attribuzione. Questo è comune per publisher, SSP o ad server dei publisher che ospitano creatività e non prevedono di utilizzare i report sull'attribuzione autonomamente, ma che vogliono attivare l'API Attribution Reporting per i propri partner DSP o per società di tagging di misurazione come ad server di terze parti, fornitori di servizi di misurazione o analisi.

In questo caso, la parte responsabile dell'attivazione degli eventi di clic e impressioni nella configurazione attuale deve aggiungere il nuovo attributo attributionsrc alle creatività e assicurarsi che i reindirizzamenti funzionino come previsto. Questo dipende molto dall'integrazione di ciascun publisher, ma per gli eventi di clic, potrebbe trattarsi dell'SSP, della pubblicazione di tecnologia pubblicitaria o del publisher stesso. Per gli eventi relativi alle impressioni, di solito è il fornitore di servizi di misurazione di terze parti.

Nell'esempio di configurazione della campagna tipico dello scenario 1, l'ad server del publisher, la piattaforma SSP o il publisher stesso potrebbero dover semplicemente assicurarsi che l'attributo attributionsrc fornito dalla DSP raggiunga la pagina del publisher.

Dettagli di implementazione

La seguente tabella descrive i passaggi ad alto livello di implementazione dell'API Attribution Reporting:

Passaggi	Responsabilità del lavoro	Esempi
Passaggio 1: attiva l'origine attribuzione per le creatività e il codice di misurazione esistenti	L'entità responsabile dell'attivazione degli eventi di impressione o della gestione degli eventi di clic aggiunge l'attributo attributionsrc.	Per gli eventi di clic, in genere un acquirente (ad server dell'inserzionista/DSP) che esegue il rendering della creatività aggiunge l'attributo. Per gli eventi di impressione, la Demand-Side Platform (DSP), la Supply-Side Platform (SSP), il publisher, l'ad server o un fornitore di servizi di misurazione aggiungono l'attributo, che dipende dalla configurazione del publisher. Per gli annunci video che utilizzano il formato VAST, il publisher e l'SDK video aggiungono l'attributo.
Passaggio 2: attiva Attribution Reporting per origini di terze parti	Questa opzione è immediata se utilizzi un percorso di reindirizzamento esistente con reindirizzamenti 302. Se non è possibile utilizzare i reindirizzamenti 302, è possibile usare l'attributo attributionsrc per elencare più server ad tech.	In genere, se alla creatività viene aggiunto l'attributo attributionsrc, i reindirizzamenti di terze parti dovrebbero ricevere le chiamate all'API Attribution Reporting.
Passaggio 3: configura le risposte per le richieste dell'API Attribution Reporting	Qualsiasi entità che voglia ricevere report dall'API Attribution Reporting	La piattaforma DSP e il fornitore di servizi di misurazione di terze parti utilizzati dall'inserzionista.

Tieni presente che le specifiche di ogni passaggio dipendono dal modo in cui le creatività vengono visualizzate e pubblicate sulla pagina del publisher e da quali entità della tecnologia pubblicitaria ricevono i report inviati dall'API Attribution Reporting.

Importante: il fornitore di servizi di misurazione di terze parti deve assicurarsi di essere registrato e che i suoi server siano pronti a ricevere e rispondere alle richieste dell'API Attribution Reporting.

Passaggio 1: attiva l'origine attribuzione per le creatività e il codice di misurazione esistenti

Nel primo passaggio, vengono attivate le origini dell'attribuzione.

Come funziona l'attributo attributionsrc

Il nuovo attributo attributionsrc specifica dove verranno inviate le richieste dell'API Attribution Reporting. L'entità responsabile dell'attivazione degli eventi di impressioni e clic deve aggiornare le creatività con l'attributo attributionsrc. Il campo attributionsrc deve essere aggiunto agli eventi di clic e impressioni esistenti e può essere vuoto o non vuoto.

Per gli eventi di clic che utilizzano reindirizzamenti, è necessario aggiungere l'attributo attributionsrc alla navigazione. Eventuali reindirizzamenti 302 successivi alla navigazione non devono aggiungere l'attributo attributionsrc e saranno idonei per l'ARA se durante la navigazione iniziale è stato aggiunto attributionsrc.

Quando il campo attributionsrc è vuoto, le richieste ARA vengono inviate all'URL definito nell'attributo href dell'anchor tag (URL di clickthrough). Una volta definito l'attributo attributionsrc, le richieste ARA verranno inviate all'URL definito nell'attributo attributionsrc. L'URL di clickthrough è idoneo anche per la registrazione delle sorgenti.

In genere, utilizza un attributo attributionsrc vuoto se il server che ospita l'URL di clickthrough può ricevere e rispondere alle richieste dell'API Attribution Reporting. Definisci il tuo URL attributionsrc se vuoi che le richieste dell'API Attribution Reporting vadano a un server diverso.

Esempio di attributo attributionsrc vuoto:

La tua configurazione esistente	Con integrazione ARA
<a href="[CLICKTHROUGH_URL]">...</a>	<a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>

Quando l'attributo attributionsrc è vuoto, le richieste dell'API Attribution Reporting vengono inviate all'URL definito dall'attributo href dell'anchor tag.

Esempio di attributo attributionsrc non vuoto:

La tua configurazione esistente	Con integrazione ARA
<a href="[CLICKTHROUGH_URL]">...</a>	<a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a>

Se il campo attributionsrc non è vuoto, le richieste dell'API Attribution Reporting vengono inviate all'URL definito dal tag attributionsrc. L'URL di clickthrough è idoneo anche per la registrazione delle sorgenti.

Aggiungi attributionsrc per eventi di clic e impressioni

• Eventi di clic:
  • La persona giuridica responsabile dell'aggiunta di attributionsrc è in genere la tecnologia pubblicitaria per la pubblicazione.
  • Agli anchor tag con eventi di clic deve essere aggiunto un attributo attributionsrc.
  • I clic che utilizzano window.open devono utilizzare l'argomento windowFeatures della chiamata window.open per specificare l'origine dell'attribuzione.
• Eventi relativi alle impressioni:
  • La persona giuridica responsabile dell'aggiunta di attributionsrc è in genere la tecnologia pubblicitaria per la pubblicazione e il fornitore o i fornitori di servizi di misurazione.
  • Gli eventi di impressioni attivati dal tag <img> o dal tag <script> devono includere un attributo attributionsrc.
  • Gli eventi di impressioni che utilizzano l'API Fetch devono includere un oggetto attributionReporting nell'argomento opzioni passato alla chiamata API fetch.

Consulta la seguente tabella per il riepilogo delle modifiche necessarie per gli eventi di clic e impressioni:

Evento	Tag	La tua configurazione esistente	Dopo l'integrazione ARA
Clic	HTML	<a href="[CLICKTHROUGH_URL]">...</a>	<a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
	JavaScript	window.open("[CLICKTHROUGH_URL]", "_blank");	window.open("[CLICKTHROUGH_URL]", "_blank", "attributionsrc");
Impressione	Tag HTML <img>	<img src="[IMPRESSION_URL]">	<img src="[IMPRESSION_URL]" attributionsrc>
	Tag HTML <script>	<script src="[IMPRESSION_URL]"></script>	<script src="[IMPRESSION_URL]" attributionsrc></script>
	JavaScript	const options = {...} window.fetch("[IMPRESSION_URL]", options);	const options = {   attributionReporting: {     eventSourceEligible: true,     triggerEligible: false,   },   ... }; window.fetch("[IMPRESSION_URL]", options);

Attivare la registrazione dell'origine dell'attribuzione in un'asta Protected Audience

Per misurare le conversioni in un'asta Protected Audience, anziché utilizzare attributionsrc, puoi utilizzare registerAdBeacon/registerAdMacro e setReportEventDataForAutomaticBeacons/reportEvent per attivare la registrazione delle origini di attribuzione.

Per generare report sugli indicatori di Protected Audience, la funzione registerAdBeacon è disponibile all'interno dei worklet di reporting e registerAdMacro è disponibile all'interno del worklet di reporting per le vittorie dell'acquirente. Successivamente, i dati sugli eventi all'interno del frame dell'annuncio possono essere aggiunti ai beacon e alle macro registrati con le funzioni reportEvent e setReportEventDataForAutomaticBeacons dell'API Fenced Frame Ads Reporting. In questo modo è possibile associare tra loro gli indicatori dei worklet dei report di Protected Audience e il payload dell'evento del frame della creatività dell'annuncio.

L'intestazione HTTP Attribution-Reporting-Eligible viene aggiunta alla richiesta quando beacon e macro vengono attivati dalla chiamata reportEvent da un frame o quando i beacon automatici vengono attivati dal browser. Puoi utilizzare la risposta del beacon per registrare un'origine dell'attribuzione. Le richieste di beacon potrebbero essere reindirizzate per consentire la misurazione di terze parti.

Nota: l'API Fenced Frame Ads Reporting è disponibile sia in iframe sia in un frame protetto

Per un'analisi più approfondita, consulta la sezione Supporto per i report sull'attribuzione nell'articolo esplicativo dell'API Fenced Frame Ad Reporting.

Attiva i report sull'attribuzione per i formati VAST

VAST è un formato comune per la pubblicazione e la misurazione dell'inventario pubblicitario video e molti degli eventi definiti in questo standard devono essere considerati potenziali eventi sorgente idonei per la registrazione con l'API Attribution Reporting. L'appendice VAST per il supporto di Attribution Reporting tratta questo argomento nel dettaglio, ma, in breve, tutti gli eventi <Tracking>, <Impression>, <*ClickThrough> e <*ClickTracking> sono potenziali eventi di origine dell'attribuzione. Tutte le implementazioni VAST devono fornire una copertura dell'idoneità alla registrazione per questi eventi.

L'appendice VAST definisce nuovi attributi per questi elementi al fine di consentire l'impostazione di un URL secondario specifico per la registrazione dell'attribuzione. Quando un evento contiene attributiontype="DOUBLE_PING" e attributionsrc="[URL]", il codice che lo attiva deve utilizzare [URL] come valore dell'attributo attributionsrc quando attivi l'API Attribution Reporting. L'appendice VAST contiene esempi per ogni scenario.

Per garantire la massima copertura, le implementazioni VAST devono rendere tutti gli eventi elencati idonei per la registrazione quando vengono attivati i ping degli eventi. Ad esempio, quando attivi un URL di evento <Impression>, l'attributo attributionsrc (vuoto) deve essere utilizzato nell'elemento <img> utilizzato per inviare la richiesta (o l'equivalente nella chiamata di recupero), per consentire sempre alla parte ricevente di registrare potenzialmente quell'evento con l'API Attribution Reporting.

Passaggio 2: attiva Attribution Reporting per origini di terze parti

Per consentire a terze parti di utilizzare l'API Attribution Reporting, puoi usare i reindirizzamenti esistenti o aggiungere un elenco di terze parti all'attributo attributionsrc. Nella maggior parte dei casi, ciascuna tecnologia pubblicitaria dispone del proprio tracker delle impressioni indipendente, quindi i reindirizzamenti sono più pertinenti per i tracker dei clic.

Gestire origini di terze parti in una catena di reindirizzamento esistente

In un tipico clickthrough dell'annuncio, molti tracker dei clic possono essere presenti come una catena di reindirizzamenti 302 effettuati durante la navigazione alla pagina di destinazione finale. Ogni richiesta nella catena di reindirizzamento è idonea per la registrazione con l'API Attribution Reporting se il target del clic originale è stato annotato con attributionsrc o registrato con registerAdBeacon/registerAdMacro nell'API Protected Audience. Anche la tecnologia pubblicitaria nella catena di reindirizzamento deve essere registrata.

Tieni presente che il corpo della richiesta iniziale non viene inviato nei reindirizzamenti. Per le aste Protected Audience, se eventData trasmesso a reportEvent e setReportEventDataForAutomaticBeacons deve essere utilizzato come parte del reindirizzamento, deve essere trasmesso esplicitamente come parte dell'URL di reindirizzamento.

Nel seguente esempio, utilizzeremo una tecnologia pubblicitaria per la pubblicazione (serving-adtech.example) e un fornitore di servizi di misurazione di terze parti (3p-measurement.example) come due entità distinte che vogliono generare e ricevere report sull'attribuzione. In questo esempio, la tecnologia pubblicitaria per la pubblicazione può essere una DSP che esegue il rendering della creatività sul sito del publisher e che dispone di un proprio prodotto per la generazione di report. Il fornitore di servizi di misurazione di terze parti può essere un'entità utilizzata dall'inserzionista per i report sulle conversioni.

Al momento della registrazione all'origine, vengono eseguiti i seguenti passaggi:

1. serving-adtech.example imposta l'attributo attributionsrc nella creatività. L'utente visita la pagina del publisher e il browser invia una richiesta a serving-adtech.example..
2. serving-adtech.example risponde con le intestazioni Attribution-Reporting-Register-Source e Location.
   1. serving-adtech.example utilizza l'intestazione Attribution-Reporting-Register-Source per rispondere con metadati relativi all'origine da registrare.
   2. serving-adtech.example utilizza l'intestazione Location per includere un reindirizzamento a 3p-measurement.example. Tieni presente che è probabile che l'intestazione Location sia già utilizzata nei tuoi flussi di monitoraggio dei clic esistenti per supportare i reindirizzamenti 302 a una terza parte.
3. Il browser riceve la risposta da serving-adtech.example e analizza l'intestazione Attribution-Reporting-Register-Source. Il browser archivia l'evento di origine, utilizzando serving-adtech.example come origine del report.
4. Poiché questa richiesta è un reindirizzamento, il browser invia anche una nuova richiesta a 3p-measurement.example.
5. 3p-measurement.example risponde con una risposta che contiene l'intestazione Attribution-Reporting-Register-Source.
6. Il browser riceve questa risposta da 3p-measurement.example e legge Attribution-Reporting-Register-Source. Il browser archivia l'evento di origine, utilizzando 3p-measurement.example come origine del report.

Utilizza attributionsrc per origini di terze parti non incluse in una catena di reindirizzamento

Se più origini di segnalatori vogliono registrare una sorgente per un evento di navigazione, ma per qualsiasi motivo non possono essere visualizzate in una catena di reindirizzamento, puoi elencare più siti come origini di attribuzione in attributionsrc come soluzione alternativa.

La tua configurazione esistente	Con modifica ARA
<a href="[CLICKTHROUGH_URL]">...</a>	<a href="[CLICKTHROUGH_URL]" attributionsrc="[REPORTING_URL_1] [REPORTING_URL_2]">...</a>

In questo esempio, le richieste idonee per l'API Attribution Reporting verranno inviate sia a REPORTING_URL_1 sia a.REPORTING_URL_2. La richiesta di navigazione inviata all'URL di clickthrough è idonea anche per la registrazione delle origini di attribuzione.

Avviso: queste richieste vengono inviate solo sui browser che supportano l'API Attribution Reporting e potrebbero andare perse negli ambienti non supportati.

Passaggio 3: configura le risposte per le richieste dell'API Attribution Reporting

Per tutte le origini che ricevono una richiesta all'API Attribution Reporting, assicurati che il server risponda con l'intestazione Attribution-Reporting-Register-Source appropriata. Consulta la guida Registra fonti e l'spiegazione per scoprire come strutturare la risposta.

Registra più trigger

Puoi registrare più attivatori di attribuzione aggiungendo più elementi pixel sul lato conversione (uno per attivatore). L'elemento attributionsrc è facoltativo per la registrazione dell'attivatore.

Puoi anche registrare più attivatori da un singolo elemento pixel utilizzando richieste di reindirizzamento o elencando più URL nell'elemento attributionsrc come per la registrazione dell'origine. Verranno abbinati gli eventi di origine e gli eventi trigger generati dalle stesse origini.