Служба агрегирования генерирует сводные отчеты с подробными данными о конверсиях и измерениями охвата на основе необработанных агрегированных отчетов. У рекламных специалистов есть две основные точки входа для агрегирования на стороне клиента для направления отчетов в службу агрегации либо через API отчетов по атрибуции, либо через API частной агрегации.
Статус реализации
- Служба агрегации теперь стала общедоступной .
- Службу агрегации можно использовать с API отчетов об атрибуции , API частной агрегации для API защищенной аудитории и API общего хранилища .
Доступность
| Предложение | Статус |
|---|---|
| Поддержка службы агрегации для веб-служб Amazon (AWS) через API отчетов об атрибуции, API частной агрегации. Объяснитель | Доступный |
| Поддержка службы агрегации для Google Cloud через API отчетов об атрибуции и API частной агрегации. Объяснитель | Доступный |
| Регистрация сайта службы агрегации и агрегация нескольких источников. Регистрация сайта включает сопоставление сайта с облачными учетными записями (AWS или GCP). Чтобы объединить несколько источников, они должны находиться на одном сайте. Часто задаваемые вопросы на GitHub Документация по API агрегации сайтов | Доступный |
| Значение эпсилон Службы агрегирования будет сохранено в диапазоне до 64, чтобы облегчить экспериментирование и обратную связь по различным параметрам. Отправьте отзыв об ARA epsilon . Отправьте отзыв о PAA epsilon . | Доступный. Мы предоставим экосистеме предварительное уведомление перед обновлением значений диапазона эпсилон. |
| Более гибкая фильтрация вкладов для запросов службы агрегации. Объяснитель | Доступный |
| Процесс восстановления бюджета после стихийных бедствий (ошибок, неправильных конфигураций и т. д.) Объяснитель | Доступный Механизм для проверки процента общих идентификаторов, восстановленных рекламной технологией с использованием возмещения бюджета, и приостановки будущих возмещений в случае чрезмерного восстановления, запланированного на первое полугодие 2025 года. |
| Accenture выступает в качестве одного из координаторов AWS Блог разработчиков | Доступный |
| Независимая сторона, действующая в качестве одного из координаторов в Google Cloud. Блог разработчиков | Доступный |
| Поддержка службы агрегирования для агрегированных отчетов об отладке API отчетов об атрибуции Объяснитель | Доступный |
Ключевые термины и понятия
Если вы планируете использовать службу агрегирования в своем рабочем процессе по рекламным технологиям, следующие термины и понятия помогут вам лучше понять, что этот новый процесс агрегирования может предоставить вашей команде:
| Term | Description |
|---|---|
| Aggregation Service | An ad tech-operated service that processes aggregatable reports to create a summary report. |
| Aggregatable Reports |
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. Learn more about aggregatable reports. |
| Aggregatable Report Accounting | A distributed ledger located in both coordinators that tracks allocated privacy budget and enforces the 'No Duplicates' rule. This is the privacy preserving mechanism, located and run within coordinators, that ensures that no report passes through Aggregation Service beyond the allocated privacy budget. Read more on batching strategies on how it relates to aggregatable reports. |
| Aggregatable Report Accounting Budget | References to the budget that ensures reports are not processed more than once. |
| Trusted Execution Environment (TEE) |
Доверенная среда выполнения — это специальная конфигурация компьютерного оборудования и программного обеспечения, которая позволяет внешним сторонам проверять точные версии программного обеспечения, работающего на компьютере. TEE позволяют внешним сторонам проверять, что программное обеспечение делает именно то, что заявляет производитель программного обеспечения, — ни больше, ни меньше. Чтобы узнать больше о TEE, используемых в предложениях Privacy Sandbox, прочтите пояснение к службам API защищенной аудитории и объяснение службы агрегации . |
| Coordinators |
Координатор – лицо, отвечающее за управление ключами и учет агрегированной отчетности. Координатор ведет список хешей утвержденных конфигураций службы агрегации и настраивает доступ к ключам расшифровки. |
| Shared ID |
Computed value that consists of: shared_info, reporting_origin, destination_site (available for Attribution Reporting API only), source_registration-time (available for Attribution Reporting API only), scheduled_report_time, version.
This means that multiple reports belong to the same shared ID should they share the same attributes of the shared_info field. This plays an important role within Aggregatable Report Accounting.
Read more about Trusted Servers.
|
| Summary Report |
Сводный отчет – это тип отчета API отчетов об атрибуции и API частного агрегирования. Сводный отчет включает в себя агрегированные данные о пользователях и может содержать подробные данные о конверсиях с добавлением шума. Сводные отчеты состоят из совокупных отчетов. Сводные отчеты обеспечивают большую гибкость и более богатую модель данных, чем отчеты на уровне событий, особенно для некоторых вариантов использования, таких как значения конверсий. |
| Reporting Origin |
The reporting origin is the entity that receives aggregatable reports—in other words, the ad tech that called the Attribution Reporting API. Aggregatable reports are sent from user devices to a well-known URL associated with the reporting origin. This reporting origin should be designated during enrollment. |
| Contribution Bonding | Aggregatable reports may contain an arbitrary number of counter increments. For example, a report may contain a count of products that a user has viewed on an advertiser's site. The sum of increments in all aggregatable reports related to a single source event must not exceed a given limit, `L1=2^16`. Learn more in the aggregatable reports explainer. |
| Noise & Scaling | A certain amount of statistical noise is added to summary reports as a part of the aggregation process that also functions to preserve privacy and ensure the final reports provide anonymized measurement information. Read more about additive noise mechanism, which is drawn from Laplace distribution. |
| Attestation |
Аттестация — это механизм аутентификации идентичности программного обеспечения, обычно с помощью криптографических хешей или подписей. Для предложения службы агрегации аттестация сопоставляет код, работающий в службе агрегации, управляемой рекламными технологиями, с открытым исходным кодом. Read more about attestation. |
Подробнее о предыстории Службы агрегирования читайте в нашем пояснении и в полном списке терминов .
Варианты использования агрегирования
Рассмотрим следующие пути разработчиков для измерения рекламы и соответствующие клиентские библиотеки для измерения.
| Вариант использования | Точка входа | Описание |
|---|---|---|
| Оптимизация ставок | 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) | Используйте агрегированные отчеты, чтобы отслеживать распределение значений ставок на аукционах. |
Сквозной поток
На следующей диаграмме показана служба агрегации в действии. Мы сосредоточимся на сквозном процессе от получения отчетов из Интернета и мобильных устройств до создания сводных отчетов в службе агрегирования.
- Получите открытый ключ для создания зашифрованных отчетов.
- Зашифрованные агрегированные отчеты отправляются на серверы рекламных технологий для сбора, преобразования и пакетной обработки.
- Сервер рекламных технологий группирует отчеты (в формате avro) и отправляет их в развернутую службу агрегации. (Должен быть выполнен специалистом по рекламе).
- Получение агрегированных отчетов для расшифровки.
- Получить ключи дешифрования от координаторов.
- Служба агрегации расшифровывает отчеты для агрегирования и зашумления.
- Служба учета агрегированных отчетов проверяет, остался ли бюджет конфиденциальности для создания сводного отчета для данных агрегированных отчетов.
- Предоставьте окончательный сводный отчет.
На диаграмме вы можете увидеть общую связь, которую имеет служба агрегации с основными API измерения клиентов, API отчетов по атрибуции , API частной агрегации и координаторами.
Процесс начинается с различных API-интерфейсов измерений, таких как API отчетов об атрибуции или API частного агрегирования, которые создают отчеты из нескольких экземпляров браузера. Chrome берет открытый ключ из службы хостинга ключей в координаторе для шифрования отчетов перед их отправкой в источник отчетов рекламной технологии. Открытые ключи меняются каждые семь дней.
Как только источник отчетов рекламной технологии получит эти отчеты, источник отчетов должен быть настроен на сбор и преобразование этих отчетов в формат avro и отправку в развернутый экземпляр службы агрегации. Ознакомьтесь со стратегиями пакетной обработки .
Как только рекламная технология готова к пакетной обработке, она создает пакетный запрос в службу агрегации, где отчеты расшифровываются путем получения ключей расшифровки из службы хостинга ключей, а затем агрегируются и обрабатываются для создания сводного отчета. Имейте в виду, что это зависит от того, достаточно ли бюджета на конфиденциальность для создания окончательных сводных отчетов.
Конечная точка источника отчетов о рекламных технологиях, где собираются отчеты, размещается у рекламной технологии, а служба агрегации развертывается в облаке рекламной технологии.
Пакетная обработка агрегированных отчетов
Поток отчетов не был бы полным без помощи назначенного сервера источника отчетов. Это источник, который рекламная технология должна была бы указать в процессе регистрации. Основными действиями, за которые отвечает источник отчетов, будут сбор, преобразование и пакетирование полученных агрегированных отчетов и подготовка их к отправке в развернутую службу агрегации рекламной технологии в Google Cloud или Amazon Web Services. Узнайте больше о том, как подготовить агрегированные отчеты .
Теперь, когда у вас есть общая концепция, присмотритесь к компонентам, которые будут развернуты в вашей службе агрегации.
Облачные компоненты
Служба агрегации состоит из различных компонентов облачной службы. Предоставленные сценарии Terraform предоставляют и настраивают все необходимые компоненты облачных служб.
Фронтенд-сервис
Управляемая облачная служба: облачная функция (Google Cloud)/шлюз API (веб-службы Amazon)
Frontend Service — это бессерверный шлюз, который служит точкой входа для вызовов API агрегации для создания заданий и получения состояния заданий. Он отвечает за получение запросов от пользователей службы агрегации, проверку входных параметров и инициирование процесса планирования заданий агрегации.
Во Frontend Service доступны два API:
| Конечная точка | Описание |
|---|---|
createJob | Этот API запускает задание службы агрегации. Для запуска задания требуется такая информация, как идентификатор задания, сведения о входном хранилище, сведения о выходном хранилище, источник отчета и многое другое. |
getJob | Этот API возвращает статус задания для указанного идентификатора задания. Он предоставляет информацию о состоянии задания, например «Получено», «В процессе» или «Завершено». Кроме того, если задание завершено, отображается его результат, включая все сообщения об ошибках, возникшие во время выполнения задания. |
Ознакомьтесь с документацией по API службы агрегации .
Очередь заданий
Управляемая облачная служба: Pub/Sub (Google Cloud) / Amazon SQS (веб-службы Amazon)
Очередь заданий — это очередь сообщений, в которой хранятся запросы заданий для службы агрегирования. Служба внешнего интерфейса вставляет в очередь сообщения с запросом задания, которые затем используются работником агрегации для обработки запроса задания.
Облачное хранилище
Управляемая облачная служба: Облачное хранилище Google (Google Cloud) / Amazon S3 (Amazon Web Services). Облачное хранилище используется для хранения входных и выходных файлов, используемых службой агрегации (примеры: зашифрованные файлы отчетов, выходные сводные отчеты и т. д.).
База данных метаданных вакансий
Управляемая облачная служба: Spanner (Google Cloud) / DynamoDB (веб-службы Amazon)
База данных метаданных заданий хранит и отслеживает статус заданий агрегирования. В базе данных хранятся метаданные, такие как время создания, время запроса, время обновления и состояние (примеры: «Получено», «В процессе», «Завершено» и т. д.). Aggregation Worker обновляет базу данных метаданных задания по мере выполнения задания.
Агрегационный работник
Управляемая облачная служба: вычислительная система с конфиденциальным пространством (Google Cloud) / Amazon Web Services EC2 с Nitro Enclave (Amazon Web Services)
Aggregation Worker обрабатывает запросы заданий, инициированные запросом задания в очереди заданий , расшифровывая зашифрованные входные данные с помощью ключей, полученных из службы генерации и распространения ключей (KGDS) в координаторах. Чтобы минимизировать задержку обработки заданий, ключи дешифрования кэшируются в Aggregation Worker на 8 часов и могут использоваться для всех заданий, обрабатываемых этим экземпляром Worker.
Рабочий работает в экземпляре доверенной среды выполнения (TEE) . Каждый работник одновременно выполняет только одну работу. Рекламные технологии могут настроить несколько работников для параллельной обработки заданий, установив конфигурацию автоматического масштабирования. Благодаря автоматическому масштабированию количество воркеров динамически регулируется в зависимости от количества сообщений, остающихся в очереди заданий . Минимальное и максимальное количество воркеров для автоматического масштабирования можно настроить через файл среды Terraform. Дополнительную информацию об автомасштабировании можно найти в следующих скриптах terraform. [ Веб-сервисы Amazon / Облако Google ]
Aggregation Worker вызывает службу Aggregatable Report Accounting для учета агрегированных отчетов. Служба учета агрегированных отчетов будет гарантировать, что задания выполняются только до тех пор, пока они еще не превысили лимит бюджета конфиденциальности. (См. правило «Нет дубликатов» ). Если бюджет доступен, сводный отчет создается с использованием зашумленных агрегатов. Подробнее о агрегированном отчете по бухгалтерскому учету читайте .
Aggregation Worker обновляет метаданные задания в базе данных метаданных задания, включая соответствующие коды возврата задания и счетчики ошибок отчетов в случае частичных сбоев отчета. Пользователи могут получить состояние с помощью API получения состояния задания ( getJob ).
Более подробное описание Службы агрегации можно найти в нашем объяснителе .
Следующие шаги
Теперь, когда вы ознакомились с основными моментами службы агрегации, пришло время развернуть свой собственный экземпляр службы агрегации через Google Cloud или веб-службы Amazon. Ознакомьтесь с разделом «Начало работы » или, если вам нужна дополнительная информация о том, как работать с развернутым сервисом агрегации. Службу агрегации перейдите по этой ссылке, чтобы узнать больше о работе Службы агрегации .
Поиск неисправностей
Обратитесь к нашему документу «Распространенные коды ошибок и меры по устранению» для получения более подробного описания сообщений об ошибках, причин, которые могли вызвать ошибку, с которой вы столкнулись, и следующих шагов по устранению.
Получите поддержку и оставьте отзыв
- Если у вас возникли технические проблемы, вопросы по продукту, отзывы и пожелания по функциям, создайте проблему в нашем репозитории GitHub .
- По вопросам, требующим предоставления конфиденциальной или частной информации для устранения неполадок, обращайтесь по адресу aggregation-service-support@google.com.
- Проверьте панель общедоступного состояния на наличие известных проблем.