Pomiar danych zagregowanych dla użytkowników za pomocą interfejsów Attribution Reporting API i Private Aggregation API.
Stan wdrożenia
- Korzystaj z raportów podsumowujących Attribution Reporting i eksperymentuj z nimi.
Co to jest raport podsumowujący?
Raport podsumowujący jest tworzony dla grupy użytkowników, dzięki czemu nie można go powiązać z żadną konkretną osobą. Raporty podsumowania zawierają szczegółowe dane o konwersjach z możliwością elastycznego dopasowania danych o kliknięciach i wyświetleniach. Raporty podsumowania nie korzystają z plików cookie ani mechanizmów innych firm, które mogą służyć do identyfikowania poszczególnych użytkowników na różnych stronach.
Raporty podsumowujące są tworzone w 2 kontekstach:
- Pomiar skuteczności reklam: firmy technologiczne zajmujące się reklamami mogą generować raporty zbiorcze za pomocą raportowania atrybucji, aby mierzyć, kiedy kliknięcie lub wyświetlenie reklamy prowadzi do konwersji w witrynie reklamodawcy, np. do sprzedaży lub rejestracji. Firmy zajmujące się technologiami reklamowymi mogą też generować raporty podsumowujące dotyczące aukcji Protected Audience API z użyciem Private Aggregation.
- Ogólne raportowanie z wielu witryn: deweloperzy rejestrują dane z wielu witryn w Shared Storage i mogą tworzyć na ich podstawie raporty za pomocą Private Aggregation. Ma to wiele zastosowań, np. pozwala uzyskać wgląd w dane demograficzne użytkowników i określić unikalny zasięg treści.
Raporty podsumowania są żądane inaczej w przypadku raportowania atrybucji i prywatnej agregacji. Zanim dowiesz się, jak generować raporty, musisz najpierw zrozumieć, czym jest agregacja i jak raporty podsumowujące mogą Ci pomóc w spełnianiu Twoich potrzeb związanych z pomiarami.
Kluczowych pojęć
Projektowanie zbierania danych
Kluczową zasadą dotyczącą raportów podsumowania jest podejmowanie decyzji projektowych na wczesnym etapie. Ty decydujesz, jakie dane zbierać w jakich kategoriach. Raporty wyjściowe zawierają informacje o kampaniach lub Twojej firmie.
Raport wyjściowy zawiera szczegółowe dane o konwersjach w różnych witrynach oraz zapewnia elastyczność w związku z łączeniem danych o kliknięciach i wyświetleniach z danymi o konwersjach. Możesz też traktować dane wyjściowe jako dane wejściowe dla narzędzi, których używasz do podejmowania decyzji.
Zadaj sobie pytanie: czego chcę się dowiedzieć o zaangażowaniu użytkowników w moje treści?
Konwersje z reklam
Jeśli na przykład wygenerujesz raporty podsumowujące, aby określić, ile konwersji doprowadziło do określonej wartości łącznych wydatków, może to pomóc Twojemu zespołowi zdecydować, na co powinna być nastawiona następna kampania reklamowa, aby uzyskać wyższe łączne wydatki.

Zaangażowanie w wielu witrynach
Jeśli np. wygenerujesz raporty podsumowujące, aby sprawdzić, ile osób czytało Twoje treści w witrynie innej firmy, może to pomóc Twojemu zespołowi w podejmowaniu decyzji o tym, jak nawiązać współpracę z tą firmą, aby zwiększyć zaangażowanie i zachęcić czytelników do bezpośredniego odwiedzania Twojej witryny.
Jakie informacje są rejestrowane w przeglądarce?
Raport możliwy do zsumowania to dane nieprzetworzone pobrane z przeglądarki użytkownika, które obejmują z góry określony zestaw zbiorów (lub kluczy agregacji). Sposób określenia tych kryteriów zależy od decyzji projektowych.
Raporty podsumowania zawierają zarówno dane zagregowane, jak i szczegółowe dane o konwersjach.
Konwersje z reklam
Konwersje są definiowane przez reklamodawcę lub firmę zajmującą się technologiami reklamowymi i mogą się różnić w różnych kampaniach reklamowych. Jedna kampania może mierzyć liczbę kliknięć reklam, po których użytkownik kupił reklamowany produkt. Inna kampania może zliczać, ile wyświetleń reklamy doprowadziło do wizyt w witrynie reklamodawcy.
Na przykład dostawca technologii reklamowych prowadzi kampanię reklamową w witrynie news.example, w której konwersja oznacza, że użytkownik kliknął reklamę butów i kupił buty w witrynie shoes.example.
Technologia reklamowa otrzymuje raport podsumowujący dotyczący kampanii reklamowej o identyfikatorze 1234567
, który wskazuje, że 12 stycznia 2022 r. w witrynie shoes.example odnotowano 518 konwersji, a łączne wydatki wyniosły 38 174 USD. 60% konwersji pochodziło od użytkowników, którzy kupili niebieskie trampki o kodzie SKU 9872
, a 40% – od użytkowników, którzy kupili żółte sandały o kodzie SKU 2643
. Identyfikator kampanii to szczegółowe dane po stronie reklamy, a kody SKU produktów to szczegółowe dane o konwersjach. Liczba konwersji i łączne wydatki to dane zbiorcze.
Zaangażowanie w wielu witrynach
Zanim zaczniesz gromadzić dane, musisz określić, jakie informacje chcesz zbierać, jakie konwersje chcesz uzyskiwać dzięki danej integracji między witrynami oraz jaki typ raportu chcesz tworzyć.
Istnieje wiele możliwych przypadków użycia, które zostały szczegółowo opisane w dokumentacji Private Aggregation. Przyjrzyjmy się temu przykładowi:
Możesz mierzyć dane demograficzne użytkowników, którzy widzieli Twoje treści w różnych witrynach. Prywatna agregacja może dostarczyć odpowiedzi, np. „Około 317 unikalnych użytkowników w wieku od 18 do 45 lat z Niemiec”. Najpierw określ, jakie informacje chcesz zbierać (np. wiek i lokalizację). Następnie użyj Shared Storage do zbierania tych konkretnych danych demograficznych z witryny innej firmy. W późniejszym czasie możesz przesłać raport za pomocą prywatnego agregatu z wymiarami grupa wiekowa i kraj zakodowanymi w kluczu agregacji.
Jak dane są rejestrowane przed agregacją?
Raporty podsumowujące są tworzone na podstawie danych zbiorczych z grupy poszczególnych urządzeń. Nie można obserwować ani sprawdzać działań poszczególnych użytkowników, ale proces zbierania danych jest taki sam w przypadku każdego z nich.
Działania pojedynczego użytkownika są szyfrowane i zbierane w raporcie umożliwiającym agregację. Raporty te zawierają też niewielką ilość niezaszyfrowanych metadanych związanych z przetwarzaniem zbiorczym.
W przypadku danych raportowania atrybucji raporty podlegające agregacji są rejestrowane w ten sposób:
- Użytkownik odwiedza witrynę wydawcy i widzi lub klika reklamę, co jest nazywane zdarzeniem źródłowym atrybucji.
- Kilka minut lub dni później użytkownik dokonuje konwersji, co jest nazywane zdarzeniem aktywowania atrybucji. Konwersję można np. zdefiniować jako zakup produktu.
- Oprogramowanie przeglądarki dopasowuje kliknięcie lub wyświetlenie reklamy do zdarzenia konwersji. Na podstawie tego dopasowania przeglądarka tworzy raport umożliwiający agregację za pomocą określonej logiki stworzonej przez dostawcę technologii reklamowych.
- Przeglądarka szyfruje te dane i po krótkim opóźnieniu wysyła je do serwera dostawcy technologii reklamowej w celu zebrania. Aby uzyskać dostęp do informacji o szumie, serwer adtech musi korzystać z usługi agregującej.
W przypadku Private Aggregation wygląda to tak:
- Inna firma decyduje, co chce mierzyć, i zapisuje dane w Shared Storage, aby można je było odczytać w późniejszym czasie.
- Użytkownik wywołuje zdarzenie, które pasuje do tego, co chce mierzyć firma zewnętrzna. Gdy np. użytkownik odwiedza witrynę z osadzonym materiałem, firma zewnętrzna może odczytać dane w Shared Storage i za pomocą Private Aggregation wysłać zagregowane raporty do Twojego serwera w celu zebrania.

Raporty zbiorcze na podstawie zbiorów danych
Zanim zebrane raporty podlegające agregacji zostaną przetworzone i zbiorczo zebrane w raport podsumowujący, muszą zostać uporządkowane w partie. Partia to strategiczna grupa raportów, które można agregować.
Raporty podlegające agregacji zawierają niewielką ilość niezaszyfrowanych danych, które są uwzględniane jako shared_info
i mogą służyć do tworzenia partii. Obejmuje to sygnaturę czasową i źródło raportu. Nie możesz utworzyć zbiorczego raportu na podstawie zaszyfrowanych informacji.
Najlepiej, gdy partie zawierają wiele raportów. Możesz tworzyć partie co godzinę, codziennie, co tydzień lub w dowolnym innym wybranym przez siebie tempie. Ta strategia może się zmieniać w przypadku określonych wydarzeń, w których przypadku spodziewasz się większego ruchu.
Jeśli np. grupowo generujesz raporty zbiorcze za pomocą interfejsu Attribution Reporting API, możesz zaktualizować strategię grupowania na godzinową w dniu dużej wyprzedaży, w której spodziewasz się większej liczby konwersji z reklam.
W przypadku interfejsu Private Aggregation API możesz spodziewać się zmiany strategii w dniu opublikowania dużego komunikatu prasowego dotyczącego konkretnego elementu treści umieszczonego w witrynach innych firm.
Przetwarzanie danych za pomocą usługi do agregacji
Usługa do agregacji odszyfrowuje i łączy dane z partii raportów podlegających agregacji, dodaje szum i zwraca końcowy raport podsumowujący. Ta usługa działa w zaufanym środowisku wykonawczym (TEE), które jest wdrażane w usłudze w chmurze obsługującej niezbędne środki bezpieczeństwa chroniące te dane.
Raporty podsumowujące z raportowaniem atrybucji
Aby dostawcy technologii reklamowych mogli pobrać raport podsumowujący, muszą wykonać te czynności:
- Dostawca technologii reklamowych zbiera raporty z możliwością agregacji z przeglądarek poszczególnych użytkowników.
- Dostawca technologii reklamowych zbiera raporty z możliwością agregacji w partie i przesyła je do usługi agregującej.
- Usługa do agregacji planuje proces agregacji danych.
- Proces agregacji odszyfrowuje i agreguje dane z raportów podlegających agregacji wraz z danymi zafałszowanymi.
- Usługa do agregacji zwraca raport podsumowujący dostawcy technologii reklamowych.

Firma ta może używać raportu podsumowania do określania stawek i oferowania raportów swoim klientom. Schemat zakodowany w formacie JSON jest zalecanym formatem raportów podsumowujących.
Raporty podsumowujące z Private Aggregation
- Odczytaj dane z różnych witryn zebrane przez Shared Storage i wygeneruj klucz agregacji, aby pogrupować dane.
- Wywołaj interfejs Private Aggregation API z workletu Shared Storage z kluczem agregacji i wartością, którą chcesz kumulować. Przeglądarka wygeneruje zaszyfrowany raport z możliwością agregacji na podstawie Twoich danych i wyśle go do Twojego serwera w celu zebrania.
- Zbieraj raporty z możliwością agregacji w partiach i przesyłaj je do usługi agregującej do przetworzenia.
- Usługa do agregacji przetwarza raporty zbiorcze, a potem dodaje szum.
- Usługa do agregacji zwraca raport podsumowujący do osoby, która go zażądała.
Zaangażowanie i przesyłanie opinii
Raporty podsumowania są kluczowym elementem propozycji pomiarów w ramach Piaskownicy prywatności. Podobnie jak inne propozycje Piaskownicy prywatności, ta jest udokumentowana i publicznie omawiana w GitHub.
- Omów interfejs Attribution Reporting API.
- Omów Private Aggregation API.
- Pomoc dla deweloperów: zadawaj pytania i ucz się w dyskusjach w repozytorium Piaskownicy prywatności dla deweloperów.