Оцените, когда клик или просмотр объявления приводят к конверсии, например к покупке на сайте рекламодателя.
Для кого это?
Здесь вы найдете основы отчетов по атрибуции и некоторые основные концепции, но не много технических подробностей.
- Если вы работаете в сфере рекламы или рекламных технологий , вы узнаете, как этот API предоставляет возможности, которые активируются сторонними файлами cookie. Ознакомьтесь с примерами использования API, в которых более подробно описано, как создаются отчеты .
- Если вы разработчик или инженер-программист , перейдите к полному обзору системы или поэкспериментируйте и примите участие в использовании API.
Рекламодателям и издателям, которые полагаются на платформы рекламных технологий для измерения конверсий, не нужно напрямую использовать API. Возможно, вам будет интересно понять, как работают отчеты по атрибуции, если ваша рекламная компания планирует интегрироваться с этим API.
Что такое API отчетов по атрибуции?
Сегодня измерение конверсии рекламы часто зависит от сторонних файлов cookie . Браузеры ограничивают доступ к сторонним файлам cookie, поскольку они могут использоваться для отслеживания пользователей на разных сайтах и препятствовать конфиденциальности пользователей.
API отчетов по атрибуции позволяет проводить эти измерения с соблюдением конфиденциальности, без использования сторонних файлов cookie.
Этот API позволяет рекламодателям и поставщикам рекламных технологий измерять конверсии в следующих случаях:
- Клики и просмотры объявлений.
- Объявления в стороннем iframe, например объявления на сайте издателя, который использует стороннего поставщика рекламных технологий.
- Реклама в собственном контексте, например реклама в социальной сети или на странице результатов поисковой системы, а также реклама издателя, показывающая его собственные объявления.
Если вы не знакомы с некоторыми из этих терминов или концепций, обратитесь к глоссарию Privacy Sandbox .
Попробуйте API
- Проверьте локально в своем браузере. Установите флаг , который сообщает браузеру Chrome о необходимости включения определенных экспериментальных функций.
Если вы хотите поэкспериментировать с API, перейдите в раздел «Отчеты по атрибуции: экспериментируйте и участвуйте» .
Изменения API
- Следите за изменениями API .
- Узнайте, почему мы выпустили API отчетов по атрибуции в первой половине 2023 года.
Доступность
建议 | 状态 |
---|---|
转化历程:从应用到网站 网站铺垫消息和 Android 铺垫消息 邮寄名单公告 |
在 Chrome 和 Android 中可用,以进行源试用 |
转化历程:跨设备 说明 |
该提案已归档。目前没有实施计划。 |
使用报告验证功能防止无效的可汇总报告 说明 |
预计于 2024 年上半年在 Chrome 中推出 |
Attribution Reporting API 权限政策的默认许可名单将保留 * 邮寄名单通知 |
将于 2023 年第 1 季度在 Chrome 中推出 |
可配置的事件级报告 epsilon GitHub 问题 |
将于 2023 年第 4 季度在 Chrome 中提供 |
可汇总报告载荷的内边距 更新了解释器 |
将于 2023 年第 4 季度在 Chrome 中提供 |
第 1 阶段精简版灵活事件级 灵活事件级配置说明说明 |
Chrome 将于 2023 年第 4 季度推出
可自定义归因报告的数量和报告期的数量/长度。 2024 年第 1 季度在 Chrome 中推出 可自定义触发器数据的位数。 |
支持在第三方 Cookie 弃用后进行 Attribution Reporting 调试 在 GitHub 上提供反馈 |
预计于 2024 年上半年在 Chrome 中推出 |
针对 Google Cloud Attribution Reporting API 和汇总服务的支持 Attribution Reporting API 说明 汇总服务说明 |
Chrome 将于 2023 年下半年推出 |
Варианты использования и возможности
API отчетов по атрибуции предоставляет доступ к различным типам информации с помощью двух типов отчетов, которые можно отправлять рекламодателю или стороннему поставщику рекламных технологий. Эти два типа отчетов могут использоваться одновременно и дополняют друг друга.
- Отчеты на уровне событий связывают конкретный клик или просмотр объявления (на стороне рекламы) с данными на стороне конверсии. Данные на стороне конверсии очень ограничены, и данные зашумлены (это означает, что в небольшом проценте случаев вместо реальных отчетов отправляются случайные данные). Это сохраняет конфиденциальность пользователей, предотвращая объединение идентификационных данных пользователей на разных сайтах. В целях дополнительной защиты конфиденциальности отчеты отправляются с задержкой.
- Сводные отчеты не привязаны к конкретному событию на рекламной стороне. Эти отчеты предоставляют более полные и точные данные о конверсиях, чем отчеты на уровне событий. Сочетание методов обеспечения конфиденциальности помогает снизить риск объединения идентификационных данных на разных сайтах.
Отчеты на уровне событий
Отчеты на уровне событий связывают клик или просмотр объявления с приблизительными данными о конверсиях.
Отчеты на уровне событий подходят для:
- Оптимизация . Ответьте на такие вопросы, как «Как я могу повысить рентабельность инвестиций?». В частности, эти отчеты можно использовать для оптимизации размещения рекламы, поскольку в отчетах могут быть доступны уникальные идентификаторы рекламных объявлений. Отчеты на уровне событий могут предоставлять данные обучения для моделей машинного обучения.
- Грубая отчетность , в которой требуется очень мало информации о конверсии. Текущий лимит составляет 3 бита данных о конверсиях для кликов⏤это означает, что конверсии можно присвоить одну из восьми категорий⏤и 1 бит для просмотров. Кодирование детальных данных о конверсиях, таких как конкретная цена или время конверсии, не поддерживается в отчетах на уровне событий.
- Обнаружение мошенничества . Данные некоторых отчетов могут быть полезны для обнаружения и анализа мошенничества с рекламой, поскольку позволяют понять закономерности, которые можно использовать для выявления спамовой или недействительной активности.
Сводные отчеты
Сводные отчеты (ранее известные как сводные отчеты) предлагают более подробные данные о конверсиях и большую гибкость для объединения данных о кликах или просмотрах и данных о конверсиях.
Узнайте больше о сводных отчетах .
Сводные отчеты лучше всего подходят для отчетов о сценариях использования. Эти отчеты помогают ответить на такие вопросы, как: «Какова моя рентабельность инвестиций?»
Использование сводных отчетов для оптимизации — например, для оптимизации стоимости покупки, которая не поддерживается отчетами на уровне событий (поскольку данные о конверсиях слишком грубы) — является областью активных исследований.
Другие особенности
Другие функции этого API включают в себя:
- Атрибуция между приложением и сайтом : посмотрите или щелкните рекламу в приложении и совершите конверсию в Интернете.
Поддержка браузера
- Firefox и Edge не используют общие сигналы .
- Safari и Webkit отреагировали отрицательно и предложили другой API для измерения конверсий рекламы, который называется Private Click Measurement .
Хотя эти два API различны, Chrome и WebKit открыто работают вместе, чтобы упростить работу разработчиков, например, путем согласования имен атрибутов и структуры JSON для отчетов .
Набор функций API отчетов по атрибуции отличается от API измерения частных кликов, предлагаемого Safari и WebKit. В частности, с API отчетов по атрибуции:
- Поддерживается отслеживание показов.
- Могут быть предоставлены отчеты на уровне событий.
- Сводные отчеты содержат обширную информацию как о кликах/просмотрах, так и о конверсиях.
- Третьи стороны, такие как платформы рекламных технологий, могут получать отчеты от имени издателей и рекламодателей.
Конфигурация браузера
- Пользователи могут отказаться от API с помощью пользовательских настроек по адресу
chrome://settings/adPrivacy
. - API не активен в режиме инкогнито .
- API неактивен, если сторонние файлы cookie отключены.
Как сайты могут контролировать доступ?
Если 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 в списке рассылки отчетов об атрибуции .
- Если у вас есть технические вопросы, сообщите об ошибке Chromium .
- По вопросам реализации, интеграции и общим рекомендациям: создайте проблему в репозитории поддержки разработчиков Privacy Sandbox.