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

Gli ambiti di attribuzione consentono ai chiamanti API di specificare un elenco di stringhe durante la registrazione di origini e trigger che possono essere utilizzate per il filtraggio prima che venga eseguita l'attribuzione. Ciò consente un filtraggio più granulare per aumentare l'efficienza dell'API e offrire maggiore flessibilità. Ad esempio, consente di monitorare in modo distinto inserzionisti separati sullo stesso sito. Inoltre, semplifica il monitoraggio di più campagne o prodotti all'interno di un singolo banner pubblicitario.

Gli ambiti di attribuzione sono campi facoltativi che possono essere impostati durante la registrazione di origini e trigger. Durante l'attribuzione, verranno prese in considerazione solo le sorgenti i cui valori dell'ambito di attribuzione contengono almeno uno dei valori dell'ambito di attribuzione del trigger. Se non viene specificato alcun ambito nel trigger, verranno prese in considerazione tutte le origini. Prima di continuare, devi acquisire familiarità con l'API Attribution Reporting e i filtri di alto livello.

Durante la registrazione della fonte

Un parametro facoltativo attribution_scopes viene aggiunto all'intestazione Attribution-Reporting-Register-Source, che contiene due parametri obbligatori: valori e limite; e un parametro facoltativo: max_event_states.

  • limite:rappresenta il numero totale di ambiti distinti consentiti per destinazione per l'origine dei report di origine. Tutte le origini registrate esistenti con la stessa origine e destinazione dei report, ma 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 caratteri.
  • max_event_states (facoltativo): rappresenta il numero massimo di stati evento che un chiamante API prevede di utilizzare in tutte le registrazioni successive di origini eventi. Tieni presente che tutte le origini registrate esistenti con la stessa origine e destinazione dei report, ma con un max_event_states value diverso, verranno eliminate. Il valore predefinito di 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 del trigger

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

Esempio di registrazione del trigger

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

Esempio di ambiti attribuzione

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

Registrazione dell'origine n. 1

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

Registrazione dell'origine n. 2

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

Registrazione del trigger

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

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

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 dei trigger. Il filtro degli ambiti di attribuzione viene applicato 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 dei report, in base alle origini che hanno ambiti che si intersecano con gli ambiti trovati nel trigger. I filtri di primo livello, tuttavia, vengono applicati dopo che un trigger è stato attribuito a una singola origine. Se i filtri di origine e trigger non si intersecano, non vengono generati report.

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

Quattro caselle etichettate con i numeri di origine da 1 a 4 e una singola casella etichettata &quot;Trigger n. 1&quot;. La prima origine ha i seguenti attributi &quot;Ambito attribuzione&quot;: &quot;abbigliamento sportivo&quot; e Priorità: 2. La seconda origine ha gli attributi &quot;Ambito attribuzione&quot;: &quot;activewear&quot; e Filtro: &quot;outerwear&quot;. La terza fonte ha gli attributi &quot;Ambito dell&#39;attribuzione&quot;: &quot;casualwear&quot;, Filtro: &quot;outerwear&quot;. La quarta origine ha gli attributi &quot;Ambito attribuzione&quot;: &quot;casualwear&quot; e Filtro: &quot;outerwear&quot; e Priorità: 1. Il trigger ha gli attributi &quot;Ambito attribuzione&quot;: &quot;casualwear&quot; e Filtro: &quot;outerwear&quot;.
Esempio di funzionamento dell'attribuzione con ambiti e filtri di attribuzione

Prima dell'attribuzione

  • L'origine n. 1 viene filtrata perché il suo ambito di attribuzione non corrisponde all'ambito del trigger casualwear. Avere la priorità più alta tra tutte le origini disponibili non impedisce che venga filtrata, poiché il filtro pre-attribuzione viene eseguito prima della verifica delle priorità.
  • Anche l'origine n. 2 viene esclusa perché non ha lo stesso ambito del trigger. Questa origine ha anche lo stesso filtro del trigger, ma i filtri di alto livello vengono applicati solo dopo l'attribuzione.

Durante l'attribuzione

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

Attribuzione dei post

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

L'esempio precedente non comporta la generazione di un report. Tuttavia, se la quarta fonte viene rimossa completamente:

Le stesse quattro caselle etichettate con i numeri di origine da 1 a 4 e una singola casella etichettata &quot;Trigger n. 1&quot;. La differenza in questa immagine è che la casella etichettata &quot;Fonte n. 4&quot; è barrata con una X rossa.
Esempio modificato di come funziona l'attribuzione con ambiti e filtri di attribuzione

Durante l'attribuzione

  • La sorgente n. 3 è selezionata perché ha un ambito di attribuzione che si interseca con il trigger.

Attribuzione dei post

  • L'origine n. 3 non viene rifiutata perché il relativo filtro interseca il filtro nell'attivatore. L'attribuzione verrà quindi sottoposta al resto dei controlli post-attribuzione e, se li supera tutti, 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 quindi applicati a questo pool più piccolo di sorgenti, il che potrebbe generare 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 il filtraggio della finestra dei report personalizzati. Il seguente diagramma mostra una versione semplificata del flusso di attribuzione complessivo, in cui l'ambito dell'attribuzione viene definito prima dell'attribuzione e del resto dei controlli di attribuzione.

Una versione semplificata del flusso di attribuzione, in cui ogni passaggio è rappresentato da un quadrato collegato al passaggio successivo da una freccia. I passaggi in ordine sono &quot;Registrazione dell&#39;origine&quot;, &quot;Registrazione del trigger&quot;, &quot;Corrispondenza dell&#39;origine&quot;, &quot;Controllo degli ambiti di attribuzione&quot;, &quot;Attribuzione&quot;, &quot;Controllo dei filtri&quot;, &quot;Disattivazione di altre origini&quot;, &quot;Controlli dell&#39;attribuzione&quot; e &quot;Generazione del report&quot;.
Flusso di attribuzione semplificato

Operazioni del flusso di attribuzione

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

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

Passaggi successivi