Attivare la misurazione delle conversioni

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

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

Ad esempio, è comune che un publisher abbia una o più tecnologie pubblicitarie responsabili della pubblicazione dell'annuncio, ad esempio le parti responsabili della fornitura del markup per la creatività, le parti che forniscono l'impressione o il pixel di monitoraggio nella creatività e le parti che forniscono l'SDK o il tag per l'area annuncio nella pagina del publisher. Queste tecnologie pubblicitarie possono o meno voler ricevere report sull'attribuzione dall'ARA, ma sono in grado di garantire che le tecnologie pubblicitarie a valle possano ricevere questi report.

Inoltre, l'inserzionista potrebbe utilizzare anche un fornitore di servizi di misurazione delle conversioni di terze parti per l'attribuzione cross-network e altre funzionalità di generazione di report. Gli inserzionisti utilizzano questi dati per comprendere il ritorno sull'investimento pubblicitario su più publisher e canali unici, pertanto è importante che le DSP o gli ad server comprendano come attivare l'API Attribution Reporting per supportare questi casi d'uso. Gli inserzionisti che vogliono utilizzare una terza parte 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ù esperti di tecnologia pubblicitaria di registrare origini e attivatori di attribuzione per la stessa impressione o conversione e di ricevere report separati dall'API. Ad esempio, una DSP può ricevere i propri report sull'attribuzione dall'API Attribution Reporting e consentire report separati per il fornitore di servizi di misurazione di terze parti dell'inserzionista. Un fornitore di tecnologia pubblicitaria deve registrare sia le origini che gli attivatori dell'attribuzione per ricevere i report dall'API. L'attribuzione viene eseguita tra le origini e gli attivatori dell'attribuzione che il fornitore di tecnologia pubblicitaria ha registrato singolarmente nell'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 di pubblicazione sia 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 e la tecnologia pubblicitaria che ospita la creatività vuole attribuire le conversioni all'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 gli inserzionisti che si integrano con fornitori di analisi o misurazione di terze parti.

In questo caso, la tecnologia pubblicitaria di pubblicazione è anche la parte responsabile dell'attivazione di eventi di clic e impressioni nella configurazione corrente. La tecnologia pubblicitaria di pubblicazione deve impostare il nuovo attributionsrc nelle posizioni appropriate e assicurarsi che i reindirizzamenti siano configurati correttamente. Inoltre, sia la tecnologia pubblicitaria di pubblicazione sia 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 di campagna tipica potrebbe essere la seguente:

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

2. La DSP offre funzionalità per aggiungere ulteriori pixel di monitoraggio delle impressioni e dei clic per la misurazione e deve assicurarsi che attributionsrc sia incluso nel markup della creatività dell'annuncio finale con cui fa 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 ha requisiti di misurazione dell'attribuzione. Questo è comune per i publisher, le SSP o gli ad server dei publisher che ospitano le creatività e non intendono utilizzare i report sull'attribuzione, ma vogliono attivare l'API Attribution Reporting per i propri partner DSP o per società di tagging delle misurazioni come ad server di terze parti, fornitori di misurazione o analisi.

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

Nell'esempio di configurazione della campagna tipico dello scenario 1, l'ad server, la SSP o il publisher stesso potrebbero dover solo assicurarsi che l'attributo attributionsrc fornito dal DSP venga inserito nella pagina del publisher.

Dettagli di implementazione

La tabella seguente descrive a grandi linee i passaggi di implementazione dell'API Attribution Reporting:

Passaggi	Responsabilità del lavoro	Esempi
Passaggio 1: attiva l'origine dell'attribuzione per le creatività e il codice di misurazione esistenti	L'entità responsabile dell'attivazione di eventi impressione o della gestione di eventi clic aggiunge l'attributo attributionsrc.	Per gli eventi di clic, in genere l'attributo viene aggiunto da un acquirente (DSP/ad server dell'inserzionista) che esegue il rendering della creatività. Per gli eventi impressioni, 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, l'attributo viene aggiunto dal publisher e dall'SDK video.
Passaggio 2: attiva i report sull'attribuzione per le origini di terze parti	Questa operazione funziona immediatamente se utilizzi un percorso di reindirizzamento esistente con reindirizzamenti 302. Se non è possibile utilizzare i reindirizzamenti 302, l'attributo attributionsrc può essere utilizzato per elencare più server di tecnologia pubblicitaria.	In genere, purché l'attributo attributionsrc venga aggiunto alla creatività, 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 vuole ricevere report dall'API Attribution Reporting	La piattaforma DSP e il fornitore di servizi di misurazione di terze parti utilizzato dall'inserzionista

Tieni presente che le specifiche di ogni passaggio dipendono da come le creatività vengono visualizzate e pubblicate sulla pagina del publisher e da quali entità ad tech ricevono i report inviati dall'API Attribution Reporting.

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

Nel primo passaggio, le origini di attribuzione vengono attivate.

Come funziona l'attributo attributionsrc

Il nuovo attributo attributionsrc specifica la destinazione delle richieste all'API Attribution Reporting. La persona giuridica responsabile dell'attivazione degli eventi di impressione e clic deve aggiornare le creatività con l'attributo attributionsrc. 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 i reindirizzamenti, l'attributo attributionsrc deve essere aggiunto alla navigazione. Eventuali reindirizzamenti 302 dopo la navigazione non devono aggiungere l'attributo attributionsrc e saranno idonei per l'ARA purché la navigazione iniziale abbia aggiunto attributionsrc.

Quando attributionsrc è vuoto, le richieste ARA vengono inviate all'URL definito nell'attributo href del tag di ancoraggio (URL di clickthrough). Quando l'attributo attributionsrc è definito, le richieste ARA vengono inviate all'URL definito nell'attributo attributionsrc. Anche l'URL di clickthrough è idoneo per la registrazione delle origini.

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 vengano inviate a un altro server.

Esempio di attributo attributionsrc vuoto:

La tua configurazione esistente	Con l'integrazione di 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 del tag di ancoraggio.

Esempio di attributo attributionsrc non vuoto:

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

Quando attributionsrc non è vuoto, le richieste dell'API Attribution Reporting vengono inviate all'URL definito dal tag attributionsrc. Anche l'URL di clickthrough è idoneo per la registrazione delle origini.

Aggiungi attributionsrc per gli eventi di clic e impressione

• Eventi di clic:
  • L'entità responsabile dell'aggiunta del attributionsrc è in genere la tecnologia pubblicitaria di pubblicazione.
  • Ai tag di ancoraggio 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 di impressione:
  • La persona giuridica responsabile dell'aggiunta del attributionsrc è in genere la tecnologia pubblicitaria di pubblicazione e i fornitori di servizi di misurazione.
  • Gli eventi Impressione attivati dal tag <img> o dal tag <script> devono includere un attributo attributionsrc.
  • Gli eventi Impressione che utilizzano l'API Fetch devono includere un oggetto attributionReporting nell'argomento options passato alla chiamata dell'API Fetch.

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

Evento	Tag	La tua configurazione esistente	Dopo l'integrazione di 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 nelle aste Protected Audience, anziché utilizzare attributionsrc, puoi utilizzare registerAdBeacon/registerAdMacro e setReportEventDataForAutomaticBeacons/reportEvent per attivare la registrazione delle origini attribuzione.

Per generare report sugli indicatori Protected Audience, la funzione registerAdBeacon è disponibile all'interno dei worklet dei report e registerAdMacro è disponibile all'interno del worklet dei report sulle offerte vinte 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, gli indicatori dei worklet dei report Protected Audience e il payload dell'evento del frame della creatività dell'annuncio possono essere associati tra loro.

L'intestazione HTTP Attribution-Reporting-Eligible viene aggiunta alla richiesta quando i beacon e le 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 attribuzione. Le richieste dei beacon potrebbero essere reindirizzate per consentire la misurazione di terze parti.

Per approfondire, consulta la sezione Supporto per l'API Attribution Reporting della spiegazione dell'API Fenced Frame Ad Reporting.

Attivare 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 di origine idonei per la registrazione con l'API Attribution Reporting. Il Supplemento VAST per l'assistenza per i report sull'attribuzione tratta questo argomento in 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 la copertura dell'idoneità alla registrazione per questi eventi.

L'addendum VAST definisce nuovi attributi per questi elementi per 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 attiva l'evento deve utilizzare [URL] come valore dell'attributo attributionsrc quando viene attivata l'API Attribution Reporting. L'appendice VAST contiene esempi per ogni scenario.

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

Passaggio 2: attiva i report sull'attribuzione per le origini di terze parti

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

Gestire le origini di terze parti in una catena di reindirizzamento esistente

In un tipico clicthrough dell'annuncio, potrebbero essere presenti molti tracker dei clic sotto forma di una catena di reindirizzamenti 302 effettuati durante la navigazione fino alla pagina di destinazione finale. Ogni richiesta nella catena di reindirizzamento è idonea per la registrazione con l'API Attribution Reporting se il target di 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 durante i reindirizzamenti. Per le aste Protected Audience, se eventData passato a reportEvent e setReportEventDataForAutomaticBeacons deve essere utilizzato nell'ambito del reindirizzamento, deve essere trasmesso esplicitamente nell'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. La tecnologia pubblicitaria di pubblicazione in questo esempio può essere una DSP che esegue il rendering della creatività sul sito del publisher e ha un proprio prodotto di generazione di report. Il fornitore di servizi di misurazione di terze parti può essere una persona giuridica utilizzata dall'inserzionista per i report sulle conversioni.

Al momento della registrazione dell'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 l'intestazione Attribution-Reporting-Register-Source e l'intestazione Location.
   1. serving-adtech.example utilizza l'intestazione Attribution-Reporting-Register-Source per rispondere con i 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à in uso nei flussi di monitoraggio dei clic esistenti per supportare i reindirizzamenti Location a terze parti.302
3. Il browser riceve la risposta da serving-adtech.example e analizza l'intestazione Attribution-Reporting-Register-Source. Il browser memorizza l'evento di origine utilizzando serving-adtech.example come origine 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 contenente l'intestazione Attribution-Reporting-Register-Source.
6. Il browser riceve questa risposta da 3p-measurement.example e legge Attribution-Reporting-Register-Source. Il browser memorizza l'evento di origine utilizzando 3p-measurement.example come origine report.

Utilizza attributionsrc per le origini di terze parti non presenti in una catena di reindirizzamenti

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

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 registrare le origini di attribuzione.

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

Per tutte le origini che ricevono una richiesta dell'API Attribution Reporting, assicurati che il server risponda con l'intestazione Attribution-Reporting-Register-Source appropriata. Consulta la guida alla registrazione delle origini e la spiegazione per scoprire come deve essere costruita la risposta.

Registra più attivatori

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

Puoi anche registrare più attivatori da un singolo elemento del pixel utilizzando richieste di reindirizzamento o elencando più URL nell'elemento attributionsrc nello stesso modo in cui registri l'origine. Gli eventi source e gli eventi trigger generati dalle stesse origini verranno associati.