Neuerungen bei den Attributionsberichten im Juni 2022

Änderung des Vorschlags für Attribution Reporting für die Chrome-Version 104 mit neuen API-Mechanismen, -Funktionen und -Updates mit dem Aggregationsdienst.

Für wen sind diese Updates gedacht?

Diese Aktualisierungen sind für Sie in folgenden Fällen relevant:

  • Sie sind bereits mit der API vertraut, oder die Teilnahme an den Diskussionen über das WICG-Repository sind und die an der API vorgenommenen Änderungen verstehen.
  • Sie verwenden die Attribution Reporting API in einer Demo oder planen einen Test in der Ursprungstest verwendet werden.

Wenn Sie die API zum ersten Mal verwenden und/oder noch nicht mit finden Sie in der Einführung in das API.

Neuerungen bei der Attribution Reporting API

Demo zu Attributionsberichten wurden aktualisiert, um die neuesten Änderungen am Attribution Reporting zu berücksichtigen clientseitige API verwendet.

Für die meisten Änderungen sind keine Maßnahmen Ihrerseits erforderlich. Diejenigen, die Updates für Ihre sind unten beschrieben.

Einheitliche Header für die Registrierung (Aktion erforderlich)

Die Header wurden vereinheitlicht. Es gibt jetzt nur einen Header für Quellen und einen für Trigger im JSON-Format.

  • Wenn Sie Attributionsquellen registrieren möchten, können Sie auf Registrierungsanfragen antworten mit der Überschrift Attribution-Reporting-Register-Source.
  • Legen Sie zum Abschließen der Triggerregistrierung Attribution-Reporting-Register-Trigger-Header.

Für diese Änderung sind Maßnahmen erforderlich. Weitere Informationen finden Sie im API-Entwicklerleitfaden .

Aggregationsschlüssel (Aktion erforderlich) sind jetzt ein Wörterbuch

So registrieren Sie Attributionsquellen: weiterhin aggregation_keys verwenden, aber jetzt als JSON-Wörterbuch gespeichert einer Liste.

Beispiel:

"aggregation_keys": {
    // Generate a "0x159" key piece for the key named "campaignCounts".
    "campaignCounts": "0x159", // User saw ad from campaign 345 (out of 511)

    // Generates a "0x5" key piece (low order bits of the key) for 
    // the key named "geoValue".
    "geoValue": "0x5" // Source-side geo region = 5 (US), out of a possible ~100 regions
 }

Für diese Änderung sind Maßnahmen erforderlich. Weitere Informationen finden Sie im API-Leitfaden .

Berichterstellung

Sie können festlegen, dass nur aggregierte Berichte generiert werden, die aggregiert werden können. zusammenfassende Berichte. Wenn Ihre Filter mit keinem Ereignistrigger übereinstimmen, ist kein werden Berichte auf Ereignisebene erstellt.

Einstellung für einheitliche Debug-Schlüssel

Der Debug-Schlüssel sollte jetzt in den Quell- und Trigger-Headern anstatt mit separaten Headern. Weitere Informationen zur Fehlerbehebung berichten.

Attributionsquellen registrieren

Mit Script-Tags können jetzt Attributionsquellen registriert werden, ähnlich wie bei der für das <img>-Tag.

Weitere API-Updates

Weitere Änderungen, die im API-Handbuch vorgenommen und zitiert werden:

  • Quellen können mit JavaScript-Anfrage-APIs registriert werden.
  • "window.registerSource" wurde entfernt.
  • Es ist jetzt optional, bei der Registrierung einen Wert für attributionsrc anzugeben. Quellen.
  • Attribution-Reporting-Eligible-Header zur eingehenden Quelle hinzugefügt Registrierungsanfragen.
  • Am encodeURIComponent wurde eine geringfügige Änderung vorgenommen.
  • Der Datenschutzschlüssel für das Budget wurde entfernt in aggregierten Berichten aus dem Feld shared_info.

Unterstützung für den Zusammenfassungsdienst

In Chrome 104 möchten wir das Format einiger Informationen in aggregierte Berichte. Wir arbeiten derzeit an der Unterstützung für diese Änderung in der Zusammenfassungsdienst Dieses Dokument wird ebenso wie die Änderungsprotokoll nachdem die Änderungen versendet wurden.

Wir haben ein Dokument mit praktischen Tipps und Strategien zur Erstellung von Zusammenfassungen berichten. Es gibt eine Reihe von Statistiken, darunter:

  • Übersicht über das Rauschen bei der Erstellung des Zusammenfassungsberichts
  • Eine ausführliche Erläuterung von Dimensionen, Schlüsseln und Werten
  • Aggregationsschlüssel in der Praxis, einschließlich einer Schlüsselstrukturzuordnung
  • Aggregierbare Werte in der Praxis und Auswirkungen des Beitragsbudgets
  • Leitfaden für Experimente mit Epsilon

Weitere Informationen zu den Aktualisierungen

Das Kopfzeilenbild stammt von Diana Polekhina auf Unsplash.