Эта страница переведена с помощью Cloud Translation API.

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

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

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

Глоссарий

Источником отчетов является источник , который [устанавливает источник отчетов об атрибуции и заголовки триггеров . Все отчеты, созданные браузером, отправляются в этот источник. В этом руководстве мы используем https://adtech.example в качестве примера источника сообщения.
Отчет об атрибуции (сокращенно отчет ) – это окончательный отчет (на уровне событий или агрегированный), содержащий запрошенные вами данные измерений.
Отчет об отладке содержит дополнительные данные об отчете об атрибуции или об источнике или событии-триггере. Получение отчета об отладке не обязательно означает, что что-то работает неправильно! Существует два типа отчетов об отладке.
Переходный отчет об отладке — это отчет об отладке, для создания и отправки которого требуется установка файла cookie. Отчеты о переходной отладке будут недоступны, если файл cookie не установлен, а также если сторонние файлы cookie устарели. Все отчеты об отладке, описанные в этом руководстве, являются отчетами об отладке переходного периода.
Отчеты об успешной отладке отслеживают успешное создание отчета об атрибуции . Они относятся непосредственно к отчету об атрибуции. Отчеты об успешной отладке доступны начиная с Chrome 101 (апрель 2022 г.).
Подробные отчеты об отладке позволяют отслеживать отсутствующие отчеты и помогают определить причину их отсутствия. Они указывают на случаи, когда браузер не записал событие источника или триггера (что означает, что он не будет генерировать отчет об атрибуции), а также случаи, когда отчет об атрибуции не может быть создан или отправлен по какой-либо причине. Подробные отчеты об отладке включают поле type , описывающее причину, по которой исходное событие, событие-триггер или отчет об атрибуции не был создан. Подробные отчеты об отладке доступны начиная с Chrome 109 ( стабильная версия — январь 2023 г. ).
Ключи отладки — это уникальные идентификаторы, которые вы можете установить как на стороне источника, так и на стороне триггера. Ключи отладки позволяют сопоставлять конверсии на основе файлов cookie и конверсии на основе атрибуции. Когда вы настроите свою систему для создания отчетов об отладке и установки ключей отладки, браузер будет включать эти ключи отладки во все отчеты об атрибуции и отчеты об отладке.

Дополнительные понятия и ключевые термины, используемые в нашей документации, см. в глоссарии Privacy Sandbox .

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

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

Примечание. Если type подробного отчета начинается с trigger-event , его можно создать только для событий источника или триггера, связанных с отчетами на уровне событий. Если type подробного отчета начинается с trigger-aggregate , его можно создать только для событий источника или триггера, связанных с агрегируемыми отчетами. Во всех остальных случаях это либо отчет на уровне событий, либо агрегированный отчет.

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

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

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 отчетов по атрибуции может быть связано с поведением пользователей.

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

Шаг 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 может быть признаком ошибки браузера или сетевой ошибки. Если вы неоднократно сталкиваетесь с этим, сообщите об ошибке разработчикам браузера.