Ресурсы поддержки API Topics в Интернете

Найдите рекомендации по отладке, устранению неполадок и ресурсы поддержки для тем в Интернете.

Поиск неисправностей

Если вы выполняете вызов 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 при вызовах тем.
  • Постарайтесь ограничить изменения в вашей реализации в течение первых трех недель.

Ресурсы