Oferta Attribution Reporting w wersji Chrome 104 ulegnie zmianie, w której zostaną wprowadzone nowe mechanizmy i funkcje interfejsu API oraz aktualizacje usługi agregacji.
Dla kogo są przeznaczone te aktualizacje?
Te aktualizacje są dla Ciebie, jeśli:
- Znasz już interfejs API, np. jeśli obserwujesz lub uczestniczysz w dyskusjach w repozytorium WICG i chcesz zrozumieć wprowadzone w nim zmiany.
- Używasz interfejsu Attribution Reporting API w wersji demonstracyjnej lub planujesz testować ją w okresie próbnym źródła.
Jeśli dopiero zaczynasz korzystać z tego interfejsu API lub jeszcze z nim nie testujesz, przejdź od razu do wprowadzenia do interfejsu API.
Aktualizacje interfejsu Attribution Reporting API
Zaktualizowaliśmy prezentację funkcji Raportowanie atrybucji, aby uwzględniała ona najnowsze zmiany w interfejsie API do raportowania atrybucji po stronie klienta.
Większość zmian nie wymaga żadnych działań. Te, które wymagają aktualizacji, zostały wyróżnione poniżej.
(Wymagane działanie) ujednolicone nagłówki rejestracji
Nagłówki zostały ujednolicone. Jest tylko jeden nagłówek dla źródeł i jeden dla aktywatorów, w formacie JSON.
- Aby zarejestrować źródła atrybucji, odpowiadaj na żądania rejestracji, używając nagłówka
Attribution-Reporting-Register-Source
. - Aby ukończyć rejestrację aktywatora, ustaw nagłówek
Attribution-Reporting-Register-Trigger
.
Ta zmiana wymaga podjęcia działania. Więcej informacji znajdziesz w przewodniku po interfejsie API dla programistów.
(Wymagane działanie) klucze agregacji są teraz słownikami
Aby zarejestrować źródła atrybucji, nadal korzystaj z funkcji aggregation_keys
, ale teraz są przechowywane w postaci słownika JSON zamiast listy.
Na przykład:
"aggregation_keys": {
// Generate a "0x159" key piece for the key named "campaignCounts".
"campaignCounts": "0x159", // User saw ad from campaign 345 (out of 511)
// Generates a "0x5" key piece (low order bits of the key) for
// the key named "geoValue".
"geoValue": "0x5" // Source-side geo region = 5 (US), out of a possible ~100 regions
}
Ta zmiana wymaga podjęcia działania. Więcej informacji znajdziesz w podręczniku API.
Generowanie raportu
Możesz też generować tylko raporty zbiorcze, które potem zostaną połączone w raporty podsumowujące. Jeśli do filtrów nie pasują żadne reguły zdarzeń, nie będą generowane raporty na poziomie zdarzenia.
Ustawienie ujednoliconego klucza debugowania
Klucz debugowania powinien być teraz ustawiony w nagłówkach źródła i aktywatora, a nie w osobnych nagłówkach. Dowiedz się więcej o debugowaniu raportów.
Rejestrowanie źródeł atrybucji
Do rejestrowania źródeł atrybucji możesz teraz używać tagów skryptu, podobnie jak w przypadku tagu <img>
.
Więcej aktualizacji interfejsu API
Inne zmiany wprowadzone i cytowane w podręczniku dotyczącym interfejsu API to między innymi:
- Źródła można rejestrować za pomocą interfejsów API żądań JavaScript.
- Pole „
window.registerSource
” zostało usunięte. - Podczas rejestrowania źródeł możesz teraz dodać wartość
attributionsrc
. - Do przychodzących próśb o rejestrację dodano nagłówek
Attribution-Reporting-Eligible
. - Wprowadzono nieznaczną zmianę w:
encodeURIComponent
. - Klucz budżetu prywatności został usunięty z pola
shared_info
w raportach zbiorczych.
Obsługa usługi agregacji
W Chrome 104 zamierzamy zaktualizować format niektórych informacji w raportach zbiorczych. Obecnie pracujemy nad obsługą tej zmiany w usłudze agregacji. Po wysłaniu zmian ten dokument i historia zmian zostaną zaktualizowane.
Przygotowaliśmy dokument z praktycznymi wskazówkami i strategiami dotyczącymi generowania raportów podsumowujących. Dostępne są różne statystyki, m.in.:
- Omówienie szumu podczas generowania raportu podsumowującego
- szczegółowe objaśnienie wymiarów, kluczy i wartości;
- Praktyczne klucze agregacji, w tym mapa struktury kluczy
- Agregowane wartości w praktyce oraz konsekwencje budżetu darowizn
- Przewodnik po eksperymentowaniu z epsilonem
Więcej informacji o aktualizacjach
- Przeczytaj artykuł Co warto wiedzieć o interfejsie API.
- Przeczytaj artykuł Eksperymentowanie z raportami atrybucji: strategia i wskazówki dotyczące raportów podsumowujących.
Źródłem obrazu w nagłówku jest Diana Polekhina na kanale Unsplash.