Найдите рекомендации по отладке, устранению неполадок и ресурсы поддержки для тем в Интернете.
Поиск неисправностей
Если вы выполняете вызов document.browsingTopics()
или запрос fetch()
с установленным заголовком Sec-Browsing-Topics
, но получаете в качестве ответа пустой массив, существует ряд шагов отладки, которые вы можете предпринять, чтобы определить основную причину. проблемы как в вашей локальной среде разработки, так и в действующей системе.
Отладка локально
Если вы тестируете локально, убедитесь, что вы используете Chrome с необходимыми параметрами.
- Чтобы обойти регистрацию, включите флаг
chrome://flags/#privacy-sandbox-enrollment-overrides
и добавьте URL-адрес сайта, который вызывает темы. Настройте API Topics для тестирования с помощью флагов функций . Эти флаги позволяют вам изменять такие параметры, как продолжительность эпохи, количество популярных тем и другие, чтобы вы могли удобно тестировать темы. Вы можете использовать следующие рекомендуемые флаги функций:
--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting
Прежде чем запускать Chrome с флагами, убедитесь, что вы закрыли все остальные экземпляры и процессы Chrome.
Убедитесь, что:
- Вы используете Chrome 101 или более позднюю версию.
- Ваш скрипт вызвал API тем для наблюдения за темами. При тестировании вы можете моделировать поведение пользователя, посещая сайты, на которых встроен ваш скрипт. Обратитесь к демо-версии для практического примера.
- У вас не запущен блокировщик рекламы или подобное приложение или расширение.
- Вы не в режиме инкогнито.
- В
chrome://settings/trackingProtection
опцияBlock all third-party cookies
отключена .
Отладка живой реализации
Если вы вызываете API тем из действующего приложения в течение первой недели наблюдения за пользователем, то ожидается пустой результат, поскольку ваше приложение, возможно, еще не обнаружило темы для пользователя. Вы можете отладить свое решение, следуя нашим рекомендациям.
- Убедитесь, что ваш сайт зарегистрирован в Privacy Sandbox.
- Проверьте свой код внешнего интерфейса, чтобы убедиться, что ваш JavaScript работает должным образом.
- Проверьте свой сервер, чтобы получить результаты по темам.
- Не забудьте убедиться, что типы данных и параметры серверного API настроены правильно.
- Убедитесь, что ваш бэкэнд настроен для соответствующего масштабирования .
- По нашему опыту, необходимо подождать как минимум три недели, прежде чем начать получать результаты по более актуальным темам.
- Не у всех пользователей будут включены темы:
- Пользователи могут явно отключить API тем.
- Страницы издателя могут контролировать политику разрешений и отключать свои сайты.
- Добавьте в эту среду метрики и наблюдаемость: они понадобятся вам для анализа первых результатов. Примеры показателей включают в себя:
- Задержка звонков.
- Ошибки HTTP при вызовах тем.
- Постарайтесь ограничить изменения в вашей реализации в течение первых трех недель.
Ресурсы
- GitHub : прочтите пояснение к API Topics, задавайте вопросы и следите за обсуждением проблем, связанных с репозиторием API .
- W3C : Обсудите примеры использования в отрасли в группе по улучшению бизнес-группы веб-рекламы .
- Поддержка разработчиков Privacy Sandbox : задавайте вопросы и присоединяйтесь к обсуждениям в репозитории поддержки разработчиков Privacy Sandbox .
- Chromium : сообщите об ошибке Chromium , чтобы задать вопросы о реализации в Chrome.