Zmiany w raportach atrybucji w czerwcu 2022 r.

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

Źródłem obrazu w nagłówku jest Diana Polekhina na kanale Unsplash.