Usługa agregująca generuje raporty podsumowujące z szczegółowymi danymi o konwersjach i danymi o zasięgu na podstawie nieprzetworzonych raportów podlegających agregacji. Jako dostawca technologii reklamowej możesz używać interfejsów Attribution Reporting API i Private Aggregation API, które są 2 głównymi punktami wejścia po stronie klienta, aby kierować raporty do usługi agregacji i otrzymywać w odpowiedzi raporty podsumowujące.
Na tej stronie zakładamy, że jesteś doświadczonym specjalistą ds. technologii reklamowych. Tutaj znajdziesz informacje o:
- Stan implementacji
- Kluczowe terminy i pojęcia
- Przypadki użycia agregacji
- Cały proces
- Przesyłanie zbiorczo raportów podlegających agregacji
- Elementy w chmurze
Stan wdrożenia
- Usługa agregacji jest teraz ogólnie dostępna.
- Usługa agregacji może być używana z interfejsem Attribution Reporting API i interfejsem Private Aggregation API w przypadku interfejsu Protected Audience API i interfejsu Shared Storage API.
Dostępność
| Propozycja | Stan |
|---|---|
| Usługa budżetu na potrzeby prywatności w wielu chmurach
Omówienie |
Dostępna |
| Obsługa usługi agregacji w Amazon Web Services (AWS) w interfejsach Attribution Reporting API i Private Aggregation API
Opis |
Dostępna |
| Obsługa usługi agregacji w Google Cloud w interfejsach Attribution Reporting API i Private Aggregation API Omówienie |
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 można było zsumować dane z kilku źródeł, muszą one pochodzić z tej samej witryny.
Najczęstsze pytania na GitHubie Dokumentacja interfejsu API agregacji witryn |
Dostępna |
| Wartość epsilon usługi agregacji będzie przechowywana w zakresie do 64, aby ułatwić eksperymentowanie i przekazywanie informacji zwrotnych dotyczących różnych parametrów.
Prześlij opinię na temat epsilona w ARA. Prześlij opinię na temat AA epsilon |
Dostępne Przed aktualizacją wartości zakresu epsilon powiadomimy o tym wcześniej ekosystem. |
| Większa elastyczność filtrowania udziału w zapytaniach do usługi do agregacji
Wprowadzenie |
Dostępna |
| Proces odzyskiwania budżetu po katastrofach (błędy, nieprawidłowe konfiguracje itp.) Wyjaśnienie |
Dostępny Mechanizm umożliwiający sprawdzenie odsetka wspólnych identyfikatorów odzyskanych przez firmę technologiczną obsługującą reklamy za pomocą funkcji przywracania budżetu i zawieszenie przyszłych przywracań w przypadku nadmiernego odzyskiwania zaplanowanego na I kwartał 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 do agregacji w ramach zbiorczego raportowania debugowania w interfejsie Attribution Reporting API Wprowadzenie |
Dostępna |
| Usługi kluczy kryptograficznych w wielu chmurach
Wyjaśnienie |
Przewidywana data: pierwszy kwartał 2025 r. |
Kluczowe terminy i pojęcia
Jeśli rozważasz użycie usługi agregacji w swoim procesie, poniższe terminy i zagadnienia mogą pomóc Ci zrozumieć, co nowy proces agregacji może wnieść do Twojego zespołu.
Słowniczek terminów
- Raporty zbiorcze
-
Aggregatable reports are encrypted reports sent from individual user devices. These reports contain data about cross-site user behavior and conversions. Conversions (sometimes called attribution trigger events) and associated metrics are defined by the advertiser or ad tech. Each report is encrypted to prevent various parties from accessing the underlying data.
- Uwzględnianie raportów zbiorczych
-
分布式账本，位于两个协调者中，用于跟踪分配的隐私预算并强制执行“无重复”规则。这是位于协调器中并在其中运行的隐私保护机制，可确保没有任何报告在通过汇总服务时超出分配的隐私预算。
- Budżet rozliczeniowy raportu zbiorczego
-
对预算的引用，用于确保不会对单个报告进行多次处理。
- 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.
Więcej informacji o usłudze agregacji znajdziesz w artykule i pełnej wersji warunków.
- Potwierdzenie
-
一种用于对软件身份进行身份验证的机制，通常使用加密哈希或签名。对于汇总服务提案，认证会将广告技术平台运营的汇总服务中运行的代码与开源代码进行匹配。
- Contribution Bonding
- Koordynator
-
Entities responsible for key management and aggregatable report accounting. A Coordinator maintains a list of hashes of approved aggregation service configurations and configures access to decryption keys.
- Szum i skalowanie
-
szum statystyczny dodawany do raportów zbiorczych podczas procesu agregacji w celu zachowania prywatności i zapewnienia, że raporty końcowe zawierają anonimowe informacje pomiarowe.
Dowiedz się więcej o mechanizmie addytywnym generującym szum, który jest oparty na rozkładzie Laplace’a.
- Źródło raportu
-
接收可汇总报告的实体，也就是您或调用了 Attribution Reporting API 的广告技术平台。可汇总的报告会从用户设备发送到与报告来源关联的知名网址。报告来源是在注册期间指定的。
- Shared ID
-
A computed value that consists of
shared_info,reporting_origin,destination_site(for Attribution Reporting API only),source_registration-time(for Attribution Reporting API only),scheduled_report_time, and version.Multiple reports that share the same attributes in the
shared_infofield should have the same shared ID. Shared IDs play an important role within Aggregatable Report Accounting. - Raport zbiorczy
-
Attribution Reporting API 和 Private Aggregation API 报告类型。摘要报告包含汇总的用户数据，并且可能包含添加了噪声的详细转化数据。摘要报告由汇总报告组成。与事件级报告相比，这些报告具有更高的灵活性，并提供更丰富的数据模型，对于转化价值等某些用例尤其如此。
- Zaufane środowisko wykonawcze (TEE)
-
计算机硬件和软件的安全配置，可让外部方验证机器上运行的软件的确切版本，而无需担心信息泄露。通过 TEE，外部方可以确认软件的行为和功能与其制造商声称的完全一致，不多不少。
如需详细了解用于 Privacy Sandbox 方案的 TEE，请参阅 Protected Audience API 服务说明文档和汇总服务说明文档。
Przypadki użycia agregacji
Zapoznaj się z tymi ścieżkami dla programistów dotyczącymi pomiaru reklam i odpowiednimi bibliotekami klienta pomiarów.
| Przypadek użycia | Punkt wejścia | Opis |
|---|---|---|
| Optymalizacja stawek | Attribution Reporting API (Chrome i Android) | Korzystaj z raportów zbiorczych, aby pozyskiwać sygnały konwersji na potrzeby optymalizacji stawek. |
| Pomiar na różnych 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. |
| Raporty dotyczące 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. |
| Raportowanie danych demograficznych | Shared Storage API i Private Aggregation API (Chrome) | Używaj widoku reklamy 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 zmienne widoku reklamy w wielu witrynach i konwersji, aby przeprowadzać zbiorczą analizę ścieżki konwersji. |
| Wyniki marki i zwiększenie liczby konwersji | Shared Storage API i Private Aggregation API (Chrome) | Raportowanie dotyczące grup testowych i kontrolnych oraz informacji o głosowaniu na potrzeby pomiaru wzrostu skuteczności marki i przyrostu wartości. |
| Debugowanie aukcji | Protected Audience API & Private Aggregation API (Chrome) | Korzystaj z raportów zbiorczych na potrzeby debugowania. |
| Rozkład stawek | Protected Audience API & Private Aggregation API (Chrome) | Korzystaj z raportów zbiorczych, aby rejestrować rozkład wartości stawek w aukcjach. |
Cały proces
Poniższy diagram pokazuje działanie usługi agregacji. Skupimy się na pełnym procesie, od momentu otrzymania raportów z sieci i urządzeń mobilnych do momentu utworzenia raportu podsumowującego w usłudze agregującej.
- Pobierz klucz publiczny, aby generować zaszyfrowane raporty.
- Zaszyfrowane raporty z możliwością agregacji są wysyłane na serwery dostawców technologii reklamowych w celu zebrania, przekształcenia i zbiorowego przetwarzania.
- Serwer dostawcy technologii reklamowej grupuje raporty (w formacie avro) i wysyła je do usługi agregującej. (musisz to zrobić).
- Pracownik agregujący pobiera zagregowane raporty w celu ich odszyfrowania.
- Pracownik agregacji pobiera klucze odszyfrowywania od koordynatora.
- Proces agregacji odszyfrowuje raporty na potrzeby agregacji i dodawania szumu.
- Usługa księgowania raportów agregowalnych sprawdza, czy jest wystarczający budżet na ochronę prywatności, aby wygenerować raport podsumowujący dla podanych raportów agregowalnych.
- Prześlij końcowy raport podsumowujący.
Diagram pokazuje ogólne relacje usługi agregacji z głównymi interfejsami API pomiaru klienta: Attribution Reporting API, Private Aggregation API i koordynatorami.
Proces rozpoczyna się od interfejsów API służących do pomiarów, 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 szyfrować raporty przed ich wysłaniem do źródła raportowania w technologii reklamowej. Klucze publiczne są poddawane rotacji co 7 dni.
Źródło raportowania technologii reklamowych powinno być skonfigurowane tak, aby zbierać i konwertować przychodzące raporty do formatu avro oraz wysyłać je do usługi agregującej zgodnie z opisem w strategiach zbiorczego przetwarzania danych.
Gdy masz gotową partię, wysyłasz do usługi agregacji żądanie zbiorcze. Usługa agregująca pobiera klucze odszyfrowywania z usługi hostingu kluczy, odszyfrowuje raporty, a następnie agreguje je i zaciemnia, aby utworzyć raport podsumowujący. Pamiętaj, że zależy to od tego, czy masz wystarczający budżet na ochronę prywatności.
Usługa agregująca jest wdrażana w chmurze dostawcy technologii reklamowej, a punkt końcowy pochodzenia raportów dostawcy technologii reklamowej, w którym są zbierane raporty, jest hostowany przez Ciebie.
grupowanie raportów zbiorczych.
Proces raportowania nie byłby kompletny bez pomocy wyznaczonego serwera pochodzenia raportów. To jest pochodzenie, które zostało przesłane w trakcie procesu rejestracji. Źródło raportu odpowiada za zbieranie, przekształcanie i grupowanie otrzymanych raportów podlegających agregacji oraz przygotowanie ich do wysłania do usługi agregacji w Google Cloud lub Amazon Web Services. Dowiedz się więcej o przygotowywaniu raportów możliwych do zsumowania.
Teraz, gdy znasz już ogólną koncepcję, możemy przyjrzeć się bliżej komponentom wdrożonym w Twojej usłudze agregacji.
Komponenty Cloud
Usługa agregacji składa się z kilku komponentów usług w chmurze. Aby skonfigurować wszystkie niezbędne komponenty usług w chmurze, użyj dostarczonych skryptów Terraform.
Usługa frontendu
Zarządzana usługa w chmurze: Cloud Function (Google Cloud) / API Gateway (Amazon Web Services)
Usługa frontendu to bezserwerowa brama, która jest głównym punktem wejścia do wywołań interfejsu Aggregation API służących do tworzenia zadań i pobierania ich stanu. Odpowiada on za otrzymywanie żądań od użytkowników usługi agregacji, sprawdzanie parametrów wejściowych i inicjowanie procesu planowania zadania agregacji.
Usługa frontendu ma 2 dostępne interfejsy API:
| Punkt końcowy | Opis |
|---|---|
createJob |
Ten interfejs API uruchamia zadanie usługi do agregacji. Aby uruchomić zadanie, musisz podać takie informacje, jak identyfikator zadania, szczegóły miejsca docelowego danych wejściowych, szczegóły miejsca docelowego danych wyjściowych i źródło raportowania. |
getJob |
Ten interfejs API zwraca stan zadania o określonym identyfikatorze. Zawiera informacje o stanie zadania, takie jak „Otrzymano”, „W toku” lub „Ukończono”. Jeśli zadanie zostało ukończone, zwraca również wynik zadania, w tym wszystkie komunikaty o błędach, które wystąpiły podczas jego wykonywania. |
Zapoznaj się z dokumentacją interfejsu API usługi do agregacji.
Kolejka zadań
Zarządzana usługa w chmurze: Pub/Sub (Google Cloud) / Amazon SQS (Amazon Web Services).
Kolejka zadań to kolejka wiadomości zawierająca żądania zadań dotyczące usługi agregacji. Usługa frontendu wstawia żądania zadań do kolejki, które są następnie wykorzystywane przez pracowników agregacji, którzy je przetwarzają.
Cloud Storage
Zarządzana usługa w chmurze: Google Cloud Storage (Google Cloud) / Amazon S3 (Amazon Web Services).
Pliki wejściowe i wyjściowe używane przez usługę agregacji, takie jak zaszyfrowane pliki raportów i raporty podsumowania wyjściowego, są przechowywane w chmurze.
Baza danych metadanych zadań
Zarządzana usługa w chmurze: Spanner (Google Cloud) / DynamoDB (Amazon Web Services)
Baza danych metadanych zadań służy do przechowywania stanu zadań agregacji i śledzenia go. Zapisywanie metadanych, takich jak czas utworzenia, czas zgłoszenia, czas aktualizacji i stan (np. Otrzymano, W toku lub Gotowe). Instancje robocze agregacji aktualizują bazę danych metadanych zadań w miarę wykonywania zadań.
Zasób roboczy agregacji
Zarządzana usługa w chmurze: Compute Engine z Confidential space (Google Cloud) lub Amazon Web Services EC2 z Nitro Enclave (Amazon Web Services).
Pracownik agregacji przetwarza żądania zadań w kole zadań i odszyfrowuje zaszyfrowane dane wejściowe za pomocą kluczy pobieranych z usługi Key Generation and Distribution Service (KGDS) w koordynatorze. Aby zminimalizować opóźnienie przetwarzania zadania, instancje robocze agregacji przechowują klucze odszyfrowywania w pamięci podręcznej przez 8 godzin i używają ich w ramach przetwarzanych zadań.
Procesy agregacji działają w środowisku Trusted Execution Environment (TEE). Worker obsługuje tylko jedno zadanie naraz. Możesz skonfigurować wiele instancji roboczych do przetwarzania zadań równolegle, ustawiając konfigurację automatycznego skalowania. Jeśli jest używane, autoskalowanie dynamicznie dostosowuje liczbę instancji roboczych do liczby wiadomości w kolejce zadań. Minimalną i maksymalną liczbę instancji roboczych do automatycznego skalowania możesz skonfigurować w pliku środowiska Terraform. Więcej informacji o autoskalowaniu znajdziesz w tych skryptach Terraform: Amazon Web Services lub Google Cloud.
Procesy robocze agregacji wywołują usługę księgowania raportów agregowalnych w celu księgowania raportów agregowalnych. Ta usługa zapewnia, że zadania są wykonywane tylko wtedy, gdy nie przekroczono limitu budżetu prywatności. (zobacz regułę „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.
Pracownicy agregacji aktualizują metadane zadań w bazie danych metadanych zadań. Te informacje obejmują kody zwrotne zadań i liczniki błędów raportów w przypadku częściowych błędów raportów. Użytkownicy mogą pobrać stan za pomocą interfejsu getJob job state retrieval API.
Szczegółowe informacje o usłudze agregacji znajdziesz w tym artykule.
Dalsze kroki
Teraz, gdy znasz najważniejsze informacje o usłudze agregacji, możesz wdrożyć własny jej egzemplarz w Google Cloud lub Amazon Web Services. Aby dowiedzieć się więcej o działaniu usługi agregacji, zapoznaj się z sekcją „Pierwsze kroki” lub kliknij ten link.
Rozwiązywanie problemów
Szczegółowe opisy komunikatów o błędach, informacje o możliwych przyczynach ich występowania oraz dalsze kroki, które należy podjąć, aby je rozwiązać, znajdziesz w dokumentacji Typowe kody błędów i sposoby ich rozwiązania.
Uzyskiwanie pomocy i przesyłanie opinii
- Aby zadać pytanie o usługę, przekazać opinię lub zgłosić prośbę o dodanie funkcji, utwórz zgłoszenie w naszym repozytorium GitHub.
- Jeśli podczas wdrażania, utrzymywania lub wykonywania zadań za pomocą usługi agregacji wystąpił błąd, możesz poprosić o pomoc techniczną, korzystając z tego formularza.
- Sprawdź panel stanu usługi Google Analytics, aby dowiedzieć się, czy wystąpiły znane problemy.