Служба агрегирования генерирует сводные отчеты с подробными данными о конверсиях и измерениями охвата на основе необработанных агрегированных отчетов. Как специалист по рекламе, вы можете использовать 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 отчетов об атрибуции Объяснитель | Доступный |
Межоблачные службы криптографических ключей Объяснитель | Ожидается в первом полугодии 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) | Используйте агрегированные отчеты, чтобы отслеживать распределение значений ставок на аукционах. |
Сквозной поток
На следующей диаграмме показана служба агрегации в действии. Мы сосредоточимся на сквозном потоке с момента получения отчетов из Интернета и мобильных устройств до момента создания сводного отчета в службе агрегирования.
![Процесс сквозной агрегации](https://developers.google.cn/static/privacy-sandbox/private-advertising/aggregation-service/e2e-ags-flow.png?authuser=00&hl=ru)
- Получите открытый ключ для создания зашифрованных отчетов.
- Зашифрованные агрегированные отчеты отправляются на серверы рекламных технологий для сбора, преобразования и пакетной обработки.
- Сервер рекламных технологий группирует отчеты (в формате avro) и отправляет их в службу агрегации. (Вы должны выполнить это.)
- Работник агрегирования извлекает агрегированные отчеты для расшифровки.
- Работник агрегации получает ключи дешифрования от координатора.
- Aggregation Worker расшифровывает отчеты на предмет агрегации и зашумления.
- Служба учета агрегированных отчетов проверяет, имеется ли достаточный бюджет конфиденциальности для создания сводного отчета для данных агрегированных отчетов.
- Предоставьте итоговый сводный отчет.
На диаграмме показаны высокоуровневые отношения, которые служба агрегации имеет с основными API измерения клиентов: API отчетов по атрибуции , API частной агрегации и координаторы.
Процесс начинается с API-интерфейсов измерений, таких как API отчетов об атрибуции или API частного агрегирования , которые создают отчеты из нескольких экземпляров браузера. Chrome получает открытый ключ от службы хостинга ключей в координаторе для шифрования отчетов перед отправкой их в источник отчетов вашей рекламной технологии. Открытые ключи меняются каждые семь дней.
Источник отчетов о рекламных технологиях должен быть настроен на сбор и преобразование входящих отчетов в формат avro и их отправку в службу агрегирования, как описано в стратегиях пакетной обработки .
Когда у вас есть готовый пакет, вы отправляете пакетный запрос в службу агрегации. Служба агрегирования получает ключи дешифрования от службы хостинга ключей, расшифровывает отчеты, а затем объединяет и обрабатывает их для создания сводного отчета. Имейте в виду, что это зависит от наличия достаточного бюджета на конфиденциальность для их создания.
Вы размещаете конечную точку источника отчетов о рекламных технологиях, где собираются отчеты, а служба агрегации развертывается в вашем облаке рекламных технологий.
Пакетная обработка агрегированных отчетов
Поток отчетов не был бы полным без помощи назначенного сервера источника отчетов. Это происхождение, которое вы указали бы в процессе регистрации. Источник отчетов отвечает за сбор, преобразование и группировку получаемых агрегированных отчетов, а также подготовку их к отправке в вашу службу агрегации в Google Cloud или веб-службах Amazon. Узнайте больше о том, как подготовить агрегированные отчеты .
Теперь, когда у вас есть общая концепция, мы можем более внимательно рассмотреть компоненты, которые развернуты в вашей службе агрегации.
Облачные компоненты
Служба агрегации состоит из нескольких компонентов облачной службы. Вы используете предоставленные сценарии Terraform для подготовки и настройки всех необходимых компонентов облачных служб.
![Облачные компоненты службы агрегации](https://developers.google.cn/static/privacy-sandbox/private-advertising/aggregation-service/ags-cloud-components.png?authuser=00&hl=ru)
Фронтенд-сервис
Управляемая облачная служба: облачная функция (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 .
- Чтобы запросить техническую поддержку по устранению неполадок, если вы столкнулись с ошибкой при развертывании, обслуживании или выполнении заданий с помощью Службы агрегирования, используйте эту форму технической поддержки .
- Проверьте панель общедоступного состояния на наличие известных проблем.