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ść
建议 | 状态 |
---|---|
转化历程:从应用到网站 网站铺垫消息和 Android 铺垫消息 邮寄名单公告 |
在 Chrome 和 Android 中可用,以进行源试用 |
转化历程:跨设备 说明 |
该提案已归档。目前没有实施计划。 |
使用报告验证功能防止无效的可汇总报告 说明 |
预计于 2024 年上半年在 Chrome 中推出 |
Attribution Reporting API 权限政策的默认许可名单将保留 * 邮寄名单通知 |
将于 2023 年第 1 季度在 Chrome 中推出 |
可配置的事件级报告 epsilon GitHub 问题 |
将于 2023 年第 4 季度在 Chrome 中提供 |
可汇总报告载荷的内边距 更新了解释器 |
将于 2023 年第 4 季度在 Chrome 中提供 |
第 1 阶段精简版灵活事件级 灵活事件级配置说明说明 |
Chrome 将于 2023 年第 4 季度推出
可自定义归因报告的数量和报告期的数量/长度。 2024 年第 1 季度在 Chrome 中推出 可自定义触发器数据的位数。 |
支持在第三方 Cookie 弃用后进行 Attribution Reporting 调试 在 GitHub 上提供反馈 |
预计于 2024 年上半年在 Chrome 中推出 |
针对 Google Cloud Attribution Reporting API 和汇总服务的支持 Attribution Reporting API 说明 汇总服务说明 |
Chrome 将于 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.
![Raport na poziomie zdarzenia](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=3&hl=pl)
news.example
(załączonego z identyfikatorem użytkownika Roberta Kowalskiego w dniu news.example
) doprowadziło do zakupu w dniu shop.example
.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.
![Przykładowe statystyki z raportów podsumowujących](https://developers.google.cn/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=3&hl=pl)
news.example
doprowadziła do 518 konwersji w dniu shoes.example
, a łączne wydatki wyniosły 38 174 USD. Połowa konwersji pochodziła z Nowego Jorku w Stanach Zjednoczonych.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
![raport na poziomie zdarzenia](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=3&hl=pl)
Przeglądarka dopasowuje kliknięcia lub wyświetlenia do danych o konwersjach zdefiniowanych przez technologię reklamową.
Następnie przeglądarka wysyła wynikowe raporty do wstępnie zdefiniowanego punktu końcowego z pewnym opóźnieniem i szumem.
Raporty podsumowujące
![](https://developers.google.cn/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=3&hl=pl)
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.
![Widok dzisiejszego internetu (powiązana tożsamość) i przyszłości (tożsamość partycjonowana)](https://developers.google.cn/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=3&hl=pl)
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.
![](https://developers.google.cn/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=3&hl=pl)
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.