Attiva la misurazione delle conversioni

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

Ad esempio, accade di solito che un publisher abbia uno o più ad tech responsabili della pubblicazione dell'annuncio. Potrebbero essere incluse le parti responsabili della fornitura del markup della creatività, le parti che forniscono l'impressione o il pixel di monitoraggio della creatività e le parti che forniscono l'SDK o il tag per l'area annuncio sulla pagina del publisher. Questi tecnici pubblicitari potrebbero voler ricevere o meno i report sull'attribuzione dall'ARA, ma si trovano in una posizione tale da garantire che le tecnologie pubblicitarie downstream possano ricevere i report sull'attribuzione.

Inoltre, l'inserzionista potrebbe anche utilizzare un fornitore di servizi di misurazione delle conversioni di terze parti per l'attribuzione su più reti e altre funzionalità di generazione dei report. Gli inserzionisti utilizzano questi dati per comprendere il ritorno sull'investimento pubblicitario per più publisher e canali unici, perciò è importante che le DSP o gli ad server capiscano 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 la registrazione e la ricezione dei report dall'API.

L'API Attribution Reporting consente a più tecnologie pubblicitarie di registrare le origini e gli 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, nonché consentire report separati per il fornitore di servizi di misurazione di terze parti dell'inserzionista. Una tecnologia pubblicitaria deve registrare sia le origini di attribuzione sia gli attivatori per ricevere report dall'API. L'attribuzione avviene tra le origini e gli attivatori di attribuzione che la tecnologia pubblicitaria ha registrato individualmente 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 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 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 inserzionisti che si integrano con fornitori di servizi di misurazione o analisi di terze parti.

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

  1. L'ad server dell'inserzionista (3PAS) fornisce il markup per la creatività dell'annuncio alla 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 assicurarsi che attributionsrc sia incluso nel markup della creatività dell'annuncio.

  2. La DSP offre la possibilità di aggiungere ulteriori pixel di monitoraggio delle impressioni e dei clic di misurazione e deve assicurarsi che attributionsrc sia incluso nel markup finale della creatività dell'annuncio per il quale fa offerte.

Scenario 2: solo il fornitore di servizi di misurazione di terze parti deve 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, ma la tecnologia pubblicitaria che ospita la creatività non ha requisiti di misurazione dell'attribuzione. Si tratta di un comportamento comune per publisher, SSP o ad server dei publisher che ospitano creatività e non intendono utilizzare i report sull'attribuzione autonomamente, ma che vogliono attivare l'API Attribution Reporting per i propri partner DSP o per le aziende di tagging di misurazione, ad esempio ad server di terze parti e fornitori di servizi di misurazione o analisi.

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

Nell'esempio di configurazione tipico della campagna nello scenario 1, l'ad server del publisher, la SSP o il publisher potrebbero semplicemente dover verificare che l'attributo attributionsrc fornito dalla DSP sia inserito nella pagina del publisher.

Dettagli di implementazione

La tabella seguente descrive a livello generale i passaggi per implementare l'API Attribution Reporting:

Procedura 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 degli eventi di impressioni o della gestione degli eventi di clic aggiunge l'attributo attributionsrc. Per gli eventi di clic, in genere un acquirente (ad server DSP/inserzionista) che esegue il rendering della creatività aggiunge l'attributo.

Per gli eventi di impressioni, Demand-Side Platform (DSP), Supply-Side Platform (SSP), publisher, 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 soluzione è pronta all'uso 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, a condizione che 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 voglia ricevere report dall'API Attribution Reporting La DSP e il fornitore di servizi di misurazione di terze parti utilizzato dall'inserzionista

Tieni presente che le specifiche di ciascun passaggio dipendono dal modo in cui le creatività vengono visualizzate e pubblicate sulla pagina del publisher e da quali entità di tecnologia pubblicitaria 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, vengono attivate le origini di 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 valore 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 dopo la navigazione non devono aggiungere l'attributo attributionsrc e saranno idonei per l'ARA purché nella navigazione iniziale sia stato aggiunto attributionsrc.

Quando il campo attributionsrc è vuoto, le richieste ARA verranno 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 a richieste dell'API Attribution Reporting. Definisci il tuo URL attributionsrc se vuoi che le richieste dell'API Attribution Reporting vengano indirizzate a un altro server.

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 attributionsrc non è vuoto, le richieste dell'API Attribution Reporting verranno 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:
    • L'entità responsabile dell'aggiunta di attributionsrc è di solito l'ad tech in 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 impressioni:
    • L'entità responsabile dell'aggiunta di attributionsrc è di solito 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 options passato alla chiamata API fetch.

Consulta la seguente tabella per il riepilogo delle modifiche necessarie per gli eventi relativi a 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 di attribuzione in un'asta Protected Audience

Per misurare le conversioni in un'asta Protected Audience, invece di 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 dei report, mentre registerAdMacro è disponibile all'interno del worklet dei report sulle vincite dell'acquirente. Quindi, i dati sugli eventi all'interno del frame dell'annuncio possono essere aggiunti alle macro e ai beacon 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 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 di attribuzione. Le richieste di beacon potrebbero essere reindirizzate per consentire la misurazione di terze parti.

Per un approfondimento più dettagliato, consulta la sezione relativa al supporto per i report sull'attribuzione 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 dovrebbero essere considerati potenziali eventi di origine idonei per la registrazione con l'API Attribution Reporting. L'Addendum VAST per il supporto dei report sull'attribuzione tratta questo aspetto in dettaglio, ma in breve tutti gli eventi <Tracking>, <Impression>, <*ClickThrough> e <*ClickTracking> sono potenziali eventi origine dell'attribuzione. Tutte le implementazioni VAST devono fornire una copertura di idoneità per la registrazione per questi eventi.

L'appendice VAST definisce nuovi attributi per questi elementi per consentire di impostare un URL secondario specifico per la registrazione dell'attribuzione. Quando un evento contiene attributiontype="DOUBLE_PING" e attributionsrc="[URL]", il codice di attivazione dell'evento deve utilizzare [URL] come valore dell'attributo attributionsrc durante l'abilitazione dell'API Attribution Reporting. L'appendice di VAST contiene esempi per ogni scenario.

Per garantire la massima copertura, le implementazioni VAST devono rendere tutti gli eventi elencati idonei per la registrazione per impostazione predefinita durante l'attivazione dei ping degli eventi. Ad esempio, quando attivi un URL dell'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 l'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 utilizzare i reindirizzamenti esistenti o aggiungere un elenco di terze parti all'attributo attributionsrc. Nella maggior parte dei casi, ciascuna tecnologia pubblicitaria dispone di un proprio tracker delle impressioni indipendente, pertanto i reindirizzamenti sono più pertinenti per i tracker dei clic.

Gestisci le 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 effettuata durante la navigazione alla pagina di destinazione finale. Ogni richiesta nella catena di reindirizzamento è idonea alla registrazione con l'API Attribution Reporting se il target dei clic originale è stato annotato con attributionsrc o registrato con registerAdBeacon/registerAdMacro nell'API Protected Audience. Deve essere registrata anche la tecnologia pubblicitaria nella catena di reindirizzamento.

Tieni presente che il corpo della richiesta iniziale non viene inviato nei reindirizzamenti. Per le aste di Protected Audience, se il valore eventData trasmesso a reportEvent e setReportEventDataForAutomaticBeacons deve essere utilizzato nel 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. La tecnologia pubblicitaria per la pubblicazione di questo esempio può essere una DSP che esegue il rendering della creatività sul sito del publisher e ha il proprio prodotto per la generazione di report. Il fornitore di servizi di misurazione di terze parti può essere un'entità che l'inserzionista utilizza per i report sulle conversioni.

Diagramma che descrive il modo in cui la prima parte registra la sorgente, poi la terza parte registra il

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 sulla fonte 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 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 il 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 che non fanno parte di una catena di reindirizzamento

Se più origini reporter vogliono registrare una sorgente in un evento di navigazione, ma non possono apparire in una catena di reindirizzamento per qualsiasi motivo, 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 che a REPORTING_URL_2. La richiesta di navigazione inviata all'URL di clickthrough è idonea anche per la registrazione delle 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 Registra le origini e il spiegatore per scoprire come deve essere creata la risposta.

Registra più attivatori

Puoi registrare più attivatori di attribuzione aggiungendo più elementi di 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 le richieste di reindirizzamento o elencando più URL nell'elemento attributionsrc come faresti per la registrazione di origine. Gli eventi di origine e gli eventi di trigger generati dalle stesse origini verranno abbinati.