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ść
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 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.
![Raport na poziomie zdarzenia](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=9&hl=pl)
news.example
(załączonego z identyfikatorem użytkownika Roberta Kowalskiego w 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 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.
![Przykładowe statystyki z raportów podsumowujących](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=9&hl=pl)
news.example
o identyfikatorze news.example
doprowadziła do 518 konwersji w shoes.example
, a łączne wydatki wynoszą 38 174 zł. Połowa konwersji pochodziła z Nowego Jorku w Stanach Zjednoczonych.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
![raport na poziomie zdarzenia](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=9&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-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=9&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 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.
![Widok dzisiejszego internetu (powiązana tożsamość) i przyszłości (tożsamość partycjonowana)](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=9&hl=pl)
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.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=9&hl=pl)
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.