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

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

Для начала вы научитесь:

  • Различие между типами отчетов API отчетов об атрибуции

  • Полная реализация API и этапы создания отчетов

  • Найдите справочную информацию и информацию по устранению неполадок.

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

Для эффективного измерения эффективности рекламной кампании с различным уровнем детализации и конфиденциальности API отчетов по атрибуции предоставляет два различных типа отчетов:

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

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

Обзор реализации

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

Предварительное условие: ваши сайты должны иметь сертификаты SSL/TLS (HTTPS), прежде чем вы сможете регистрировать источники, триггеры и получать отчеты.

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

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

  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. Пакетная обработка и отправка отчетов: пакетируйте сводные отчеты и отправляйте их в службу агрегирования для обработки. Служба агрегирования затем сгенерирует сводные отчеты. Дополнительные сведения см. в разделе Стратегии пакетной обработки .

Более подробное описание сводных отчетов можно найти в описании сводных отчетов .

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

Настройте фильтры (необязательно)

Чтобы получить более детальный контроль над получаемыми вами данными атрибуции, вы можете настроить фильтры.

Фильтрация обеспечивает более точный анализ данных, который изолирует определенные подмножества данных для анализа, уменьшая шум. Это также помогает отслеживать эффективность конкретных рекламных кампаний и событий-конверсий для более точного измерения.

Чтобы настроить фильтрацию, см. раздел «Определение пользовательских правил с помощью фильтров и триггеры» в разделе «Регистрация триггера атрибуции», где приведены сведения, относящиеся к агрегированным отчетам.

Убедитесь, что API включен

Прежде чем использовать API, проверьте, включен ли он, с помощью следующего кода:

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

Эта проверка показывает, разрешен ли API в текущем контексте. Однако настройки браузера пользователя или другие факторы могут по-прежнему препятствовать использованию API. Из соображений конфиденциальности не существует программного способа окончательно подтвердить удобство использования API.

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

В следующих разделах представлена ​​дополнительная информация о том, как начать работу с отчетами по атрибуции.

Выполнение

Предыстория и концепции

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

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