Оцените, когда клик или просмотр объявления приводят к конверсии, например к покупке на сайте рекламодателя.
Для кого это?
Здесь вы найдете основы отчетов по атрибуции и некоторые основные концепции, но не много технических подробностей.
- Если вы работаете в сфере рекламы или рекламных технологий , вы узнаете, как этот 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 для пробной версии 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 отчетов по атрибуции предоставляет доступ к различным типам информации с помощью двух типов отчетов, которые можно отправлять рекламодателю или стороннему поставщику рекламных технологий. Эти два типа отчетов могут использоваться одновременно и дополняют друг друга.
- Отчеты на уровне событий связывают конкретный клик или просмотр объявления (на стороне рекламы) с данными на стороне конверсии. Данные на стороне конверсии очень ограничены, и данные зашумлены (это означает, что в небольшом проценте случаев вместо реальных отчетов отправляются случайные данные). Это сохраняет конфиденциальность пользователей, предотвращая объединение идентификационных данных пользователей на разных сайтах. В целях дополнительной защиты конфиденциальности отчеты отправляются с задержкой.
- Сводные отчеты не привязаны к конкретному событию на рекламной стороне. Эти отчеты предоставляют более полные и точные данные о конверсиях, чем отчеты на уровне событий. Сочетание методов конфиденциальности помогает снизить риск объединения идентификационных данных на разных сайтах.
Отчеты на уровне событий
Отчеты на уровне событий связывают клик или просмотр объявления с приблизительными данными о конверсиях.
![Отчет на уровне событий](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=002&hl=ru)
news.example
(привязанный к идентификатору пользователя Bob_Doe на news.example
) привел к покупке на shop.example
.Отчеты на уровне событий подходят для:
- Оптимизация . Ответьте на такие вопросы, как «Как я могу повысить рентабельность инвестиций?». В частности, эти отчеты можно использовать для оптимизации размещения рекламы, поскольку в отчетах могут быть доступны уникальные идентификаторы рекламных объявлений. Отчеты на уровне событий могут предоставлять данные обучения для моделей машинного обучения.
- Грубая отчетность , в которой требуется очень мало информации о конверсии. Текущий лимит составляет 3 бита данных о конверсиях для кликов⏤это означает, что конверсии можно назначить одну из восьми категорий⏤и 1 бит для просмотров. Кодирование детальных данных о конверсиях, таких как конкретная цена или время конверсии, не поддерживается в отчетах на уровне событий.
- Обнаружение мошенничества . Данные некоторых отчетов могут быть полезны для обнаружения и анализа мошенничества с рекламой, поскольку позволяют понять закономерности, которые можно использовать для выявления спамовой или недействительной активности.
Сводные отчеты
Сводные отчеты (ранее известные как сводные отчеты) предлагают более подробные данные о конверсиях и большую гибкость для объединения данных о кликах или просмотрах и данных о конверсиях.
Узнайте больше о сводных отчетах .
![Пример информации из сводных отчетов.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=002&hl=ru)
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 доступен в данном браузере, он доступен по умолчанию на любом сайте, как в документах и скриптах верхнего уровня, так и в iframe того же происхождения.
Произвольные третьи стороны (например, iframe с перекрестным происхождением, которые не были добавлены на страницу с помощью скрипта, имеющего доступ верхнего уровня), не могут использовать API без ведома издателя или рекламодателя: в этих iframe API отчетов об атрибуции необходимо явно включить с помощью политики разрешений .
<iframe src="..." allow="attribution-reporting"></iframe>
Третьи лица с доступом верхнего уровня, которые добавляют на страницу iframe из разных источников, также могут включить API отчетов об атрибуции с политикой разрешений .
Сайт может отключить API отчетов об атрибуции для всех сторон, включая скрипты с доступом верхнего уровня, отправив заголовок ответа HTTP:
Permissions-Policy: attribution-reporting=()
Как работает API отчетов по атрибуции?
API отчетов по атрибуции позволяет измерять два связанных друг с другом события: событие на веб-сайте издателя, например просмотр пользователем объявления или нажатие на него, с последующей конверсией на сайте рекламодателя.
Отчеты на уровне событий
![отчет на уровне событий](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=002&hl=ru)
Браузер сопоставляет клики или просмотры с данными о конверсиях, определенными рекламной технологией.
Позже браузер отправляет полученные отчеты в заранее определенную конечную точку с некоторой задержкой и шумом.
Сводные отчеты
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=002&hl=ru)
Сводные отчеты формируются следующим образом:
- Пользователь нажимает или просматривает специально настроенное объявление. Браузер на локальном устройстве пользователя записывает это событие вместе с заранее указанными данными конфигурации атрибуции.
- Позже, когда пользователь совершает конверсию, браузер сопоставляет это подробное событие клика или просмотра (известное как событие источника атрибуции ) с подробными данными о конверсии (известными как данные триггера атрибуции ). Размеры собираемых деталей заранее определяются компанией, занимающейся рекламными технологиями, и браузер следует определенной логике, определенной рекламной технологией. Браузер выводит эти данные в сводный отчет .
- Агрегированные отчеты шифруются браузером и отправляются на сервер рекламных технологий. С сервера рекламных технологий агрегированные отчеты отправляются в службу агрегации для создания сводного отчета.
- Сводные отчеты затем предоставляются специалисту по рекламе. Обратите внимание, что сводные отчеты не задерживаются в такой степени, как отчеты на уровне событий.
Подробнее о сводных отчетах читайте .
Конфиденциальность
В отличие от сторонних файлов cookie, API отчетов об атрибуции позволяет рекламным компаниям получать информацию о конверсиях, не отслеживая действия отдельных пользователей на сайтах .
Давайте возьмем человека по имени Боб. Боб видит рекламу, читая новости на news.example
. Неделю спустя Боб покупает обувь на сайте shoes.example
.
Сегодня эта конверсия будет отслеживаться с помощью стороннего файла cookie, используемого в качестве межсайтового идентификатора . С помощью сторонних файлов cookie компания, занимающаяся рекламными технологиями, может получить доступ ко многим подробностям о деятельности Боба на сайтах news.example
и shoes.example
. Рекламные технологии могут объединить эти фрагменты информации вместе, чтобы создать подробный профиль Боба, включая его местоположение, привычки просмотра и предпочтительное чтение на news.example
. Этот профиль также может включать информацию о покупках, активности и кредитной карте на сайте shoes.example
. Это межсайтовое объединение полезно для измерения рекламных конверсий. Но это мешает конфиденциальности пользователей: активность Боба отслеживается на всех сайтах с высокой степенью детализации.
![Параллельное представление сегодняшней сети (объединенная идентификация) и завтрашней сети (разделенная идентификация)](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=002&hl=ru)
Между сайтами объединяется небольшой объем информации: его достаточно для измерения конверсий, но недостаточно для детального отслеживания активности Боба на разных сайтах. Действия Боба на news.example
и shoes.example
остаются отдельными.
Средства защиты в каждом типе отчетов
Отчеты на уровне событий связывают идентификатор рекламы с небольшим объемом данных о конверсиях. Хотя они и предоставляют межсайтовую информацию о конверсии, информация на стороне конверсии слишком груба, чтобы можно было объединить личность пользователя на разных сайтах.
Сводные отчеты предоставляют подробную информацию, но только на агрегированном уровне; поскольку содержимое этих агрегированных отчетов зашифровано при отправке рекламному специалисту, рекламный специалист не может получить какую-либо информацию из отчетов без использования службы агрегирования. Служба агрегирования предоставляет доступ только к зашумленным агрегатам.
Дополнительные меры защиты конфиденциальности, такие как ограничения скорости, применяются как к отчетам на уровне событий, так и к сводным отчетам.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=002&hl=ru)
Подробно: отчеты на уровне событий и конфиденциальность
Отчеты на уровне событий предоставляют информацию о конверсиях без отслеживания пользователей на разных сайтах, используя следующие механизмы конфиденциальности:
- Межсайтовый идентификатор не используется, и никакие подробные сведения о межсайтовом просмотре не покидают устройство.
- Отчеты на уровне событий связывают 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.