Zmiany w raportach atrybucji w czerwcu 2022 r.

Propozycja raportowania atrybucji zmienia się w wersji Chrome 104 z nowymi mechanizmami, funkcjami i aktualizacjami interfejsu API do usługi agregacji.

Dla kogo są te aktualizacje?

Te aktualizacje są dla Ciebie, jeśli:

  • Znasz już interfejs API – jeśli na przykład obserwujesz lub uczestniczysz w dyskusjach w repozytorium WICG i chcesz zrozumieć zmiany wprowadzone w interfejsie API.
  • Korzystasz z interfejsu Attribution Reporting API w ramach wersji demonstracyjnej lub zamierzasz przetestować w interfejsie origin próbny.

Jeśli dopiero zaczynasz korzystać z tego interfejsu API lub nie masz z nim żadnych eksperymentów przejdź bezpośrednio do wprowadzenia do API.

Aktualizacje interfejsu Attribution Reporting API

Prezentacja raportowania atrybucji zostały zaktualizowane, aby uwzględnić najnowsze zmiany w raportach atrybucji. API po stronie klienta.

Większość zmian nie wymaga żadnych działań. Te, które wymagają aktualizacji dotyczące ich implementacji.

(Wymagane działanie) ujednolicone nagłówki na potrzeby rejestracji

Nagłówki zostały ujednolicone. Teraz tylko 1 nagłówek dla źródeł i 1 dla aktywatorów w formacie JSON.

  • Aby zarejestrować źródła atrybucji, możesz odpowiadać na prośby o rejestrację z nagłówkiem Attribution-Reporting-Register-Source.
  • Aby dokończyć rejestrację aktywatora, ustaw w parametrze Nagłówek Attribution-Reporting-Register-Trigger.

Ta zmiana wymaga działania. Zapoznaj się z Przewodnik po interfejsie API dla programistów .

(Wymagane działanie) Klucze agregacji są teraz słownikiem

Aby zarejestrować źródła atrybucji: nadal używaj aggregation_keys, ale teraz jest ona przechowywana jako słownik JSON z 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 działania. Zapoznaj się z Podręcznik o interfejsie API .

Generowanie raportów

Możesz generować tylko raporty agregowane, które mogą być agregowane do raportów podsumowujących. Jeśli filtry nie pasują do żadnych reguł zdarzeń, wtedy nie. na poziomie zdarzenia.

Ustawienie ujednoliconego klucza debugowania

Klucz debugowania powinien być teraz ustawiony w nagłówkach źródła i aktywatora, a nie z osobnymi nagłówkami. Dowiedz się więcej o debugowaniu. .

Rejestrowanie źródeł atrybucji

Tagi skryptu można teraz używać do rejestrowania źródeł atrybucji, podobnie jak dla tagu <img>.

Więcej aktualizacji interfejsu API

Inne zmiany, które zostały 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 rejestracji możesz teraz opcjonalnie podać wartość attributionsrc źródeł.
  • Do źródła przychodzącego dodano Attribution-Reporting-Eligible nagłówek wniosków o rejestrację.
  • Wprowadzono niewielką zmianę w: encodeURIComponent.
  • Klucz prywatności budżetu został usunięty z pola shared_info w raportach agregowanych.

Pomoc dotycząca usługi agregacji

W Chrome 104 zamierzamy zaktualizować format niektórych informacji do agregacji. Pracujemy nad tą zmianą agregacja danych. Ten dokument zostanie zaktualizowany. historia zmian, po wysłaniu zmian.

Zebraliśmy dokument z praktycznymi wskazówkami i strategiami generowania podsumowania . Dostępnych jest wiele statystyk, w tym:

  • Omówienie szumu podczas generowania raportów podsumowujących
  • szczegółowe omówienie wymiarów, kluczy i wartości;
  • Klucze agregacji w praktyce, w tym mapa struktury kluczy
  • Agregowane wartości w praktyce oraz konsekwencje budżetu darowizn
  • Przewodnik po eksperymentowaniu z wartością ypsilon

Więcej informacji o zmianach

Obraz w nagłówku pochodzi od Diany Polekhina na kanale Unsplash.