Konfigurieren Sie die API so, dass bestimmte Quellen oder Trigger priorisiert werden.
Bestimmte Klicks oder Aufrufe für Berichte auf Ereignisebene oder aggregierte Berichte priorisieren
Mithilfe von Prioritäten auf Quellseite können Sie das Standardverhalten der Attribution Reporting API ändern. Standardmäßig wird das Attributionsmodell „Letzte Interaktion“ verwendet. Eine Conversion wird also dem zuletzt übereinstimmenden Quellereignis zugeordnet. Dieses Verhalten können Sie sowohl für Berichte auf Ereignisebene als auch für aggregierte Berichte anpassen.
Wenn Sie die Standardpriorität ändern möchten, fügen Sie dem Quellregistrierungsheader den Schlüssel „priority“ hinzu.
Legen Sie für Quellen, die Sie priorisieren möchten, eine höhere Priorität fest. Größere Werte bedeuten eine höhere Priorität. Beispielsweise hat ein Quellereignis mit einem priority von 2 Vorrang vor einer Quelle mit einem priority von 1.
Es wird nur der Bericht gesendet, der mit dem Quellereignis mit der höchsten Priorität übereinstimmt.
Beispielcode
Ändern Sie die Zuordnung, um weniger aktuelle Quellen auszuwählen (erster Klick):
const currentTimestamp = Date.now();
const priority = -currentTimestamp;
res.set(
"Attribution-Reporting-Register-Source",
JSON.stringify({
// … all usual fields for that header
priority: `${priority}`
})
);
Bestimmte Conversions für Berichte auf Ereignisebene priorisieren
Im Gegensatz zu quellseitigen Prioritäten ist das Festlegen von trigger-seitigen Prioritäten nur für Berichte auf Ereignisebene verfügbar.
Angenommen, ein Nutzer klickt auf eine Anzeige und löst viermal eine Conversion aus: Er besucht die Startseite der Website des Werbetreibenden, ruft eine Produktseite auf, meldet sich für den Newsletter an und kauft schließlich etwas.
Aufgrund des Limits von drei Berichten für Klicks werden jedoch standardmäßig alle nachfolgenden Berichte nach der Registrierung (dritte Conversion) entfernt, einschließlich des Kaufberichts.
Stattdessen können Sie die API so konfigurieren, dass Sie Berichte zu Conversions erhalten, die Ihnen wichtiger sind, z. B. Kaufberichte.
Fügen Sie dazu dem Header für die Trigger-Registrierung den Schlüssel „priority“ hinzu und legen Sie eine höhere Priorität für Conversions fest, die Sie priorisieren möchten.
Wenn eine Attribution für ein bestimmtes Quellereignis ausgelöst wird und die maximale Anzahl von Attributionen (drei für Klicks und eine für Aufrufe) für diese Quelle erreicht wurde, geschieht im Browser Folgendes:
Vergleichen Sie die Priorität des neuen Berichts mit den Prioritäten vorhandener geplanter Berichte für dieselbe Quelle.
Löschen Sie den Bericht mit der niedrigsten Priorität, um stattdessen den neuen Bericht zu planen. Wenn der neue Bericht die niedrigste Priorität hat, wird er ignoriert und Sie erhalten ihn nicht.
Wenn keine Prioritäten festgelegt sind, greift der Browser auf sein Standardverhalten zurück: Alle Conversions, die nach der dritten Conversion für Klicks oder nach der ersten Conversion für Aufrufe erfolgen, werden verworfen.
Sehen Sie sich den Beispielcode an: Conversions vom Typ „Bezahlvorgang priorisieren“.
Nächste Schritte
Informationen zum Festlegen von Quellen und Triggern finden Sie unter: