Эксперимент Chrome Topics для RTB

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

Эксперимент с API тем доступен RTB-партнёрам в запросах ставок. Темы рассылаются всем RTB-партнёрам в зависимости от их доступности .

Представление заявки на участие в торгах

Протокол OpenRTB

Темы представлены в виде сегментов в сообщении OpenRTB BidRequest.user.data .

Поле Тип Описание
Data.ext.segtax Целое число Идентификатор таксономии, зарегистрированный централизованно . Для тем это версия рекламной таксономии, которая определяет семантическое значение каждого идентификатора темы. 600 используется для начальной таксономии тем Chrome.
Data.ext.segclass Нить Эквивалентно classifier_version .
Data.segment.id Нить Эквивалентно id , преобразованному в строку.

Data.ext — это расширение сообщения BidRequest.user.data . Это расширение доступно в открытой бета-версии протокола .

Вот определение:

// Ad Exchange extensions for the Data object.
message DataExt {
  // The ID for a taxonomy that is registered centrally. Used to define the
  // namespace and semantic meaning of the segment IDs. See
  // https://github.com/InteractiveAdvertisingBureau/openrtb/blob/master/extensions/community_extensions/segtax.md#enumeration-of-taxonomies
  // for the enumeration of the taxonomies that this value can take. Currently
  // only Chrome Topics API taxonomy (segtax=600) is supported.
  optional int32 segtax = 1;

  // The version of the classifier which produced the segment IDs within the
  // taxonomy. For example, in the case of Chrome Topics API (segtax=600), this
  // is the version of the classifier used by the browser to map hostnames to
  // topics in the taxonomy.
  optional string segclass = 2;
}

Протокол Google RTB (устарел)

Темы представлены в поле topics сообщения BidRequest . Это поле доступно в открытой бета-версии протокола .

Вот определение:

  // Experimental field; subject to change.
  // A coarse-grained topic that a website visitor might currently be interested
  // in based on recent browsing activity. See
  // https://developer.chrome.com/docs/privacy-sandbox/topics/ and/or
  // https://privacysandbox.com/intl/en_us/proposals/topics/ for more
  // information about the Topics API. Reach out to your account manager to
  // participate in the Topics API experiment.
  message Topic {
    // The value of a topic ID. A numerical identifier corresponding to a
    // coarse-grained advertising topic. See
    // https://github.com/patcg-individual-drafts/topics/blob/main/taxonomy_v1.md
    // for a list of topics in the initial taxonomy.
    optional int32 id = 1;
    // The version of the advertising taxonomy which defines the semantic
    // meaning of each topic ID for the topics, for example "v1".
    optional string taxonomy_version = 2;
    // The version of the classifier used by the browser to map hostnames to
    // topic IDs in the taxonomy.
    optional string classifier_version = 3;
  }

  // The list of topics that a website visitor might currently be interested in
  // inferred by the browser based on recent browsing activity. See
  // https://developer.chrome.com/docs/privacy-sandbox/topics/ and/or
  // https://privacysandbox.com/intl/en_us/proposals/topics/ for more
  // information about Topics API.
  repeated Topic topics = 74;

Примеры

Ниже приведен пример того, как протоколы Google Authorized Buyers и OpenRTB представляют темы, возвращаемые API тем Chrome.

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

[
  {
    "modelVersion": "classifier_v1",
    "taxonomyVersion": "taxonomy_v1",
    "topic": 3
  },
  {
    "modelVersion": "classifier_v1",
    "taxonomyVersion": "taxonomy_v1",
    "topic": 44
  },
  {
    "modelVersion": "classifier_v1",
    "taxonomyVersion": "taxonomy_v1",
    "topic": 59
  }
]

OpenRTB BidRequest :

{
  "user": {
    "data": [
      {
        "ext": {
          "segtax": 600,
          "segclass": "classifier_v1"
        },
        "segment": [
          { "id": "3" },
          { "id": "44" },
          { "id": "59" }
        ]
      }
    ]
  }
}

Протокол Google RTB (устарел) BidRequest :

topics {
  id: 3
  taxonomy_version: "taxonomy_v1"
  classifier_version: "classifier_v1"
}
topics {
  id: 44
  taxonomy_version: "taxonomy_v1"
  classifier_version: "classifier_v1"
}
topics {
  id: 59
  taxonomy_version: "taxonomy_v1"
  classifier_version: "classifier_v1"
}

В приведенном выше примере API тем Chrome taxonomy_version подразумевает использование сопоставления taxonomy_v1 . Согласно таксономии, эти идентификаторы тем соответствуют следующим темам:

Идентификатор темы Значение темы
3 /Искусство и развлечения/Комиксы
44 /Искусство и развлечения/Опера
59 /Автомобили и транспорт/Классические автомобили

Доступность

Наличие тем в запросе ставки регулируется действующими мерами защиты и контроля конфиденциальности. Например, темы будут недоступны, если пользователь откажется от персонализированной рекламы или будет использовать неперсонализированный рекламный инвентарь.