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

Po wprowadzeniu zmian w propozycji interfejsu API w pierwszych miesiącach 2021 roku zmieniamy sposób wdrażania interfejsów API w Chrome. Co się zmienia:

  • Nazwa interfejsu API i nazwa zasady 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ść tych raportów (credit) została usunięta wraz z raportami, które miałyby 0 udziałów.

W Chrome 92 pozostaje tylko zestaw obsługiwanych funkcji: raporty na poziomie zdarzenia, tylko dotyczące kliknięć. Informacje na ten temat Po tej zmianie w kolejnych wersjach Chrome zostaną udostępnione inne aktualizacje i funkcje.

Kiedy te zmiany zaczną obowiązywać?

Te zmiany obowiązują od Chrome 92, na 20 lipca 2021 r. Przeglądarka Chrome 92 w wersji beta została udostępniona 3 czerwca 2021 r.

Co musisz zrobić?

Jeśli zdarzyło Ci się korzystać z testu origin lub wdrożyłeś(-aś) wersję demonstracyjną tego interfejsu API, masz 2 opcje:

  • Opcja 1 (zalecana): przeprowadź migrację kodu teraz lub w kolejnych tygodniach, najlepiej przed do połowy lipca 2021 r. Dzięki temu baza kodu będzie gotowa na przyszłe zmiany i będzie będą nadal działać w nowszych klientach Chrome.
  • Opcja 2. Poczekaj, aż w kolejnych wersjach Chrome pojawią się dodatkowe aktualizacje i funkcje. i wprowadzić wszystkie niezbędne zmiany w kodzie jednocześnie.

Migruj

Przykładowa migracja

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

Zaktualizuj kod zasad uprawnień

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

Zaktualizuj kod 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żna zarejestrować dla nawigacji zainicjowanych przez window.open(). Zaktualizuj te wywołania, jeśli do rejestrowania źródeł atrybucji używasz konta window.open().

Twój nowy kod powinien wyglądać następująco (zmiana nazwy jest zgodna z atrybutami HTML zmiana nazwy):

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

Aktualizowanie adresu URL i parametru połączenia rejestracyjnego

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
oczekiwane żądania 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łana jako parametry adresu URL. Wysyłane w formacie JSON w treści żądania.

Dane z raportu są zawarte w treści żądania jako obiekt JSON z parametrem następujące klucze:
source_event_id: dawniej impression-data, 64-bitowy identyfikator zdarzenia ustawiany w źródle atrybucji.
trigger_data: wcześniej conversion-data, 3-bitowy zbiór danych w regule atrybucji. .

⚠️ credit został usunięty.

Attribution Reporting: wszystkie materiały

Przeczytaj artykuł Raporty atrybucji.