Ä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
- Wichtige Informationen zur API
- Weitere Informationen finden Sie unter Experimentieren mit Attributionsberichten: Strategie und Tipps für zusammenfassende Berichte.
Das Kopfzeilenbild stammt von Diana Polekhina auf Unsplash.