Quellen vor der Attribution mithilfe von Attributionsbereichen filtern

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Mithilfe von Attribution Scopes können API-Caller bei der Registrierung von Quellen und Triggern eine Liste von Strings angeben, die vor der Attribution zum Filtern verwendet werden können. So können Sie die API-Effizienz steigern und mehr Flexibilität erreichen. So können Sie beispielsweise separate Werbetreibende auf derselben Website eindeutig erfassen. Außerdem können Sie damit mehrere Kampagnen oder Produkte in einem einzigen Anzeigenbanner erfassen.

Zuordnungsbereiche sind optionale Felder, die bei der Registrierung von Quellen und Triggern festgelegt werden können. Bei der Attribution werden nur Quellen berücksichtigt, deren Werte für den Attributionsbereich mindestens einen der Werte für den Attributionsbereich des Triggers enthalten. Wenn im Trigger kein Umfang angegeben ist, werden alle Quellen berücksichtigt. Bevor Sie fortfahren, sollten Sie mit der Attribution Reporting API und übergeordneten Filtern vertraut sein.

Während der Quellenregistrierung

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

• limit:Die Gesamtzahl der zulässigen eindeutigen Bereiche pro Ziel für den Ursprung der Berichtsquelle. Alle vorhandenen registrierten Quellen mit demselben Ursprung und Ziel für Berichte, aber einem geringeren Limit, werden gelöscht.
• values:Liste der Attributionsbereiche für eine bestimmte Quelle. 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-Caller für alle nachfolgenden Registrierungen von Ereignisquellen verwenden möchte. Alle vorhandenen registrierten Quellen mit demselben Ursprung und Ziel der Berichterstellung, aber einer anderen max_event_states value, werden gelöscht. Der Standardwert für dieses optionale Feld ist 3.

Beispiel für die Registrierung von Quellen

  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 wird nur mit Quellen abgeglichen, deren „attribution_scopes“-Wertparameter mindestens einen der „attribution_scopes“-Werte des Triggers enthält, sofern angegeben.

Beispiel für die Triggerregistrierung

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

Beispiel für Attributionsbereiche

Im folgenden Beispiel wird gezeigt, wie ein Trigger einer Quelle zugeordnet wird, wenn Attributionsbereiche verwendet werden.

Quellenregistrierung 1

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

Quellenregistrierung 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"],
  ...
  }

Bei der Triggerregistrierung wählt die API Quellen aus, die für die Attribution berücksichtigt werden sollen und deren attribution_scopes-Werte mit den Werten in der Triggerregistrierung übereinstimmen. 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 Quellenregistrierung zugeordnet wird.

Attributionsbereiche im Vergleich zu Filtern

Die Funktionsweise von Attributionsbereichen und Filtern mag zwar ähnlich erscheinen, der entscheidende Faktor ist jedoch, wo sie im Triggerregistrierungsvorgang angewendet werden. Die Filterung nach Attributionsbereichen erfolgt vor der Attribution. Das bedeutet, dass der Pool der nicht abgelaufenen Kandidatenquellen mit derselben Zielwebsite und demselben Berichtsorigin reduziert wird. Dabei werden nur Quellen berücksichtigt, deren Gültigkeitsbereich sich mit dem im Trigger festgelegten Gültigkeitsbereich überschneidet. Filter auf oberster 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, demselben Berichts-Ursprung und ohne Ablaufdatum. Wir sprechen kurz darüber, wie Attributionsbereiche und -filter verwendet werden und ob ein Bericht basierend auf den verfügbaren Quellen und Triggern generiert wird.

<img "activewear"="" "attribution="" "casualwear"="" "casualwear",="" "outerwear"="" "outerwear".="" "outerwear"."="" #1".the="" 1.="" 2.="" alt="An image showing 4 boxes labelled sources numbered 1 through 4 and a single box labelled " and="" attributes="" filter:="" first="" following="" fourth="" has="" priority:="" scope":="" second="" source="" src="/static/assets/images/attribution-scopes-example-1.png" the="" third="" title="Example on how attribution works with attribution scopes and filters" trigger="" />

Vor der Attribution

• Quelle 1 wird herausgefiltert, da ihr Attributionsbereich nicht mit dem Bereich „casualwear“ des Triggers übereinstimmt. Auch wenn eine Quelle die höchste Priorität aller verfügbaren Quellen hat, kann sie herausgefiltert werden, da die vor der Attribution erfolgende Filterung vor der Prüfung der Prioritäten erfolgt.
• 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 Attribution 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 denselben Attributionsbereich wie der Trigger hat und die höchste Priorität hat. Allgemeine Filter werden nach der Attribution angewendet und werden daher nicht bei der Attribution berücksichtigt.

Beitragsattribution

• Es wird kein Bericht generiert, da sich die Filter auf höherer Ebene für die ausgewählte Quelle (Quelle 4) und der Trigger nicht überschneiden.

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

Während der Attribution

• Quelle 3 ist ausgewählt, da sich ihr Attributionsumfang mit dem des Triggers überschneidet.

Beitragsattribution

• Quelle 3 wird nicht abgelehnt, da ihr Filter mit dem Filter im Trigger übereinstimmt. Die Attribution wird dann den restlichen Überprüfungen nach der Attribution unterzogen. Wenn alle Überprüfungen bestanden werden, wird ein Bericht generiert.

Mit Attributionsbereichen wird die Anzahl der Quellen reduziert, die für die Attribution berücksichtigt werden. Die verbleibenden Attributionsschritte werden dann auf diesen kleineren Pool von Quellen angewendet, was möglicherweise zu einem Bericht führt.

Platz der Attributionsbereiche im Attributionsablauf

Attributionsebenen werden angewendet, bevor eine Quelle für die Attribution ausgewählt wird. Dies gilt auch für Filter auf oberster Ebene und die Filterung im benutzerdefinierten Berichtsfenster. Das folgende Diagramm zeigt eine vereinfachte Version des gesamten Attributionsablaufs. Der Attributionsbereich wird vor der Attribution und den restlichen Attributionsüberprüfungen festgelegt.

<img "attribution="" "attribution",="" "deactivation="" "filters="" "report="" "source="" "trigger="" alt="Ein Bild, das eine vereinfachte Version des Attributionsflusses zeigt. Jeder Schritt ist als Quadrat dargestellt, das durch einen Pfeil mit dem nächsten Schritt verbunden ist. Die Schritte in der richtigen Reihenfolge sind „ 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" />

Vorgänge für den Attributionsablauf

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

• Quellenregistrierung:Wenn ein Nutzer mit einer Anzeige auf der Website des Werbetreibenden interagiert, wird ein Quellenereignis registriert. Das Gerät sendet dann eine Anfrage an den Endpunkt des Berichtsorigins, der mit einem Header antwortet, der Quellereignisdaten enthält.
• Triggerregistrierung:Wenn auf der Website des Werbetreibenden eine Conversion erfolgt, wird ein Triggerereignis registriert. Das Gerät sendet eine weitere Anfrage an den Ursprung der Meldung, der mit einem Header antwortet, der Triggerereignisdaten enthält.
• Quellabgleich:Das Gerät gleicht Quell- und Triggerereignisse anhand von Kriterien wie Zielwebsite, Berichtsquelle und Ablaufdatum ab.
• Prüfung der Attributionsbereiche:Quellen werden basierend auf der Überschneidung der Werte „attribution_scopes“ von Quelle und Trigger gefiltert.
• Attribution:Wenn mehrere Quellen übereinstimmen, wählt das Gerät die Quelle mit der höchsten Priorität für die Attribution aus. Bei gleicher Priorität wird die neueste ausgewählt.
• Filterprüfung:Das Gerät vergleicht die Quell- und Triggerfilter, um festzustellen, ob sie übereinstimmen. Wenn die Filter nicht übereinstimmen, wird die Attribution nicht berücksichtigt.
• Deaktivierung anderer Quellen:Wenn die Filter der ausgewählten Quelle übereinstimmen, deaktiviert das Gerät die Quellen, die in der Phase der Quellenabgleichs übereinstimmten. Zu den deaktivierten Quellen gehören auch Quellen, deren Attributionsbereiche nicht mit den Triggerbereichen übereinstimmen.
• Prüfung nach der Attribution:Das Gerät führt weitere Prüfungen der ausgewählten Attribution durch, z. B. ob die Quelle mit gefälschten Berichten manipuliert wurde, ob es sich bei den Attributionen um Duplikate handelt, ob der Trigger in den Berichtszeitraum der Quelle fällt und ob die Ratenlimits eingehalten werden.
• Berichterstellung:Wenn alle Prüfungen bestanden werden, generiert und plant das Gerät einen Attributionsbericht, der an den Endpunkt der Berichtsquelle gesendet wird.

Nächste Schritte

• Weitere Informationen zu Attributionsbereichen finden Sie im GitHub-Erläuterungsartikel zur Vorabfilterung von Attributionen.
• Weitere Informationen zu Filtern finden Sie unter Kundenregeln mithilfe von Filtern definieren.