Możesz mierzyć, kiedy kliknięcie lub wyświetlenie reklamy prowadzi do konwersji, np. zakupu do witryny reklamodawcy.
Dla kogo jest to przypomnienie?
Tutaj znajdziesz podstawowe informacje o raportach atrybucji oraz koncepcje, ale niewiele szczegółów technicznych.
- Jeśli zajmujesz się reklamami lub technologiami reklamowymi, dowiesz się, jak ten interfejs API udostępnia funkcje obsługiwane za pomocą plików cookie innych firm. Sprawdź przypadki użycia interfejsu API, które zawierają więcej informacji o tym, generowane są raporty.
- Jeśli jesteś programistą lub inżynierem oprogramowania, przejdź do pełnego przeglądu systemu lub eksperymentuj i bierz udział za pomocą interfejsu API.
Reklamodawcy i wydawcy, którzy polegają na platformach technologii reklamowych w przypadku konwersji. rozwiązania pomiarowe nie muszą bezpośrednio korzystać z interfejsu API. Może Cię zainteresować jak działa raportowanie atrybucji, jeśli technologia reklamowa planuje zintegrować za pomocą tego interfejsu API.
Czym jest interfejs Attribution Reporting API?
Obecnie pomiar konwersji z reklam często opiera się na zewnętrznych narzędziach . Przeglądarki ograniczają dostęp do plików cookie innych firm, ponieważ mogą one służą do śledzenia użytkowników w różnych witrynach i ograniczania ich prywatności.
Interfejs Attribution Reporting API umożliwia te pomiary chroniących prywatność, bez plików cookie innych firm.
Ten interfejs API umożliwia reklamodawcom i dostawcom technologii reklamowych mierzyć konwersje w następujących przypadkach:
- Kliknięcia i wyświetlenia reklam.
- Reklamy w elemencie iframe firmy zewnętrznej, np. w witrynie wydawcy, która korzysta z tagu zewnętrznego dostawcy technologii reklamowych.
- Reklamy wyświetlane w kontekście własnych źródeł, np. w sieci społecznościowej lub wyszukiwarce z wynikami wyszukiwania czy z wydawcą wyświetlającym własne reklamy.
Jeśli nie znasz niektórych z tych pojęć lub pojęć, zapoznaj się z Glosariusz Piaskownicy prywatności.
Wypróbuj API
- Przetestuj ją lokalnie w przeglądarce. Ustaw flagę, który informuje przeglądarkę Chrome, że ma włączyć określony funkcje zabezpieczeń.
Jeśli chcesz eksperymentować z interfejsem API, przejdź do Raporty 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 za pomocą 2 typy raportów, które można wysyłać do reklamodawcy lub zewnętrznej technologii reklamowej dostawcy usług. Tych 2 typów raportów można używać jednocześnie i uzupełniają się.
- Raporty na poziomie zdarzenia powodują powiązanie z konkretną reklamą. lub wyświetlenia (po stronie reklamy) z danymi po stronie konwersji. Dane po stronie konwersji są bardzo ograniczone i zaszumione (co oznacza, że w przypadku w niektórych przypadkach 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 usługach witryn. W ramach dodatkowej ochrony prywatności raporty są wysyłane z opóźnieniem.
- Raporty podsumowujące nie są powiązane z konkretnym zdarzeniem w dniu po stronie reklamy. Raporty te zapewniają bogatsze i dokładniejsze dane o konwersjach niż w raportach na poziomie zdarzenia. Połączenie technik ochrony prywatności pomaga zmniejszyć ryzyko łączenia tożsamości w różnych 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 inwestycję?”. Raporty te mogą być szczególnie przydatne do optymalizacji reklam, bo w raportach można udostępnić 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 na temat konwersji. Obecny limit to 3 bity danych o konwersjach dotyczących kliknięć⏤this Oznacza to, że do konwersji można przypisać jedną z ośmiu kategorii⏤ i 1 bit dla wyświetleń. Kodowanie szczegółowych danych po stronie konwersji, takich jak dane dotyczące określonej ceny lub czasu konwersji nie są obsługiwane w raportach na poziomie zdarzenia.
- Wykrywanie oszustw. Dane w niektórych raportach mogą być przydatne w przypadku oszustw reklamowych wykrywaniem i analizą, umożliwiając zrozumienie wzorców, które mogą używane 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 i skalowalnych danych.
Dowiedz się więcej o raportach z podsumowaniem.
Raporty podsumowujące nadają się najlepiej do raportowania przypadków użycia. Raporty te są pomocne dla odpowiedzi na takie pytania, jak „Jaki jest mój zwrot z inwestycji?”
Użycie raportów podsumowujących do optymalizacji – np. do optymalizacji pod kątem wartości zakupu, która nie jest obsługiwana w raportach na poziomie zdarzenia (ponieważ parametr dane o konwersjach są zbyt ogólne) – jest to obszar prowadzonych badań.
Inne funkcje
Inne funkcje tego interfejsu API:
- Atrybucja z aplikacji do witryny: zobaczyć lub kliknąć reklamę w aplikacji i dokonać konwersji w internecie.
Obsługa przeglądarek
- Przeglądarki Firefox i Edge nie mają wspólnych sygnałów.
- Safari i Webkit są wykluczające i zaproponowali inny interfejs API do pomiaru konwersji z reklam, nazywany Private Click Pomiary.
Chociaż te dwa interfejsy API są różne, Chrome i WebKit współpracują ze sobą i otwierania zasad, aby uprościć programistom, na przykład poprzez dostosowanie nazw atrybutów oraz Struktura JSON dla raportów.
Zestaw funkcji interfejsu Attribution Reporting API różni się od zestawu funkcji Interfejs Private Click Measurement API zaproponowany 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 za pomocą ustawień 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 każdej zarówno w dokumentach i skryptach najwyższego poziomu, jak i w elementach iframe z tego samego źródła.
dowolne firmy zewnętrzne – np. elementy iframe reklam z innych domen, które nie zostały dodano do strony za pomocą skryptu z dostępem najwyższego poziomu – nie może używać interfejsu API bez wiedzy wydawcy lub reklamodawcy: w takich elementach iframe Interfejs Attribution Reporting API należy bezpośrednio włączyć za pomocą: Uprawnienia .
<iframe src="..." allow="attribution-reporting"></iframe>
Inne firmy z dostępem najwyższego poziomu, które dodają do strony elementy iframe z innych domen, mogą możesz też włączyć Attribution Reporting API Zasady dotyczące uprawnień.
Witryna może wyłączyć 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 zdarzeń razem: zdarzenie w witrynie wydawcy, np. wyświetlenie lub kliknięcie przez użytkownika. co przekłada się na konwersję na stronie 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 zgodnie z określoną logiką określoną przez tę technologię. Przeglądarka zapisuje te dane w raporcie agregowanym.
- 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 w takim samym stopniu 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 pozwala firmom reklamowym uzyskać wgląd konwersje bez śledzenia aktywności użytkownika w różnych witrynach.
Weźmy na imię Robert. Jakub widzi reklamę podczas czytania
wiadomości na temat: news.example
. Tydzień później Robert kupuje buty
shoes.example
Dzisiaj taka konwersja byłaby śledzona przez firmę zewnętrzną
jako identyfikatora w wielu witrynach.
Dzięki plikom cookie innych firm firma z branży technologii reklamowych
szczegółowych informacji na temat aktywności Roberta w news.example
i w dniu
shoes.example
Technologia reklamowa może połączyć te elementy
aby stworzyć szczegółowy profil Roberta,
takie jak lokalizacja Roberta, nawyki przeglądania
preferowane odczyty w usłudze news.example
. Ten profil mógł też
obejmują informacje o zakupach, aktywności i kartach kredytowych
shoes.example
To połączenie między witrynami pozwala mierzyć
konwersje z reklam. Narusza to jednak prywatność użytkowników:
Aktywność Roberta jest śledzona w wielu witrynach z dużą ilością szczegółów.
Złączono niewielką ilość informacji
w różnych witrynach – wystarczająco dużo, aby mierzyć konwersje,
do śledzenia aktywności Roberta w różnych witrynach. Robert
aktywność w news.example
i shoes.example
pozostaje
i rozdziel.
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ż podają one informacje z różnych witryn na temat w konwersji, informacje po stronie konwersji są zbyt ogólne, by dołączyć do użytkownika tożsamości w witrynach.
Raporty podsumowujące zawierają szczegółowe informacje, ale tylko na poziomie zbiorczym. ponieważ treść tych agregowanych raportów jest zaszyfrowanych po przesłaniu do technologii reklamowej, żadnych informacji z raportów bez korzystania z usługi agregacji. Tylko usługa agregacji zapewnia dostęp do zaszumionych agregacji.
Na oba te typy nakładane są dodatkowe środki ochrony prywatności, takie jak ograniczenia liczby żądań na poziomie zdarzenia i raportach zbiorczych.
Szczegółowe informacje: prywatność w raportach na poziomie zdarzenia
Raporty na poziomie zdarzenia zapewniają statystyki konwersji bez konieczności śledzenia stosując następujące mechanizmy ochrony prywatności:
- Nie są używane żadne identyfikatory innych witryn ani szczegółowe dane związane z przeglądaniem w różnych witrynach. opuszcza urządzenie.
- Raporty na poziomie zdarzenia przypisują do reklamy 64 bity informacji
(
news.example
) tylko z 1 lub 3 bitami po stronie konwersji (shop.example
). Wartość 64-bitowa to wystarczająca ilość informacji, aby można ją było zmapować ale te 64-bitowe dane można połączyć tylko Mało informacji z innych witryn: 1 lub 3 bity, które nie wystarczają do przechowywania identyfikator.- 64-bitowe dane po stronie reklamy nie są nowymi informacjami. Identyfikator użytkownika może być już
dostępnych na stronie.
news.example
lubadtech.example
ma już informacje o aktywności określonego użytkownika wnews.example
.
- 64-bitowe dane po stronie reklamy nie są nowymi informacjami. Identyfikator użytkownika może być już
dostępnych na stronie.
- 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 mieć wpływ na wynikowe podsumowanie raport. Każdy użytkownik może aktywować wiele atrybucji dla określonego do 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ólne zdarzenia. Gdy spojrzymy na w miarę jak poziom szczegółowości zwiększa się wraz ze wzrostem względnego szumu tych danych także rośnie. Wycinki danych agregujące wiele zdarzeń a użytkownicy z większą dokładnością.
- Nieprzetworzone raporty, które łączą szczegółowe zdarzenie kliknięcia lub wyświetlenia ze szczegółowymi dane o konwersjach są szyfrowane i niemożliwe do odczytania przez firmę zajmującą 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ź aktualizacje i ogłoszenia dotyczące interfejsu API na Lista adresowa raportowania atrybucji.
- W przypadku pytań technicznych 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.