Служба агрегирования генерирует сводные отчеты с подробными данными о конверсиях и измерениями охвата на основе необработанных агрегированных отчетов. Как специалист по рекламе, вы можете использовать API отчетов по атрибуции и API частной агрегации, две основные точки входа для агрегирования на стороне клиента, для направления отчетов в службу агрегирования и получения в ответ сводного отчета.
На этой странице предполагается, что вы опытный специалист по рекламе. Он охватывает:
- Статус реализации
- Ключевые термины и понятия
- Варианты использования агрегирования
- Сквозной поток
- Пакетная обработка агрегированных отчетов
- Облачные компоненты
Статус реализации
- Служба агрегации теперь стала общедоступной .
- Службу агрегации можно использовать с API отчетов об атрибуции , API частной агрегации для API защищенной аудитории и API общего хранилища .
Доступность
| 提案 | 状态 |
|---|---|
| 跨云隐私预算服务
说明 |
可用 |
| 针对 Attribution Reporting API、Private Aggregation API 中的 Amazon Web Services (AWS) 提供汇总服务支持
说明 |
可用 |
| 针对 Attribution Reporting API、Private Aggregation API 的 Google Cloud 汇总服务支持 说明 |
可用 |
| 汇总服务网站注册和多源汇总。网站注册包括将网站映射到云账号（AWS 或 GCP）。如需汇总多个来源，这些来源必须属于同一网站。
GitHub 上的常见问题解答 Site aggregation API 文档 |
可用 |
| 汇总服务的 epsilon 值将保持在 64 以内的范围内，以便对不同的参数进行实验和反馈。
提交 ARA 小数值反馈。 提交 PAA 小数值反馈。 |
可用。在更新 epsilon 范围值之前，我们会提前通知生态系统。 |
| 为汇总服务查询提供了更灵活的贡献过滤功能
解说 |
可用 |
| 灾难发生后（错误、配置错误等）预算恢复流程
说明 |
已推出 机制，用于查看广告技术平台使用预算恢复功能恢复的共享 ID 的百分比，并暂停计划在 2025 年上半年过度恢复的未来恢复 |
| Accenture 是 AWS 协调者之一
开发者博客 |
可用 |
| 作为 Google Cloud 协调者之一的独立方
开发者博客 |
可用 |
| 汇总服务支持 Attribution Reporting API 上的汇总调试报告
说明 |
可用 |
| 跨云加密密钥服务
解说 |
预计 2025 年上半年 |
Ключевые термины и понятия
Если вы рассматриваете службу агрегации для своего рабочего процесса, следующие термины и понятия могут дать представление о том, что этот новый процесс агрегации может предоставить вашей команде.
Глоссарий терминов
- Агрегированные отчеты
-
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.
- Агрегированный отчет учета
-
分布式账本，位于两个协调者中，用于跟踪分配的隐私预算并强制执行“无重复”规则。这是位于协调器中并在其中运行的隐私保护机制，可确保没有任何报告在通过汇总服务时超出分配的隐私预算。
- Агрегированный отчет по бухгалтерскому бюджету
-
对预算的引用，用于确保不会对单个报告进行多次处理。
- Служба агрегации
-
由广告技术平台运营的服务，用于处理可汇总报告以创建摘要报告。
- Аттестация
-
A mechanism to authenticate software identity, usually with cryptographic hashes or signatures. For the aggregation service proposal, attestation matches the code running in your ad tech-operated aggregation service with the open source code.
- Вклад
- Координатор
-
Субъекты, ответственные за управление ключами и учет агрегированной отчетности. Координатор ведет список хешей утвержденных конфигураций службы агрегации и настраивает доступ к ключам расшифровки.
- Шум и масштабирование
-
Статистический шум, который добавляется к сводным отчетам во время процесса агрегирования, чтобы сохранить конфиденциальность и гарантировать, что окончательные отчеты содержат анонимную информацию об измерениях.
Узнайте больше об аддитивном механизме шума , который основан на распределении Лапласа .
- Сообщение о происхождении
-
接收可汇总报告的实体，也就是您或调用了 Attribution Reporting API 的广告技术平台。可汇总的报告会从用户设备发送到与报告来源关联的知名网址。报告来源是在注册期间指定的。
- Общий идентификатор
-
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. - Сводный отчет
-
Тип отчета API отчетов об атрибуции и API частного агрегирования. Сводный отчет включает в себя агрегированные данные о пользователях и может содержать подробные данные о конверсиях с добавлением шума. Сводные отчеты состоят из совокупных отчетов. Они обеспечивают большую гибкость и предоставляют более богатую модель данных, чем отчеты на уровне событий, особенно для некоторых вариантов использования, таких как значения конверсий.
- Доверенная среда выполнения ( TEE )
-
A secure configuration of computer hardware and software that allows external parties to verify the exact versions of software running on the machine without fear of exposure. TEEs allow external parties to verify that the software does exactly what the software manufacturer claims it does—nothing more or less.
To learn more about TEEs used for the Privacy Sandbox proposals, read the Protected Audience API services explainer and the Aggregation Service explainer.
Варианты использования агрегирования
Рассмотрим следующие пути разработчиков для измерения рекламы и соответствующие клиентские библиотеки для измерения.
| Вариант использования | Точка входа | Описание |
|---|---|---|
| Оптимизация ставок | 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) и отправляет их в службу агрегации. (Вы должны выполнить это.)
- Работник агрегирования извлекает агрегированные отчеты для расшифровки.
- Работник агрегации получает ключи дешифрования от координатора.
- Aggregation Worker расшифровывает отчеты на предмет агрегации и зашумления.
- Служба учета агрегированных отчетов проверяет, имеется ли достаточный бюджет конфиденциальности для создания сводного отчета для данных агрегированных отчетов.
- Предоставьте итоговый сводный отчет.
На диаграмме показаны высокоуровневые отношения, которые служба агрегации имеет с основными 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 .
- Чтобы запросить техническую поддержку по устранению неполадок, если вы столкнулись с ошибкой при развертывании, обслуживании или выполнении заданий с помощью Службы агрегирования, используйте эту форму технической поддержки .
- Проверьте панель общедоступного состояния на наличие известных проблем.