Możesz mierzyć, kiedy kliknięcie lub wyświetlenie reklamy prowadzi do konwersji, np. do zakupu na stronie reklamodawcy.
Dla kogo jest to przypomnienie?
Tutaj znajdziesz podstawowe informacje o raportach atrybucji i kilka podstawowych koncepcji, ale nie o konkretnych szczegółach technicznych.
- Jeśli zajmujesz się reklamami lub technologiami reklamowymi, dowiesz się, jak ten interfejs API udostępnia funkcje obsługiwane przez pliki cookie innych firm. Zapoznaj się z przypadkami użycia interfejsu API, które zawierają więcej informacji o generowaniu raportów.
- Jeśli jesteś deweloperem lub inżynierem oprogramowania, zapoznaj się z pełnym omówieniem systemu lub eksperymentuj z interfejsem API i dołącz do niego.
Reklamodawcy i wydawcy, którzy do pomiaru konwersji używają platform technologii reklamowych, nie muszą bezpośrednio używać interfejsu API. Może Cię zainteresować, jak działa raportowanie atrybucji, jeśli Twoje technologie reklamowe planują 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 witrynach i zakłócają ich prywatność.
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 pomiar konwersji w tych przypadkach:
- Kliknięcia i wyświetlenia reklam.
- Reklamy w elemencie iframe zewnętrznej, np. reklamy w witrynie wydawcy, które korzystają z zewnętrznego dostawcy technologii reklamowych.
- reklamy wyświetlane w kontekście własnym, np. w sieci społecznościowej lub na stronie wyników wyszukiwania albo przez wydawcę 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 atrybucji: eksperymenty i uczestnictwo.
Zmiany interfejsu API
- Monitoruj zmiany interfejsu API.
- Dowiedz się, dlaczego wprowadziliś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 typów statystyk w ramach 2 typów raportów, które można wysyłać do reklamodawcy lub zewnętrznego dostawcy technologii reklamowych. Tych 2 typów raportów można używać jednocześnie i uzupełniające się.
- Raporty na poziomie zdarzenia przypisują określone kliknięcie lub wyświetlenie (po stronie reklamy) do danych od strony konwersji. Dane po stronie konwersji są bardzo ograniczone, a dane są zaszumiane (co oznacza, że w niewielkim odsetku przypadków zamiast rzeczywistych raportów są wysyłane dane losowe). Pozwala to chronić prywatność użytkowników, uniemożliwiając łączenie ich tożsamości z różnych witryn. 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. Raporty te zapewniają bogatsze i dokładniejsze dane o konwersjach niż raporty na poziomie zdarzenia. Połączenie technik ochrony prywatności pomaga zmniejszyć ryzyko złączenia tożsamości między witrynami.
Raporty na poziomie zdarzenia
Raporty na poziomie zdarzenia łączą kliknięcie lub wyświetlenie reklamy z przybliżonymi danymi o konwersjach.
Dzięki raportom na poziomie zdarzenia:
- Optymalizacja. Odpowiedz na pytania typu „Jak poprawić zwrot z inwestycji?”. W szczególności do optymalizacji miejsc docelowych reklamy można wykorzystać te raporty, ponieważ w nich można podawać unikalne identyfikatory po stronie reklamy. Raporty na poziomie zdarzenia mogą zawierać dane treningowe dla modeli systemów uczących się.
- dokładne raportowanie – w tym przypadku potrzeba niewiele informacji o konwersji; Obecny limit to 3 bity danych o konwersjach związanych z kliknięciami ⏤ oznacza to, że konwersję można przypisać do jednej z 8 kategorii⏤ i 1 bitu dla 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ą służyć do wykrywania i analizowania oszustw reklamowych, ponieważ dają wgląd w wzorce, które można wykorzystać do wykrywania spamu lub nieprawidłowej aktywności.
Raporty podsumowujące
Raporty podsumowujące (dawniej określane jako raporty zbiorcze) zapewniają bardziej szczegółowe dane o konwersjach oraz zapewniają większą elastyczność łączenia danych o kliknięciach lub wyświetleniach z danymi o konwersjach.
Dowiedz się więcej o raportach podsumowania.
Raporty podsumowujące najlepiej nadają się do raportowania przypadków użycia. Pomagają one uzyskać odpowiedzi na pytania w rodzaju „Jaki jest zwrot z inwestycji?”.
Korzystanie z raportów podsumowujących do optymalizacji, np. do optymalizacji pod kątem wartości zakupu, które nie jest obsługiwane w raportach na poziomie zdarzenia (ponieważ dane o konwersjach są zbyt ogólne), to obszar aktywnego poszukiwania informacji.
Inne funkcje
Inne funkcje tego interfejsu API:
- Atrybucja z aplikacji do witryny: zobaczenie lub kliknięcie reklamy w aplikacji i dokonanie konwersji w witrynie.
- Atrybucja na różnych urządzeniach: zobacz lub kliknij reklamę na urządzeniu mobilnym i dokonaj konwersji na komputerze.
Obsługiwane przeglądarki
- Przeglądarki Firefox i Edge nie mają wspólnych sygnałów.
- Safari i Webkit są wykluczające, dlatego do pomiaru konwersji z reklam zaproponowano inny interfejs API – prywatny pomiar kliknięć.
Chociaż te 2 interfejsy API są różne, Chrome i WebKit współpracują ze sobą, aby uprościć pracę programistów, na przykład, ujednolicają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 przeglądarki Safari i WebKit. W szczególności dzięki interfejsowi Attribution Reporting API:
- Pomiar konwersji po wyświetleniu jest obsługiwany.
- Można generować raporty na poziomie zdarzenia.
- Raporty podsumowania zawierają szczegółowe informacje zarówno po stronie kliknięć/wyświetleń, jak i po stronie konwersji.
- Firmy zewnętrzne, np. platformy z branży technologii reklamowych, mogą otrzymywać raporty w imieniu wydawców i reklamodawców.
Konfiguracja przeglądarki
- Użytkownicy mogą zrezygnować z tego 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 każdej witrynie – zarówno w dokumentach i skryptach najwyższego poziomu, jak i elementach iframe z tego samego źródła.
Arbitrażowe firmy zewnętrzne, 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ą używać interfejsu API bez wiedzy wydawcy ani 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ą zasad dotyczących uprawnień.
Witryna może wyłączyć interfejs Attribution Reporting API w przypadku 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 następnie konwersji 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 ze wstępnie określonymi danymi konfiguracji atrybucji.
- Gdy później 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ł atrybucji). Wymiary rejestrowanych szczegółów są wstępnie zdefiniowane przez firmę zajmującą się technologiami reklamowymi, a przeglądarka działa zgodnie z określonymi przez nią zasadami. Przeglądarka przesyła 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 agregującej w celu wygenerowania raportu podsumowującego.
- Raporty podsumowujące są następnie udostępniane technikom reklamowym. Należy pamiętać, ż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 umożliwia firmom reklamowym uzyskiwanie wglądu w konwersje bez śledzenia aktywności użytkowników w witrynach.
Weźmy na przykład osobę o imieniu Robert. Jakub widzi reklamę,
czytając wiadomości w news.example
. Tydzień później Robert kupuje buty w witrynie shoes.example
.
Obecnie konwersja ta byłaby śledzona przez plik cookie innej firmy służący jako identyfikator w wielu witrynach.
Dzięki plikom cookie innych firm firma z branży technologii reklamowych może uzyskać szczegółowe informacje o aktywności Roberta w news.example
i shoes.example
. Technologie reklamowe mogą połączyć te informacje, aby utworzyć szczegółowy profil Roberta, w tym jego lokalizację, zwyczaje związane z przeglądaniem i preferowane pozycje w news.example
. Ten profil może też zawierać informacje o zakupach, aktywności i karcie kredytowej w shoes.example
. Takie połączenie między witrynami
przydaje się do pomiaru konwersji z reklamy. Jednak narusza to prywatność użytkowników:
aktywność Roberta jest śledzona na wielu stronach i bardzo szczegółowo.
Porównuje się w nich niewielka ilość informacji – wystarczają one do pomiaru konwersji, ale to za mało, żeby dokładnie śledzić aktywność Roberta w różnych witrynach. Aktywność Roberta w news.example
i shoes.example
pozostaje niezależna.
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 konwersji z różnych witryn, ale dane po stronie konwersji są zbyt ogólne, aby można je było łączyć w różnych witrynach.
Raporty podsumowujące dostarczają szczegółowych statystyk, ale tylko na poziomie zbiorczym. Ich zawartość jest szyfrowana w momencie wysyłania do technologii reklamowej, dlatego technologia reklamowa nie może pobrać żadnych informacji z raportów bez korzystania z usługi agregacji. Usługa agregująca zapewnia dostęp tylko do zaszumionych agregacji.
Zarówno w raportach zbiorczych, jak i na poziomie zdarzenia, nałożone są dodatkowe zabezpieczenia związane z ochroną prywatności, takie jak ograniczenie liczby żądań.
Szczegółowe informacje: raporty i prywatność na poziomie zdarzenia
Raporty na poziomie zdarzenia zapewniają statystyki konwersji bez śledzenia użytkowników w różnych witrynach dzięki poniższym mechanizmom ochrony prywatności:
- Nie jest używany żaden identyfikator między witrynami i żadna szczegółowa aktywność związana z przeglądaniem różnych witryn nie opuszcza urządzenia.
- Raporty na poziomie zdarzenia wiążą 64 bity informacji po stronie reklamy (
news.example
) z 1 bitem lub 3 bitami po stronie konwersji (shop.example
). Liczba 64 bitów wystarczy do zmapowania na identyfikator użytkownika, ale te 64 bity można powiązać tylko z bardzo małą ilością informacji z różnych witryn: 1 lub 3 bitów, które nie wystarczają do przechowywania identyfikatora.- 64-bitowe elementy po stronie reklamy nie są nowymi informacjami. Identyfikator User-ID może być już
dostępny po stronie reklamy.
news.example
lubadtech.example
wie już o aktywności określonego użytkownika wnews.example
.
- 64-bitowe elementy 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, stosowane są dodatkowe zabezpieczenia:
- Raporty są wysyłane z opóźnieniem.
- Dane o konwersjach są zaszumiane: w określonym procentach 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, wykorzystując następujące mechanizmy ochrony prywatności:
- Nie jest używany identyfikator z innej witryny.
- Każda atrybucja może mieć wiele udziałów w uzyskanym raporcie podsumowującym. Każdy użytkownik może wywołać wiele atrybucji w przypadku określonego kliknięcia (lub obejrzenia) i konwersji.
- Dane są agregowane do poziomu wielu zdarzeń (wielu użytkowników), więc nie można dokładnie zaobserwować poszczególnych zdarzeń. W przypadku danych zbiorczych, im bardziej szczegółowo wzrasta, tym wzrasta również względny szum w danych. 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 zdarzenia kliknięcia lub wyświetlenia ze szczegółowymi danymi o konwersjach, są szyfrowane i nie mogą zostać odczytane przez firmę z branży technologii reklamowych. Te dane może odczytać tylko usługa agregacji.
- Aby zapobiegać nadużyciom i śledzeniu w witrynach, stosowane są dodatkowe zabezpieczenia:
- Raporty są wysyłane z losowymi opóźnieniami.
- Częstotliwość zapytań kierowanych na różne wycinki danych jest ograniczona.
Angażuj 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, które znajdziesz na liście adresowej raportowania atrybucji.
- Jeśli masz pytania techniczne, zgłoś błąd Chromium.
- Jeśli masz pytania na temat wdrażania i integracji oraz ogólnych sprawdzonych metod, utwórz problem w repozytorium pomocy dla deweloperów Piaskownicy prywatności.