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

Interfejs Conversion Measurement API zmieni się w Chrome 92.

Co się zmienia?

W pierwszych miesiącach 2021 r. wprowadziliśmy zmiany w propozycji interfejsu API, a teraz rozwijamy jego implementację w Chrome. Co się zmienia:

Nazwa interfejsu API i nazwa zasady uprawnień.
Nazwy atrybutów HTML i .well-known adresy URL.
Format raportów. Raporty są teraz wysyłane w formacie JSON w treści żądania.
Treści w raportach: credit zostały usunięte wraz z raportami, które miałyby 0 kredytów.

W Chrome 92 nie zmienia się zestaw obsługiwanych funkcji: raporty na poziomie zdarzenia, ale tylko w przypadku kliknięć. Będziemy o tym informować na bieżąco. Po tej zmianie inne aktualizacje i funkcje będą udostępniane w przyszłych wersjach Chrome.

Kiedy te zmiany zaczną obowiązywać?

Zmiany te zaczną obowiązywać w Chrome 92, którego stabilna wersja zostanie udostępniona 20 lipca 2021 r. Wersja beta Chrome 92 została wydana 3 czerwca 2021 r.

Co musisz zrobić?

Jeśli korzystasz z okresu próbnego lub masz wdrożoną wersję demonstracyjną tego interfejsu API, masz 2 możliwości:

Opcja 1 (zalecana): przenieś kod teraz lub w najbliższych tygodniach, najlepiej przed połową lipca 2021 r. Dzięki temu baza kodu będzie gotowa na przyszłe zmiany i będzie działać w nowszych klientach Chrome.
Opcja 2: poczekać na kolejne aktualizacje i funkcje, które zostaną udostępnione w przyszłych wersjach Chrome, i wprowadzić wszystkie niezbędne zmiany w kodzie naraz.

Migruj

Przykładowa migracja

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

Aktualizowanie kodu 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')`

Aktualizowanie atrybutów HTML

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

Aktualizowanie argumentów `window.open()`

Źródło atrybucji można zarejestrować w przypadku nawigacji zainicjowanych przez window.open(). Jeśli do rejestrowania źródeł atrybucji używasz window.open(), zaktualizuj te wywołania.

Nowy kod powinien wyglądać tak (zmiana nazwy jest zgodna z zasadami zmiany 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 wywołania rejestracji i parametru

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, których można się spodziewać ze strony 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.	Wysyłane w formacie JSON w treści żądania. Dane raportu są zawarte w treści żądania jako obiekt JSON z tymi kluczami: `source_event_id`: wcześniej `impression-data`, 64-bitowy identyfikator zdarzenia ustawiony w źródle atrybucji. `trigger_data`: wcześniej `conversion-data`, 3-bitowy zbiór danych w wyzwalaczu atrybucji przekierowanie. ⚠️ Usunięto `credit`.

Raporty atrybucji: wszystkie zasoby

Zobacz Raportowanie atrybucji.