Рецепты отладки отчетов об атрибуции

Часть 3 из 3, посвященная отладке отчетов по атрибуции. Найдите инструкции по использованию отчетов об отладке.

В этой кулинарной книге вы найдете инструкции по использованию отчетов об отладке для различных случаев использования, описанных в Части 1: Введение в отчеты об отладке .

Глоссарий

• The reporting origin is the origin that sets the Attribution Reporting source and trigger headers. All reports generated by the browser are sent to this origin. In this guidance, we use https://adtech.example as the example reporting origin.
• An attribution report (report for short) is the final report (event-level or aggregatable) that contains the measurement data you've requested.
• A debug report contains additional data about an attribution report, or about a source or trigger event. Receiving a debug report does not necessarily mean that something is working incorrectly! There are two types of debug reports
• A transitional debug report is a debug report that requires a cookie to be set in order to be generated and sent. Transitional debug reports will be unavailable if a cookie is not set, and once third-party cookies are deprecated. All debug reports described in this guide are transitional debug reports.
• Success debug reports track successful generation of an attribution report. They relate directly to an attribution report. Success debug reports have been available since Chrome 101 (April 2022).
• Verbose debug reports can track missing reports and help you determine why they're missing. They indicate cases where the browser did not record a source or trigger event, (which means it will not generate an attribution report), and cases where an attribution report can't be generated or sent for some reason. Verbose debug reports include a type field that describes the reason why a source event, trigger event or attribution report was not generated. Verbose debug reports are available starting in Chrome 109 (Stable in January 2023).
• Debug keys are unique identifiers you can set on both the source side and the trigger side. Debug keys enable you to map cookie-based conversions and attribution-based conversions. When you've set up your system to generate debug reports and set debug keys, the browser will include these debug keys in all attribution reports and debug reports.

For more concepts and key terms used throughout our documentation, refer to the Privacy Sandbox glossary.

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

1. Настройте свою систему для создания отчетов об успешной отладке . Узнайте, как это сделать, в Части 2: Настройка отчетов об отладке .
2. Всякий раз, когда вы развертываете код отчетов по атрибуции, проверяйте в режиме реального времени, получаете ли вы какие-либо отчеты об успешной отладке на своей конечной точке. Если да, то ваша настройка отчетов по атрибуции работает.
3. Отчеты об успешной отладке отправляются только при выполнении преобразования. Вместо этого вы можете проверить, правильно ли настроена ваша интеграция независимо от конверсий, то есть вы хотите убедиться, что источники успешно зарегистрированы. Чтобы добиться этого, вы можете положиться на подробные отчеты об успешной регистрации источника . Узнайте, как их настроить, в Части 2: Настройка отчетов об отладке .

Практическое руководство: анализ потерь и устранение неполадок в интеграции

Чтобы сравнить результаты измерения конверсий на основе файлов cookie с отчетами об атрибуции, используйте ключи отладки и сопоставляйте конверсии файлов cookie с отчетами об отладке. Помните, что отчеты об отладке немедленно отправляются на вашу конечную точку.

Обзор

Используйте ключи отладки (пара <source_debug_key, trigger_debug_key> ) для сопоставления преобразований файлов cookie с отчетами об успешной отладке. Получали ли вы соответствующий отчет об успешной отладке для каждого преобразования файлов cookie во время преобразования?

Если да : для всех этих отчетов об успешной отладке вы можете рассчитывать на получение отчета об атрибуции позже — за некоторыми исключениями. Подробности см. в сценарии отчета об успешной отладке .

Если нет , это означает, что конверсия не была зарегистрирована в отчетах по атрибуции. Используйте пару <source_debug_key, trigger_debug_key> (или ключ отладки источника, если ключ отладки триггера отсутствует) для сопоставления преобразований файлов cookie с подробными отчетами об отладке. Получали ли вы в какой-то момент (источник или момент запуска) для каждого из этих преобразований соответствующий подробный отчет об отладке?

• Если вы не получили подробный отчет об отладке: это может быть связано с поведением пользователя или проблемой интеграции. Подробности см. в сценарии отсутствия отчета об отладке .

• Если вы получили подробный отчет об отладке, посмотрите на его поле type .

  • Если его type — source-success : это означает, что источник был успешно зарегистрирован, а триггер — нет. Чтобы сузить причину отсутствия отчета об успешной отладке, найдите соответствующий подробный отчет об отладке любого другого типа — этот отчет укажет на проблему на стороне триггера.

  • Если его type любой другой: источник или триггер не зарегистрирован. type говорит вам, почему. Соответствующий отчет об атрибуции (и отчет об успешной отладке) будет отсутствовать. В зависимости от type подробного отчета об отладке вы можете просто использовать эту информацию в качестве точки данных анализа потерь (другими словами, никаких действий с вашей стороны), или вы можете захотеть зарегистрировать ошибку или устранить неполадки в вашей реализации. Подробные сведения см. в сценарии подробного отчета об отладке .

Возможные сценарии

Отчет об успешной отладке

Если для определенного преобразования файлов cookie вы получили отчет об успешной отладке, это означает, что это преобразование было успешно зарегистрировано в отчетах по атрибуции.

Вы можете рассчитывать позже на получение отчета об атрибуции для этой конверсии ⏤за некоторыми исключениями:

• Поведение пользователя: очистка данных после конверсии и перед отправкой отчета об атрибуции, закрытие браузера и т. д. Если пользователь закрывает браузер после конвертации и не открывает его в течение недели, отчет не будет отправлен в течение недели или более. Вы можете считать эту задержку потерей.
• Применимо только к уровню событий: отчет уровня события заменяется другим отчетом с более высоким приоритетом.
• Возможные проблемы с сетью.

Подробный отчет об отладке типа source-success

Если для источника данного преобразования файлов cookie вы получили подробный отчет об отладке типа source-success , это означает, что регистрация источника прошла успешно. В зависимости от того, будет ли регистрация триггера впоследствии успешной, вы можете получить или не получить отчет об этой конверсии.

Здесь есть одно предостережение:

Подробный отчет об отладке любого другого типа

Если для данного преобразования файлов cookie вы получили подробный отчет об отладке любого другого типа, вы не получите отчет об успешной отладке и, следовательно, позже не получите отчет об атрибуции, поскольку подробный отчет означает, что произошел сбой, о котором можно сообщить. Что-то препятствовало регистрации источника, регистрации триггера, созданию отчета или отправке отчета. Возможные причины:

• Ограничения конфиденциальности
• Ограничения хранилища
• Пользовательские правила
• Проблема реализации в вашем коде
• Ошибка браузера

Некоторые из них ожидаемы! Какое действие следует предпринять, зависит от type каждого подробного отчета. Ознакомьтесь со справкой по подробным отчетам .

Нет отчетов об отладке

Если для данного преобразования файлов cookie вы получили только отчет об атрибуции (нет отчета об успешной отладке или подробного отчета об отладке), это означает, что что-то помешало созданию отчетов об отладке. Возможные причины:

• Пользовательские настройки (пользователь отключил сторонние файлы cookie)
• Отсутствует файл cookie или отсутствуют ключи отладки (ключ отладки удален из-за отсутствия файла cookie). В chrome://attribution-internals откройте вкладку «Журналы» и проверьте, не обнаружена ли там какая-либо проблема.
• Проблемы с сетью, возникшие в момент источника или триггера, но не во время отправки отчета об атрибуции.

Получаете ли вы отчеты об атрибуции?

Это частный случай отсутствия отчета об отладке: если для данного преобразования файлов cookie вы не получили никаких отчетов (ни одного отчета об отладке, ни отчета об атрибуции), это означает, что произошел сбой, не подлежащий отчету. . Возможные причины:

• Фундаментальный вопрос интеграции. Узнайте, как устранить эти неполадки, в разделе «Устранение фундаментальных проблем интеграции» .
• Возможные проблемы с сетью.
• Пользовательские настройки в настройках браузера, такие как Privacy Sandbox, отключены.

Справочник по подробным отчетам об отладке

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

Успешная регистрация источника

Источник успешно зарегистрирован.

source-success

Подробности и текст отчета

Отчеты об ограничениях конфиденциальности

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

source-destination-limit

Подробности и текст отчета

source-noised

Подробности и текст отчета

trigger-attributions-per-source-destination-limit

Подробности и текст отчета

trigger-reporting-origin-limit

Подробности и текст отчета

trigger-event-noise

Подробности и текст отчета

trigger-event-excessive-reports

Это генерируется, если количество отчетов превышает лимит; вы можете зарегистрировать максимум одну конверсию по просмотрам и три по кликам. Обратите внимание, что вы можете настроить, какие отчеты получать, установив приоритеты . Подробности и текст отчета

Отчеты об ограничениях хранилища

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

source-storage-limit

Подробности и текст отчета

trigger-event-storage-limit

Подробности и текст отчета

trigger-aggregate-storage-limit

Подробности и текст отчета

Отчеты о пользовательских правилах

Эти отчеты ожидаются, если вы используете фильтрацию, дедупликацию, приоритеты или фильтрацию на основе окон . На всякий случай дважды проверьте соответствующие пользовательские правила, чтобы убедиться, что отчет, соответствующий этому подробному отчету, действительно является отчетом, который вы хотите удалить. Если это верно, вам не нужно предпринимать никаких действий.

trigger-no-matching-filter-data

Подробности и текст отчета

trigger-event-no-matching-configuration

Подробности и текст отчета

trigger-event-deduplicated

Подробности и текст отчета

trigger-aggregate-deduplicated

Подробности и текст отчета

trigger-event-low-priority

Подробности и текст отчета

trigger-event-report-window-passed

Подробности и текст отчета

trigger-aggregate-report-window-passed

Подробности и текст отчета

Другие подробные отчеты

Эти отчеты могут указывать на потенциальные проблемы реализации в вашем коде.

trigger-no-matching-source

Это может быть проблема реализации. Убедитесь, что в настройках <reporting origin, destination> нет неправильной конфигурации. Это также может быть ожидаемым поведением API. Например, пользователь удалил данные в какой-то момент после взаимодействия с рекламой и перед конверсией, или пользователь совершил конверсию, даже не увидев связанную рекламу. Подробности и текст отчета

trigger-aggregate-no-contributions

Скорее всего, это не то поведение, которое вы ожидаете от своего кода. Устраните неполадки с кодом регистрации триггера; убедитесь, что конфигурация вашего вклада верна. Подробности и текст отчета

trigger-aggregate-insufficient-budget

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

Неожиданные ошибки (потенциальные ошибки браузера)

Эти сообщения неожиданны . Они могут быть из-за ошибки браузера! Сообщите об ошибке и укажите в описании действия по ее воспроизведению.

source-unknown-error

Подробности и текст отчета

trigger-unknown-error

Подробности и текст отчета

Пример анализа потерь

Шаг 1. Настройка и сопоставление с помощью файлов cookie

Следуйте инструкциям в Части 2: Настройка отчетов об отладке , чтобы настроить систему для создания отчетов об успешной отладке и подробных отчетов об отладке .

При этом вы можете использовать информацию о конверсиях на основе файлов cookie для поиска соответствующих отчетов об отладке или отчетов об атрибуции.

Шаг 2. Определите успешные регистрации и недостающие отчеты.

В этом примере предположим, что вы отследили 100 конверсий с помощью своей системы на основе файлов cookie.

Каждый раз, когда вы записываете преобразование на основе файлов cookie, ищите отчет об успешной отладке (отправленный немедленно), который имеет ту же пару <source_debug_key, trigger_debug_key> что и это преобразование на основе файлов cookie.

Предположим, вы получили отчет об успешной отладке для 70 таких преобразований файлов cookie.

• Отчеты об успехе означают, что атрибуция была успешно записана, поэтому можно с уверенностью предположить, что вы получите отчет об атрибуции, соответствующий каждому отчету об успехе — за некоторыми исключениями.
• Вы можете принять решение отслеживать эти исключения. Для этого, поскольку отчеты об атрибуции отправляются на вашу конечную точку в течение следующих дней/недель (в зависимости от срока действия), найдите отчеты об атрибуции, которые имеют ту же пару ключей отладки, что и каждый отчет об успешной отладке. Обязательно подождите немного: отчеты могут не отправляться сразу в конце каждого окна. Предположим, вы нашли только 60 отчетов по атрибуции. Отсутствие 10 отчетов по атрибуции может быть связано с поведением пользователей.

Шаг 3: Краткая оценка потерь

100–70 = отсутствуют 30 отчетов об успешной отладке. Это означает, что эти 30 конверсий (которые отслеживались в вашей реализации на основе файлов cookie) не были записаны с помощью отчетов по атрибуции. Вы не будете получать по ним отчеты об атрибуции.

Поскольку у вас 100 конверсий на основе файлов cookie и только 70 конверсий на основе атрибуции, ваши потери составят 30 %. Теперь у вас есть краткая оценка потерь.

Шаг 4. Анализ причин

Чтобы выяснить, почему эти отчеты отсутствуют, найдите соответствующие подробные отчеты об отладке, которые вы получили во время преобразования (регистрации триггера) или ранее во время регистрации источника. Используйте ключи преобразований на основе файлов cookie, чтобы сопоставить их с подробными отчетами об отладке.

• Предположим, что есть 10 ключей, для которых нет подробного отчета об отладке. Проверьте, нет ли проблем с интеграцией. Если нет, это может быть связано с поведением пользователя.
• У вас есть 20 подробных отчетов об отладке. Теперь вы можете уточнить анализ потерь. Проанализируйте поле type каждого подробного отчета. Например, вы можете обнаружить, что:
  • 10 (= 10 % в нашем примере) отчетов отсутствуют из-за pending destination limit
  • 5 (= 5%) отчетов отсутствуют из-за trigger-aggregate-no-contributions .
  • 5 (= 5%) отчетов отсутствуют из-за unknown-error .

Шаг 5. Примите меры и устраните неполадки

Теперь, когда вы поняли, почему отсутствуют отчеты, вы можете действовать на основе этой информации.

Какое действие следует предпринять, зависит от type каждого подробного отчета. Дополнительные сведения см. в справочнике по подробным отчетам. Например:

• pending-destination-limit — это защита конфиденциальности. Никаких действий предпринимать не нужно. Используйте это число в качестве точки данных для собственной видимости и мониторинга.
• trigger-aggregate-no-contributions может быть признаком проблемы с реализацией на вашей стороне. Проанализируйте это дальше. Используйте подробную информацию в тексте подробного отчета, чтобы устранить неполадки и исправить их, если это необходимо.
• unknown-error может быть признаком ошибки браузера или сетевой ошибки. Если вы неоднократно сталкиваетесь с этим, сообщите об ошибке разработчикам браузера.