[Veraltet] Migrationsanleitung (Chrome 92): Conversion Measurement API zur Attribution Reporting API

Die Conversion Measurement API wird in Chrome 92 geändert.

Was ändert sich?

Aufgrund der Änderungen des API-Vorschlags in den ersten Monaten 2021 wird auch die API-Implementierung in Chrome weiterentwickelt. Folgendes wird sich ändern:

  • Der API-Name und der Name der Berechtigungsrichtlinie.
  • Die HTML-Attributnamen und .well-known-URLs.
  • Das Format der Berichte. Berichte werden jetzt als JSON im Anfragetext gesendet.
  • Der Inhalt der Berichte „credit“ und die Berichte, denen sonst kein Guthaben mehr zugeordnet worden wäre, wurden entfernt.

In Chrome 92 bleiben die unterstützten Funktionen unverändert: Berichte auf Ereignisebene nur für Klicks. Weitere Informationen Nach dieser Änderung werden in zukünftigen Chrome-Versionen weitere Updates und Funktionen veröffentlicht.

Wann treten diese Änderungen in Kraft?

Diese Änderungen gelten ab dem 20. Juli 2021 ab Chrome 92. Die Betaversion von Chrome 92 wurde am 3. Juni 2021 veröffentlicht.

Was solltet ihr tun?

Wenn Sie einen Ursprungstest ausgeführt oder eine Demo für diese API implementiert haben, haben Sie zwei Möglichkeiten:

  • Option 1 (empfohlen): Migrieren Sie Ihren Code jetzt oder in den folgenden Wochen, idealerweise vor Mitte Juli 2021. Auf diese Weise ist Ihre Codebasis für zukünftige Änderungen gerüstet und funktioniert weiterhin für neuere Chrome-Clients.
  • Option 2: Warten Sie, bis weitere Updates und Funktionen in zukünftigen Chrome-Versionen veröffentlicht werden, und nehmen Sie dann alle erforderlichen Codeänderungen gleichzeitig vor.

Migrieren

Beispielmigration

In dieser Pull-Anfrage (Entwurf) sehen Sie ein Beispiel für die Migration einer kleinen Demo-App.

Code für die Richtlinie für Berechtigungen aktualisieren

Legacy-Code Neuer Code
allow='conversion-measurement' allow='attribution-reporting'

Code zur Funktionserkennung aktualisieren

Legacy-Code Neuer Code
document.featurePolicy.features()
.includes('conversion-measurement')		 document.featurePolicy.features()
.includes('attribution-reporting')

HTML-Attribute aktualisieren

Legacy-Code Neuer Code
conversiondestination attributiondestination
impressiondata attributionsourceeventid
impressionexpiry attributionexpiry
reportingorigin attributionreportto

window.open() Argumente aktualisieren

Für durch window.open() initiierte Navigationen kann eine Attributionsquelle registriert werden. Aktualisieren Sie diese Aufrufe, wenn Sie window.open() zum Registrieren von Attributionsquellen verwenden.

Der neue Code sollte so aussehen (diese Umbenennung folgt der Umbenennung von HTML-Attributen):

window.open(
  'https://dest.example',
  '_blank',
  'attributionsourceeventid=1234,attributiondestination=https://dest.example,attributionreportto=https://reporter.example,attributionexpiry=604800000'
);

URL und Parameter für den Registrierungsaufruf aktualisieren

Legacy-Code Neuer Code
.well-known/register-conversion?conversion-data={DATA} .well-known/attribution-reporting/trigger-attribution?trigger-data={DATA}

Code für Endpunkt der Berichterstellung aktualisieren

Legacy-Code Neuer Code
Vom Browser zu erwartende Anfragen .well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100 .well-known/attribution-reporting/trigger-attribution
Eingehende Berichte Wird als URL-Parameter gesendet. Wird als JSON im Anfragetext gesendet.

Die Berichtsdaten sind im Anfragetext als JSON-Objekt mit den folgenden Schlüsseln enthalten:
source_event_id: früher impression-data, die 64-Bit-Ereignis-ID, die in der Attributionsquelle festgelegt wurde.
trigger_data: früher conversion-data, der 3-Bit-Datensatz im Attributionstrigger.

⚠️ credit wurde entfernt.

Attribution Reporting: alle Ressourcen

Weitere Informationen finden Sie unter Attributionsberichte.