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() |
document.featurePolicy.features() |
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.