Измеряйте данные, агрегированные по пользователям, с помощью API-интерфейса Attribution Reporting и API-интерфейса Private Aggregation.
Статус реализации
- Участвуйте и экспериментируйте с краткими отчетами Attribution Reporting .
Что такое сводный отчет?
Сводный отчет составляется для группы пользователей, поэтому его нельзя привязать к какому-либо отдельному человеку. Сводные отчеты предлагают подробные данные о конверсиях с гибкостью для данных о кликах и просмотрах. Сводные отчеты не полагаются на сторонние файлы cookie или механизмы, которые могут использоваться для идентификации отдельных пользователей на сайтах.
Сводные отчеты создаются в двух контекстах:
- Измерение рекламы : специалисты по рекламе могут создавать сводные отчеты с помощью Attribution Reporting , чтобы измерять, когда клик по рекламе или ее просмотр приводит к конверсии на сайте рекламодателя, например, к продаже или регистрации. Специалисты по рекламе также могут создавать сводные отчеты для аукционов API защищенной аудитории с помощью Private Aggregation .
- Общая межсайтовая отчетность : разработчики собирают межсайтовые данные в общем хранилище и могут составлять отчеты по этим данным с помощью Private Aggregation . Это имеет множество применений, например, получение информации о демографических данных пользователей и сбор уникальных охватов контента.
Сводные отчеты запрашиваются по-разному для Attribution Reporting и Private Aggregation. Прежде чем вы сможете научиться генерировать отчеты, вы должны сначала понять, что такое агрегация и как сводные отчеты могут быть использованы для удовлетворения ваших потребностей в измерениях.
Ключевые понятия
Спроектируйте свой сбор данных
Ключевым принципом сводных отчетов является раннее принятие решений о дизайне. Вы решаете, какие данные собирать в каких категориях. Выходные отчеты предоставляют информацию о ваших кампаниях или бизнесе.
Выходной отчет предлагает подробные данные о конверсиях между сайтами и гибкость для объединения данных о кликах и просмотрах с данными о конверсиях. Вы также можете рассматривать конечный вывод как входные данные для инструментов, которые вы используете для принятия решений.
Спросите себя: что я хочу узнать о взаимодействии пользователей с моим контентом?
Рекламные конверсии
Например, если вы создаете сводные отчеты для определения того, сколько конверсий привело к определенному общему значению расходов, это может помочь вашей команде решить, на что следует нацелить вашу следующую рекламную кампанию, чтобы получить более высокие общие расходы.

Межсайтовое взаимодействие
Например, если вы создаете сводные отчеты для определения того, сколько людей читают ваш контент на стороннем веб-сайте, это может помочь вашей команде решить, как сотрудничать с этой третьей стороной, чтобы повысить вовлеченность и побудить читателей посещать ваш сайт напрямую.
Какая информация сохраняется в браузере?
Агрегируемый отчет — это необработанные данные, полученные из браузера пользователя, которые включают в себя предопределенный набор сегментов (или ключей агрегации ). То, как вы определяете этот критерий, зависит от ваших проектных решений .
Сводные отчеты содержат как обобщенные данные, так и подробные данные о конверсиях.
Рекламные конверсии
Конверсии определяются рекламодателем или компанией, занимающейся рекламными технологиями, и могут различаться для разных рекламных кампаний. Одна кампания может измерять количество кликов по рекламе, за которыми последовала покупка пользователем рекламируемого товара. Другая кампания может измерять количество просмотров рекламы, приведших к посещениям сайта рекламодателя.
Например, поставщик рекламных технологий запускает рекламную кампанию на news.example, где конверсией считается нажатие пользователем объявления о покупке обуви на shoes.example.
Специалист по рекламе получает сводный отчет по этой рекламной кампании с идентификатором 1234567
, в котором указано, что 12 января 2022 г. было совершено 518 конверсий на shoes.example с общими расходами в размере 38 174 долл . США. 60% конверсий были получены от пользователей, купивших синие кроссовки с артикулом товара 9872
, а 40% — от пользователей, купивших желтые сандалии с артикулом товара 2643
Идентификатор кампании — это подробные данные на стороне рекламы, а артикулы товаров — подробные данные о конверсиях. Количество конверсий и общие расходы — это агрегированные данные.
Межсайтовое взаимодействие
Прежде чем собирать данные, необходимо определить, какую информацию вы хотите собирать, какие конверсии вы ожидаете от той или иной межсайтовой интеграции, а также определить, какой тип отчетов следует собирать.
Существует ряд возможных вариантов использования, подробно описанных в документации Private Aggregation. Давайте рассмотрим один пример:
Возможно, вам захочется измерить демографические данные пользователей, которые видели ваш контент на разных сайтах. Private Aggregation может дать ответ, например: «Примерно 317 уникальных пользователей в возрасте от 18 до 45 лет из Германии». Сначала решите, какую именно информацию вы хотите собрать (например, возраст и местоположение). Затем используйте Shared Storage для сбора этих конкретных демографических данных со стороннего сайта. Позднее вы можете отправить отчет через Private Aggregation с параметрами возрастной группы и страны, закодированными в ключе агрегации.
Как собираются данные перед агрегацией?
Сводные отчеты состоят из агрегированных данных из группы отдельных устройств. Хотя действия отдельного пользователя невозможно наблюдать и просматривать, процесс сбора данных одинаков для каждого человека.
Действия отдельного пользователя шифруются и собираются в агрегируемый отчет. Эти отчеты также включают небольшое количество незашифрованных метаданных, относящихся к пакетированию .
Для данных Attribution Reporting агрегированные отчеты собираются следующим образом:
- Пользователь посещает сайт издателя и видит рекламу или нажимает на нее, что также называется событием источника атрибуции.
- Через несколько минут или дней пользователь совершает конверсию, иначе называемую событием-триггером атрибуции. Например, конверсию можно определить как покупку продукта.
- Программное обеспечение браузера сопоставляет клик или просмотр рекламы с событием конверсии. На основе этого соответствия браузер создает агрегируемый отчет с определенной логикой, созданной поставщиком рекламных технологий.
- Браузер шифрует эти данные и после небольшой задержки отправляет их на сервер рекламных технологий для сбора. Сервер рекламных технологий должен полагаться на службу агрегации для доступа к зашумленным инсайтам.
Для частного агрегирования это выглядит следующим образом:
- Третья сторона решает, что именно она хочет измерить, и записывает данные в общее хранилище для последующего чтения.
- Пользователь запускает событие, которое соответствует тому, что хочет измерить третья сторона. Например, когда пользователь посещает сайт со встроенным контентом, третья сторона может прочитать данные в общем хранилище и использовать частную агрегацию для отправки зашифрованных агрегируемых отчетов на ваш сервер для сбора.

Пакетные агрегируемые отчеты
Прежде чем собранные агрегируемые отчеты можно будет обработать и объединить в сводный отчет, их необходимо объединить в пакет. Пакет — это стратегическая группа агрегируемых отчетов.
Агрегируемые отчеты содержат небольшое количество незашифрованных данных, включенных как shared_info
, которые можно использовать для создания пакетов. Сюда входят временная метка и источник отчета. Вы не можете создавать пакеты на основе зашифрованной информации в отчете.
В идеале пакеты будут содержать много отчетов. Вы можете выбрать пакеты почасово, ежедневно, еженедельно или с любой другой частотой по вашему выбору. Эта стратегия может меняться для определенных событий, где ожидается более высокий трафик.
Например, при пакетной обработке агрегированных отчетов для API Attribution Reporting вы можете решить обновить стратегию пакетной обработки до почасовой в день крупной распродажи, когда вы ожидаете большего объема конверсий рекламы.
Благодаря API частной агрегации вы можете рассчитывать на изменение своей стратегии в день публикации большого пресс-релиза о конкретном фрагменте контента, размещенного на сторонних веб-сайтах.
Обработка данных с помощью сервиса агрегации
Служба агрегации расшифровывает и объединяет пакетные данные из агрегируемых отчетов, добавляет шум и возвращает окончательный сводный отчет. Эта служба работает в доверенной среде выполнения (TEE), которая развернута в облачной службе, поддерживающей необходимые меры безопасности для защиты этих данных.
Сводные отчеты с Attribution Reporting
Чтобы поставщики рекламных технологий могли получить сводный отчет, необходимо выполнить следующие шаги:
- Поставщик рекламных технологий собирает агрегированные отчеты из браузеров отдельных пользователей.
- Поставщик рекламных технологий формирует пакеты агрегируемых отчетов и отправляет их в службу агрегации.
- Служба агрегации назначает исполнителя для агрегации данных.
- Агрегирующий работник расшифровывает и агрегирует данные из агрегируемых отчетов вместе с зашумленными данными.
- Служба агрегации возвращает сводный отчет поставщику рекламных технологий.

Рекламный технолог может использовать сводный отчет для информирования торгов и предоставления отчетов своим собственным клиентам. Предлагаемый формат для сводных отчетов — схема в кодировке JSON .
Сводные отчеты с частной агрегацией
- Считайте межсайтовые данные, собранные общим хранилищем, и сгенерируйте ключ агрегации для группировки данных.
- Вызовите API Private Aggregation из рабочего модуля Shared Storage с ключом агрегации и значением, которое вы хотите аккумулировать. Браузер генерирует зашифрованный агрегируемый отчет из вашего ввода и отправляет его на ваш сервер для сбора.
- Формируйте агрегированные отчеты и отправляйте их в службу агрегации для обработки.
- Служба агрегации обрабатывает пакетные отчеты, а затем добавляет шум.
- Служба агрегации возвращает запрашивающему лицу сводный отчет.
Привлекайте и делитесь отзывами
Сводные отчеты являются ключевой частью предложений по измерению Privacy Sandbox. Как и другие предложения Privacy Sandbox, это документируется и обсуждается публично на GitHub.
- Обсудите API отчетов об атрибуции .
- Обсудите API частного агрегирования .
- Поддержка разработчиков: задавайте вопросы и присоединяйтесь к обсуждениям в репозитории Privacy Sandbox Developer Support .