Отслеживайте, когда клик по рекламе или ее просмотр приводит к конверсии, например, к покупке на сайте рекламодателя.
Для кого это?
Здесь вы найдете основы атрибуционной отчетности и некоторые базовые концепции, но не так много технических подробностей.
- Если вы работаете в сфере рекламы или рекламных технологий , вы узнаете о том, как этот API предоставляет возможности, доступные благодаря сторонним файлам cookie. Ознакомьтесь с примерами использования API, где более подробно описывается, как создаются отчёты .
- Если вы разработчик или инженер-программист , ознакомьтесь с полным обзором системы или поэкспериментируйте и примите участие в работе с API.
Рекламодателям и издателям, использующим платформы рекламных технологий для измерения конверсий, не обязательно использовать API напрямую. Возможно, вам будет интересно узнать, как работает отчётность по атрибуции, если ваша рекламная компания планирует интегрировать её с этим 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 отчётности по атрибуции отличается от API измерения частных кликов, предлагаемого Safari и WebKit. В частности, API отчётности по атрибуции:
- Поддерживается измерение сквозного просмотра.
- Могут быть предоставлены отчеты на уровне событий.
- Сводные отчеты содержат подробную информацию как по кликам/просмотрам, так и по конверсиям.
- Третьи стороны, такие как рекламные технологические платформы, могут получать отчеты от имени издателей и рекламодателей.
Конфигурация браузера
- Пользователи могут отказаться от API с помощью пользовательских настроек по адресу
chrome://settings/adPrivacy. - API неактивен в режиме инкогнито .
Как сайты могут контролировать доступ?
Если API доступен в определенном браузере, то он доступен по умолчанию на любом сайте, как в документах и скриптах верхнего уровня, так и в фреймах того же происхождения.
Произвольные третьи стороны, например, кросс-оригинальные рекламные фреймы, которые не были добавлены на страницу со скриптом, имеющим доступ верхнего уровня, не могут использовать API без ведома издателя или рекламодателя: в этих фреймах API Attribution Reporting необходимо явно включить с помощью политики разрешений .
<iframe src="..." allow="attribution-reporting"></iframe>
Третьи стороны с доступом верхнего уровня, которые добавляют кросс-источниковые iframes на страницу, также могут включить API Attribution Reporting с политикой разрешений .
Сайт может отключить API Attribution Reporting для всех сторон, включая скрипты с доступом верхнего уровня, отправив заголовок HTTP-ответа:
Permissions-Policy: attribution-reporting=()
Как работает API отчетов по атрибуции?
API Attribution Reporting позволяет измерять два связанных между собой события: событие на веб-сайте издателя, например просмотр пользователем рекламы или нажатие на нее, с последующей конверсией на сайте рекламодателя.
Отчеты на уровне событий

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

Сводные отчеты формируются следующим образом:
- Пользователь нажимает на специально настроенное объявление или просматривает его. Браузер на локальном устройстве пользователя регистрирует это событие вместе с заранее заданными данными конфигурации атрибуции.
- Позже, когда пользователь совершает конверсию, браузер сопоставляет это подробное событие клика или просмотра (известное как событие источника атрибуции ) с подробными данными о конверсии (известными как данные триггера атрибуции ). Размеры собираемой информации заранее определяются компанией, занимающейся рекламными технологиями, и браузер следует определенной логике, заданной этой компанией. Браузер выводит эти данные в виде агрегированного отчета .
- Агрегированные отчёты шифруются браузером и отправляются на сервер рекламных технологий. С сервера рекламных технологий агрегированные отчёты передаются в сервис агрегации для формирования сводного отчёта.
- Затем сводные отчёты предоставляются рекламному специалисту. Обратите внимание, что сводные отчёты не задерживаются так же сильно, как отчёты на уровне событий.
Подробнее о сводных отчетах читайте здесь.
Конфиденциальность
В отличие от сторонних файлов 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 .