Migrationsleitfaden (Chrome 92): Vom Conversion Measurement API zum Attribution Reporting API

In Chrome 92 werden am Conversion Measurement API Änderungen vollzogen.

Published on Updated on

Translated to: English, Español, Português, 한국어, 中文, Pусский, 日本語, Français

Wenn Sie Fragen haben oder während Ihrer Migration Unterstützung benötigen, tragen Sie sich in die Mailingliste ein und stellen Sie Ihre Frage.

Was ändert sich?

Nach den Änderungen am API-Vorschlag in den ersten Monaten des Jahres 2021 entwickelt sich die API-Implementierung in Chrome nun weiter. Folgendes ändert sich:

  • Der API-Name und der Feature-Policy-Name.
  • Die Namen der HTML-Attribute und .well-known-URLs.
  • Das Berichtsformat. Berichte werden jetzt als JSON im Body der Anfrage gesendet.
  • Der Inhalt der Berichte: Die credit-Angabe, sowie Berichte die einen Credit von 0 hätten, wurden entfernt.

Was in Chrome 92 unverändert bleibt, ist die Auswahl unterstützter Funktionen: Berichte auf Ereignisebene (nur für Klicks). Erwarten Sie hierzu in Zukunft weitere Neuigkeiten. Nach dieser Änderung werden in zukünftigen Chrome-Versionen weitere Updates und Funktionen veröffentlicht.

Um Updates zur Origin-Trial für dieses API und kommende Funktionen zu erhalten, tragen Sie sich in die Mailingliste ein.

Wann treten diese Änderungen in Kraft?

Diese Änderungen traten am 20. Juli 2021 mit der Veröffentlichung der stabilen Version von Chrome 92 in Kraft. Die Betaversion von Chrome 92 wurde am 3. Juni 2021 veröffentlicht.

Was sollte man tun?

Es wird in zukünftigen Versionen weitere Änderungen an dem API geben. Bei diesen Änderung werden die neuen Bezeichnungen verwendet, die in Chrome 92 eingeführt wurden.

Wenn Sie eine Origin-Trial ausführen oder eine Demo für dieses 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 bereit und wird auch mit neueren Chrome-Clients funktionieren.
  • Option 2: Warten Sie, bis weitere Updates und Funktionen in zukünftigen Chrome-Versionen veröffentlicht werden, und nehmen Sie alle erforderlichen Codeänderungen auf einmal vor.

Migrieren Sie

Beispiel für eine Migration

In dieser Pull-Anfrage (Entwurf) sehen Sie ein entsprechendes Beispiel für eine kleine Demo-App.

Aktualisieren Sie den Code Ihrer Feature-Policy

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

Aktualisieren Sie Ihren Funktionserkennungs-Code

Legacy-CodeNeuer Code
document.featurePolicy.features()<br>.includes('conversion-measurement')document.featurePolicy.features()<br>.includes('attribution-reporting')

Aktualisieren Sie die HTML-Attribute

Legacy-CodeNeuer Code
conversiondestinationattributiondestination
impressiondataattributionsourceeventid
impressionexpiryattributionexpiry
reportingoriginattributionreportto

Aktualisieren Sie die window.open()-Argumente

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

Ihr neuer Code sollte wie folgt aussehen (die Angaben berücksichtigen die Umbenennung der HTML-Attribute):

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

Aktualisieren Sie die URL und den Parameter Ihres Registrierungsaufrufs

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

Aktualisieren Sie den Code Ihres Berichtendpunkts

Legacy-CodeNeuer Code
Vom Browser zu erwartende Anfragen.well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100.well-known/attribution-reporting/trigger-attribution</td> </tr> <tr> <td>Ankommende Berichte</td> <td>Als URL-Parameter gesendet.</td> <td>Als JSON im Body der Anfrage gesendet.<br> <br> Die Daten des Berichts sind <strong>im Anfrage-Body als JSON-Objekt </strong> mit den folgenden Schlüsseln enthalten:<br> <code>source_event_id:<br> <code>source_event_id: vorher impression-data, die 64-Bit-Ereignis-ID, die für die Attributionsquelle festgelegt wurde.
trigger_data: früher conversion-data, der 3-Bit-Datensatz in der Attributions-Trigger-Weiterleitung.

⚠️ credit wurde entfernt.

Updated on Improve article

This site uses cookies to deliver and enhance the quality of its services and to analyze traffic. If you agree, cookies are also used to serve advertising and to personalize the content and advertisements that you see. Learn more about our use of cookies.