Часть 1 из 3 посвящена отладке отчетов об атрибуции. Узнайте, почему отладка важна и когда использовать отчеты об отладке при тестировании.
Зачем нужны отладочные отчеты
Если вы тестируете API для формирования отчетов об атрибуции, вам следует убедиться в корректной работе интеграции, выявить расхождения в результатах измерений между вашей реализацией на основе файлов cookie и реализацией для формирования отчетов об атрибуции, а также устранить любые проблемы с интеграцией.
Для выполнения этих задач необходимы отладочные отчеты. Поэтому мы настоятельно рекомендуем вам их настроить.
Глоссарий
Ключевые аспекты отладочных отчетов
Два типа отладочных отчетов
Доступны два типа отладочных отчетов. Используйте оба, поскольку они предназначены для разных сценариев использования.
Отчеты об успешной отладке
Отчеты об успешной отладке отслеживают успешное создание отчета об атрибуции . Они напрямую связаны с отчетом об атрибуции.
Отчеты об успешной отладке доступны с версии Chrome 101 (апрель 2022 года).
Подробные отладочные отчеты
Подробные отладочные отчеты предоставляют более полную информацию об исходных и триггерных событиях, позволяя либо убедиться в успешной регистрации источников, либо отслеживать отсутствующие отчеты и определять причины их отсутствия (сбой в исходных или триггерных событиях, сбой при отправке или генерации отчета). Подробные отладочные отчеты показывают:
- Случаи, когда браузер успешно зарегистрировал источник.
- Случаи, когда браузеру не удалось успешно зарегистрировать источник или событие-триггер, — это означает, что он не сгенерирует отчет об атрибуции.
- Случаи, когда отчет об атрибуции не может быть сгенерирован или отправлен по какой-либо причине.
Подробные отладочные отчеты содержат поле type , описывающее либо успешную регистрацию источника, либо причину, по которой отчет об источнике, триггере или атрибуции не был сгенерирован.
Подробные отладочные отчеты доступны с версии Chrome 109 (январь 2023 г.), за исключением подробных отладочных отчетов об успешной регистрации источника , которые были добавлены позже, в Chrome 112.
Примеры отчетов см. во второй части: Настройка отладочных отчетов .
Отчеты об отладке основаны на файлах cookie.
Для использования отладочных отчетов источнику отчета необходимо установить cookie-файл .
Если источником, настроенным для получения отчетов, является третья сторона, то этот cookie будет сторонним. Это означает, что отладочные отчеты генерируются только в том случае, если в браузере пользователя разрешены сторонние cookie .
Отладочные отчеты отправляются немедленно.
Отладочные отчеты отправляются браузером немедленно источнику сообщения . Это отличается от отчетов об атрибуции, которые отправляются с задержкой .
Отчёты об успешной отладке генерируются и отправляются сразу после создания соответствующего отчёта об атрибуции: то есть, при регистрации триггера.
Подробные отладочные отчеты отправляются немедленно после регистрации источника или триггера.
В отладочных отчетах используются разные пути к конечным точкам.
Как и отчеты об атрибуции, все отчеты об отладке отправляются в источник сообщения . Отчеты об отладке отправляются в три отдельных конечных точки источника сообщения :
- Конечная точка для отчетов об успешной отладке на уровне событий.
- Конечная точка для получения сводных отчетов об успешной отладке, доступных для агрегирования.
- Конечная точка для подробных отладочных отчетов, как на уровне событий, так и в агрегированном виде.
Подробнее об этом в части 2: Настройка отладочных отчетов .
Варианты использования
Базовая проверка интеграции в реальном времени
Отладочные отчеты отправляются на вашу конечную точку немедленно, в отличие от отчетов об атрибуции, которые отправляются с задержкой для защиты конфиденциальности пользователей. Используйте отладочные отчеты в качестве сигнала в реальном времени о том, что ваша интеграция с API отчетов об атрибуции работает.
Узнайте, как это сделать, в части 3: Отладка кулинарной книги .
Анализ потерь
В отличие от сторонних файлов cookie, API для создания отчетов об атрибуции включает встроенные средства защиты конфиденциальности, разработанные для достижения баланса между полезностью и конфиденциальностью. Это означает, что с помощью API для создания отчетов об атрибуции вы, возможно, не сможете собрать все данные измерений, которые можно собрать с помощью файлов cookie. Не все конверсии, которые можно отслеживать с помощью сторонних файлов cookie, будут генерировать отчет об атрибуции.
Например: для отчетов на уровне событий можно зарегистрировать не более одной конверсии на показ. Это означает, что для данного показа объявления вы получите только один отчет по атрибуции, независимо от того, сколько раз пользователь совершил конверсию.
Используйте отладочные отчеты, чтобы получить представление о различиях между результатами измерений на основе файлов cookie и результатами, полученными с помощью API отчетов по атрибуции. Определите, какие конверсии отображаются в отчете, сколько конверсий не отображается, и конкретно, какие именно и почему.
Узнайте, как провести анализ убытков, в части 3: Руководство по отладке .
Поиск неисправностей
Хотя потери, вызванные проблемами конфиденциальности или защиты ресурсов, ожидаемы, могут быть и непреднамеренные. Неправильные настройки в вашей реализации или ошибки в самом браузере могут привести к пропаже отчетов.
Вы можете использовать отладочные отчеты для обнаружения и исправления проблем с реализацией на вашей стороне или для сообщения о потенциальной ошибке командам разработчиков браузера. Узнайте, как это сделать, в части 3: Отладка cookbook .
Расширенная проверка конфигурации
Некоторые функции API для создания отчетов об атрибуции позволяют настраивать поведение API. Примерами таких функций являются правила фильтрации, правила дедупликации и правила приоритета.
При использовании этих функций используйте отладочные отчеты, чтобы убедиться, что ваша логика приводит к желаемому поведению в рабочей среде, не дожидаясь отчетов об авторизации. Узнайте, как это сделать в части 3: Отладка рецептов .
Локальное тестирование с возможностью агрегирования отчетов.
В отличие от агрегируемых отчетов об атрибуции, которые зашифрованы, агрегируемые отладочные отчеты включают незашифрованную полезную нагрузку.
Используйте сводные отладочные отчеты для проверки содержимого сводных отчетов и для создания локальных отчетов для тестирования с помощью инструмента агрегирования .
Отчеты службы повторной обработки агрегации
Еще одно преимущество использования режима отладки заключается в том, что он позволяет повторно обрабатывать отчеты. Поэтому, чтобы обрабатывать отчеты более одного раза, убедитесь, что отладка отчетов включена. Повторная обработка отчетов может потребоваться в следующих случаях:
- Попытка отладки службы агрегации.
- Экспериментирование с различными стратегиями пакетной обработки.
- экспериментирование с различными значениями эпсилон.
Восстановление данных
Мы рекомендуем рекламным технологическим компаниям включить режим отладки, чтобы получать отладочные отчеты и восстанавливать данные отчетов. Это полезно в случаях проблем со службой агрегации, таких как недоступность или неработоспособность сервисов, что может привести к сбою генерации сводного отчета.
Далее
Часть 2: Настройка отладочных отчетов