[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.