Служба агрегирования генерирует сводные отчеты с подробными данными о конверсиях и измерениями охвата на основе необработанных агрегированных отчетов. Как специалист по рекламе, вы можете использовать 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 年上半年 |
Ключевые термины и понятия
Если вы рассматриваете службу агрегации для своего рабочего процесса, следующие термины и понятия могут дать представление о том, что этот новый процесс агрегации может предоставить вашей команде.
Глоссарий терминов
- Агрегированные отчеты
-
Агрегированные отчеты — это зашифрованные отчеты, отправляемые с отдельных пользовательских устройств. Эти отчеты содержат данные о поведении пользователей и конверсиях на разных сайтах. Конверсии (иногда называемые событиями-триггерами атрибуции) и связанные с ними показатели определяются рекламодателем или рекламным специалистом. Каждый отчет зашифрован, чтобы предотвратить доступ различных сторон к базовым данным.
- Агрегированный отчет учета
-
Распределенный реестр, расположенный в обоих координаторах, который отслеживает выделенный бюджет конфиденциальности и обеспечивает соблюдение правила «Нет дубликатов» . Это механизм сохранения конфиденциальности, расположенный и управляемый координаторами, который гарантирует, что никакие отчеты не пройдут через Службу агрегирования сверх выделенного бюджета конфиденциальности.
Узнайте больше о том, как стратегии пакетной обработки связаны с агрегируемыми отчетами .
- Агрегированный отчет по бухгалтерскому бюджету
-
Ссылки на бюджет, обеспечивающий обработку отдельных отчетов не более одного раза.
- Служба агрегации
-
Служба, управляемая рекламными технологиями, которая обрабатывает агрегированные отчеты для создания сводного отчета.
Подробнее о предыстории Службы агрегирования читайте в нашем пояснении и в полном списке терминов .
- Аттестация
-
Механизм аутентификации идентичности программного обеспечения, обычно с помощью криптографических хешей или подписей. Для предложения услуги агрегации аттестация сопоставляет код, работающий в вашей службе агрегации, управляемой рекламными технологиями, с открытым исходным кодом.
- Вклад
- Координатор
-
Субъекты, ответственные за управление ключами и учет агрегированной отчетности. Координатор ведет список хешей утвержденных конфигураций службы агрегации и настраивает доступ к ключам расшифровки.
- Шум и масштабирование
-
Статистический шум, который добавляется к сводным отчетам во время процесса агрегирования, чтобы сохранить конфиденциальность и гарантировать, что окончательные отчеты содержат анонимную информацию об измерениях.
Узнайте больше об аддитивном механизме шума , который основан на распределении Лапласа .
- Сообщение о происхождении
-
Объект, который получает агрегированные отчеты — другими словами, вы или рекламная технология, которая называется API отчетов по атрибуции. Агрегированные отчеты отправляются с пользовательских устройств на известный URL-адрес, связанный с источником отчетов. Источник отчетности указывается во время регистрации.
- Общий идентификатор
-
Вычисляемое значение, состоящее
shared_info,reporting_origin,destination_site(только для API отчетов об атрибуции),source_registration-time(только для API отчетов об атрибуции),scheduled_report_timeи версии.Несколько отчетов с одинаковыми атрибутами в
shared_infoдолжны иметь один и тот же общий идентификатор. Общие идентификаторы играют важную роль в учете агрегированных отчетов. - Сводный отчет
-
Тип отчета API отчетов об атрибуции и API частного агрегирования. Сводный отчет включает в себя агрегированные данные о пользователях и может содержать подробные данные о конверсиях с добавлением шума. Сводные отчеты состоят из совокупных отчетов. Они обеспечивают большую гибкость и предоставляют более богатую модель данных, чем отчеты на уровне событий, особенно для некоторых вариантов использования, таких как значения конверсий.
- Доверенная среда выполнения ( TEE )
-
计算机硬件和软件的安全配置，可让外部方验证机器上运行的软件的确切版本，而无需担心信息泄露。通过 TEE，外部方可以确认软件的行为和功能与其制造商声称的完全一致，不多不少。
如需详细了解用于 Privacy Sandbox 方案的 TEE，请参阅 Protected Audience 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) | Используйте агрегированные отчеты, чтобы отслеживать распределение значений ставок на аукционах. |
Сквозной поток
На следующей диаграмме показана служба агрегации в действии. Мы сосредоточимся на сквозном потоке с момента получения отчетов из Интернета и мобильных устройств до момента создания сводного отчета в службе агрегирования.
- Получите открытый ключ для создания зашифрованных отчетов.
- Зашифрованные агрегированные отчеты отправляются на серверы рекламных технологий для сбора, преобразования и пакетной обработки.
- Сервер рекламных технологий группирует отчеты (в формате 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 .
- Чтобы запросить техническую поддержку по устранению неполадок, если вы столкнулись с ошибкой при развертывании, обслуживании или выполнении заданий с помощью Службы агрегирования, используйте эту форму технической поддержки .
- Проверьте панель общедоступного состояния на наличие известных проблем.