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

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

Was ändert sich?

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

  • Der API-Name und der Name der Berechtigungsrichtlinie.
  • Die Namen der HTML-Attribute und die .well-known-URLs.
  • Das Format der Berichte. Berichte werden jetzt als JSON im Anfragetext gesendet.
  • Inhalte der Berichte: credit wurde entfernt, ebenso Berichte, die keine Gutschrift ergeben hätten.

In Chrome 92 bleibt die Anzahl der unterstützten Funktionen unverändert: Berichte auf Ereignisebene nur für Klicks. Wir halten Sie auf dem Laufenden. Nach dieser Änderung werden andere Updates und Funktionen in zukünftigen Chrome-Versionen veröffentlicht.

Wann treten diese Änderungen in Kraft?

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

Was solltest du 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. So ist Ihr Code für zukünftige Änderungen gerüstet und funktioniert auch mit neueren Chrome-Clients.
  • Option 2: Warten Sie, bis in zukünftigen Chrome-Versionen weitere Updates und Funktionen veröffentlicht werden, und nehmen Sie alle erforderlichen Codeänderungen auf einmal vor.

Migrieren

Beispiel für die Migration

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

Code für Berechtigungsrichtlinien aktualisieren

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

Code zur Erkennung von Funktionen 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

Eine Attributionsquelle kann für Navigationen registriert werden, die von window.open() initiiert werden. Aktualisieren Sie diese Aufrufe, wenn Sie window.open() verwenden, um Attributionsquellen zu registrieren.

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'
);

Registrierungsaufruf-URL und ‑Parameter aktualisieren

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

Code für den Berichterstellungs-Endpunkt 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 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: Die 64-Bit-Ereignis-ID, die für die Attributionsquelle festgelegt ist. Früher impression-data.
trigger_data: Früher conversion-data, das 3‑Bit-Dataset in der Attributions-Trigger-Weiterleitung.

⚠️ credit wurde entfernt.

Attribution Reporting: Alle Ressourcen

Weitere Informationen finden Sie unter Attribution Reporting.