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

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

Реализация серверной части тем

Реализация вашей серверной части зависит от того, как вы хотите использовать темы, рассчитанные в браузере. Мы рекомендуем рекламным решениям использовать темы в качестве дополнительного сигнала 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 в качестве дополнительного сигнала.
    • Как только вы начнете получать непустой список тем, вы можете отправить его на свой бэкэнд вместе с другими контекстными сигналами.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также

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