Руководство по интеграции тем для SSP

В рамках Privacy Sandbox Chrome предложил API Topics . API тем предоставляет сторонним абонентам на веб-странице (включая поставщиков рекламных технологий) подробные рекламные темы , которые могут заинтересовать посетителя страницы. Эти темы могут дополнять контекстную информацию о текущей странице.

Display & Video 360 и Google Ads обнаружили, что темы являются ценным сигналом в сочетании с другими сигналами для предоставления рекламы на основе интересов без использования сторонних файлов cookie. Узнайте больше о подходе Display & Video 360 и Google Ads к рекламе на основе интересов. Google рекомендует SSP включать темы в свои запросы, чтобы повысить релевантность ваших ресурсов издателя.

В следующем руководстве представлены шаги, необходимые SSP для интеграции с Topics и их тестирования с помощью Display & Video 360 и Google Ads или любого другого участвующего поставщика рекламных технологий.

Общая информация

Прежде чем углубляться в API Topics, сначала ознакомьтесь с руководством разработчика Topics в Chrome. Начиная с октября 2023 года Chrome требует регистрации всех пользователей Privacy Sandbox API, включая Topics. Для получения дополнительной информации и последних обновлений мы рекомендуем посетить страницу состояния Chrome Topic API и последние обновления Topics API .

Методы доступа к темам

Ниже приводится краткое описание наиболее распространенных методов доступа к темам. Если эти методы не подходят для вашей конфигурации, DV360 рекомендует вам обратиться к команде Chrome по предложенным каналам, указанным на странице статуса API темы Chrome .

Прямая реализация

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

Использование модуля Prebid

Поставщики общих служб, участвующие в Prebid, могут обратиться к документации Prebid , чтобы узнать, как получать темы с помощью themeFpdModule . Поскольку издателям необходимо включить этот модуль в свой окончательный пакет предварительной ставки, DV360 рекомендует вам обратиться к своим партнерам-издателям, чтобы убедиться, что это требование находится в их поле зрения.

Использование Prebid 8.9.0+

Компания Prebid выпустила новую функцию в основных модулях Prebid 8.9.0+, которая позволяет вызывать темы в исходящих запросах ставок [ примечания к выпуску ]. В документации Prebid описывается, как включить темы Observe-Browsing-Topics в ответ сервера. Темы доступны в заголовке Sec-Browsing-Topics запроса fetch() . Поставщикам SSP может потребоваться перенести темы из заголовка в запрос ставки перед отправкой в ​​DV360. Поскольку для того, чтобы эта возможность была доступна, издателям необходимо внедрить ядро ​​версии 8.9.0+, убедитесь, что ваши партнеры-издатели знают об этом.

Использование Open Bidding

Поставщики общих служб, участвующие в Open Bidding, могут ссылаться на Документацию для авторизованных покупателей , чтобы получать темы в запросах ставок от Google с использованием протокола OpenRTB.

Передача тем в DV360 и Google Ads

В предыдущем разделе были описаны варианты доступа к темам. Получив доступ к темам, вы можете поделиться темами в потоке ставок со своими покупателями DSP. В этом разделе описывается, как перейти на DV360 и Google Ads. DV360 и Google Ads ожидают, что темы будут находиться в объекте user.data в OpenRTBRequest. Узнайте, как передавать идентификаторы сегментов в таксономии конкретного поставщика с помощью JSON.

Пример

Ответ Chrome Topics API, возвращаемый document.browsingTopics() :

[
  {
    "modelVersion": "classifier_v2",
    "taxonomyVersion": "taxonomy_v2",
    "topic": 351
  },
  {
    "modelVersion": "classifier_v2",
    "taxonomyVersion": "taxonomy_v2",
    "topic": 163
  },
  {
    "modelVersion": "classifier_v2",
    "taxonomyVersion": "taxonomy_v2",
    "topic": 59
  }
]

OpenRTBRequest JSON:

{
  ...
  "user": {
    "data": [
      {
        "ext": {
          "segtax": 601,
          "segclass": "classifier_v1"
        },
        "segment": [
          { "id": "351" },
          { "id": "163" },
          { "id": "59" }
        ]
      }
    ]
  }
}

В предыдущем примере taxonomy_version подразумевает, что используется сопоставление таксономии_v2 . В зависимости от таксономии эти идентификаторы тем соответствуют следующим темам:

Идентификатор темы Значение темы
351 /Искусство и развлечения/Комиксы и анимация
163 /Финансы/Страхование/Страхование путешествий
59 /Автотранспортные средства/Классические транспортные средства