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