Служба агрегирования генерирует сводные отчеты с подробными данными о конверсиях и измерениями охвата на основе необработанных агрегированных отчетов. Как специалист по рекламе, вы можете использовать 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 отчетов об атрибуции Объяснитель | Доступный |
Ключевые термины и понятия
Если вы рассматриваете службу агрегации для своего рабочего процесса, следующие термины и понятия могут дать представление о том, что этот новый процесс агрегации может предоставить вашей команде.
Глоссарий терминов
- Агрегированные отчеты
-
Агрегированные отчеты — это зашифрованные отчеты, отправляемые с отдельных пользовательских устройств. Эти отчеты содержат данные о поведении пользователей и конверсиях на разных сайтах. Конверсии (иногда называемые событиями-триггерами атрибуции) и связанные с ними показатели определяются рекламодателем или рекламным специалистом. Каждый отчет зашифрован, чтобы предотвратить доступ различных сторон к базовым данным.
- Агрегированный отчет учета
-
Распределенный реестр, расположенный в обоих координаторах, который отслеживает выделенный бюджет конфиденциальности и обеспечивает соблюдение правила «Нет дубликатов» . Это механизм сохранения конфиденциальности, расположенный и управляемый координаторами, который гарантирует, что никакие отчеты не пройдут через Службу агрегирования сверх выделенного бюджета конфиденциальности.
Узнайте больше о том, как стратегии пакетной обработки связаны с агрегируемыми отчетами .
- Агрегированный отчет по бухгалтерскому бюджету
-
Ссылки на бюджет, обеспечивающий обработку отдельных отчетов не более одного раза.
- Служба агрегации
-
Служба, управляемая рекламными технологиями, которая обрабатывает агрегированные отчеты для создания сводного отчета.
Подробнее о предыстории Службы агрегирования читайте в нашем пояснении и в полном списке терминов .
- Аттестация
-
Механизм аутентификации идентичности программного обеспечения, обычно с помощью криптографических хешей или подписей. Для предложения услуги агрегации аттестация сопоставляет код, работающий в вашей службе агрегации, управляемой рекламными технологиями, с открытым исходным кодом.
- Вклад
- Координатор
-
Субъекты, ответственные за управление ключами и учет агрегированной отчетности. Координатор ведет список хешей утвержденных конфигураций службы агрегации и настраивает доступ к ключам расшифровки.
- Шум и масштабирование
-
Статистический шум, который добавляется к сводным отчетам во время процесса агрегирования, чтобы сохранить конфиденциальность и гарантировать, что окончательные отчеты содержат анонимную информацию об измерениях.
Узнайте больше об аддитивном механизме шума , который основан на распределении Лапласа .
- Сообщение о происхождении
-
Объект, который получает агрегированные отчеты — другими словами, вы или рекламная технология, которая называется API отчетов по атрибуции. Агрегированные отчеты отправляются с пользовательских устройств на известный URL-адрес, связанный с источником отчетов. Источник отчетности указывается во время регистрации.
- Общий идентификатор
-
Вычисляемое значение, состоящее
shared_info,reporting_origin,destination_site(только для API отчетов об атрибуции),source_registration-time(только для API отчетов об атрибуции),scheduled_report_timeи версии.Несколько отчетов с одинаковыми атрибутами в
shared_infoдолжны иметь один и тот же общий идентификатор. Общие идентификаторы играют важную роль в учете агрегированных отчетов. - Сводный отчет
-
Тип отчета API отчетов об атрибуции и 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) | Используйте агрегированные отчеты, чтобы отслеживать распределение значений ставок на аукционах. |
Сквозной поток
На следующей диаграмме показана служба агрегации в действии. Мы сосредоточимся на сквозном потоке с момента получения отчетов из Интернета и мобильных устройств до момента создания сводного отчета в службе агрегирования.
- Получите открытый ключ для создания зашифрованных отчетов.
- Зашифрованные агрегированные отчеты отправляются на серверы рекламных технологий для сбора, преобразования и пакетной обработки.
- Сервер рекламных технологий группирует отчеты (в формате 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 .
- Чтобы запросить техническую поддержку по устранению неполадок, если вы столкнулись с ошибкой при развертывании, обслуживании или выполнении заданий с помощью Службы агрегирования, используйте эту форму технической поддержки .
- Проверьте панель общедоступного состояния на наличие известных проблем.