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

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

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

Используя 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. Чтобы защитить конфиденциальность пользователей, нет возможности проверить это программно.

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

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

Настраивать

Фон

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

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

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