Omówienie raportowania atrybucji w internecie

Mierz, kiedy kliknięcie lub wyświetlenie reklamy prowadzi do konwersji, np. zakupu w witrynie reklamodawcy.

Dla kogo jest przeznaczony ten program?

Znajdziesz tu podstawy raportowania atrybucji i niektóre powiązane z nim pojęcia, ale nie znajdziesz tu zbyt wielu szczegółów technicznych.

• Jeśli pracujesz w branży reklamowej lub technologii reklamowych, dowiesz się, jak ten interfejs API zapewnia funkcje, które są obsługiwane przez pliki cookie innych firm. Zapoznaj się z przypadkami użycia interfejsu API, aby dowiedzieć się więcej o tym, jak generowane są raporty.
• Jeśli jesteś programistą lub inżynierem oprogramowania, zapoznaj się z pełnym omówieniem systemu lub eksperymentuj i uczestnicz w używaniu interfejsu API.

Reklamodawcy i wydawcy, którzy korzystają z platform technologicznych do pomiaru konwersji, nie muszą używać interfejsu API bezpośrednio. Jeśli Twoja firma technologiczna planuje integrację z tym interfejsem API, warto, abyś dowiedział się, jak działa raportowanie atrybucji.

Uwaga: w przyszłości interfejs Attribution Reporting API może służyć do celów innych niż reklama.

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 ograniczać ich prywatność.

Interfejs Attribution Reporting API umożliwia przeprowadzanie pomiarów w sposób zapewniający ochronę prywatności, bez plików cookie innych firm.

Ten interfejs API umożliwia reklamodawcom i dostawcom technologii reklamowych pomiar konwersji w tych sytuacjach:

• Kliknięcia i wyświetlenia reklamy.
• Reklamy w ramce iframe zewnętrznego dostawcy, np. reklamy w witrynie wydawcy, która korzysta z zewnętrznego dostawcy technologii reklamowych.
• Reklamy w kontekście pierwotnym, np. reklamy w mediach społecznościowych lub na stronie z wynikami wyszukiwania, lub reklamy wyświetlane przez wydawcę.

Jeśli nie znasz niektórych z tych terminów lub pojęć, zapoznaj się z glosariuszem Piaskownicy prywatności.

Wypróbuj API

• Przetestuj lokalnie w przeglądarce. Ustaw flagę, która mówi przeglądarce Chrome, aby włączyła określone funkcje eksperymentalne.

Jeśli chcesz eksperymentować z interfejsem API, przeczytaj artykuł Attribution Reporting: experiment and participate (Raportowanie o przypisaniu: eksperymentuj i ucz się).

Uwaga: ten interfejs API jest w trakcie opracowywania i będzie ewoluować w zależności od opinii i danych wejściowych z ekosystemu. Twoje opinie pomagają w omówieniu rozwiązań dla różnych przypadków użycia. Ten interfejs API jest inkubowany i rozwijany w środowisku otwartym. Rozważ udział w rozmowie.

Zmiany w interfejsie API

• Śledź zmiany w interfejsie API.
• Dowiedz się, dlaczego w pierwszej połowie 2023 r. udostępniliśmy interfejs Attribution Reporting API.

Uwaga: raportowanie atrybucji było wcześniej znane jako interfejs Event Conversion Measurement API. Nazwa została zmieniona w 2022 r., ponieważ pierwotny zakres na poziomie zdarzenia został rozszerzony o dodatkowe przypadki użycia pomiarów.

Dostępność

提案	状态
转化历程：应用到网站 网站说明和 Android 说明 邮寄名单通告	适用于 Chrome 和 Android 的源试用
转化历程：跨设备 说明	此提案已归档。目前没有实施计划。
使用报告验证功能防止可汇总报告无效 说明	此提案已归档。我们改为为此用例实现了 trigger_context_id。
Attribution Reporting API Permissions-Policy 的默认许可名单将保持不变 * 邮寄名单通告	2023 年第 1 季度在 Chrome 中推出
可配置的事件级报告 epsilon GitHub 问题	2023 年第 4 季度在 Chrome 中推出
可汇总报告载荷的填充 更新了说明	2023 年第 4 季度在 Chrome 中推出
灵活事件级 “灵活事件级配置”说明	将于 2023 年第 4 季度在 Chrome 中推出 可自定义归因报告的数量以及报告期的数量/时长。 将于 2024 年第 1 季度在 Chrome 中推出 能够自定义触发器数据的位数。
支持不依赖于第三方 Cookie 的 Attribution Reporting 详细调试报告 说明	2024 年第 3 季度在 Chrome 中推出
支持 Google Cloud 的 Attribution Reporting API 和汇总服务 Attribution Reporting API 说明 汇总服务说明	2023 年下半年在 Chrome 中推出
灵活的贡献过滤 说明	2024 年第 3 季度在 Chrome 中推出
归因前过滤：归因范围 说明	2024 年第 4 季度在 Chrome 中推出

Uwaga: aby zapoznać się ze stanem wszystkich interfejsów API Piaskownicy prywatności, przeczytaj oś czasu Piaskownicy prywatności.

Przypadki użycia i funkcje

Interfejs Attribution Reporting API zapewnia dostęp do różnych rodzajów informacji za pomocą 2 typów raportów, które można wysyłać do reklamodawcy lub zewnętrznego dostawcy technologii reklamowych. Te 2 rodzaje raportów mogą być używane jednocześnie i uzupełniają się nawzajem.

• Raporty na poziomie zdarzenia powiązane są z kliknięciem lub wyświetleniem reklamy (po stronie reklamy) z danymi po stronie konwersji. Dane po stronie konwersji są bardzo ograniczone i zawierają szum (co oznacza, że w niewielkiej liczbie przypadków zamiast rzeczywistych raportów wysyłane są dane losowe). Ma to na celu ochronę prywatności użytkowników przez zapobieganie łą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 reklamodawcy. Te raporty zawierają bogatsze i bardziej szczegółowe dane o konwersjach niż raporty na poziomie zdarzenia. Połączenie różnych technik ochrony prywatności pomaga zmniejszyć ryzyko powiązania tożsamości w różnych witrynach.

Raporty na poziomie zdarzenia

Raporty na poziomie zdarzenia powiązane są z kliknięciem lub wyświetleniem reklamy z nieprecyzyjnymi danymi o konwersjach.

Przykładowy raport na poziomie zdarzenia: kliknięcie o identyfikatorze 200400600 na stronie news.example (powiązane z identyfikatorem użytkownika Bob_Doe na stronie news.example) doprowadziło do zakupu na stronie shop.example.

Raporty na poziomie zdarzenia są odpowiednie do:

• Optymalizacja. Odpowiedz na pytania w rodzaju „Jak mogę zwiększyć zwrot z inwestycji?”. Można ich używać m.in. do optymalizacji umiejscowienia reklam, ponieważ w raportach można udostępniać unikalne identyfikatory po stronie reklamy. Raporty na poziomie zdarzenia mogą zawierać dane treningowe dla modeli uczenia maszynowego.
• Raportowanie przybliżone, w którym potrzebne są tylko podstawowe informacje o konwersji. Obecny limit to 3 bity danych konwersji w przypadku kliknięć⏤, co oznacza, że konwersji można przypisać jedną z 8 kategorii⏤ i 1 bit w przypadku wyświetleń. Kodowanie szczegółowych danych dotyczących konwersji, np. konkretnej ceny lub czasu konwersji, nie jest obsługiwane w raportach na poziomie zdarzenia.
• wykrywanie oszustw. Dane w niektórych raportach mogą być przydatne do wykrywania i analizowania oszustw związanych z reklamami, ponieważ pozwalają zrozumieć wzorce, które można wykorzystać do wykrywania spamu lub nieprawidłowej aktywności.

Raporty podsumowujące

Raporty podsumowania (dawniej raporty zbiorcze) zawierają bardziej szczegółowe dane o konwersjach i większą elastyczność w łączeniu danych o kliknięciach i wyświetleniach oraz danych o konwersjach.

Dowiedz się więcej o raportach Podsumowanie.

Przykład statystyk z raportów zbiorczych: kampania o identyfikatorze 1234567 w dniu news.example wygenerowała 518 konwersji w dniu shoes.example, a łączne wydatki wyniosły 38174 PLN. Połowa konwersji pochodziła od użytkowników z Nowego Jorku w USA.

Raporty podsumowania są najbardziej odpowiednie do raportowania przypadków użycia. Dzięki tym raportom możesz uzyskać odpowiedzi na pytania w rodzaju: „Jaki jest mój zwrot z inwestycji?”.

Korzystanie z raportów podsumowujących do optymalizacji – np. do optymalizacji pod kątem wartości zakupu, która nie jest obsługiwana przez raporty na poziomie zdarzenia (ponieważ dane o konwersjach są zbyt ogólne) – jest obecnie przedmiotem naszych badań.

Inne funkcje

Inne funkcje tego interfejsu API:

• Atrybucja z aplikacji do witryny internetowej: wyświetlenie lub kliknięcie reklamy w aplikacji i dokonanie konwersji w witrynie internetowej.

Uwaga: w przyszłości, gdy nie będzie już plików cookie innych firm, ten interfejs API zostanie połączony z innymi interfejsami API reklam chroniącymi prywatność, aby obejmować kompleksowe przypadki użycia: - Remarketing: patrz Protected Audience API - Wybór reklam opartych na zainteresowaniach: patrz Topics API

Obsługa przeglądarek

• Firefox i Edge nie udostępniają sygnałów.
• Safari i Webkit mają negatywną opinię i zaproponowały inny interfejs API do pomiaru konwersji reklam, zwany prywatnym pomiarem kliknięć.

Mimo że te 2 interfejsy API są różne, Chrome i WebKit współpracują ze sobą, aby uprościć pracę programistów, np. przez dostosowanie nazw atrybutów i struktury JSON raportów.

Zestaw funkcji interfejsu Attribution Reporting API różni się od zestawu funkcji interfejsu Private Click Measurement API zaproponowanego przez Safari i WebKit. W szczególności w przypadku interfejsu Attribution Reporting API:

• Pomiar konwersji po obejrzeniu jest obsługiwany.
• Można udostępniać raporty na poziomie zdarzenia.
• Raporty podsumowania zawierają obszerne informacje zarówno o kliknięciach i wyświetleniach, jak i o konwersjach.
• Firmy zewnętrzne, np. platformy reklamowe, mogą otrzymywać raporty w imieniu wydawców i reklamodawców.

Konfiguracja przeglądarki

• Użytkownicy mogą zrezygnować z interfejsu API, korzystając z ustawień użytkownika na stronie chrome://settings/adPrivacy.
• Interfejs API nie jest aktywny w trybie incognito.

Uwaga: interfejs API nie korzysta z plików cookie innych firm. Jednak w fazie testowania, aby włączyć interfejs API, musisz włączyć pliki cookie innych firm. Dzięki temu deweloperzy mogą uzyskiwać raporty debugowania i porównywać wyniki interfejsu API z atrybucją opartą na plikach cookie.

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 tego samego źródła.

dowolne osoby trzecie, np. elementy iframe reklam z innych domen, które nie zostały dodane do strony za pomocą skryptu z dostępem na najwyższym poziomie, nie mogą korzystać z interfejsu API bez wiedzy wydawcy lub reklamodawcy. W przypadku takich elementów iframe interfejs Attribution Reporting API musi zostać wyraźnie włączony za pomocą polityki uprawnień.

<iframe src="..." allow="attribution-reporting"></iframe>

Firmy zewnętrzne z dostępem najwyższego poziomu, które dodają na stronę elementy iframe z innych źródeł, mogą też włączyć interfejs Attribution Reporting API za pomocą zasad dotyczących uprawnień.

Uwaga:

Korzyści związane z bezpieczeństwem

Dzięki temu skrypt z dostępem najwyższego poziomu umożliwia ramkom, które dodaje, korzystanie z raportowania atrybucji. Tylko skrypt zewnętrzny, któremu zaufała witryna, powinien mieć dostęp na najwyższym poziomie, więc nie jest to problem. Główna zaleta tej zasady polega na czymś innym: ramki dodane bez skryptu najwyższego poziomu nie powinny domyślnie być uznawane za zaufane źródła rejestrowania źródeł lub wyzwalaczy (chyba że ich twórca jest już zaufany). Dlatego witryna najwyższego poziomu musi wyraźnie włączyć interfejs API dla tych ramek iframe.

Witryna może wyłączyć interfejs Attribution Reporting API dla wszystkich stron, w tym skryptów z dostępem na najwyższym poziomie, wysyłając nagłówek odpowiedzi HTTP:

Permissions-Policy: attribution-reporting=()

Jak działa interfejs Attribution Reporting API?

Attribution Reporting API umożliwia prowadzenie pomiarów 2 połączonych zdarzeń: zdarzenia w witrynie wydawcy, np. wyświetlenia lub kliknięcia reklamy przez użytkownika, oraz następującej po nim konwersji w witrynie reklamodawcy.

Uwaga: interfejs Attribution Reporting API może nie być odpowiedni do rozliczeń na podstawie kosztu konwersji ze względu na zakłócenia dodawane do raportów na poziomie zdarzenia i raportów zbiorczych. Możesz przesłać opinię na temat wpływu na różne modele rozliczeniowe za pomocą interfejsu Attribution Reporting API na GitHub.

Raporty na poziomie zdarzenia

Raporty na poziomie zdarzenia są generowane w następujący sposób:
przeglądarka dopasowuje kliknięcia lub wyświetlenia do danych o konwersjach zdefiniowanych przez dostawcę technologii reklamowej.
Później przeglądarka wysyła wygenerowane raporty do wcześniej zdefiniowanego punktu końcowego. Dzieje się to z pewnym opóźnieniem i dodaniem szumu.

Raporty podsumowujące

Generowanie raportu zbiorczego

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 wcześniej określonymi danymi konfiguracyjnymi atrybucji.
• Później, gdy użytkownik dokona konwersji, przeglądarka dopasuje to konkretne zdarzenie kliknięcia lub wyświetlenia (nazywane zdarzeniem źródłowym atrybucji) do szczegółowych danych o konwersjach (nazywanych danymi aktywowania atrybucji). Wymiary rejestrowanych szczegółów są wstępnie zdefiniowane przez firmę dostarczającą technologię reklamową, a przeglądarka postępuje według logiki określonej przez tego dostawcę technologii. Przeglądarka przekazuje te dane wyjściowe w raporcie umożliwiającym ich agregację.
• Raporty z możliwością agregacji są szyfrowane przez przeglądarkę i wysyłane na serwer dostawcy technologii reklamowej. Z serwera są przesyłane dalej do usługi agregującej w celu wygenerowania raportu podsumowującego.
• Raporty podsumowujące są następnie udostępniane dostawcy technologii reklamowej. Warto zauważyć, że te raporty nie podlegają takim opóźnieniom 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 poszczególnych osób w różnych witrynach.

Weźmy na przykład osobę o nazwie Bob. Jakub widzi reklamę podczas czytania wiadomości na stronie news.example. Tydzień później Robert kupuje buty na stronie shoes.example.

Obecnie ta konwersja jest śledzona za pomocą pliku cookie innej firmy, który służy jako identyfikator śledzenia użytkowników w różnych witrynach. Dzięki plikom cookie innych firm firma z branży technologii reklamowych może uzyskać dostęp do wielu informacji o działaniach Boba na news.example i na shoes.example. Technologia reklamowa może łączyć te informacje, aby tworzyć szczegółowe profile użytkowników, w tym ich lokalizację, nawyki przeglądania i ulubione treści na news.example. Profil może też zawierać informacje o zakupach, aktywności i karcie kredytowej.shoes.example Ta wspólna konwersja między witrynami przydaje się do pomiaru konwersji typu ad. Jednak wpływa to na prywatność użytkowników: aktywność Boba jest śledzona w witrynach z bardzo szczegółowymi informacjami.

Widok porównawczy dzisiejszego internetu (z połączoną tożsamością) i internetu jutra (z partycjonowaną tożsamością)

Niewielka ilość informacji jest złączana w różnych witrynach – wystarcza to do pomiaru konwersji, ale nie do szczegółowego śledzenia aktywności Boba w różnych witrynach. Działania Boba na kontach news.example i shoes.example pozostają od siebie niezależne.

Ochrona w przypadku poszczególnych typów raportów

Raporty na poziomie zdarzenia łączą identyfikator po stronie reklamy z niewielką ilością danych po stronie konwersji. Chociaż zawierają one informacje o konwersji w różnych witrynach, są one zbyt ogólne, aby można było na ich podstawie zidentyfikować użytkownika w różnych witrynach.

Raporty podsumowujące dostarczają szczegółowych informacji, ale tylko na poziomie zagregowanym. Ponieważ zawartość tych raportów jest szyfrowana podczas wysyłania do dostawcy technologii reklamowych, dostawca ten nie może uzyskać żadnych informacji z raportów bez korzystania z usługi agregującej. Usługa agregacji zapewnia dostęp tylko do zbiorczych danych z błędami.

Dodatkowe zabezpieczenia prywatności, takie jak ograniczenia częstotliwości, są nakładane zarówno na raporty na poziomie zdarzenia, jak i na raporty zbiorcze.

Szczegóły: raporty na poziomie zdarzenia i prywatność

Raporty na poziomie zdarzenia dostarczają statystyk konwersji bez śledzenia użytkowników w różnych witrynach. Aby to osiągnąć, stosujemy następujące mechanizmy ochrony prywatności:

• Nie jest używany identyfikator witryn, a szczegółowe informacje o przeglądaniu w witrynach nie opuszczają urządzenia.
• Raporty na poziomie zdarzenia powiązane z 64-bitowymi informacjami po stronie reklamy (news.example) z jedynym bitem lub 3 bitami po stronie konwersji (shop.example). 64 bity to wystarczająca ilość informacji do mapowania na indywidualny identyfikator użytkownika, ale te 64 bity można powiązać tylko z bardzo małą ilością informacji dotyczących różnych witryn: 1 bit lub 3 bity, które nie wystarczają do przechowywania identyfikatora.
  • 64 bity po stronie reklamy nie są nową informacją. Identyfikator użytkownika jest już dostępny po stronie reklamy. news.example lub adtech.example już wie o działaniach danego użytkownika w news.example.
• Aby zapobiegać nadużyciom i śledzeniu w witrynach, stosujemy dodatkowe zabezpieczenia:
  • Raporty są wysyłane z opóźnieniem.
  • Dane o konwersjach są zaśmiecone: w pewnym odsetku przypadków generowane są fałszywe raporty.
  • Liczba raportów o przypisanych konwersjach jest ograniczona do liczby konwersji na kliknięcie lub wyświetlenie.

Szczegóły: raporty zbiorcze i prywatność

Raporty podsumowania powiązane są ze zdarzeniem kliknięcia lub wyświetlenia oraz szczegółowymi danymi o konwersjach. Zapewniają one statystyki konwersji bez śledzenia użytkowników w witrynach, korzystając z tych mechanizmów ochrony prywatności:

• Nie jest używany identyfikator w wielu witrynach.
• Każda atrybucja może mieć wiele udziałów w wygenerowanym raporcie podsumowania. Każdy użytkownik może wywołać wiele atrybucji w przypadku danego kliknięcia (lub wyświetlenia) i konwersji.
• Dane są agregowane do poziomu wielu zdarzeń (wielu użytkowników) i nie można dokładnie obserwować poszczególnych zdarzeń. W miarę zwiększania poziomu szczegółowości zagregowanych danych wzrasta też ich względny szum. Przekroje danych, które obejmują dużą liczbę zdarzeń i użytkowników, są dokładniejsze, co pozwala zachować ich przydatność.
• Raporty nieprzetworzone, które powiązane są z konkretnym zdarzeniem kliknięcia lub wyświetlenia z konkretnymi danymi o konwersji, są zaszyfrowane i nieczytelne dla dostawcy technologii reklamowej. Te dane mogą być odczytywane tylko przez usługę agregacji.
• Aby zapobiegać nadużyciom i śledzeniu w witrynach, stosujemy dodatkowe zabezpieczenia:
  • Raporty są wysyłane z losowymi opóźnieniami.
  • Zapytania dotyczące różnych wycinków danych są ograniczone pod względem szybkości.

Zaangażowanie i przesyłanie opinii

• W przypadku pytań dotyczących interfejsu API: utwórz zgłoszenie w repozytorium interfejsu API.
• Aktualizacje interfejsu API i ogłoszenia znajdziesz na liście mailingowej Attribution Reporting.
• Jeśli masz pytania techniczne, zgłoś błąd w Chromium.
• W przypadku pytań dotyczących implementacji, integracji i ogólnych sprawdzonych metod: utwórz zgłoszenie w repozytorium pomocy dla deweloperów Piaskownicy prywatności.