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