Usługa agregacji

Usługa agregacji generuje raporty podsumowujące szczegółowych danych o konwersjach i danych dotyczących zasięgu na podstawie nieprzetworzonych raportów podlegających agregacji. Technologie reklamowe mają po stronie klienta 2 główne zagregowane punkty wejścia, które umożliwiają przekazywanie raportów ścieżki do usługi agregacji – za pomocą Attribution Reporting API lub Private Aggregation API.

Stan wdrożenia

Dostępność

Propozycja Stan
Obsługa usługi agregacji w Amazon Web Services (AWS) w ramach interfejsów Attribution Reporting API i Private Aggregation API
Wprowadzenie		 Dostępna
Obsługa Google Cloud w ramach interfejsu Attribution Reporting API i interfejsu Private Aggregation API
Wyjaśnienie		 Dostępna
Rejestracja witryny w usłudze do agregacji i agregacja wieloźródłowa. Rejestrowanie witryny obejmuje mapowanie witryny na konta w chmurze (AWS lub GCP). Aby agregować wiele źródeł, muszą one należeć do tej samej witryny.
Najczęstsze pytania na GitHubie
Dokumentacja interfejsu API agregacji witryn 		Dostępna
Wartość ypsilon usługi agregacji będzie przechowywana w zakresie do 64, aby ułatwić eksperymentowanie i uzyskiwanie informacji na temat różnych parametrów.
Prześlij opinię na temat epsilona w ARA.
Prześlij opinię na temat ypsilon PAA.		 Dostępne Zanim zaktualizujemy wartości zakresów ypsilon, powiadomimy o tym ekosystem z wyprzedzeniem.
Bardziej elastyczne filtrowanie treści udziału w zapytaniach dotyczących usługi agregacji
Wyjaśnienie		 Dostępna
Proces odzyskiwania budżetu po katastrofie (błędy, nieprawidłowe konfiguracje itp.)
Wyjaśnienie		 Dostępne
mechanizm pozwalający na przywrócenie odsetka udostępnionych identyfikatorów odzyskanych przez technologię reklamową za pomocą przywrócenia budżetu i zawieszenie możliwości odzyskania w przyszłości przypadków nadmiernych operacji przywracania w pierwszej połowie 2025 r.
Accenture działający jako jeden z koordynatorów w AWS
Blog dla deweloperów		 Dostępna
Niezależna strona działająca jako jeden z koordynatorów Google Cloud
Blog dla deweloperów		 Dostępna
Obsługa usługi agregacji w przypadku zbiorczych raportów debugowania w interfejsie Attribution Reporting API
Wyjaśnienie		 Dostępna

Kluczowe terminy i pojęcia

Jeśli zastanawiasz się nad wykorzystaniem usługi agregacji w swojej pracy związanej z technologią reklamową, z poniższych terminów i zagadnień dowiesz się, co nowy proces agregacji może Ci zaoferować:

Termin Opis
Usługa do agregacji Usługa obsługiwana przez firmę zajmującą się technologiami reklamowymi, która przetwarza raporty podlegające agregacji, aby utworzyć raport podsumowania.
Raporty zbiorcze

Raporty zbiorcze to zaszyfrowane raporty wysyłane z urządzeń poszczególnych użytkowników. Raporty te zawierają dane o zachowaniach użytkowników i konwersjach w różnych witrynach. Konwersje (nazywane też zdarzeniami powodującymi atrybucję) i powiązane z nimi dane są definiowane przez reklamodawcę lub technologię reklamową. Każdy raport jest zaszyfrowany, aby uniemożliwić różnym podmiotom dostęp do danych źródłowych.

Więcej informacji o raportach możliwych do agregacji
Uwzględnianie raportów zbiorczych Rozproszona księga zlokalizowana u obu koordynatorów, która śledzi przydzielony budżet na potrzeby prywatności i wymusza stosowanie zasady „Brak duplikatów”, . Jest to mechanizm chroniący prywatność, który działa w ramach koordynatorów. Zapewnia on, że żadne raporty nie są przekazywane przez usługę agregacji poza przypisanym budżetem na potrzeby prywatności. Dowiedz się więcej o strategiach grupowania dotyczących ich związku z raportami agregowanymi
Budżet księgowy raportu agregowanego Odwołania do budżetu, które zapewniają, że raporty nie są przetwarzane więcej niż raz.
Zaufane środowisko wykonawcze (TEE)

Zaufane środowisko wykonawcze to specjalna konfiguracja sprzętu i oprogramowania komputerowego, która umożliwia weryfikacji dokładnych wersji oprogramowania działającego na komputerze. Środowiska TEE umożliwiają podmiotom zewnętrznym sprawdzenie, czy oprogramowanie działa dokładnie tak, jak twierdzi deweloper, i nic więcej.

Aby dowiedzieć się więcej o TEE wykorzystywanych w ofertach pakietowych Piaskownicy prywatności, przeczytaj Wyjaśnienie usług Protected Audience API i objaśnienie usługi agregacji.
Koordynatorzy

Koordynator to podmiot odpowiedzialny za zarządzanie kluczami i księgowość raportów agregujących. Koordynator przechowuje listę skrótów zatwierdzonych konfiguracji usługi agregacji i konfiguruje dostęp do kluczy odszyfrowywania.
Shared ID Wartość obliczona, która składa się z tych elementów: shared_info, reporting_origin, destination_site (dostępna tylko w przypadku interfejsu Attribution Reporting API), source_registration-time (dostępna tylko w przypadku interfejsu Attribution Reporting API), scheduled_report_time, version. Oznacza to, że wiele raportów należących do tego samego udostępnianego identyfikatora powinno mieć te same atrybuty co pole shared_info. Odgrywa to ważną rolę w księgowości agregowanych raportów. Więcej informacji o zaufanych serwerach
Raport zbiorczy

Raport podsumowujący to typy raportów interfejsów Attribution Reporting API i Private Aggregation API. Podsumowanie zawiera zbiorcze dane o użytkownikach, które mogą zawierać szczegółowe dane o konwersjach (bez szumu). Raporty podsumowujące składają się z raportów zbiorczych. Raporty podsumowania zapewniają większą elastyczność i bogatszy model danych niż raportowanie na poziomie zdarzenia, zwłaszcza w przypadku niektórych zastosowań, np. wartości konwersji.
Źródło raportu

Źródło raportowania to podmiot, który otrzymuje raporty podlegające agregacji, czyli inaczej technologia reklamowa, która wywołała interfejs Attribution Reporting API. Raporty podlegające agregacji są wysyłane z urządzeń użytkowników na znany adres URL powiązany z miejscem pochodzenia raportu. To źródło raportowania należy określić podczas rejestracji.
Contribution Bonding Raporty umożliwiające agregację mogą zawierać dowolną liczbę przyrostów licznika. Raport może np. zawierać liczbę produktów wyświetlonych przez użytkownika w witrynie reklamodawcy. Suma przyrostów we wszystkich raportach agregowanych dotyczących pojedynczego zdarzenia źródłowego nie może przekraczać danego limitu, czyli „L1=2^16”. Więcej informacji znajdziesz w objaśnieniu raportów agregowanych
Szum Skalowanie Do raportów zbiorczych jest dodawany pewien szum statystyczny w ramach procesu agregacji, który służy też do ochrony prywatności i zapewnia, że raporty końcowe zawierają zanonimizowane informacje pomiarowe. Dowiedz się więcej o mechanizmie dodawania szumu, który jest oparty na rozkładzie Laplace’a.
Potwierdzenie

Atest to mechanizm uwierzytelniania tożsamości oprogramowania, zwykle za pomocą haseł kryptograficznych lub podpisów. W przypadku oferty usługi agregacji atest jest zgodny z kodem działającym w usłudze agregacji obsługiwanej przez technologie reklamowe z kodem open source.

Dowiedz się więcej o ateście.

Przeczytaj więcej o historii usługi agregacji w naszym objaśnieniu i na pełnej liście warunków.

Przypadki użycia agregacji

Zapoznaj się z podanymi niżej ścieżkami dewelopera związanymi z pomiarem skuteczności reklam i odpowiadającymi im bibliotekami klienta do pomiaru.

Przypadek użycia Punkt wejścia Opis
Optymalizacja stawek Attribution Reporting API (Chrome i Android) Używaj raportów zbiorczych do pozyskiwania sygnałów konwersji na potrzeby optymalizacji określania stawek.
Pomiar na wielu platformach Attribution Reporting API (Chrome i Android) Korzystaj z możliwości pomiaru skuteczności w internecie i aplikacjach, aby mieć wgląd w skuteczność w Chrome i na Androidzie.
Raportowanie konwersji Attribution Reporting API (Chrome i Android) tworzenie raportów o konwersjach zbiorczych dostosowanych do potrzeb kampanii klientów (w tym CTC i VTC);
Pomiar zasięgu kampanii Shared Storage API i Private Aggregation API(Chrome) Używaj zmiennych widoku reklamy w wielu witrynach do pomiaru zasięgu kampanii.
Raporty demograficzne Shared Storage API i Private Aggregation API (Chrome) Używaj danych o wyświetleniach reklam w wielu witrynach i danych demograficznych do pomiaru zasięgu według danych demograficznych.
Analiza ścieżki konwersji Shared Storage API i Private Aggregation API (Chrome) Przechowuj dane o wyświetleniach reklam w różnych witrynach i zmienne konwersji, aby przeprowadzać zagregowaną analizę ścieżki konwersji.
Wyniki marki i zwiększenie liczby konwersji Shared Storage API i Private Aggregation API(Chrome) Raportowanie na temat grup testowych/kontrolnych oraz informacji z ankiet służących do pomiaru wyników marki i przyrostu wartości.
Debugowanie aukcji Protected Audience API i Private Aggregation API (Chrome) Używaj raportów zbiorczych do debugowania.
Rozkład stawek Protected Audience API & Private Aggregation API (Chrome) Korzystaj z raportów zbiorczych, by rejestrować rozkład wartości stawek w aukcjach.

Kompleksowy proces

Poniższy diagram pokazuje działanie usługi agregacji. Skupimy się na całym procesie – od otrzymywania raportów z internetu i aplikacji mobilnych po tworzenie raportów podsumowujących w usłudze agregacji.

Proces kompleksowej usługi agregacji

  1. Pobierz klucz publiczny, aby generować zaszyfrowane raporty.
  2. Szyfrowane raporty podlegające agregacji wysyłane na serwery technologii reklamowych w celu zebrania, przekształcenia i zbiorowego przetwarzania.
  3. Serwer technologii reklamowych tworzy raporty zbiorcze (w formacie avro) i wysyła je do wdrożonej usługi agregacji. (musi zostać wypełniony przez dostawcę technologii reklamowych).
  4. Pobieranie zagregowanych raportów do odszyfrowania.
  5. Pobieranie kluczy odszyfrowywania od koordynatorów.
  6. Usługa do agregacji odszyfrowuje raporty na potrzeby agregacji i dodawania szumu.
  7. Usługa księgowania raportów agregowanych sprawdza, czy pozostały budżet związany z prywatnością do wygenerowania raportu podsumowującego dane zbiorcze.
  8. Prześlij końcowy raport podsumowujący.

Na diagramie widać ogólne relacje usługi agregacji z głównymi interfejsami API pomiarów klienta: Attribution Reporting API, Private Aggregation API i koordynatorami.

Proces rozpoczyna się od różnych interfejsów Measurement API, takich jak Attribution Reporting API czy Private Aggregation API, które generują raporty z wielu instancji przeglądarki. Chrome pobiera klucz publiczny z usługi hostingu kluczy w koordynatorze, aby zaszyfrować raporty, zanim trafią one do źródła raportowania technologii reklamowych. Klucze publiczne są poddawane rotacji co 7 dni.

Gdy usługa raportowania otrzyma te raporty, powinna je zebrać i przekształcić w format avro, a potem przesłać do wdrożonej instancji usługi agregacji. Zapoznaj się z strategiami zbiorczego ustalania stawek.

Gdy technologia reklamowa jest gotowa do przetwarzania wsadowego, tworzy żądanie zbiorcze do usługi agregacji, w której raporty są odszyfrowywane przez pobranie kluczy odszyfrowywania z usługi hostingu kluczy, a następnie zagregowanie i zaszumianie w celu utworzenia raportu podsumowującego. Pamiętaj, że zależy to od tego, czy masz wystarczający budżet na prywatność, aby wygenerować końcowe raporty podsumowania.

Punkt końcowy punktu początkowego raportowania dotyczącego technologii reklamowych, w którym są zbierane raporty, jest hostowany przez technologię reklamową, a usługa agregacji jest wdrożona w chmurze technologii reklamowej.

grupowanie raportów zbiorczych.

Raportowanie nie byłoby pełne bez pomocy wyznaczonego serwera źródła zgłoszeń. To jest źródło, które firma zajmująca się technologią reklamową przesłałaby w ramach procesu rejestracji. Główne działania, za które odpowiada źródło raportowania, to gromadzenie, przekształcanie i grupowanie otrzymanych raportów zbiorczych oraz przygotowywanie ich do wysłania do wdrożonej w danej technologii reklamowej usługi agregacji w Google Cloud lub Amazon Web Services. Dowiedz się więcej o przygotowywaniu raportów zbiorczych.

Teraz gdy masz już ogólne założenie, przyjrzyj się komponentom, które zostaną wdrożone w Twojej usłudze agregacji.

Komponenty Cloud

Usługa agregacji składa się z różnych komponentów usług w chmurze. Udostępnione skrypty Terraform udostępniają i konfigurują wszystkie niezbędne komponenty usługi w chmurze.

Komponenty usługi do agregacji w chmurze

Usługa frontendu

Usługa w chmurze zarządzanej: Cloud Functions (Google Cloud) / API Gateway (usługi internetowe Amazon)

Usługa frontendu to bezserwerowa brama, która służy jako punkt wejścia dla wywołań interfejsu Aggregation API na potrzeby tworzenia i pobierania stanu zadania. Odpowiada za odbieranie żądań od użytkowników usługi agregacji, weryfikowanie parametrów wejściowych i inicjowanie procesu planowania zadań agregacji.

W usłudze frontendu dostępne są 2 interfejsy API:

Punkt końcowy Opis
createJob Ten interfejs API uruchamia zadanie usługi do agregacji. Do aktywowania zadania wymagane są takie informacje jak identyfikator zadania, dane wejściowe miejsca na dane, szczegóły miejsca wyjściowego, źródło raportowania itp.
getJob Ten interfejs API zwraca stan zadania o określonym identyfikatorze. Zawiera informacje o stanie zadania, takie jak „Otrzymano”, „W toku” lub „Ukończono”. Dodatkowo, jeśli zadanie zostało ukończone, wyświetla się jego wynik, w tym komunikaty o błędach, które wystąpiły podczas jego wykonywania.

Zapoznaj się z dokumentacją interfejsu API usługi do agregacji.

Kolejka zadań

Usługa w chmurze zarządzanej: Pub/Sub (Google Cloud) / Amazon SQS (Amazon Web Services)

Kolejka zadań to kolejka wiadomości, w której przechowywane są żądania zadań dotyczące usługi agregacji. Usługa frontendu wstawia do kolejki komunikaty o żądaniach zadań, które są następnie wykorzystywane przez instancję roboczą agregacji do przetworzenia żądania zadania.

Cloud Storage

Zarządzana usługa w chmurze: Google Cloud Storage (Google Cloud) / Amazon S3 (Amazon Web Services) Cloud Storage służy do przechowywania plików wejściowych i wyjściowych używanych przez usługę agregacji (np. zaszyfrowane pliki raportów, podsumowania wyjściowe itp.).

Baza danych metadanych zadania

Zarządzana usługa w chmurze: Spanner (Google Cloud) / DynamoDB (Amazon Web Services)

Baza danych zadań przechowuje i śledzi stan zadań agregacji. Baza danych rejestruje metadane, takie jak czas utworzenia, czas zgłoszenia, czas aktualizacji i stan (np. Otrzymano, W toku, Zakończono itp.). Procesor agregacji aktualizuje bazę danych metadanych zadań w miarę ich przetwarzania.

Skrypt roboczy agregacji

Usługa w chmurze zarządzana: Compute Engine z przestrzenią poufną (Google Cloud) / Amazon Web Services EC2 z Nitro Enclave (Amazon Web Services)

Skrypt roboczy agregacji przetwarza żądania zadań zainicjowane przez żądanie w kolejce zadań, odszyfrowywając zaszyfrowane dane wejściowe za pomocą kluczy pobranych z usługi generowania i dystrybucji kluczy (KGDS) w ramach koordynatorów. Aby zminimalizować opóźnienie przetwarzania zadania, klucze odszyfrowywania są przechowywane w pamięci podręcznej w instancji roboczej agregacji przez 8 godzin i mogą być używane w przypadku zadań przetwarzanych przez tę instancję roboczą.

Pracownik działa w środowisku Trusted Execution Environment (TEE). Każda instancja robocza obsługuje tylko jedno zadanie naraz. Technologia reklamowa może skonfigurować wiele instancji roboczych do równoległego przetwarzania zadań przez ustawienie konfiguracji autoskalowania. Dzięki automatycznemu skalowaniu liczba instancji roboczych jest dostosowywana dynamicznie do liczby wiadomości pozostających w kolejce zadań. Minimalną i maksymalną liczbę instancji roboczych do automatycznego skalowania można skonfigurować w pliku środowiska Terraform. Więcej informacji o autoskalowaniu znajdziesz w tych skryptach terraforma. [Amazon Web Services / Google Cloud]

Zasób roboczy agregacji wywołuje usługę księgowania raportów agregacji w celu księgowania raportów agregacji. Usługa księgowania raportów umożliwiająca agregację zapewni, że zadania będą wykonywane tylko do momentu przekroczenia limitu budżetu na potrzeby prywatności. (Patrz reguła „Brak duplikatów”). Jeśli budżet jest dostępny, na podstawie zbiorczych danych o wysokiej zmienności jest generowany raport podsumowujący. Dowiedz się więcej o rachunkowości w raportach możliwych do zsumowania.

Skrypt roboczy agregacji aktualizuje metadane zadań w bazie danych metadanych zadań, w tym odpowiednie kody zwrotne zadań i zgłasza liczniki błędów w przypadku częściowych błędów raportu. Użytkownicy mogą pobierać stan za pomocą interfejsu Retrieval API (getJob).

Bardziej szczegółowy opis usługi agregacji znajdziesz w naszym objaśnieniu.

Dalsze kroki

Teraz, gdy znasz najważniejsze informacje o usłudze agregacji, możesz wdrożyć własną instancję tej usługi za pomocą Google Cloud lub Amazon Web Services. Zapoznaj się z sekcją Wprowadzenie. Jeśli potrzebujesz więcej informacji o działaniu wdrożonej usługi agregacji, kliknij ten link, aby dowiedzieć się więcej o działaniu usługi agregacji.

Rozwiązywanie problemów

Szczegółowe opisy komunikatów o błędach, przyczyny napotkanego błędu i opisy działań naprawczych znajdziesz w dokumencie Typowe kody błędów i środki zaradcze.

Uzyskiwanie pomocy i przesyłanie opinii