Możesz mierzyć, kiedy kliknięcie lub wyświetlenie reklamy prowadzi do konwersji, np. zakupu na stronie reklamodawcy.
Dla kogo jest to przeznaczone?
W tym artykule omawiamy podstawy raportowania atrybucji i objaśniamy niektóre koncepcje, nie zagłębiamy się jednak w szczegóły techniczne.
- Jeśli zajmujesz się reklamami lub technologiami reklamowymi, dowiesz się, jak ten interfejs API udostępnia funkcje, które są obecnie włączone przez pliki 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, zapoznaj się z pełnym omówieniem systemu lub eksperymentuj i dołącz do interfejsu API.
Reklamodawcy i wydawcy, którzy używają platform technologii reklamowych do pomiaru konwersji, nie muszą bezpośrednio korzystać z interfejsu API. Być może chcesz dowiedzieć się, jak działa raportowanie atrybucji w przypadku planów technologii reklamowych związanych z integracją z tym interfejsem API.
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 zakłócania ich prywatności.
Interfejs Attribution Reporting API umożliwia przeprowadzanie 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 następujących przypadkach:
- Kliknięcia i wyświetlenia reklam.
- Reklamy w elementach iframe zewnętrznej, np. reklamy w witrynie wydawcy, która korzysta z zewnętrznego dostawcy technologii reklamowych.
- Reklamy w kontekście własnym, np. reklamy w sieci społecznościowej lub na stronie wyników wyszukiwania lub reklamy wydawcy wyświetlającego własne reklamy.
Jeśli nie znasz niektórych z tych terminów lub pojęć, zajrzyj do słowniczka Piaskownicy prywatności.
Wypróbuj interfejs API
- Przetestuj lokalnie w przeglądarce. Ustaw flagę, która informuje przeglądarkę Chrome o włączeniu określonych funkcji eksperymentalnych.
Jeśli chcesz poeksperymentować z interfejsem API, przejdź do artykułu Atrybucja: eksperymentowanie i uczestnictwo.
Zmiany w interfejsie API
- Śledź zmiany w interfejsie API.
- Dowiedz się, dlaczego planujemy udostępnić interfejs Attribution Reporting API w pierwszej połowie 2023 r.
Dostępność
Propozycja | Stan |
---|---|
Raporty na poziomie zdarzeń dotyczące kliknięć i wyświetleń Wyjaśnienie |
Dostępne w Chrome |
Agregujące raporty dotyczące kliknięć i wyświetleń Objaśnienie |
Dostępne w Chrome |
Ścieżka konwersji: przejście z aplikacji do witryny Wyjaśnienie internetowe i Wyjaśnienie dotyczące Androida Ogłoszenie dotyczące listy adresowej |
Dostępne w Chrome i na Androidzie w ramach wersji próbnej origin |
Ścieżka konwersji: różne urządzenia Objaśnienie |
Ta oferta pakietowa została zarchiwizowana. Obecnie nie ma planów wdrażania. |
Zapobieganie nieprawidłowym raportom zbiorczym w ramach weryfikacji raportów Objaśnienie |
Oczekiwana w pierwszej połowie 2024 r. w Chrome |
Obsługa wielu miejsc docelowych w rejestracji źródła Błąd Chromium |
Dostępne w Chrome od I kwartału 2023 r. |
Domyślna lista dozwolonych dla Attribution Reporting API Permissions-Policy pozostanie bez zmian * Ogłoszenie dotyczące listy adresowej |
Dostępne w Chrome od I kwartału 2023 r. |
Obsługa kluczy do deduplikacji opartych na filtrach na potrzeby raportów agregujących Ogłoszenie dotyczące listy adresowej |
Dostępne w Chrome od I kwartału 2023 r. |
Obsługa raportów o udanej rejestracji źródła w ramach szczegółowego debugowania Książka kucharska na temat debugowania |
Dostępne w Chrome od I kwartału 2023 r. |
Mniejsze opóźnienia w generowaniu raportów zbiorczych Problem z GitHubem | Zaktualizowany objaśnienie |
Dostępne w Chrome od II kwartału 2023 r. |
Elastyczny poziom zdarzenia Phase 1 Lite Wyjaśnienie elastycznej konfiguracji na poziomie zdarzenia |
Pojawi się w Chrome w IV kwartale 2023 r. |
Faza 2 – pełna elastyczna konfiguracja na poziomie zdarzenia Wyjaśnienie elastycznej konfiguracji na poziomie zdarzenia |
Pojawi się w Chrome w I kwartale 2024 r. |
Obsługa debugowania raportowania atrybucji po wycofaniu plików cookie innych firm Prośba o opinię na GitHubie |
Oczekiwana w pierwszej połowie 2024 r. w Chrome |
Obsługa interfejsu Attribution Reporting API i usługi agregacji w Google Cloud Wyjaśnienie interfejsu Attribution Reporting API Wyjaśnienie usługi agregacji |
Oczekiwana w Chrome w drugiej połowie 2023 r. |
Przypadki użycia i funkcje
Interfejs Attribution Reporting API zapewnia dostęp do różnych typów statystyk za pomocą 2 typów raportów, które można wysyłać do reklamodawców lub zewnętrznych dostawców technologii reklamowych. Tych 2 typów raportów można używać jednocześnie i są wzajemnie się uzupełniające.
- Raporty na poziomie zdarzenia wiążą kliknięcie lub wyświetlenie konkretnej reklamy (po stronie reklamy) z danymi dotyczącymi konwersji. Dane po stronie konwersji są bardzo ograniczone, a dane są zniekształcane (co oznacza, że w niewielkim odsetku przypadków zamiast rzeczywistych raportów wysyłane są dane losowe). Pozwala to chronić prywatność użytkowników, uniemożliwiając im łączenie ich tożsamości z różnymi witrynami. W ramach dodatkowej ochrony prywatności raporty nie są wysyłane od razu.
- Raporty podsumowujące nie są powiązane z konkretnym zdarzeniem po stronie reklamy. Raporty te zapewniają bogatsze i bardziej precyzyjne dane o konwersjach niż raporty na poziomie zdarzenia. Połączenie technik ochrony prywatności pomaga zmniejszyć ryzyko złączenia tożsamości z różnych witryn.
Raporty na poziomie zdarzenia
Raporty na poziomie zdarzenia łączą kliknięcie lub wyświetlenie reklamy z przybliżonymi danymi o konwersjach.

news.example
(dołączone do identyfikatora użytkownika Bob_Kowalski w dniu news.example
) doprowadziło do zakupu w aplikacji shop.example
.
Dzięki raportom na poziomie zdarzenia można:
- Optymalizacja. Odpowiedz na pytania w rodzaju „Jak mogę poprawić zwrot z inwestycji?”. Raporty te mogą służyć w szczególności do optymalizacji miejsc docelowych reklam, ponieważ w nich można udostępniać unikalne identyfikatory po stronie reklamy. Raporty na poziomie zdarzenia mogą dostarczyć danych treningowych dla modeli systemów uczących się.
- Dokładne raportowanie, w którym trzeba podać niewiele informacji o konwersjach. Obecny limit to 3 bity danych o konwersjach po kliknięciu⏤to oznacza, że konwersji można przypisać do jednej z 8 kategorii⏤ i 1 bitu w przypadku wyświetleń. W raportach na poziomie zdarzenia kodowanie szczegółowych danych po stronie konwersji, takich jak określona cena lub czas konwersji, nie jest obsługiwane.
- Wykrywanie oszustw. Dane z niektórych raportów mogą być przydatne do wykrywania i analizowania oszustw reklamowych, ponieważ pomagają rozpoznać wzorce, które można wykorzystać do wykrywania spamu lub 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 i wyświetleniach z danymi o konwersjach.
Dowiedz się więcej o raportach podsumowania.

news.example
wygenerowała 518 konwersji w shoes.example
, a łączna kwota wydatków wyniosła 38 174 zł. Połowa konwersji pochodziła od użytkowników z Nowego Jorku w Stanach Zjednoczonych.Raporty podsumowujące najlepiej nadają się do raportowania przypadków użycia. Dzięki tym raportom możesz uzyskać odpowiedzi na pytania w rodzaju „Jaki jest mój zwrot z inwestycji?”.
Wykorzystanie raportów podsumowujących do optymalizacji, np. do optymalizacji pod kątem wartości zakupu, ale nie jest obsługiwane w raportach na poziomie zdarzenia (ponieważ dane o konwersjach są zbyt ogólne), to obszar prowadzenia intensywnych badań.
Inne funkcje
Inne funkcje tego interfejsu API:
- Atrybucja z aplikacji do witryny: widzenie lub kliknięcie reklamy w aplikacji i dokonywanie konwersji w witrynie.
- Atrybucja na różnych urządzeniach: zobacz lub kliknij reklamę na komórce i dokonaj konwersji na komputerze.
Obsługiwane przeglądarki
- Przeglądarki Firefox i Edge nie udostępniają sygnałów.
- Przeglądarka Safari/Webkit jest ujemna i zaproponowała inny interfejs API do pomiaru konwersji z reklam – prywatny pomiar kliknięć.
Różnice między interfejsem Attribution Reporting API a interfejsem API proponowanym przez WebKit
Choć te 2 interfejsy API są różne, Chrome i WebKit współpracują ze sobą w sposób otwarty, aby uprościć środowisko dla programistów, na przykład dostosowując nazwy atrybutów i strukturę JSON na potrzeby raportów.
Zestaw funkcji interfejsu Attribution Reporting API różni się od zestawu funkcji Private Click Measurement API zaproponowanego przez Safari/WebKit. W szczególności dzięki interfejsowi Attribution Reporting API:
- Pomiar konwersji po wyświetleniu jest obsługiwany.
- Możesz generować raporty na poziomie zdarzenia.
- Raporty podsumowujące zawierają szczegółowe informacje po stronie kliknięć/wyświetleń i konwersji.
- Firmy zewnętrzne, np. platformy technologii reklamowych, mogą otrzymywać raporty w imieniu wydawców i reklamodawców.
Konfiguracja przeglądarki
- Użytkownicy mogą zrezygnować z interfejsu API w ustawieniach użytkownika na stronie
chrome://settings/adPrivacy
. - Interfejs API nie jest aktywny w trybie incognito.
- Interfejs API jest nieaktywny, gdy wyłączone są pliki cookie innych firm.
W jaki sposób witryny mogą kontrolować dostęp?
Jeśli interfejs API jest dostępny w danej przeglądarce, domyślnie jest dostępny w dowolnej witrynie, zarówno w dokumentach i skryptach najwyższego poziomu, jak i elementach iframe tego samego źródła.
Dowolna firma zewnętrzna – na przykład 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ą używać interfejsu API bez wiedzy wydawcy lub reklamodawcy. W takich elementach iframe interfejs Attribution Reporting API musi być wyraźnie włączony 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ą zasady dotyczącej 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?
Interfejs Attribution Reporting API umożliwia pomiar 2 połączonych ze sobą zdarzeń: zdarzenia w witrynie wydawcy, np. wyświetlenia lub kliknięcia reklamy przez użytkownika, a później konwersji w witrynie reklamodawcy.
Raporty na poziomie zdarzenia

Przeglądarka dopasowuje kliknięcia lub wyświetlenia do danych o konwersjach zdefiniowanych przez technologię reklamową.
Później przeglądarka wysyła wynikowe raporty do wstępnie zdefiniowanego punktu końcowego (z pewnym opóźnieniem i z pewnymi zakłóceniami).
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 ze wstępnie określonymi 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 zarejestrowanych szczegółów są wstępnie zdefiniowane przez firmę zajmującą się technologiami reklamowymi, a przeglądarka działa zgodnie z określonymi przez technologię reklamową. Przeglądarka zapisuje te dane w raporcie zbiorczym.
- Raporty zbiorcze są szyfrowane przez przeglądarkę i wysyłane na serwer technologii reklamowych. Z serwera technologii reklamowych raporty zbiorcze są wysyłane do usługi agregacji w celu wygenerowania raportu podsumowującego.
- Raporty podsumowujące są wtedy udostępniane technologii reklamowej. Pamiętaj, że raporty podsumowujące nie są opóźnione w takim samym stopniu jak raporty na poziomie zdarzenia.
Więcej informacji o raportach podsumowania.
Prywatność
W odróżnieniu od plików cookie innych firm interfejs Attribution Reporting API pozwala firmom reklamowym uzyskiwać wgląd w konwersje bez śledzenia aktywności poszczególnych użytkowników w witrynach.
Weźmy osobę o imieniu Robert. Czytając wiadomości w aplikacji news.example
, Robert widzi reklamę. Tydzień później Robert kupuje buty na stronie
shoes.example
.
Obecnie konwersja ta będzie śledzona przez plik cookie innej firmy 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 usługach news.example
i shoes.example
. Technologie reklamowe mogą połączyć te informacje, aby utworzyć szczegółowy profil Roberta,
obejmujący lokalizację Roberta, nawyki związane z przeglądaniem stron i preferowane artykuły w news.example
. Ten profil może też zawierać
informacje o zakupach, aktywności i karcie kredytowej w shoes.example
. Takie połączenie przydają się
do pomiaru konwersji z reklam. Jednak niekorzystnie wpływa to na prywatność użytkowników:
aktywność Michała jest bardzo szczegółowo śledzona w różnych witrynach.
W witrynach łączymy niewielką ilość informacji – to wystarcza, by zmierzyć konwersje, ale nie dość, by dokładnie śledzić aktywność Roberta w różnych witrynach. Aktywność Roberta w news.example
i shoes.example
nie ulegnie zmianie.
Zabezpieczenia w poszczególnych typach raportów
Raporty na poziomie zdarzenia łączą identyfikator po stronie reklamy z niewielką ilością danych po stronie konwersji. Dostarczają one informacji o konwersjach z różnych witryn, ale są one zbyt ogólne, aby można było złączać tożsamość użytkownika w różnych witrynach.
Raporty podsumowujące zawierają szczegółowe statystyki, ale tylko na poziomie zbiorczym. Ich zawartość jest szyfrowana podczas przesyłania do technologii reklamowej, dlatego technologia reklamowa nie może pobrać żadnych informacji z raportów bez korzystania z usługi agregacji. Usługa agregacji zapewnia dostęp tylko do zagregowanych danych.
Zarówno w przypadku raportów na poziomie zdarzenia, jak i w raportach zbiorczych nałożone są dodatkowe zabezpieczenia związane z ochroną prywatności, np. ograniczenia liczby żądań.

Szczegółowe informacje: raporty i prywatność na poziomie zdarzenia
Raporty na poziomie zdarzenia dostarczają statystyk konwersji bez śledzenia użytkowników w różnych witrynach dzięki tym mechanizmom ochrony prywatności:
- Z urządzenia nie jest używany żaden identyfikator pochodzący z innej witryny, a szczegółowe informacje o aktywności związanej z przeglądaniem w różnych witrynach nie są opuszczane.
- Raporty na poziomie zdarzenia wiążą 64 bity informacji po stronie reklamy (
news.example
) z tylko 1 lub 3 bitami po stronie konwersji (shop.example
). 64-bitowe informacje wystarczają do zmapowania na pojedynczy identyfikator użytkownika, ale te 64 bity można powiązać tylko z bardzo małą ilością informacji z innych witryn: 1 lub 3 bitów, które nie wystarczają do przechowywania identyfikatora.- 64-bitowe dane po stronie reklamy to nie są nowe informacje. Identyfikator użytkownika może być już dostępny
w reklamie.
news.example
lubadtech.example
wie już o aktywności określonego użytkownika wnews.example
.
- 64-bitowe dane po stronie reklamy to nie są nowe informacje. Identyfikator użytkownika może być już dostępny
w reklamie.
- Stosujemy dodatkowe zabezpieczenia, aby zapobiegać nadużyciom i śledzeniu w witrynach:
- Raporty są wysyłane z opóźnieniem.
- Dane o konwersjach są zakłócone: w określonym procentie czasu generowane są fałszywe raporty.
- Liczba raportów dotyczących konwersji przypisanych do poszczególnych kliknięć lub wyświetleń jest ograniczona.
Szczegółowe informacje: raporty podsumowujące i prywatność
Raporty podsumowujące łą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, korzystając z tych mechanizmów ochrony prywatności:
- Nie jest używany identyfikator z innej witryny.
- Każda atrybucja może mieć wiele pozycji w wynikowym raporcie podsumowującym. Każdy użytkownik może wywołać wiele atrybucji dla danego kliknięcia (lub wyświetlenia) i konwersji.
- Dane są agregowane do poziomu wielu zdarzeń (wielu użytkowników), więc nie można dokładnie rejestrować poszczególnych zdarzeń. Wraz ze wzrostem poziomu szczegółowości danych zbiorczych rośnie też względny szum informacyjny. Wycinki danych, które agregują wiele zdarzeń, są dokładniejsze, aby zachować przydatność.
- Nieprzetworzone raporty, które łączą szczegółowe zdarzenia kliknięcia lub wyświetlenia ze szczegółowymi danymi o konwersjach, są szyfrowane i nie mogą być odczytane przez firmę z branży technologii reklamowych. Te dane może odczytać tylko usługa agregacji.
- Stosujemy dodatkowe zabezpieczenia, aby zapobiegać nadużyciom i śledzeniu w witrynach:
- Raporty są wysyłane z losowymi opóźnieniami.
- Zapytania dotyczące różnych wycinków danych są ograniczone szybkością.
Angażuj i dziel się opiniami
- Jeśli masz pytania dotyczące interfejsu API, utwórz problem w repozytorium API.
- Śledź aktualizacje i ogłoszenia dotyczące interfejsu API na liście adresowej Attribution Reporting.
- Jeśli masz pytania techniczne, zgłoś błąd Chromium.
- W przypadku pytań dotyczących implementacji i integracji oraz ogólnych sprawdzonych metod: utwórz problem w repozytorium pomocy dla deweloperów Piaskownicy prywatności.