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