В этом руководстве представлен обзор и инструкции по настройке отчетов по атрибуции как на уровне отдельных событий, так и сводных отчетов с использованием API для создания отчетов по атрибуции.
Для начала вы научитесь:
Различия между типами отчетов API для анализа атрибуции
Полная реализация API и этапы генерации отчетов.
Найдите справочную информацию и информацию по устранению неполадок.
Выберите тип отчета
Для эффективного измерения эффективности рекламных кампаний с различной степенью детализации и конфиденциальности API отчетов по атрибуции предоставляет два различных типа отчетов:
Отчеты на уровне событий: предоставляют подробные данные, связывающие конкретный клик или просмотр объявления ( источник ) с соответствующими данными о конверсии ( триггер ). Отчеты на уровне событий ограничивают объем данных о конверсиях и добавляют лишнюю информацию в отчеты. Они идеально подходят для случаев, когда ключевое значение имеет атрибуция отдельных событий, например, для измерения охвата кампании.
Сводные отчеты: предоставляют агрегированные данные о пользователях и могут включать более подробную информацию о конверсиях с учетом шума. Используя как API для создания отчетов по атрибуции, так и API для частной агрегации, они формируются на основе агрегированных отчетов и предлагают более богатую модель данных, чем отчеты на уровне событий. Сводные отчеты особенно полезны в сценариях, требующих агрегированных данных, таких как расчет значений конверсий или анализ эффективности кампаний по сегментам пользователей.
Обзор реализации
В следующих разделах описаны основные этапы создания каждого типа отчета. Вы также можете ознакомиться с демонстрацией API для создания отчетов по атрибуции, чтобы получить пошаговое описание всего процесса.
Предварительное условие: Ваши сайты должны иметь SSL/TLS-сертификаты (HTTPS), прежде чем вы сможете регистрировать источники, триггеры и получать отчеты.
Создание отчетов на уровне событий
Следующие шаги описывают, как создавать отчеты на уровне событий:
Регистрация источника: связывает клик или просмотр объявления с информацией об атрибуции. Подробные инструкции см. в разделах «Регистрация источников атрибуции» и «Регистрация источников атрибуции» . Обратите внимание, что процесс регистрации немного отличается для кликов и просмотров.
Регистрация триггера: записывает событие конверсии и связывает его с ранее зарегистрированным источником. Инструкции см. в разделе «Регистрация триггеров атрибуции» .
Настройка конечной точки для отчетов: Создайте на своем сервере конечную точку для получения отчетов на уровне событий. URL-адрес конечной точки должен соответствовать следующему формату:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution. Пример кода для методаPOSTсм. в файлеadtech.js. Дополнительную информацию о.well-knownсм. в Википедии .
Для более подробного ознакомления с отчетами на уровне событий см. раздел « Пояснение к отчетам на уровне событий» .
Создание сводного отчета
Регистрация источника: аналогично регистрации источников на уровне событий. Подробнее см. разделы «Регистрация источников атрибуции» и «Регистрация источников атрибуции» .
Регистрация триггера: аналогично для отчетов на уровне событий. См. раздел «Регистрация триггеров атрибуции» .
Настройка конечной точки для формирования отчетов: Создайте конечную точку для получения сводных отчетов. URL-адрес должен быть следующим:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution. Пример методаPOSTсм. вadtech.js, а информацию о.well-knownв Википедии .Пакетная обработка и отправка отчетов: Сформируйте пакетные сводные отчеты и отправьте их в службу агрегирования для обработки. Затем служба агрегирования сгенерирует сводные отчеты. Дополнительную информацию см. в разделе «Стратегии пакетной обработки» .
Для более подробного ознакомления с сводными отчетами обратитесь к пояснению к агрегируемым отчетам .
Помимо этапов внедрения, следующие темы помогут вам спланировать стратегию составления сводных отчетов:
Настройте фильтры (необязательно)
Для более детального контроля над получаемыми данными об атрибуции вы можете настроить фильтры.
Фильтрация обеспечивает более точный анализ данных, позволяя выделить определенные подмножества данных для анализа и уменьшить количество шума. Она также помогает отслеживать эффективность конкретных рекламных кампаний и событий конверсии для более точных измерений.
Для настройки фильтрации см. раздел «Определение пользовательских правил с помощью фильтров» , а подробную информацию о регистрации триггера «Атрибуция» для отчетов, подлежащих агрегированию, см. в разделе «Триггеры».
Убедитесь, что API включен.
Перед использованием API проверьте, включен ли он, используя следующий код:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
Эта проверка показывает, разрешен ли API в текущем контексте. Однако настройки браузера пользователя или другие факторы могут по-прежнему препятствовать использованию API. Из соображений конфиденциальности нет программного способа однозначно подтвердить пригодность API к использованию.
Следующие шаги
В следующих разделах представлена дополнительная информация о начале работы с отчетами по атрибуции.