Test Topics Chrome pour le RTB

Dans le cadre de la Privacy Sandbox, Chrome a proposé d'utiliser l'API Topics expérimentale. L'API Topics fournit aux appelants tiers de la page Web (y compris les fournisseurs de technologie publicitaire) des thèmes publicitaires sommaires qui pourraient actuellement intéresser le visiteur de la page. Les thèmes peuvent compléter les informations contextuelles sur la page actuelle et peuvent être utiles pour prendre en charge la publicité ciblée par centres d'intérêt.

Le test de l'API Topics est disponible pour les partenaires RTB dans les demandes d'enchères. Remplissez le formulaire de demande pour participer à l'expérience de l'API Topics. Pour en savoir plus, contactez votre responsable de compte.

Représentation de la demande d'enchère

Protocole Google Authorized Buyers

Les sujets sont représentés dans le champ topics du message BidRequest. Ce champ est disponible dans la version bêta ouverte du protocole.

Voici la définition:

  // 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;

Protocole OpenRTB

Les thèmes sont représentés sous forme de segments dans le message BidRequest.user.data OpenRTB.

Champ	Type	Description
Data.ext.segtax	Entier	ID d'une taxonomie enregistrée de manière centralisée. Pour Topics, il s'agit de la version de la taxonomie publicitaire qui définit la signification sémantique de chaque ID de thème. La valeur 600 est utilisée pour la classification initiale de Topics dans Chrome.
Data.ext.segclass	Chaîne	Équivaut à classifier_version.
Data.segment.id	Chaîne	Équivaut à la conversion de id en chaîne.

Data.ext est une extension du message BidRequest.user.data. Cette extension est disponible dans la version bêta ouverte du protocole.

Voici la définition:

// 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;
}

Exemples

Voici un exemple de la manière dont les protocoles Google Authorized Buyers et OpenRTB représentent les thèmes renvoyés par l'API Chrome Topics.

Réponse de l'API Chrome Topics, renvoyée par 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
  }
]

BidRequest du protocole Google Authorized Buyers:

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"
}

Demande d'enchère OpenRTB:

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

Dans l'exemple précédent, taxonomy_version implique l'utilisation du mappage taxonomie_v1. Selon la taxonomie, ces ID de thèmes correspondent aux thèmes suivants:

ID du sujet	Valeur du thème
3	/Arts et divertissements/Bandes dessinées
44	/Arts et divertissements/Opéra
59	/Autos & Vehicles/Classic Vehicles

Garantie de disponibilité

La présence de thèmes dans la demande d'enchère est soumise aux contrôles et protections de la confidentialité existants. Par exemple, les thèmes ne sont pas disponibles si l'utilisateur désactive la publicité personnalisée ou l'inventaire d'annonces non personnalisées.