Измеряйте, когда клик или просмотр объявления приводит к конверсии, например, к покупке на сайте рекламодателя.
Для кого это предназначено?
Здесь вы найдете основы составления отчетов по атрибуции и некоторые базовые концепции, но не так много технических подробностей.
- Если вы работаете в сфере рекламы или рекламных технологий , вы узнаете о том, как этот API предоставляет возможности, которые активируются сторонними файлами cookie. Ознакомьтесь с примерами использования API, в которых более подробно описано, как создаются отчеты .
- Если вы разработчик или инженер-программист , перейдите к полному обзору системы или поэкспериментируйте и поучаствуйте в работе с API.
Рекламодателям и издателям, использующим платформы рекламных технологий для измерения конверсий, не обязательно использовать API напрямую. Если вы планируете интегрировать свою рекламную технологию с этим API, вам может быть интересно узнать, как работает отчетность по атрибуции.
Что такое API для создания отчетов об атрибуции?
Сегодня измерение конверсии рекламы часто основывается на использовании сторонних файлов cookie . Браузеры ограничивают доступ к сторонним файлам cookie, поскольку они могут использоваться для отслеживания пользователей на разных сайтах и нарушать конфиденциальность пользователей.
API для формирования отчетов об атрибуции позволяет проводить эти измерения с сохранением конфиденциальности, без использования сторонних файлов cookie.
Этот API позволяет рекламодателям и поставщикам рекламных технологий измерять конверсии в следующих случаях:
- Клики и просмотры рекламы.
- Реклама во сторонних iframe, например, реклама на сайте издателя, использующего стороннего поставщика рекламных технологий.
- Реклама в контексте собственных данных , например, реклама в социальных сетях или на странице результатов поиска, или реклама, размещаемая издателем самостоятельно.
Если вам незнакомы некоторые из этих терминов или понятий, обратитесь к глоссарию терминов в разделе «Песочница конфиденциальности» .
Попробуйте API
- Протестируйте локально в своем браузере. Установите флаг , который укажет браузеру Chrome включить определенные экспериментальные функции.
Если вас интересует экспериментирование с API, перейдите на страницу «Отчетность по атрибуции: экспериментируйте и участвуйте» .
изменения API
- Следите за изменениями в API .
- Узнайте, почему мы запустили API для формирования отчетов по атрибуции в первой половине 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 для формирования отчетов по атрибуции предоставляет доступ к различным типам аналитических данных с помощью двух типов отчетов, которые можно отправлять рекламодателю или стороннему поставщику рекламных технологий. Эти два типа отчетов можно использовать одновременно, и они дополняют друг друга.
- Отчеты на уровне событий связывают конкретный клик или просмотр объявления (на стороне объявления) с данными на стороне конверсии. Данные на стороне конверсии очень ограничены и содержат шум (это означает, что в небольшом проценте случаев вместо реальных отчетов отправляются случайные данные). Это обеспечивает конфиденциальность пользователей, предотвращая сопоставление их личных данных на разных сайтах. В качестве дополнительной защиты конфиденциальности отчеты отправляются с задержкой.
- Сводные отчеты не привязаны к конкретному событию на стороне рекламы. Эти отчеты предоставляют более полные и точные данные о конверсиях, чем отчеты на уровне событий. Сочетание методов обеспечения конфиденциальности помогает снизить риск объединения идентификационных данных на разных сайтах.
Отчеты на уровне событий
В отчетах на уровне событий клик или просмотр объявления связываются с приблизительными данными о конверсиях.

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

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

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

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