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

W Chrome 92 nastąpiła zmiana interfejsu API pomiaru konwersji.

Co się zmienia?

Po zmianach wprowadzonych w pierwszych miesiącach 2021 roku w propozycji interfejsu API implementacja interfejsu API w Chrome ewoluuje. Co się zmienia:

Nazwa interfejsu API i nazwa zasad dotyczących uprawnień.
nazwy atrybutów HTML i adresy URL .well-known;
Format raportów. Raporty są teraz wysyłane w formacie JSON w treści żądania.
Treści zgłoszeń: credit zostały usunięte wraz ze zgłoszeniami, które nie miały przypisanej żadnej kwoty.

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

Kiedy te zmiany zaczną obowiązywać?

Zmiany te zaczną obowiązywać w wersji Chrome 92, która jest stabilna od 20 lipca 2021 r. Wersja beta Chrome 92 została wydana 3 czerwca 2021 r.

Co musisz zrobić?

Jeśli korzystasz z bezpłatnego okresu próbnego wersji źródłowej lub zaimplementowałeś wersję demonstracyjną tego interfejsu API, masz 2 opcje:

Opcja 1 (zalecana): przenieś kod teraz lub w następnych tygodniach, najlepiej przed połową lipca 2021 r. Dzięki temu kod źródłowy będzie gotowy na przyszłe zmiany i nadal będzie działać w przypadku nowszych wersji Chrome.
Opcja 2. Poczekaj na kolejne aktualizacje i funkcje, które zostaną wydane w przyszłych wersjach Chrome, a potem wprowadź wszystkie niezbędne zmiany kodu od razu.

Migruj

Przykład migracji

Przykład migracji małej aplikacji demonstracyjnej znajdziesz w tym pull request (draft).

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 być zarejestrowane w przypadku nawigacji rozpoczętej przez window.open(). Zaktualizuj te wywołania, jeśli do rejestrowania źródeł atrybucji używasz wywołania window.open().

Twój nowy kod powinien wyglądać tak (ta zmiana nazwy następuje zgodnie z przemianą 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 parametrów 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
Prośby o dostęp z przeglądarki	`.well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100`	`.well-known/attribution-reporting/trigger-attribution`
Raporty przychodzące	Parametry są wysyłane jako parametry adresu URL.	Jest on wysyłany w postaci danych JSON w treści żądania. Dane raportu są zawarte w ciele żądania jako obiekt JSON z tymi kluczami: `source_event_id`: w tym polu (wcześniej `impression-data`) znajduje się 64-bitowy identyfikator zdarzenia ustawiony w źródle atrybucji. `trigger_data`: wcześniej `conversion-data`, 3-bitowy zbiór danych w przekierowaniu reguły atrybucji. ⚠️ `credit` został usunięty.

Raportowanie atrybucji: wszystkie zasoby

Zobacz raportowanie atrybucji.