[Nieaktualne] Przewodnik po migracji (Chrome 92): Conversion Measurement API do Attribution Reporting API

W Chrome 92 zmienia się interfejs Conversion Measurement API.

Co się zmienia?

W związku ze zmianami wprowadzonymi w propozycji interfejsu API w pierwszych miesiącach 2021 roku wdrażanie interfejsu API w Chrome zmienia się. Co się zmienia:

  • Nazwa interfejsu API i nazwa zasady uprawnień.
  • Nazwy atrybutów HTML i adresy URL .well-known.
  • Format raportów. Raporty w treści żądania są wysyłane w formacie JSON.
  • Usunęliśmy treść raportów: credit oraz raporty, które miałyby 0 udziału.

W Chrome 92 pozostaje tylko zestaw obsługiwanych funkcji: raporty na poziomie zdarzenia obejmujące tylko kliknięcia. Możesz spodziewać się nowych informacji na ten temat. Po wprowadzeniu tej zmiany inne aktualizacje i funkcje będą udostępniane w kolejnych wersjach Chrome.

Kiedy te zmiany zaczną obowiązywać?

Te zmiany zaczną obowiązywać Chrome 92, stabilnie w dniu 20 lipca 2021 roku. Wersja beta Chrome 92 została opublikowana 3 czerwca 2021 r.

Co musisz zrobić?

Jeśli korzystasz z testowania origin lub wdrażasz wersję demonstracyjną tego interfejsu API, masz 2 możliwości:

  • Opcja 1 (zalecana): przeprowadź migrację kodu teraz lub w ciągu najbliższych tygodni, najlepiej do połowy lipca 2021 r. Dzięki temu Twoja baza kodu będzie gotowa na przyszłe zmiany i będzie nadal działać z nowszymi klientami Chrome.
  • Opcja 2: poczekaj na pojawienie się kolejnych aktualizacji i funkcji w kolejnych wersjach Chrome, a następnie wprowadź wszystkie niezbędne zmiany w kodzie naraz.

Migracja

Przykładowa migracja

Przykład migracji małej aplikacji demonstracyjnej znajdziesz w tym żądaniu pull (wersja robocza).

Zaktualizuj kod zasad dotyczących uprawnień

Starszy kod Nowy kod
allow='conversion-measurement' allow='attribution-reporting'

Aktualizowanie kodu wykrywania funkcji

Starszy kod Nowy kod
document.featurePolicy.features()
.includes('conversion-measurement')		 document.featurePolicy.features()
.includes('attribution-reporting')

Zaktualizuj atrybuty HTML

Starszy kod Nowy kod
conversiondestination attributiondestination
impressiondata attributionsourceeventid
impressionexpiry attributionexpiry
reportingorigin attributionreportto

Zaktualizuj argumenty window.open()

Źródło atrybucji może zostać zarejestrowane dla nawigacji zainicjowanych przez użytkownika window.open(). Zaktualizuj te połączenia, jeśli do rejestrowania źródeł atrybucji używasz funkcji window.open().

Nowy kod powinien wyglądać tak (zmiana nazwy odpowiada zmianie nazw atrybutów HTML):

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

Aktualizowanie adresu URL i parametru wywołania rejestracji

Starszy kod Nowy kod
.well-known/register-conversion?conversion-data={DATA} .well-known/attribution-reporting/trigger-attribution?trigger-data={DATA}

Aktualizowanie kodu punktu końcowego raportowania

Starszy kod Nowy kod
Żądania oczekiwane od przeglądarki .well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100 .well-known/attribution-reporting/trigger-attribution
Raporty przychodzące Wysyłane jako parametry adresu URL. Wysłano jako JSON w treści żądania.

Dane raportu są uwzględniane w treści żądania jako obiekt JSON z tymi kluczami:
source_event_id: dawniej impression-data, 64-bitowy identyfikator zdarzenia ustawiony w źródle atrybucji.
trigger_data: dawniej conversion-data, 3-bitowy zbiór danych w przekierowaniu reguły atrybucji.

⚠️ Użytkownik credit został usunięty.

Attribution Reporting: wszystkie zasoby

Patrz raporty atrybucji.