Filtrare le sorgenti prima dell'attribuzione utilizzando gli ambiti di attribuzione

Gli ambiti di attribuzione consentono agli utenti che chiamano l'API di specificare un elenco di stringhe durante la registrazione di origini e attivatori che può essere utilizzato per il filtro prima che venga eseguita l'attribuzione. In questo modo è possibile filtrare con una granularità maggiore per aumentare l'efficienza dell'API e offrire maggiore flessibilità. Ad esempio, consente di monitorare separatamente gli inserzionisti sullo stesso sito. Inoltre, semplifica il monitoraggio di più campagne o prodotti all'interno di un singolo banner dell'annuncio.

Gli ambiti di attribuzione sono campi facoltativi che possono essere impostati durante la registrazione dell'origine e dell'attivatore. Durante l'attribuzione, verranno prese in considerazione solo le origini i cui valori dell'ambito di attribuzione contengono almeno uno dei valori dell'ambito di attribuzione dell'attivatore. Se nell'attivatore non è specificato alcun ambito, verranno prese in considerazione tutte le origini. Prima di continuare, devi conoscere l'API Attribution Reporting e i filtri di alto livello.

Durante la registrazione dell'origine

All'intestazione Attribution-Reporting-Register-Source viene aggiunto un parametro facoltativo attribution_scopes contenente due parametri obbligatori: values e limit e un parametro facoltativo: max_event_states.

  • limit: rappresenta il numero totale di ambiti distinti consentiti per destinazione per l'origine report dell'origine. Le origini registrate esistenti con la stessa origine e destinazione dei report, ma con un limite inferiore, verranno eliminate.
  • values: rappresenta l'elenco degli ambiti di attribuzione per una determinata origine. Questi valori devono essere stringhe con una lunghezza massima di 50.
  • max_event_states (facoltativo): rappresenta il numero massimo di stati evento che un chiamante dell'API prevede di utilizzare in tutte le registrazioni dell'origine evento successive. Tieni presente che tutte le origini registrate esistenti con la stessa origine e destinazione dei report, ma un max_event_states value diverso, verranno eliminate. Il valore predefinito per questo campo facoltativo è 3.

Esempio di registrazione dell'origine

  Attribution-Reporting-Register-source: {
  //optional
  "attribution_scopes":{
  "limit": <int>,
  "values": <list of strings>,
  // optional
  "max_event_states": <int>
    },
  ...
  }

Durante la registrazione dell'attivatore

Un parametro facoltativo attribution_scopes viene aggiunto all'intestazione Attribution-Reporting-Register-Trigger durante la registrazione dell'attivatore. Assicurati che il valore del parametro sia un elenco di stringhe che rappresentano gli ambiti per l'attivatore. L'attivatore corrisponderà solo alle origini il cui parametro valori di attribution_scopes contiene almeno uno degli attribution_scopes dell'attivatore, se specificato.

Esempio di registrazione dell'attivatore

Attribution-Reporting-Register-Trigger: {
//optional
"attribution_scopes": <list of strings>,
...
}

Esempio di ambiti di attribuzione

L'esempio seguente mostra il caso in cui un attivatore viene attribuito a una sorgente durante l'utilizzo degli ambiti di attribuzione.

Registrazione della sorgente 1

  Attribution-Reporting-Register-source: {
  "destination": "https://trigger.example",
  "attribution_scopes": {
  "limit": 2,
  "values": ["advertiser1"],
  "max_event_states": 3
  },
  ...
  }

Registrazione della sorgente 2

  Attribution-Reporting-Register-source: {
  "destination": "https://trigger.example",
  "attribution_scopes": {
  "limit": 2,
  "values": ["advertiser2"],
  "max_event_states": 3
  },
  ...
  }

Registrazione trigger

  Attribution-Reporting-Register-Trigger: {
  "attribution_scopes": ["advertiser1"],
  ...
  }

Quando si verifica la registrazione dell'attivatore, l'API seleziona le origini da prendere in considerazione per l'attribuzione che hanno valori attribution_scopes che si intersecano con i valori nella registrazione dell'attivatore. Le registrazioni delle origini corrispondenti continueranno con il resto del flusso di attribuzione. In questo esempio, l'autore della chiamata all'API riceverà un report sull'attribuzione che attribuisce la registrazione dell'attivatore alla prima registrazione dell'origine.

Ambiti di attribuzione e filtri

Sebbene la funzionalità degli ambiti e dei filtri di attribuzione possa sembrare simile, il fattore distintivo è il punto in cui vengono applicati nel flusso di registrazione dell'attivatore. Il filtro degli ambiti di attribuzione avviene prima dell'attribuzione. Ciò significa che riduce il pool di origini candidate non scadute che hanno lo stesso sito di destinazione e la stessa origine report, in base a quali origini hanno ambiti che si intersecano con quelli trovati nell'attivatore. I filtri di primo livello, invece, vengono applicati dopo che un attivatore è stato attribuito a una singola origine. Se i filtri di origine e di attivazione non si intersecano, non vengono generati report.

L'immagine seguente mostra un gruppo di origini e un attivatore che hanno lo stesso sito di destinazione, la stessa origine report e non sono scaduti. Parleremo brevemente di come vengono utilizzati gli ambiti e i filtri di attribuzione e se verrà generato un report in base alle origini e agli attivatori disponibili.

<img "activewear"="" "attribution="" "casualwear"="" "casualwear",="" "outerwear"="" "outerwear".="" "outerwear"."="" #1".the="" 1.="" 2.="" alt="Un'immagine che mostra 4 caselle etichettate come sorgenti numerate da 1 a 4 e una singola casella etichettata come " e="" attributi="" filtro:="" primo="" seguente="" quarto="" ha="" priorità:="" ambito":="" secondo="" sorgente="" src="/static/assets/images/attribution-scopes-example-1.png" the="" third="" title="Esempio di come funziona l'attribuzione con ambiti e filtri di attribuzione" trigger="" />

Prima dell'attribuzione

  • L'origine 1 viene filtrata perché il suo ambito di attribuzione non corrisponde all'ambito del trigger casualwear. Il fatto che abbia la priorità più alta tra tutte le origini disponibili non ne impedisce l'esclusione, in quanto il filtro pre-attribuzione viene applicato prima del controllo delle priorità.
  • Anche l'origine 2 viene esclusa perché non ha lo stesso ambito dell'attivatore. Questa origine ha anche lo stesso filtro dell'attivatore, ma i filtri di alto livello non vengono applicati fino dopo l'attribuzione.

Durante l'attribuzione

  • La sorgente 3 non è selezionata per l'attribuzione perché ha una priorità inferiore rispetto alla sorgente 4.
  • L'origine 4 è selezionata perché ha un ambito di attribuzione corrispondente all'attivatore e ha la priorità più alta. I filtri di alto livello vengono applicati dopo l'attribuzione, pertanto non vengono presi in considerazione durante la procedura di attribuzione.

Attribuzione post

  • Non viene generato alcun report perché i filtri di alto livello per l'origine selezionata (origine 4) e l'attivatore non si intersecano.

L'esempio precedente non genera un report. Tuttavia, se la quarta sorgente viene rimossa completamente:

La stessa immagine con 4 caselle etichettate come sorgenti numerate da 1 a 4 e una singola casella etichettata

Durante l'attribuzione

  • L'origine 3 è selezionata perché ha un ambito di attribuzione che si interseca con l'attivatore.

Attribuzione post

  • L'origine 3 non viene rifiutata perché il suo filtro si interseca con quello nell'attivatore. L'attribuzione verrà poi sottoposta al resto dei controlli post-attribuzione e, se supera tutti i controlli, verrà generato un report.

Gli ambiti di attribuzione riducono il numero di origini prese in considerazione per l'attribuzione. I passaggi di attribuzione rimanenti vengono poi applicati a questo gruppo più piccolo di origini, il che può comportare la generazione di un report.

Posizione degli ambiti di attribuzione nel flusso di attribuzione

Gli ambiti di attribuzione vengono applicati prima che venga selezionata una sorgente per l'attribuzione. Inoltre, precede i filtri di primo livello e i filtri della finestra del report personalizzato. Il seguente diagramma mostra una versione semplificata del flusso di attribuzione complessivo con l'ambito dell'attribuzione che si verifica prima dell'attribuzione e del resto dei controlli di attribuzione.

<img "attribution="" "attribution",="" "deactivation="" "filters="" "report="" "source="" "trigger="" alt="Un'immagine che mostra una versione semplificata del flusso di attribuzione con ogni passaggio rappresentato come un quadrato collegato al passaggio successivo da una freccia. I passaggi in ordine sono " and="" check",="" checks"="" generation"."="" matching",="" of="" other="" registration",="" scopes="" source="" sources",="" src="/static/assets/images/attribution-scopes-attribution-flow.png" title="Simplified attribution flow diagram" />

Operazioni del flusso di attribuzione

Di seguito è riportato un riepilogo delle varie operazioni eseguite durante il flusso di attribuzione:

  • Registrazione della sorgente:quando un utente interagisce con un annuncio sul sito dell'inserzionista, viene registrato un evento sorgente. Il dispositivo invia quindi una richiesta all'endpoint dell'origine report, che risponde con un'intestazione contenente i dati sugli eventi di origine.
  • Registrazione dell'attivatore:quando si verifica una conversione sul sito dell'inserzionista, viene registrato un evento di trigger. Il dispositivo invia un'altra richiesta all'origine report, che risponde con un'intestazione contenente i dati dell'evento di attivazione.
  • Corrispondenza dell'origine:il dispositivo associa gli eventi di origine e di attivazione in base a criteri quali sito di destinazione, origine report ed esaurimento.
  • Controllo degli ambiti di attribuzione: le origini vengono filtrate in base all'intersezione tra i valori di attribution_scopes di origine e trigger.
  • Attribuzione:il dispositivo seleziona la sorgente con la priorità più alta per l'attribuzione se più sorgenti corrispondono. Se le priorità sono uguali, viene selezionata quella più recente.
  • Controllo dei filtri:il dispositivo confronta i filtri di origine e di attivazione per determinare se corrispondono. Se i filtri non corrispondono, l'attribuzione viene eliminata.
  • Disattivazione di altre origini:se i filtri dell'origine scelta corrispondono, il dispositivo disattiva le origini corrispondenti durante la fase di corrispondenza delle origini. Le origini disattivate includeranno quelle i cui ambiti di attribuzione non corrispondono agli ambiti degli attivatori.
  • Controlli post-attribuzione: il dispositivo esegue altri controlli sull'attribuzione selezionata, ad esempio verifica se l'origine è soggetta a report falsi, verifica le attribuzioni duplicate utilizzando le chiavi di deduplica, verifica se l'attivatore rientra nella finestra di generazione dei report dell'origine e verifica i limiti di frequenza.
  • Generare report: se tutti i controlli vengono superati, il dispositivo genera e pianifica un report sull'attribuzione da inviare all'endpoint dell'origine report.

Passaggi successivi