Тестирование, развертывание и масштабирование решения на основе тем

На этой странице описано, как создавать, тестировать и масштабировать реализацию для использования в производственной среде с помощью API тем.

Темы: реализация бэкэнда

Реализация вашей серверной части зависит от того, как вы хотите использовать темы, рассчитанные в браузере. Мы рекомендуем рекламным технологическим решениям использовать темы в качестве дополнительного сигнала IBA .

// Use the language/framework/stack of your preference
function processTopicsBackendAPI(topics) {
 // If the list is not empty, continue
 // Use topics as an additional signal
}

Используйте темы в качестве дополнительного сигнала.

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

Как объясняется в статье «Максимизация релевантности рекламы после использования сторонних файлов cookie» , существует несколько подходов к использованию тем для показа релевантной рекламы. Некоторые из них предполагают использование тем для формирования аудиторий, а другие — использование тем в качестве одного из сигналов для обучения моделей машинного обучения, которые будут использоваться для определения дополнительных интересов аудитории или даже для оптимизации логики назначения ставок.

Сборка и развертывание

  1. Сбор информации по темам осуществляется путем наблюдения за пользователями в рабочей среде (ориентировочное время внедрения: приблизительно одна неделя):
    • Разберитесь в доступных вариантах: как вызывать темы с помощью HTTP-заголовков или iframe и JavaScript .
    • Укажите домен iframe, который будет вызывать API тем.
    • Создайте своё решение, используя демонстрационный пример в заголовке или демонстрационный пример на JavaScript в качестве примера кода.
    • Интегрируйте разделы «Темы» в свой код, чтобы издатели могли встраивать их на свои сайты (например, в рекламный iframe). Убедитесь, что вы вызываете разделы «Темы» из встроенного контента.
    • Чтобы начать отслеживать пользовательские темы, встройте последнюю версию вашего скрипта на ваши рабочие веб-сайты. Мы рекомендуем сначала протестировать внедрение на собственных веб-сайтах с небольшим количеством ежемесячных посещений. На этом этапе мы рекомендуем встроить ваше новое решение, основанное на анализе тем, как минимум на пяти сайтах.
    • На данном этапе ожидается, что API вернет пустой массив в качестве результата. Это связано с тем, что для пользователя еще не было зафиксировано ни одной темы. Получение тем от пользователя может занять до трех недель.
    • Проведите функциональное тестирование и проверку . Вы можете протестировать свое решение вручную или автоматически. Например:
      • Откройте браузер с флагами и установите эпоху на 15 секунд, чтобы браузер пересчитывал темы раньше.
      • Посетите сайты, на которых встроен ваш скрипт.
      • Проверьте, отслеживается ли вашим скриптом тематика по адресу chrome://topics-internals/ .
      • Посмотрите, каких результатов вы можете ожидать.
  2. Используйте данные по темам вместе с другими контекстными сигналами (такими как URL-адреса, метаданные и т. д.) (ориентировочное время: около 3 дней).
    • После трех недель работы в производственной среде ваш скрипт должен был отследить темы некоторых пользователей. На этом этапе вы сможете использовать данные о темах в качестве дополнительного сигнала.
    • Как только вы начнете получать непустой список тем, вы можете отправить его на свой бэкэнд вместе с другими контекстными сигналами.

Развертывание на целевых сайтах

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

  • Вызывается API тем.
  • В этой контролируемой среде можно проводить наблюдения за изучаемыми темами.
  • Доступ к темам возможен (API возвращает пользователю информацию о наблюдаемых темах).

Выберите целевые сайты

Перед развертыванием вашего решения на сайтах издателей мы рекомендуем протестировать его в контролируемой среде на принадлежащих вам веб-сайтах. Рекомендуем выбрать следующие целевые веб-сайты:

  • Сайт посещает небольшое количество пользователей в месяц (менее миллиона посещений в месяц) : для начала следует развернуть API для небольшой аудитории.
  • Вы являетесь владельцем и контролируете сайт : при необходимости вы можете быстро отключить эту функцию без сложных процедур согласования.
  • Данный сайт не является критически важным для бизнеса : начните с целевых сайтов с низким уровнем риска.
  • Всего не более пяти сайтов : на данном этапе вам не потребуется большой трафик или известность.
  • Целевые сайты представляют разные темы : выберите веб-сайты, представляющие разные категории (например, один о спорте, другой о новостях, еще один о еде и напитках). Вы можете использовать встроенный инструмент «Темы» в Chrome для проверки доменов и того, как они классифицируются классификатором машинного обучения «Темы».

Функциональное тестирование и проверка

При вызове API тем в этой ограниченной среде можно ожидать следующих результатов :

  • Пустой массив тем [] , если это первый вызов данного устройства для данного сайта и вызывающего абонента за последние семь дней.

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

    • Одна тема, выбранная из пяти наиболее популярных для пользователя, рассчитывается на основе имен хостов страниц, где пользователь наблюдал интересующие его темы в течение этой недели.

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

  • Если вы обращаетесь по поводу тем после четырех недель наблюдений, появляется новая тема, заменяющая одну из трех старых.

  • Если вы не отслеживали темы пользователя в течение последних трех недель или дольше, то API Topics снова вернет пустой массив [] .

Соберите показатели производительности , чтобы оценить пользовательский опыт:

  • Для дальнейшего анализа производительности следует измерить время выполнения вызовов JavaScript к API тем внутри iframe, расположенного в другом источнике.
  • Время, затраченное на создание iframe и postMessage() после получения этих тем.

Для устранения неполадок обратитесь к разделу поддержки .

Масштабирование до производства

К этому моменту вы должны были протестировать Topics в контролируемой среде (на нескольких принадлежащих вам сайтах). Если все работает как ожидалось, пора масштабировать эту реализацию. Разверните тот же код на большем количестве целевых веб-сайтов. Это позволит вам наблюдать за большим количеством пользователей, собирать больше данных о темах и углублять понимание вашей аудитории.

Вот пошаговое описание того, как можно масштабировать систему до уровня производственной среды:

  1. Протестируйте ваше тематическое решение на большем объеме трафика.
    • Добавьте свой iframe на большее количество принадлежащих вам сайтов с большим числом посетителей и следуйте приведенным ниже инструкциям для проведения нагрузочного тестирования.
  2. Разверните ваше решение на сайтах издателей.
    • После того как ваше решение заработает корректно в вашей собственной тестовой среде, сотрудничайте с издателями, чтобы интегрировать ваш iframe на их веб-сайты. Например, им может потребоваться обновить библиотеку, которая включает ваш iframe.
  3. Обработка и использование данных по темам (ориентировочное время: около четырех недель).
    • Включите данные о тематике в качестве дополнительного сигнала наряду с другими данными.
    • Найдите партнеров для тестирования системы торгов в режиме реального времени.
    • Проведите тестирование полезности, используя темы в качестве дополнительного сигнала к вашим другим данным.

Нагрузочное тестирование

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

  1. Внедряйте систему постепенно на большем количестве целевых сайтов , которыми вы владеете, особенно на тех, которые имеют больший объем трафика.
  2. Проведите нагрузочное тестирование данных по вашим темам в соответствии с ожидаемым трафиком.
    • Вам потребуется передавать информацию о теме из iframe в ваш бэкэнд . Это позволит вам дополнительно обрабатывать результаты API тем и использовать их в качестве дополнительного сигнала для выбора более релевантных для пользователя объявлений. По мере того, как все больше сайтов будут использовать ваш встраиваемый контент, количество обращений к вашему бэкэнду значительно возрастет. Убедитесь, что ваш бэкэнд может обрабатывать большой объем обращений из iframe.
    • Настройте сбор метрик и ведение журналов для анализа.
  3. Сразу после развертывания API тем проверьте метрики, чтобы выявить любые серьезные проблемы, возникающие у конечных пользователей. Регулярно проверяйте метрики.
  4. В случае сбоев или непредвиденного поведения откатите развертывание и проанализируйте журналы, чтобы понять и устранить проблему.

См. также

Ознакомьтесь с нашими ресурсами, чтобы лучше понять API Topics в Интернете.