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ść
Propozycja | Stan |
---|---|
Ścieżka konwersji: przejście z aplikacji do internetu Wyjaśnienie internetowe i wyjaśnienie dotyczące Androida Ogłoszenie dotyczące listy adresowej |
Dostępne w Chrome i na Androidzie w ramach testowania origin |
Ścieżka konwersji: różne urządzenia Wyjaśnienie |
Ta oferta pakietowa została zarchiwizowana. Obecnie nie ma planów wdrażania. |
Zapobieganie nieprawidłowościom w raportach zbiorczych przy użyciu weryfikacji raportów Wyjaśnienie |
Oczekiwane w Chrome w pierwszej połowie 2024 r. |
Domyślna lista dozwolonych dla zasady Permissions Reporting API w interfejsie Attribution Reporting API pozostanie. * Ogłoszenie dotyczące listy adresowej |
Dostępne w Chrome w I kwartale 2023 r. |
Konfigurowalny epsilon raportowania na poziomie zdarzenia problem na GitHubie |
Dostępne w Chrome w IV kwartale 2023 r. |
Dopełnienie ładunku raportów z możliwością agregacji Zaktualizowany wyjaśnienie |
Dostępne w Chrome w IV kwartale 2023 r. |
Phase 1 Lite – elastyczny poziom zdarzenia na poziomie zdarzenia Wyjaśnienie elastycznych konfiguracji na poziomie zdarzenia |
Dostępne w Chrome w IV kwartale 2023 r.
Możliwość dostosowania liczby raportów atrybucji oraz liczby i długości okien raportowania. Dostępne w Chrome w I kwartale 2024 r. Możliwość dostosowania liczby bitów danych aktywatora. |
Obsługa debugowania Attribution Reporting po wycofaniu plików cookie innych firm Uzyskiwanie opinii na GitHubie |
Oczekiwane w Chrome w pierwszej połowie 2024 r. |
Obsługa interfejsu Attribution Reporting API i usługi agregacji w Google Cloud Wyjaśnienie interfejsu Attribution Reporting API Wyjaśnienie usługi agregacji |
Dostępne w Chrome w drugiej połowie 2023 r. |
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
lubadtech.example
ma już informacje o określonej aktywności użytkownika w usłudzenews.example
.
- 64-bitowe dane po stronie reklamy nie są nowymi informacjami. Identyfikator User ID może być już
dostępny po stronie reklamy.
- 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.