Test Topics Chrome pour le RTB

Dans le cadre de la Privacy Sandbox, Chrome nous a proposé l'expérience API Topics : La L'API Topics fournit des appelants tiers sur la page Web (y compris la technologie publicitaire par des tiers) avec des sujets publicitaires plus précis que le visiteur de la page est susceptible qui vous intéressent. Les thèmes peuvent compléter les informations contextuelles sur la page actuelle et peuvent être utiles pour gérer des campagnes publicité.

Le test de l'API Topics est disponible pour les partenaires RTB dans les demandes d'enchères. Les thèmes sont envoyés à tous les partenaires du système d'enchères en temps réel en fonction availability [disponibilité].

Représentation de la demande d'enchère

Protocole OpenRTB

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

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

Data.ext est une extension du message BidRequest.user.data. Cette extension est disponible en 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;
}

Protocole Google RTB (obsolète)

Les sujets sont représentés dans le champ topics du message BidRequest. Ce 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;

Exemples

Voici un exemple de la façon dont Google Authorized Buyers et OpenRTB Les protocoles 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 OpenRTB:

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

Protocole Google RTB (obsolète) 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"
}

Dans l'exemple d'API Chrome Topics ci-dessus, taxonomy_version implique que le mappage taxonomie_v1 ; est utilisé. D'après la classification, ces identifiants de thèmes correspondent aux éléments suivants : sujets:

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

Disponibilité

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