Quellen vor der Attribution mithilfe von Attributionsbereichen filtern

Mit Attributionsbereichen können API-Aufrufer bei der Quell- und Triggerregistrierung eine Liste von Strings angeben, die zum Filtern verwendet werden können, bevor die Attribution erfolgt. So können Sie die API-Effizienz steigern und die Flexibilität erhöhen. So können beispielsweise verschiedene Werbetreibende auf derselben Website separat erfasst werden. Außerdem lassen sich so mehrere Kampagnen oder Produkte in einem einzigen Anzeigenbanner erfassen.

Attributionsbereiche sind optionale Felder, die bei der Quell- und Triggerregistrierung festgelegt werden können. Bei der Zuordnung werden nur Quellen berücksichtigt, deren Werte für den Zuordnungsbereich mindestens einen der Werte für den Zuordnungsbereich des Triggers enthalten. Wenn im Trigger kein Bereich angegeben ist, werden alle Quellen berücksichtigt. Bevor Sie fortfahren, sollten Sie sich mit der Attribution Reporting API und Filtern auf hoher Ebene vertraut machen.

Während der Quellenregistrierung

Dem Header Attribution-Reporting-Register-Source wird ein optionaler Parameter attribution_scopes hinzugefügt, der zwei erforderliche Parameter enthält: „values“ und „limit“ sowie einen optionalen Parameter: „max_event_states“.

  • limit:Stellt die Gesamtzahl der eindeutigen Bereiche dar, die pro Ziel für den Ursprung des Quellberichts zulässig sind. Alle vorhandenen registrierten Quellen mit demselben Berichtsursprung und -ziel, aber einem niedrigeren Limit, werden gelöscht.
  • values:Stellt die Liste der Attributionsbereiche für eine bestimmte Quelle dar. Diese Werte müssen Strings mit einer maximalen Länge von 50 Zeichen sein.
  • max_event_states (optional): Die maximale Anzahl von Ereignisstatus, die ein API-Aufrufer für alle nachfolgenden Registrierungen von Ereignisquellen verwenden möchte. Alle vorhandenen registrierten Quellen mit demselben Berichtsursprung und ‑ziel, aber einem anderen max_event_states value werden gelöscht. Der Standardwert für dieses optionale Feld ist 3.

Beispiel für die Quellregistrierung

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

Während der Triggerregistrierung

Bei der Triggerregistrierung wird dem Header Attribution-Reporting-Register-Trigger ein optionaler Parameter attribution_scopes hinzugefügt. Der Parameterwert muss eine Liste von Strings sein, die die Bereiche für den Trigger darstellen. Der Trigger stimmt nur mit Quellen überein, deren Parameter „attribution_scopes“ mindestens einen der „attribution_scopes“ des Triggers enthält, sofern angegeben.

Beispiel für die Triggerregistrierung

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

Beispiel für Attributionsumfang

Das folgende Beispiel zeigt den Fall, in dem ein Trigger einer Quelle zugeordnet wird, während Attributionsbereiche verwendet werden.

Quellregistrierung 1

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

Quellregistrierung 2

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

Triggerregistrierung

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

Wenn die Triggerregistrierung erfolgt, wählt die API Quellen aus, die für die Attribution berücksichtigt werden sollen und deren „attribution_scopes“-Werte sich mit den Werten in der Triggerregistrierung überschneiden. Die übereinstimmenden Quellregistrierungen werden mit dem Rest des Attributionsablaufs fortgesetzt. In diesem Beispiel erhält der API-Aufrufer einen Attributionsbericht, in dem die Triggerregistrierung der ersten Quellregistrierung zugeordnet wird.

Attributionsbereiche im Vergleich zu Filtern

Die Funktionalität von Attributionsbereichen und ‑filtern mag ähnlich erscheinen, der entscheidende Unterschied liegt jedoch darin, wo sie im Ablauf der Triggerregistrierung angewendet werden. Die Filterung von Attributionsbereichen erfolgt vor der Attribution. Dadurch wird die Anzahl der nicht abgelaufenen Quellkandidaten mit derselben Zielwebsite und demselben Berichtsursprung reduziert, basierend darauf, welche Quellen Bereiche haben, die sich mit den im Trigger gefundenen Bereichen überschneiden. Filter auf höchster Ebene werden jedoch angewendet, nachdem ein Trigger einer einzelnen Quelle zugeordnet wurde. Wenn sich die Quell- und Triggerfilter nicht überschneiden, werden keine Berichte erstellt.

Das folgende Bild zeigt eine Gruppe von Quellen und einen Trigger mit derselben Zielwebsite und demselben Berichtsursprung, die nicht abgelaufen sind. Wir gehen kurz darauf ein, wie Attributionsbereiche und ‑filter verwendet werden und ob ein Bericht auf Grundlage der verfügbaren Quellen und Trigger generiert wird.

Vier Kästen mit der Bezeichnung „Quellnummer 1“ bis „Quellnummer 4“ und ein einzelner Kasten mit der Bezeichnung „Trigger 1“. Die erste Quelle hat die folgenden Attribute für den Attributionsbereich: „activewear“ und Priorität: 2. Die zweite Quelle hat die Attribute „Attributionsbereich“: „activewear“ und Filter: „outerwear“. Die dritte Quelle hat die Attribute „Attributionsbereich“: „casualwear“, Filter: „outerwear“. Die vierte Quelle hat die Attribute „Attributionsbereich“: „casualwear“ und „Filter“: „outerwear“ sowie „Priorität“: 1. Der Trigger hat die Attribute „Attributionsbereich“: „casualwear“ und „Filter“: „outerwear“.
Beispiel für die Funktionsweise der Attribution mit Attributionsbereichen und ‑filtern

Vor der Attribution

  • Quelle 1 wird herausgefiltert, da ihr Attributionsbereich nicht mit dem Bereich des Triggers (casualwear) übereinstimmt. Auch wenn sie die höchste Priorität unter allen verfügbaren Quellen hat, kann sie herausgefiltert werden, da das Filtern vor der Zuordnung erfolgt, bevor die Prioritäten geprüft werden.
  • Quelle 2 wird ebenfalls herausgefiltert, da sie nicht denselben Umfang wie der Trigger hat. Diese Quelle hat auch denselben Filter wie der Trigger, aber Filter auf hoher Ebene werden erst nach der Zuordnung angewendet.

Während der Attribution

  • Quelle 3 wird nicht für die Attribution ausgewählt, da sie eine niedrigere Priorität als Quelle 4 hat.
  • Quelle 4 wird ausgewählt, da sie einen passenden Attributionsbereich für den Trigger hat und die höchste Priorität aufweist. Filter auf hoher Ebene werden nach der Zuordnung angewendet und spielen daher während des Zuordnungsprozesses keine Rolle.

Beitragsattribution

  • Es wird kein Bericht erstellt, da sich die Filter der obersten Ebene für die ausgewählte Quelle (Quelle 4) und den Trigger nicht überschneiden.

Im vorherigen Beispiel wird kein Bericht erstellt. Wenn die vierte Quelle jedoch vollständig entfernt wird:

Die gleichen vier Kästchen mit den Quellnummern 1 bis 4 und ein einzelnes Kästchen mit der Bezeichnung „Trigger 1“. Der Unterschied zu diesem Bild besteht darin, dass das Feld mit der Bezeichnung „Quelle 4“ mit einem roten X durchgestrichen ist.
Geändertes Beispiel für die Funktionsweise der Attribution mit Attributionsbereichen und Filtern

Während der Attribution

  • Quelle 3 ist ausgewählt, da sie einen sich überschneidenden Attributionsumfang mit dem Trigger hat.

Beitragsattribution

  • Quelle 3 wird nicht abgelehnt, da sich ihr Filter mit dem Filter im Trigger überschneidet. Die Zuordnung wird dann den restlichen Prüfungen nach der Zuordnung unterzogen. Wenn sie alle Prüfungen besteht, wird ein Bericht erstellt.

Durch Attributionsbereiche wird die Anzahl der Quellen reduziert, die für die Attribution berücksichtigt werden. Die verbleibenden Attributionsschritte werden dann auf diese kleinere Gruppe von Quellen angewendet, was zu einem Bericht führen kann.

Position von Attributionsbereichen im Attributionsablauf

Attributionsbereiche werden angewendet, bevor eine Quelle für die Attribution ausgewählt wird. Dies geht auch Filtern auf oberster Ebene und benutzerdefinierten Berichtszeitraumfiltern voraus. Das folgende Diagramm zeigt eine vereinfachte Version des gesamten Attributionsablaufs. Der Attributionsbereich wird vor der Attribution und den restlichen Attributionsprüfungen festgelegt.

Eine vereinfachte Version des Attributionsablaufs, bei der jeder Schritt als Quadrat dargestellt wird, das durch einen Pfeil mit dem nächsten Schritt verbunden ist. Die Schritte sind „Quellregistrierung“, „Triggerregistrierung“, „Quellabgleich“, „Prüfung der Attributionsbereiche“, „Attribution“, „Prüfung der Filter“, „Deaktivierung anderer Quellen“, „Attributionsprüfungen“ und „Berichterstellung“.
Vereinfachter Attributionsablauf

Vorgänge für den Attributionsablauf

Im Folgenden finden Sie eine Zusammenfassung der verschiedenen Vorgänge, die während des Attributionsablaufs ausgeführt werden:

  • Quellregistrierung:Wenn ein Nutzer auf der Website des Werbetreibenden mit einer Anzeige interagiert, wird ein Quellereignis registriert. Das Gerät sendet dann eine Anfrage an den Endpunkt des Berichterstellungsursprungs, der mit einem Header mit Quelldaten antwortet.
  • Triggerregistrierung:Wenn auf der Website des Werbetreibenden eine Conversion erfolgt, wird ein Triggerereignis registriert. Das Gerät sendet eine weitere Anfrage an den Berichterstellungsursprung, der mit einem Header mit Triggerereignisdaten antwortet.
  • Quellabgleich:Das Gerät gleicht Quell- und Triggerereignisse anhand von Kriterien wie Zielwebsite, Berichterstellungsursprung und Ablaufdatum ab.
  • Attributionsbereiche prüfen:Quellen werden basierend auf der Überschneidung zwischen den Attributionsbereichen von Quelle und Trigger gefiltert.
  • Attribution:Das Gerät wählt die Quelle mit der höchsten Priorität für die Attribution aus, wenn mehrere Quellen übereinstimmen. Wenn die Prioritäten gleich sind, wird die zuletzt verwendete ausgewählt.
  • Filterprüfung:Das Gerät vergleicht die Quell- und Triggerfilter, um festzustellen, ob sie übereinstimmen. Wenn die Filter nicht übereinstimmen, wird die Zuordnung verworfen.
  • Deaktivierung anderer Quellen:Wenn die Filter der ausgewählten Quelle übereinstimmen, werden die Quellen, die während der Quellenzuordnung übereinstimmen, vom Gerät deaktiviert. Deaktivierte Quellen umfassen Quellen, deren Attributionsbereiche nicht mit Triggerbereichen übereinstimmen.
  • Prüfungen nach der Attribution:Das Gerät führt weitere Prüfungen der ausgewählten Attribution durch. Dabei wird unter anderem geprüft, ob die Quelle durch gefälschte Berichte verfälscht wurde, ob doppelte Attributionen mithilfe von Deduplizierungsschlüsseln vorliegen, ob der Trigger in den Berichtszeitraum der Quelle fällt und ob Ratenbeschränkungen eingehalten werden.
  • Berichterstellung:Wenn alle Prüfungen bestanden sind, wird auf dem Gerät ein Attributionsbericht generiert und geplant, der an den Endpunkt des Berichterstellungsursprungs gesendet werden soll.

Nächste Schritte