Начало работы с отчетами по атрибуции

Вот с чего начать, включая настройку и краткий обзор.

Выберите тип отчета

Используя API отчетов по атрибуции, вы можете создавать два типа отчетов: отчеты на уровне событий и сводные отчеты. Отчеты на уровне событий требуют меньше настроек, чем агрегированные или сводные отчеты, поэтому они могут быть хорошей отправной точкой. Сводные отчеты требуют интеграции со Службой агрегирования ; отчеты на уровне событий — нет.

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

Отчеты на уровне событий

Отчеты на уровне событий связывают конкретный клик или просмотр объявления (на стороне рекламы) с данными на стороне конверсии. Чтобы сохранить конфиденциальность пользователей за счет ограничения объединения идентификационных данных пользователей на разных сайтах, данные на стороне конверсии очень ограничены, и данные зашумлены.

Сводные отчеты

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

Выполнение

Вы можете начать, опробовав следующие шаги.

Обратите внимание, что для данного источника событий можно создать как отчет на уровне события, так и сводный отчет. Демо проведет вас через весь процесс.

Создание отчетов на уровне событий

Вот минимальные шаги, которые необходимо выполнить для создания отчетов на уровне событий:

  1. Зарегистрируйте источник . Инструкции см. в разделе Регистрация источников атрибуции . Обратите внимание, что действия для кликов и просмотров различаются.

  2. Зарегистрируйте триггер . Инструкции см. в разделе Регистрация триггеров атрибуции .

  3. Настройте конечную точку со следующим URL-адресом:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution .
    Обратитесь к примеру кода в adtech.js , чтобы увидеть метод POST , и к Википедии для получения дополнительной информации о .well-known .

Более подробную информацию можно найти в пояснении к отчету на уровне событий .

Формирование сводного отчета

Чтобы создать сводные отчеты, выполните следующие шаги высокого уровня:

  1. Зарегистрируйте источник . Инструкции см. в разделе Регистрация источников атрибуции . Обратите внимание, что действия для кликов и просмотров различаются. Дополнительную информацию можно найти в разделе Регистрация источника атрибуции .

  2. Зарегистрируйте триггер . Инструкции см. в разделе Регистрация триггеров атрибуции .

  3. Настройте конечную точку для агрегированных отчетов со следующим URL-адресом:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution .
    Обратитесь к примеру кода в adtech.js , чтобы увидеть метод POST , и к Википедии для получения дополнительной информации о .well-known .

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

Более подробную информацию можно найти в пояснении к агрегированному отчету .

Узнайте, как настроить отчеты об отладке, в серии статей об отладке отчетов об атрибуции .

Сводные отчеты о дополнительных понятиях

Помимо понимания описанных здесь этапов реализации, следующие концепции помогут вам спланировать стратегию сводной отчетности:

Дополнительные шаги

  1. Настройте фильтры (необязательно) :
    1. Следуйте инструкциям в разделе «Определение специальных правил с помощью фильтров» .
    2. Подробные сведения о фильтрах для агрегированных отчетов см. в разделе «Триггеры» пояснения .

Не забывайте об обнаружении функций

Прежде чем использовать API, определите, не заблокирован ли он на странице, с помощью политики разрешений. Для этого запустите следующий код:

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

Если эта проверка обнаружения функции возвращает значение true, API разрешен в контексте (странице), где выполняется проверка.

Обратите внимание: сама по себе эта проверка не является гарантией того, что API можно использовать на этой странице; пользователь мог отключить API в настройках своего браузера или у него могут быть другие настройки, препятствующие использованию API. Чтобы защитить конфиденциальность пользователей, нет возможности проверить это программно.

Следующие шаги

Если вы готовы начать реализацию, ознакомьтесь со следующей документацией:

Настраивать

Фон

Демо и инструменты

Планирование

Если вы все еще находитесь на стадии планирования, взгляните на эти документы: