Служба агрегации

Служба агрегирования генерирует сводные отчеты с подробными данными о конверсиях и измерениями охвата на основе необработанных агрегированных отчетов. Как специалист по рекламе, вы можете использовать API отчетов по атрибуции и API частной агрегации, две основные точки входа для агрегирования на стороне клиента, для направления отчетов в службу агрегирования и получения в ответ сводного отчета.

На этой странице предполагается, что вы опытный специалист по рекламе. Он охватывает:

Статус реализации

Доступность

Proposal Status
Cross Cloud Privacy Budget Service
Explainer
Available
Aggregation Service support for Amazon Web Services (AWS) across Attribution Reporting API, Private Aggregation API
Explainer
Available
Aggregation Service support for Google Cloud across Attribution Reporting API, Private Aggregation API
Explainer
Available
Aggregation Service site enrollment and multi-origin aggregation. Site enrollment includes mapping of a site to cloud accounts (AWS, or GCP). To aggregate multiple origins, they must be of the same site.
FAQs on GitHub
Site aggregation API documentation
Available
The Aggregation Service's epsilon value will be kept as a range of up to 64, to facilitate experimentation and feedback on different parameters.
Submit ARA epsilon feedback.
Submit PAA epsilon feedback.
Available. We will provide advanced notice to the ecosystem before the epsilon range values are updated.
More flexible contribution filtering for Aggregation Service queries
Explainer
Available
Process for budget recovery post-disasters (errors, misconfigurations, and so on)
Explainer
Available
Mechanism to review the percentage of shared IDs recovered by an ad tech using budget recovery and suspend future recoveries for excessive recoveries planned for H1 2025
Accenture operating as one of the Coordinators on AWS
Developer Blog
Available
Independent party operating as one of the Coordinators on Google Cloud
Developer blog
Available
Aggregation Service support for Aggregate Debug Reporting on Attribution Reporting API
Explainer
Available

Ключевые термины и понятия

Если вы рассматриваете службу агрегации для своего рабочего процесса, следующие термины и понятия могут дать представление о том, что этот новый процесс агрегации может предоставить вашей команде.

Глоссарий терминов

Агрегированные отчеты

Агрегированные отчеты — это зашифрованные отчеты, отправляемые с отдельных пользовательских устройств. Эти отчеты содержат данные о поведении пользователей и конверсиях на разных сайтах. Конверсии (иногда называемые событиями-триггерами атрибуции) и связанные с ними показатели определяются рекламодателем или рекламным специалистом. Каждый отчет зашифрован, чтобы предотвратить доступ различных сторон к базовым данным.

Узнайте больше об агрегированных отчетах .

Агрегированный отчет учета

Распределенный реестр, расположенный в обоих координаторах, который отслеживает выделенный бюджет конфиденциальности и обеспечивает соблюдение правила «Нет дубликатов» . Это механизм сохранения конфиденциальности, расположенный и управляемый координаторами, который гарантирует, что никакие отчеты не пройдут через Службу агрегирования сверх выделенного бюджета конфиденциальности.

Узнайте больше о том, как стратегии пакетной обработки связаны с агрегируемыми отчетами .

Агрегированный отчет по бухгалтерскому бюджету

Ссылки на бюджет, обеспечивающий обработку отдельных отчетов не более одного раза.

Служба агрегации

Служба, управляемая рекламными технологиями, которая обрабатывает агрегированные отчеты для создания сводного отчета.

Подробнее о предыстории Службы агрегирования читайте в нашем пояснении и в полном списке терминов .

Аттестация

Механизм аутентификации идентичности программного обеспечения, обычно с помощью криптографических хешей или подписей. Для предложения услуги агрегации аттестация сопоставляет код, работающий в вашей службе агрегации, управляемой рекламными технологиями, с открытым исходным кодом.

Подробнее об аттестации читайте .

Вклад
Координатор

负责密钥管理和汇总报告会计核算的实体。协调者会维护已获批准的汇总服务配置的哈希列表,并配置对解密密钥的访问权限。

Шум и масштабирование

Статистический шум, который добавляется к сводным отчетам во время процесса агрегирования, чтобы сохранить конфиденциальность и гарантировать, что окончательные отчеты содержат анонимную информацию об измерениях.

Узнайте больше об аддитивном механизме шума , который основан на распределении Лапласа .

Сообщение о происхождении

Объект, который получает агрегированные отчеты — другими словами, вы или рекламная технология, которая называется API отчетов по атрибуции. Агрегированные отчеты отправляются с пользовательских устройств на известный URL-адрес, связанный с источником отчетов. Источник отчетности указывается во время регистрации.

Общий идентификатор

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_info field should have the same shared ID. Shared IDs play an important role within Aggregatable Report Accounting.

Read more about Trusted Servers.

Сводный отчет

Attribution Reporting API 和 Private Aggregation API 报告类型。摘要报告包含汇总的用户数据,并且可能包含添加了噪声的详细转化数据。摘要报告由汇总报告组成。与事件级报告相比,这些报告具有更高的灵活性,并提供更丰富的数据模型,对于转化价值等某些用例尤其如此。

Доверенная среда выполнения ( TEE )

Безопасная конфигурация компьютерного оборудования и программного обеспечения, позволяющая внешним сторонам проверять точные версии программного обеспечения, работающего на компьютере, не опасаясь раскрытия информации. TEE позволяют внешним сторонам проверять, что программное обеспечение делает именно то, что заявляет производитель программного обеспечения, — ни больше, ни меньше.

Чтобы узнать больше о TEE, используемых в предложениях Privacy Sandbox, прочтите пояснение к службам API защищенной аудитории и объяснение службы агрегации .

Варианты использования агрегирования

Рассмотрим следующие пути разработчиков для измерения рекламы и соответствующие клиентские библиотеки для измерения.

Вариант использования Точка входа Описание
Оптимизация ставок API отчетов по атрибуции (Chrome и Android) Используйте агрегированные отчеты для получения сигналов о конверсиях в целях оптимизации ставок.
Кроссплатформенное измерение API отчетов по атрибуции (Chrome и Android) Используйте возможности межсетевого измерения и измерения приложений, чтобы получить представление о производительности Chrome и Android.
Отчеты о конверсиях API отчетов по атрибуции (Chrome и Android) Создавайте агрегированные отчеты о конверсиях, адаптированные к потребностям кампаний клиентов (включая CTC и VTC).
Измерение охвата кампании API общего хранилища и API частного агрегирования (Chrome) Используйте переменные просмотра межсайтовой рекламы, чтобы измерить охват кампании.
Демографическая отчетность API общего хранилища и API частного агрегирования (Chrome) Используйте просмотр межсайтовой рекламы и демографическую информацию, чтобы измерить охват по демографическим группам.
Анализ пути конверсии API общего хранилища и API частного агрегирования (Chrome) Сохраняйте переменные просмотра межсайтовой рекламы и конверсии для выполнения совокупного анализа пути конверсии.
Бренд и рост конверсий API общего хранилища и API частного агрегирования (Chrome) Отчетность по тестовым/контрольным группам и информация опросов для измерения подъема бренда и его прироста.
Отладка аукциона API защищенной аудитории и API частного агрегирования (Chrome) Используйте агрегированные отчеты для отладки.
Распределение ставок API защищенной аудитории и API частного агрегирования (Chrome) Используйте агрегированные отчеты, чтобы отслеживать распределение значений ставок на аукционах.

Сквозной поток

На следующей диаграмме показана служба агрегации в действии. Мы сосредоточимся на сквозном потоке с момента получения отчетов из Интернета и мобильных устройств до момента создания сводного отчета в службе агрегирования.

Процесс сквозной агрегации
Процесс сквозной агрегации
  1. Получите открытый ключ для создания зашифрованных отчетов.
  2. Зашифрованные агрегированные отчеты отправляются на серверы рекламных технологий для сбора, преобразования и пакетной обработки.
  3. Сервер рекламных технологий группирует отчеты (в формате avro) и отправляет их в службу агрегации. (Вы должны выполнить это.)
  4. Работник агрегирования извлекает агрегированные отчеты для расшифровки.
  5. Работник агрегации получает ключи дешифрования от координатора.
  6. Aggregation Worker расшифровывает отчеты на предмет агрегации и зашумления.
  7. Служба учета агрегированных отчетов проверяет, имеется ли достаточный бюджет конфиденциальности для создания сводного отчета для данных агрегированных отчетов.
  8. Предоставьте итоговый сводный отчет.

На диаграмме показаны высокоуровневые отношения, которые служба агрегации имеет с основными API измерения клиентов: API отчетов по атрибуции , API частной агрегации и координаторы.

Процесс начинается с API-интерфейсов измерений, таких как API отчетов об атрибуции или API частного агрегирования , которые создают отчеты из нескольких экземпляров браузера. Chrome получает открытый ключ от службы хостинга ключей в координаторе для шифрования отчетов перед отправкой их в источник отчетов вашей рекламной технологии. Открытые ключи меняются каждые семь дней.

Источник отчетов о рекламных технологиях должен быть настроен на сбор и преобразование входящих отчетов в формат avro и их отправку в службу агрегирования, как описано в стратегиях пакетной обработки .

Когда у вас есть готовый пакет, вы отправляете пакетный запрос в службу агрегации. Служба агрегирования получает ключи дешифрования от службы хостинга ключей, расшифровывает отчеты, а затем объединяет и обрабатывает их для создания сводного отчета. Имейте в виду, что это зависит от наличия достаточного бюджета на конфиденциальность для их создания.

Вы размещаете конечную точку источника отчетов о рекламных технологиях, где собираются отчеты, а служба агрегации развертывается в вашем облаке рекламных технологий.

Пакетная обработка агрегированных отчетов

Поток отчетов не был бы полным без помощи назначенного сервера источника отчетов. Это происхождение, которое вы указали бы в процессе регистрации. Источник отчетов отвечает за сбор, преобразование и группировку получаемых агрегированных отчетов, а также подготовку их к отправке в вашу службу агрегации в Google Cloud или веб-службах Amazon. Узнайте больше о том, как подготовить агрегированные отчеты .

Теперь, когда у вас есть общая концепция, мы можем более внимательно рассмотреть компоненты, которые развернуты в вашей службе агрегации.

Облачные компоненты

Служба агрегации состоит из нескольких компонентов облачной службы. Вы используете предоставленные сценарии Terraform для подготовки и настройки всех необходимых компонентов облачных служб.

Облачные компоненты службы агрегации
Облачные компоненты службы агрегации

Фронтенд-сервис

Управляемая облачная служба: облачная функция (Google Cloud)/шлюз API (веб-службы Amazon)

Служба переднего плана — это бессерверный шлюз, который является основной точкой входа для вызовов API агрегации для создания заданий и получения состояния заданий. Он отвечает за получение запросов от пользователей службы агрегации, проверку входных параметров и инициирование процесса планирования заданий агрегации.

Служба внешнего интерфейса имеет два доступных API:

Конечная точка Описание
createJob Этот API запускает задание службы агрегации. Для запуска задания требуется такая информация, как идентификатор задания, сведения о входном хранилище, сведения о выходном хранилище, источник отчета и т. д.
getJob Этот API возвращает статус задания с указанным идентификатором задания. Он предоставляет информацию о состоянии задания, например «Получено», «В процессе» или «Завершено». Если задание завершено, оно также возвращает результат задания, включая все сообщения об ошибках, возникшие во время выполнения задания.

Ознакомьтесь с документацией по API службы агрегации .

Очередь заданий

Управляемая облачная служба: Pub/Sub (Google Cloud) / Amazon SQS (веб-службы Amazon)

Очередь заданий — это очередь сообщений, содержащая запросы заданий для службы агрегации. Служба переднего плана вставляет запросы заданий в очередь, которые затем используются обработчиками агрегации , которые их обрабатывают.

Облачное хранилище

Управляемая облачная служба: Google Cloud Storage (Google Cloud) / Amazon S3 (Amazon Web Services)

Входные и выходные файлы, используемые Службой агрегации, такие как зашифрованные файлы отчетов и выходные сводные отчеты, хранятся в облачном хранилище.

База данных метаданных вакансий

Управляемая облачная служба: Spanner (Google Cloud) / DynamoDB (веб-службы Amazon)

База данных метаданных заданий используется для хранения и отслеживания статуса заданий агрегирования. Он записывает метаданные, такие как время создания, запрошенное время, время обновления и состояние, например «Получено», «В процессе» или «Завершено». Рабочие агрегаторы обновляют базу данных метаданных задания по мере выполнения задания.

Агрегационный работник

Управляемая облачная служба: вычислительная система с конфиденциальным пространством (Google Cloud) / Amazon Web Services EC2 с Nitro Enclave (Amazon Web Services)

Работник агрегации обрабатывает запросы заданий в очереди заданий и расшифровывает зашифрованные входные данные, используя ключи, которые он получает из службы генерации и распространения ключей (KGDS) в координаторах. Чтобы минимизировать задержку обработки заданий, Aggregation Workers кэширует ключи дешифрования на период 8 часов и использует их во всех обрабатываемых заданиях.

Рабочие агрегаты работают в экземпляре доверенной среды выполнения (TEE) . Работник одновременно выполняет только одну работу. Вы можете настроить несколько работников для параллельной обработки заданий, задав конфигурацию автоматического масштабирования. Если используется, автоматическое масштабирование динамически регулирует количество воркеров в соответствии с количеством сообщений в очереди заданий . Вы можете настроить минимальное и максимальное количество воркеров для автоматического масштабирования через файл среды Terraform. Дополнительную информацию об автомасштабировании можно найти в сценариях Terraform: Amazon Web Services или Google Cloud .

Работники агрегирования вызывают службу учета агрегированных отчетов для учета агрегированных отчетов. Эта служба гарантирует, что задания выполняются только в том случае, если лимит бюджета конфиденциальности не превышен. (См. правило «Нет дубликатов» .) Если бюджет доступен, сводный отчет создается с использованием зашумленных агрегатов. Подробнее о агрегированном отчете по бухгалтерскому учету читайте .

Рабочие агрегаторы обновляют метаданные задания в базе данных метаданных задания. Эта информация включает коды возврата заданий и счетчики ошибок отчетов в случае частичного сбоя отчета. Пользователи могут получить состояние с помощью API получения состояния задания getJob .

См. это объяснение для более подробного описания Службы агрегирования.

Следующие шаги

Теперь, когда вы ознакомились с основными функциями Службы агрегации, пришло время развернуть собственный экземпляр Службы агрегации через Google Cloud или веб-службы Amazon. См . раздел «Начало работы» или перейдите по этой ссылке, чтобы узнать больше о работе Службы агрегирования .

Поиск неисправностей

Обратитесь к документу «Распространенные коды ошибок и меры по устранению» для получения подробного описания сообщений об ошибках, причин, которые могли вызвать ошибку, с которой вы столкнулись, и следующих шагов по устранению.

Получите поддержку и оставьте отзыв

  • Если у вас есть вопросы по продукту, отзывы и пожелания по функциям, создайте проблему в нашем репозитории GitHub .
  • Чтобы запросить техническую поддержку по устранению неполадок, если вы столкнулись с ошибкой при развертывании, обслуживании или выполнении заданий с помощью Службы агрегирования, используйте эту форму технической поддержки .
  • Проверьте панель общедоступного состояния на наличие известных проблем.