API тем: экспериментируйте и участвуйте

Краткое руководство по реализации и тестированию API. Получайте доступ к темам с помощью JavaScript и делитесь своими отзывами.

Ключевой момент: пробная версия исходной версии Privacy Sandbox Relevance and Measurement завершилась 20 сентября 2023 г., и теперь API-интерфейсы доступны для 99 % пользователей Chrome, а регистрация на пробную версию Origin завершена. Чтобы быть в курсе процентной доли пользователей, для которых включен каждый API, смотрите графики статуса Chrome .

Изучите основы

• Обзор API тем знакомит с API и объясняет проблемы, которые он решает.
• Классификация тем объясняет модель классификатора, то, как темы выводятся и назначаются браузерам пользователей, а также как пользователи могут управлять своим списком тем.
• Руководство разработчика API Topics описывает настройку, получение и настройку тем с использованием JavaScript и заголовков, а также отладку.

Попробуйте API

1. Посетите страницу состояния Privacy Sandbox, чтобы узнать обновления о состоянии реализации Topics API.
2. Поэкспериментируйте с API:
   • Попробуйте темы для одного пользователя в Chrome 101 или более поздней версии, включив chrome://flags/#privacy-sandbox-ads-apis или запустив Chrome из командной строки с флагом функции --enable-features=PrivacySandboxAdsAPIsOverride . См. демонстрационные версии API Topics .
   • В руководстве разработчика API Topics объясняется, как использовать API Topics JavaScript или метод заголовка (fetch или iframe) для доступа к темам, наблюдаемым для текущего пользователя.

Получать поддержку

Что-то мешает вам экспериментировать с API? Задайте вопрос о вашей реализации или документации :

• Откройте новый выпуск в репозитории поддержки разработчиков Privacy Sandbox. Обязательно выберите шаблон проблемы для тем.
• Если у вас есть более общие вопросы о том, как реализовать ваши варианты использования API, сообщите о проблеме в репозитории API .

Об ошибках и проблемах с реализацией API тем в Chrome:

• Просмотрите существующие проблемы, о которых сообщалось для API.
• Поднимите новую проблему на crbug.com/new .

Присоединяйтесь к обсуждению

Приглашаем всех желающих присоединиться к обсуждению API Topics. В частности, если вы экспериментируете с API, ваше мнение очень важно.

Обсудить API

Как и другие API Privacy Sandbox, этот API документирован и обсуждается публично.

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

Обсудить связанные темы

• Обсудите примеры использования в отрасли в бизнес-группе по улучшению веб-рекламы .

Дать обратную связь

• Используйте форму обратной связи Privacy Sandbox, чтобы поделиться отзывами с командой Chrome в частном порядке за пределами общедоступных форумов.
• Обратная связь Privacy Sandbox объясняет, как предоставлять другие типы отзывов и как участвовать в обсуждении API Privacy Sandbox.

Получайте обновления

• Чтобы получать уведомления об изменении статуса API, присоединитесь к списку рассылки для разработчиков .
• Чтобы внимательно следить за всеми текущими обсуждениями API, нажмите кнопку «Смотреть» на странице GitHub на GitHub . Для этого вам необходимо иметь или создать учетную запись GitHub .
• Чтобы получать общие обновления Privacy Sandbox, подпишитесь на RSS-канал [Прогресс в Privacy Sandbox].