Omówienie raportowania atrybucji w internecie

Możesz mierzyć, kiedy kliknięcie lub wyświetlenie reklamy prowadzi do konwersji, np. do zakupu w witrynie reklamodawcy.

Dla kogo jest to przypomnienie?

Znajdziesz tu podstawowe informacje o raportach atrybucji i kilka podstawowych pojęć, ale niewiele szczegółów technicznych.

• Jeśli zajmujesz się reklamami lub technologiami reklamowymi, dowiesz się, w jaki sposób ten interfejs API zapewnia możliwości wchodzące w skład korzystania z plików cookie innych firm. Więcej informacji o generowaniu raportów znajdziesz w przypadkach użycia interfejsu API.
• Jeśli jesteś programistą lub inżynierem oprogramowania, przejdź do pełnego przeglądu systemu lub eksperymentuj i korzystaj z interfejsu API.

Reklamodawcy i wydawcy, którzy używają platform technologii reklamowych do pomiaru konwersji, nie muszą bezpośrednio korzystać z interfejsu API. Jeśli Twoja technologia reklamowa ma zostać zintegrowana z tym interfejsem API, może zainteresuje Cię, jak działa raportowanie atrybucji.

Czym jest interfejs Attribution Reporting API?

Obecnie pomiar konwersji z reklam często opiera się na plikach cookie innych firm. Przeglądarki ograniczają dostęp do plików cookie innych firm, ponieważ mogą one służyć do śledzenia użytkowników w różnych witrynach i ograniczania ich prywatności.

Interfejs Attribution Reporting API umożliwia wykonywanie tych pomiarów w sposób zapewniający ochronę prywatności, bez stosowania plików cookie innych firm.

Umożliwia on reklamodawcom i dostawcom technologii reklamowych mierzenie konwersji w tych przypadkach:

• Kliknięcia i wyświetlenia reklam.
• Reklamy w elemencie iframe firmy zewnętrznej, np. reklamy w witrynie wydawcy korzystającej z usług zewnętrznego dostawcy technologii reklamowych.
• Reklamy w kontekście własnym, np. w sieci społecznościowej lub na stronie wyników wyszukiwarki albo wydawca wyświetla własne reklamy.

Jeśli nie znasz niektórych z tych terminów lub pojęć, zajrzyj do słowniczka Piaskownicy prywatności.

Wypróbuj API

• Przetestuj ją lokalnie w przeglądarce. Ustaw flagę, która informuje przeglądarkę Chrome, że ma włączyć określone funkcje eksperymentalne.

Jeśli chcesz poeksperymentować z interfejsem API, przejdź do artykułu Raportowanie atrybucji: eksperyment i uczestnictwo.

Zmiany w interfejsie API

• Śledź zmiany interfejsu API.
• Dowiedz się, dlaczego udostępniliśmy interfejs Attribution Reporting API w pierwszej połowie 2023 r.

Dostępność

Proposal	Status
Conversion journey: app-to-web Web explainer and Android explainer Mailing list announcement	Available in Chrome and Android for origin trial
Conversion journey: cross-device Explainer	This proposal has been archived. There are no current plans for implementation.
Preventing invalid aggregatable reports using report verification Explainer	Expected in Chrome in H1 2024
Default allowlist for the Attribution Reporting API Permissions-Policy will remain * Mailing list announcement	Available in Chrome in Q1 2023
Configurable Event-Level reporting epsilon GitHub issuek	Available in Chrome in Q4 2023
Padding for Aggregatable reports payload Updated explainer	Available in Chrome in Q4 2023
Phase 1 Lite Flexible Event-Level Flexible event-level configurations explainer	Available in Chrome in Q4 2023 The ability to customize the number of attribution reports and the number/length of reporting windows. Available in Chrome in Q1 2024 The ability to customize the number of bits of trigger data.
Support for Attribution Reporting debugging after third-party cookie deprecation Seeking feedback on GitHub	Expected in Chrome in H1 2024
Support for Attribution Reporting API and Aggregation Service for Google Cloud Attribution Reporting API Explainer Aggregation Service Explainer	Available in Chrome in H2 2023

Przypadki użycia i funkcje

Interfejs Attribution Reporting API zapewnia dostęp do różnych rodzajów statystyk w postaci 2 rodzajów raportów, które można wysyłać do reklamodawcy lub zewnętrznego dostawcy technologii reklamowych. Oba te typy raportów mogą być używane jednocześnie i wzajemnie się uzupełniają.

• Raporty na poziomie zdarzenia łączą konkretne kliknięcie lub wyświetlenie reklamy (po stronie reklamy) z danymi po stronie konwersji. Dane po stronie konwersji są bardzo ograniczone, a dane są zaszumione (co oznacza, że w niewielkim odsetku przypadków zamiast rzeczywistych raportów wysyłane są dane losowe). Chroni to prywatność użytkowników, zapobiegając łączeniu tożsamości użytkowników w różnych witrynach. W ramach dodatkowej ochrony prywatności raporty są wysyłane z opóźnieniem.
• Raporty podsumowujące nie są powiązane z konkretnym zdarzeniem po stronie reklamy. Zapewniają one bogatsze i bardziej dokładne dane o konwersjach niż raporty na poziomie zdarzenia. Połączenie technik ochrony prywatności pomaga zmniejszyć ryzyko łączenia tożsamości w witrynach.

Raporty na poziomie zdarzenia

Raporty na poziomie zdarzenia łączą kliknięcie lub wyświetlenie reklamy z przybliżonymi danymi o konwersjach.

Raporty na poziomie zdarzenia są przydatne w przypadku:

• Optymalizacja. Odpowiedz na pytania w rodzaju „Jak poprawić zwrot z inwestycji?”. Raporty te mogą służyć np. do optymalizacji miejsc docelowych reklam, bo w raportach można udostępniać unikalne identyfikatory po stronie reklamy. Raporty na poziomie zdarzenia mogą dostarczać dane treningowe dla modeli systemów uczących się.
• Raportowanie przybliżone, w którym potrzeba niewiele informacji o konwersji. Obecny limit to 3 bity danych o konwersjach dotyczących kliknięć⏤Oznacza to, że do konwersji można przypisać jedną z 8 kategorii⏤ i 1 bit dla wyświetleń. W raportach na poziomie zdarzenia kodowanie szczegółowych danych po stronie konwersji, np. określonej ceny lub czasu konwersji, nie jest obsługiwane.
• Wykrywanie oszustw. Dane w niektórych raportach mogą być przydatne podczas wykrywania i analizowania oszustw reklamowych, ponieważ pozwalają zrozumieć wzorce, które można wykorzystać do wykrywania spamu oraz nieprawidłowej aktywności.

Raporty podsumowujące

Raporty podsumowujące (dawniej raporty zbiorcze) oferują bardziej szczegółowe dane o konwersjach oraz większą elastyczność łączenia danych o kliknięciach lub wyświetleniach i konwersjach.

Dowiedz się więcej o raportach z podsumowaniem.

Raporty podsumowujące nadają się najlepiej do raportowania przypadków użycia. Dzięki tym raportom możesz uzyskać odpowiedzi na takie pytania, jak „Jaki jest mój zwrot z inwestycji?”.

Użycie raportów podsumowujących do optymalizacji – na przykład do optymalizacji pod kątem wartości zakupu, co nie jest obsługiwane w raportach na poziomie zdarzenia (ponieważ dane o konwersjach są zbyt ogólne) – jest obszarem aktywnych badań.

Inne funkcje

Inne funkcje tego interfejsu API:

• Atrybucja z aplikacji do witryny: wyświetlenie lub kliknięcie reklamy w aplikacji i zrealizowanie konwersji w internecie.

Obsługiwane przeglądarki

• Przeglądarki Firefox i Edge nie mają wspólnych sygnałów.
• Safari i Webkit są wykluczające i zaproponowały inny interfejs API do pomiaru konwersji z reklam – Private Click.

Chociaż te 2 interfejsy API są różne, Chrome i WebKit współpracują ze sobą, aby ułatwić pracę programistom, np. ujednolicając nazwy atrybutów i strukturę JSON na potrzeby raportów.

Zestaw funkcji Attribution Reporting API różni się od zestawu funkcji Private Click Measurement API proponowanego przez Safari i WebKit. Co najważniejsze, dzięki interfejsowi Attribution Reporting API:

• Pomiar po wyświetleniu jest obsługiwany.
• Dostępne są raporty na poziomie zdarzenia.
• Raporty podsumowujące zawierają szczegółowe informacje zarówno po stronie kliknięcia/wyświetlenia, jak i po stronie konwersji.
• Firmy zewnętrzne, takie jak platformy technologii reklamowych, mogą otrzymywać raporty w imieniu wydawców i reklamodawców.

Konfiguracja przeglądarki

• Użytkownicy mogą zrezygnować z korzystania z interfejsu API w ustawieniach użytkownika na stronie chrome://settings/adPrivacy.
• Interfejs API jest nieaktywny w trybie Incognito.
• Interfejs API jest nieaktywny, gdy wyłączone są pliki cookie innych firm.

Jak witryny mogą kontrolować dostęp?

Jeśli interfejs API jest dostępny w danej przeglądarce, jest domyślnie dostępny w dowolnej witrynie – zarówno w dokumentach i skryptach najwyższego poziomu, jak i w elementach iframe z tej samej domeny.

Dowolne inne firmy, np. elementy iframe reklam z innych domen, które nie zostały dodane do strony za pomocą skryptu z dostępem najwyższego poziomu, nie mogą korzystać z interfejsu API bez wiedzy wydawcy lub reklamodawcy. W tych elementach iframe interfejs Attribution Reporting API trzeba włączyć za pomocą zasad dotyczących uprawnień.

<iframe src="..." allow="attribution-reporting"></iframe>

Firmy zewnętrzne z dostępem najwyższego poziomu, które dodają do strony elementy iframe z innych domen, mogą też włączyć interfejs Attribution Reporting API za pomocą zasad dotyczących uprawnień.

Witryna może wyłączyć interfejs Attribution Reporting API dla wszystkich stron, w tym skryptów z dostępem najwyższego poziomu, wysyłając nagłówek odpowiedzi HTTP:

Permissions-Policy: attribution-reporting=()

Jak działa interfejs Attribution Reporting API?

Attribution Reporting API umożliwia pomiar 2 połączonych ze sobą zdarzeń: zdarzenia w witrynie wydawcy, np. wyświetlenia lub kliknięcia reklamy, które następują w witrynie reklamodawcy.

Raporty na poziomie zdarzenia

Raporty podsumowujące

Raporty podsumowujące są generowane w ten sposób:

• Użytkownik klika lub wyświetla specjalnie skonfigurowaną reklamę. Przeglądarka na lokalnym urządzeniu użytkownika rejestruje to zdarzenie wraz z ustalonymi wcześniej danymi konfiguracji atrybucji.
• Później, gdy użytkownik dokona konwersji, przeglądarka dopasowuje to szczegółowe zdarzenie kliknięcia lub wyświetlenia (nazywane zdarzeniem źródła atrybucji) do szczegółowych danych o konwersjach (nazywanych danymi reguły atrybucji). Wymiary rejestrowanych szczegółów są wstępnie zdefiniowane przez firmę z branży technologii reklamowych, a przeglądarka działa według określonej przez nią logiki. Przeglądarka generuje te dane w raporcie skumulowanym.
• Raporty zbiorcze są szyfrowane przez przeglądarkę i wysyłane na serwer technologii reklamowych. Z serwera technologii reklamowych raporty agregowane są wysyłane do usługi agregacji w celu wygenerowania raportu podsumowującego.
• Raporty podsumowujące są następnie udostępniane technikom reklamowym. Pamiętaj, że raporty podsumowujące nie są opóźnione tak samo jak raporty na poziomie zdarzenia.

Dowiedz się więcej o raportach podsumowujących.

Prywatność

W przeciwieństwie do plików cookie innych firm interfejs Attribution Reporting API umożliwia firmom reklamowym uzyskiwanie statystyk dotyczących konwersji bez śledzenia aktywności użytkownika w różnych witrynach.

Weźmy na imię Robert. Jakub widzi reklamę w usłudze news.example. Tydzień później Robert kupuje buty w witrynie shoes.example.

Obecnie taka konwersja byłaby śledzona za pomocą pliku cookie innej firmy używanego jako identyfikator w wielu witrynach. Dzięki plikom cookie innych firm firma z branży technologii reklamowych ma dostęp do wielu szczegółowych informacji o aktywności Roberta w news.example i shoes.example. Technologia reklamowa może połączyć te informacje, aby utworzyć szczegółowy profil Roberta, w tym lokalizację Roberta, jego zwyczaje związane z przeglądaniem internetu i preferowane treści z serii news.example. Profil może też zawierać informacje o zakupach, aktywności i danych kart kredytowych w shoes.example. Takie połączenie między witrynami przydaje się do pomiaru konwersji z reklam. Jednak narusza to prywatność użytkowników: działania Roberta są śledzone bardzo szczegółowo w różnych witrynach.

Z kolei w różnych witrynach łączy się niewielka ilość informacji – wystarczająca do pomiaru konwersji, ale nie wystarcza do szczegółowego śledzenia aktywności Roberta w różnych witrynach. Aktywność Michała w news.example i w shoes.example pozostaje inna.

Zabezpieczenia w poszczególnych typach raportów

Raporty na poziomie zdarzenia łączą identyfikator po stronie reklamy z niewielką ilością danych po stronie konwersji. Chociaż dostarczają one informacji o konwersji z różnych witryn, informacje po stronie konwersji są zbyt ogólne, by dołączyć informacje o tożsamości użytkownika w różnych witrynach.

Raporty podsumowujące zawierają szczegółowe statystyki, ale tylko na poziomie agregacji. Ponieważ treść tych raportów agregowanych jest szyfrowana podczas przesyłania do technologii reklamowych, nie może ona pobierać z nich żadnych informacji bez korzystania z usługi agregacji. Usługa agregacji zapewnia dostęp tylko do zaszumionych agregacji.

Zarówno w raportach zbiorczych, jak i na poziomie zdarzenia stosowane są dodatkowe mechanizmy ochrony prywatności, np. ograniczenia częstotliwości.

Szczegółowe informacje: prywatność w raportach na poziomie zdarzenia

Raporty na poziomie zdarzenia zapewniają statystyki konwersji bez śledzenia użytkowników w witrynach dzięki korzystaniu z tych mechanizmów ochrony prywatności:

• Nie są używane żadne identyfikatory z innych witryn, a żadne szczegółowe działania związane z przeglądaniem w różnych witrynach nie opuszczają urządzenia.
• Raporty na poziomie zdarzenia wiążą 64 bity informacji po stronie reklamy (news.example) z 1 lub 3 bitami po stronie konwersji (shop.example). 64 bity to wystarczająca ilość informacji, aby można je było zmapować na identyfikator użytkownika, ale te 64 bity można połączyć tylko z bardzo małą ilością informacji z różnych witryn: 1 lub 3 bitami, które nie wystarczają do przechowywania identyfikatora.
  • 64-bitowe dane po stronie reklamy nie są nowymi informacjami. Identyfikator User ID może być już dostępny po stronie reklamy. news.example lub adtech.example ma już informacje o określonej aktywności użytkownika w usłudze news.example.
• Aby zapobiegać nadużyciom i śledzeniu w witrynach, stosujemy dodatkowe zabezpieczenia:
  • Raporty są wysyłane z opóźnieniem.
  • Dane o konwersjach są zakłócone: przez pewien procent czasu generowane są fałszywe raporty.
  • Liczba raportów o konwersjach przypisanych do danego kliknięcia lub wyświetlenia jest ograniczona.

Szczegółowe informacje: raporty podsumowujące i prywatność

Raporty podsumowania łączą zdarzenie kliknięcia lub wyświetlenia ze szczegółowymi danymi o konwersjach. Zapewniają statystyki konwersji bez śledzenia użytkowników w różnych witrynach przy użyciu następujących mechanizmów ochrony prywatności:

• Nie jest używany żaden identyfikator w wielu witrynach.
• Każda atrybucja może w wielu udziałach w opracowanym raporcie podsumowującym. Każdy użytkownik może wywoływać wiele atrybucji konkretnego kliknięcia (lub obejrzenia) i konwersji.
• Dane są agregowane do poziomu wielu zdarzeń (wielu użytkowników) i nie można dokładnie obserwować poszczególnych zdarzeń. Gdy analizujemy dane zagregowane, im wyższy poziom szczegółowości, tym większy jest też względny szum związany z tymi danymi. Wycinki danych, które agregują wiele zdarzeń i użytkowników, są dokładniejsze, aby zachować użyteczność.
• Nieprzetworzone raporty, które łączą szczegółowe zdarzenie kliknięcia lub wyświetlenia ze szczegółowymi danymi o konwersjach, są szyfrowane i nieczytelne dla firmy zajmującej się technologiami reklamowymi. Te dane może odczytywać tylko usługa agregacji.
• Aby zapobiegać nadużyciom i śledzeniu w witrynach, stosujemy dodatkowe zabezpieczenia:
  • Raporty są wysyłane z losowym opóźnieniem.
  • Częstotliwość zapytań na różnych wycinkach danych jest ograniczona.

Angażuj odbiorców i dziel się opiniami

• Jeśli masz pytania dotyczące interfejsu API, utwórz problem w repozytorium API.
• Śledź najnowsze informacje i ogłoszenia dotyczące interfejsu API dostępne na liście adresowej Attribution Reporting.
• Jeśli masz pytania techniczne, zgłoś błąd w Chromium.
• Pytania dotyczące implementacji, integracji i ogólnych sprawdzonych metod: utwórz problem w repozytorium pomocy dla deweloperów Piaskownicy prywatności.