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

In Chrome 92 gibt es Änderungen an der Conversion Measurement API.

Was ändert sich?

Entsprechend den Änderungen am API-Angebot in den ersten Monaten des Jahres 2021 entwickelte sich die API-Implementierung in Chrome weiterentwickelt. Folgendes wird sich ändern:

  • Der Name der API und der Name der Berechtigungsrichtlinie.
  • Die HTML-Attributnamen und .well-known-URLs.
  • Das Format der Berichte. Berichte werden jetzt im JSON-Format im Anfragetext gesendet.
  • Der Inhalt der Berichte „credit“ und alle Berichte, denen kein Guthaben zugeordnet wurde, wurden entfernt.

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

Wann treten diese Änderungen in Kraft?

Diese Änderungen treten ab Chrome in Kraft 92, stabil am 20. Juli 2021. Die Betaversion von Chrome 92 wurde am 3. Juni 2021 veröffentlicht.

Was solltest du tun?

Wenn Sie einen Ursprungstest durchgeführt oder eine Demo für diese API implementiert haben, haben Sie zwei Optionen:

  • Option 1 (empfohlen): Migrieren Sie Ihren Code jetzt oder in den darauffolgenden Wochen, idealerweise vor Mitte Juli 2021. So ist Ihre Codebasis für zukünftige Änderungen gerüstet für neuere Chrome-Clients verwenden.
  • Option 2: Warten, bis in zukünftigen Chrome-Versionen weitere Updates und Funktionen veröffentlicht werden und alle erforderlichen Änderungen am Code auf einmal vornehmen.

Migrieren

Beispielmigration

Ein Migrationsbeispiel für eine kleine Demo-App finden Sie in dieser Pull-Anfrage (Entwurf).

Code der Berechtigungsrichtlinie aktualisieren

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

Funktionserkennungscode aktualisieren

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

HTML-Attribute aktualisieren

Alter Code Neuer Code
conversiondestination attributiondestination
impressiondata attributionsourceeventid
impressionexpiry attributionexpiry
reportingorigin attributionreportto

window.open() Argumente aktualisieren

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

Ihr neuer Code sollte wie folgt aussehen (diese Umbenennung folgt den HTML-Attributen Umbenennung):

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

URL und Parameter des Registrierungsaufrufs aktualisieren

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

Code des Endpunkts für die Berichterstellung aktualisieren

Alter Code Neuer Code
Vom Browser erwartete 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 dem Parameter folgende Schlüssel:
source_event_id: Früher impression-data, die 64-Bit-Ereignis-ID, die für die Attributionsquelle festgelegt wurde.
trigger_data: früher conversion-data, das 3-Bit-Dataset im Attributionstrigger Weiterleitung.

⚠️ credit wurde entfernt.

Attribution Reporting: Alle Ressourcen

Weitere Informationen finden Sie unter Attributionsberichte.