Определите, приводит ли клик по рекламе или ее просмотр к конверсии, например, к покупке на сайте рекламодателя.
Для кого это?
Здесь вы найдете основы атрибуционной отчетности и некоторые базовые концепции, но не так много технических подробностей.
- Если вы работаете в рекламе или рекламных технологиях , вы узнаете о том, как этот API предоставляет возможности, которые включаются сторонними файлами cookie. Ознакомьтесь с примерами использования API, которые содержат более подробную информацию о том, как генерируются отчеты .
- Если вы разработчик или инженер-программист , ознакомьтесь с полным обзором системы или поэкспериментируйте и примите участие в работе с API.
Рекламодателям и издателям, которые полагаются на платформы ad tech для измерения конверсий, не нужно использовать API напрямую. Вам может быть интересно понять, как работает Attribution Reporting, если ваша рекламная технология планирует интегрироваться с этим API.
Что такое API отчетов об атрибуции?
Сегодня измерение конверсии рекламы часто опирается на сторонние файлы cookie . Браузеры ограничивают доступ к сторонним файлам cookie, поскольку они могут использоваться для отслеживания пользователей на сайтах и нарушать конфиденциальность пользователей.
API Attribution Reporting позволяет выполнять эти измерения с сохранением конфиденциальности и без использования сторонних файлов cookie.
Этот API позволяет рекламодателям и поставщикам рекламных технологий измерять конверсии в следующих случаях:
- Клики и просмотры рекламы.
- Реклама в стороннем iframe, например, реклама на сайте издателя, использующего стороннего поставщика рекламных технологий.
- Реклама в контексте первой стороны , например, реклама в социальных сетях или на странице результатов поисковой системы, или реклама издателя, размещающего собственную рекламу.
Если вы не знакомы с некоторыми из этих терминов или понятий, обратитесь к глоссарию Privacy Sandbox .
Попробуйте API
- Тестируйте локально в своем браузере. Установите флаг , который сообщает браузеру Chrome о необходимости включить определенные экспериментальные функции.
Если вам интересно поэкспериментировать с API, перейдите на страницу Attribution Reporting: экспериментируйте и участвуйте .
Изменения API
- Следите за изменениями API .
- Узнайте, почему мы запустили API Attribution Reporting в первой половине 2023 года.
Доступность
Предложение | Статус |
---|---|
Путь конверсии: переход из приложения в Интернет Веб-пояснение и объяснение для Android Объявление о списке рассылки | Доступно в Chrome и Android для пробной версии Origin. |
Путь конверсии: кросс-девайс Объяснитель | Это предложение было заархивировано. Планов по реализации на данный момент нет. |
Предотвращение недействительных агрегированных отчетов с помощью проверки отчетов Объяснитель | Это предложение было заархивировано. Вместо этого мы реализовали trigger_context_id для этого варианта использования. |
Белый список по умолчанию для политики разрешений API Attribution Reporting останется * Объявление о списке рассылки | Доступно в Chrome в первом квартале 2023 г. |
Настраиваемая отчетность на уровне событий epsilon Проблема с GitHub | Доступно в Chrome в четвертом квартале 2023 г. |
Заполнение полезной нагрузки агрегированных отчетов Обновленный объяснитель | Доступно в Chrome в четвертом квартале 2023 г. |
Гибкий уровень событий Объяснение гибких конфигураций на уровне событий | Доступно в Chrome в четвертом квартале 2023 г. Возможность настраивать количество отчетов по атрибуции и количество/длину окон отчетности. Доступно в Chrome в первом квартале 2024 г. Возможность настройки количества бит данных триггера. |
Поддержка отчетов об атрибуции. Подробные отчеты об отладке, не зависящие от сторонних файлов cookie. Объяснитель | Доступно в Chrome в третьем квартале 2024 г. |
Поддержка API отчетов по атрибуции и службы агрегирования для Google Cloud Объяснение API отчетов по атрибуции Объяснение службы агрегации | Доступно в Chrome во втором полугодии 2023 г. |
Гибкая фильтрация вкладов Объяснитель | Доступно в Chrome в третьем квартале 2024 г. |
Фильтрация перед атрибуцией: области атрибуции Объяснитель | Доступно в Chrome в четвертом квартале 2024 г. |
Варианты использования и особенности
API Attribution Reporting предоставляет доступ к различным типам инсайтов с двумя типами отчетов, которые могут быть отправлены рекламодателю или стороннему поставщику рекламных технологий. Эти два типа отчетов могут использоваться одновременно и являются взаимодополняющими.
- Отчеты на уровне событий связывают определенный клик или просмотр рекламы (на стороне рекламы) с данными на стороне конверсии. Данные на стороне конверсии очень ограничены, и данные зашумлены (это означает, что в небольшом проценте случаев вместо реальных отчетов отправляются случайные данные). Это сохраняет конфиденциальность пользователя, предотвращая объединение идентификаторов пользователей на разных сайтах. В качестве дополнительной защиты конфиденциальности отчеты отправляются с задержкой.
- Сводные отчеты не привязаны к определенному событию на стороне рекламы. Эти отчеты предоставляют более полные и точные данные о конверсиях, чем отчеты на уровне событий. Сочетание методов конфиденциальности помогает снизить риск объединения личности на разных сайтах.
Отчеты на уровне событий
Отчеты на уровне событий связывают клик или просмотр объявления с грубыми данными о конверсиях.

news.example
(прикрепленный к идентификатору пользователя Bob_Doe на news.example
) привел к покупке на shop.example
.Отчеты на уровне событий подходят для:
- Оптимизация . Ответьте на вопросы типа «Как я могу улучшить возврат инвестиций?». В частности, эти отчеты можно использовать для оптимизации размещения рекламы, поскольку в отчетах можно сделать доступными уникальные идентификаторы на стороне рекламы. Отчеты на уровне событий могут предоставлять данные для обучения моделей машинного обучения.
- Грубая отчетность , где требуется очень мало информации о конверсии. Текущий предел составляет 3 бита данных о конверсии для кликов⏤это означает, что конверсии можно присвоить одну из восьми категорий⏤и 1 бит для просмотров. Кодирование детализированных данных о конверсии, таких как конкретная цена или время конверсии, не поддерживается в отчетах на уровне событий.
- Обнаружение мошенничества . Данные в некоторых отчетах могут быть полезны для обнаружения и анализа мошенничества с рекламой, позволяя понять закономерности, которые можно использовать для выявления спама или недействительной активности.
Сводные отчеты
Сводные отчеты (ранее известные как агрегированные отчеты) предлагают более подробные данные о конверсиях и большую гибкость для объединения данных о кликах или просмотрах и данных о конверсиях.
Узнайте больше о сводных отчетах .

news.example
привел к 518 конверсиям на shoes.example
и к общим расходам в размере 38 174 долларов США. Половина конверсий была получена от пользователей из Нью-Йорка, США.Сводные отчеты лучше всего подходят для отчетов о вариантах использования. Эти отчеты помогают ответить на такие вопросы, как: «Какова моя окупаемость инвестиций?»
Использование сводных отчетов для оптимизации, например, для оптимизации стоимости покупки, которая не поддерживается отчетами на уровне событий (поскольку данные о конверсии слишком грубые), является областью активных исследований.
Другие особенности
Другие возможности этого API включают в себя:
- Атрибуция «приложение-веб» : просмотрите или нажмите на рекламу в приложении и выполните конверсию в Интернете.
Поддержка браузера
- Firefox и Edge не обмениваются сигналами .
- Safari и Webkit отреагировали отрицательно и предложили другой API для измерения конверсий рекламы, который называется Private Click Measurement .
Хотя эти два API различаются, Chrome и WebKit открыто работают вместе, чтобы упростить работу разработчиков, например, путем согласования имен атрибутов и структуры JSON для отчетов .
Набор функций API Attribution Reporting отличается от API Private Click Measurement, предлагаемого Safari и WebKit. В частности, в API Attribution Reporting:
- Поддерживается измерение сквозного просмотра.
- Могут быть предоставлены отчеты на уровне событий.
- Сводные отчеты содержат подробную информацию как по кликам/просмотрам, так и по конверсиям.
- Третьи стороны, такие как платформы рекламных технологий, могут получать отчеты от имени издателей и рекламодателей.
Конфигурация браузера
- Пользователи могут отказаться от API с помощью пользовательских настроек по адресу
chrome://settings/adPrivacy
. - API неактивен в режиме инкогнито .
Как сайты могут контролировать доступ?
Если API доступен в определенном браузере, он доступен по умолчанию на любом сайте, как в документах и скриптах верхнего уровня, так и в фреймах того же источника.
Произвольные третьи стороны, например, кросс-родовые рекламные фреймы, которые не были добавлены на страницу с помощью скрипта, имеющего доступ верхнего уровня, не могут использовать API без ведома издателя или рекламодателя: в этих фреймах API отчетов об атрибуции необходимо явно включить с помощью политики разрешений .
<iframe src="..." allow="attribution-reporting"></iframe>
Третьи стороны с доступом верхнего уровня, которые добавляют кросс-источниковые iframe на страницу, также могут включить API отчетов об атрибуции с политикой разрешений .
Сайт может отключить API Attribution Reporting для всех сторон, включая скрипты с доступом верхнего уровня, отправив заголовок HTTP-ответа:
Permissions-Policy: attribution-reporting=()
Как работает API отчетов об атрибуции?
API отчетов об атрибуции позволяет измерять два связанных между собой события: событие на веб-сайте издателя, например просмотр пользователем рекламы или нажатие на нее, с последующей конверсией на сайте рекламодателя.
Отчеты на уровне событий

Браузер сопоставляет клики или просмотры с данными о конверсиях, определенными рекламной технологией.
Позже браузер отправляет полученные отчеты в заранее определенную конечную точку с некоторой задержкой и шумом.
Сводные отчеты

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

Небольшое количество информации объединяется между сайтами — достаточно для измерения конверсий, но недостаточно для детального отслеживания активности Боба на разных сайтах. Активность Боба на news.example
и на shoes.example
остается раздельной.
Защиты в каждом типе отчета
Отчеты на уровне событий связывают идентификатор на стороне рекламы с небольшим количеством данных на стороне конверсии. Хотя они и предоставляют межсайтовую информацию о конверсии, информация на стороне конверсии слишком грубая, чтобы объединить идентификацию пользователя на разных сайтах.
Сводные отчеты предоставляют подробную информацию, но только на агрегированном уровне; поскольку содержимое этих агрегируемых отчетов шифруется при отправке рекламному техническому специалисту, рекламный технический специалист не может получить никакой информации из отчетов без использования службы агрегации. Служба агрегации предоставляет доступ только к шумным агрегатам.
Дополнительные меры защиты конфиденциальности, такие как ограничения по частоте, применяются как к отчетам на уровне событий, так и к сводным отчетам.

Подробно: отчеты на уровне событий и конфиденциальность
Отчеты на уровне событий предоставляют информацию о конверсиях без отслеживания пользователей на разных сайтах, используя следующие механизмы конфиденциальности:
- Межсайтовый идентификатор не используется, и с устройства не отправляется никаких подробных сведений о межсайтовом просмотре.
- Отчеты на уровне событий связывают 64 бита информации на стороне рекламы (
news.example
) только с 1 или 3 битами на стороне конверсии (shop.example
). 64 бита — это достаточно информации для сопоставления с индивидуальным идентификатором пользователя, но эти 64 бита можно связать только с очень небольшим количеством межсайтовой информации: 1 бит или 3 бита, которых недостаточно для хранения идентификатора.- 64 бита на стороне рекламы не являются новой информацией. Идентификатор пользователя может быть доступен на стороне рекламы уже сегодня.
news.example
илиadtech.example
уже знают об определенной активности пользователя наnews.example
.
- 64 бита на стороне рекламы не являются новой информацией. Идентификатор пользователя может быть доступен на стороне рекламы уже сегодня.
- Для предотвращения злоупотреблений и межсайтового отслеживания применяются дополнительные меры защиты:
- Отчеты отправляются с задержкой .
- Данные о конверсиях искажаются : в определенном проценте случаев генерируются поддельные отчеты.
- Количество атрибутированных отчетов о конверсиях ограничено за один клик или просмотр.
Подробно: Сводные отчеты и конфиденциальность
Сводные отчеты связывают событие клика или просмотра с подробными данными о конверсии. Они предоставляют информацию о конверсии без отслеживания пользователей на сайтах, используя следующие механизмы конфиденциальности:
- Межсайтовый идентификатор не используется.
- Каждая атрибуция может вносить множественный вклад в итоговый сводный отчет. Любой пользователь может инициировать множественные атрибуции для определенного клика (или просмотра) и конверсии.
- Данные агрегируются до уровня многих событий (множества пользователей), и ни одно индивидуальное событие не может быть точно отмечено. При рассмотрении агрегированных данных, с ростом уровня детализации увеличивается и относительный шум в этих данных. Срезы данных, которые агрегируют много событий и пользователей, более точны для сохранения полезности.
- Необработанные отчеты, связывающие подробное событие клика или просмотра с подробными данными о конверсии, зашифрованы и не могут быть прочитаны компанией, занимающейся рекламными технологиями. Эти данные могут быть прочитаны только службой агрегации .
- Для предотвращения злоупотреблений и межсайтового отслеживания применяются дополнительные меры защиты:
- Отчеты отправляются со случайными задержками.
- Запросы к различным фрагментам данных ограничены по частоте.
Привлекайте и делитесь отзывами
- По вопросам API: создайте вопрос в репозитории API.
- Следите за обновлениями API и объявлениями в списке рассылки Attribution Reporting .
- Если у вас есть технические вопросы, отправьте сообщение об ошибке Chromium .
- По вопросам внедрения, интеграции и общим рекомендациям: создайте вопрос в репозитории поддержки разработчиков Privacy Sandbox.