Nell'ambito di Privacy Sandbox, Chrome ha proposto l'API Topics sperimentale. L'API Topics fornisce ai chiamanti di terze parti sulla pagina web (inclusi i fornitori di tecnologia pubblicitaria) argomenti pubblicitari generici a cui il visitatore della pagina potrebbe essere attualmente interessato. Gli argomenti possono integrare le informazioni contestuali della pagina corrente e possono essere utili per supportare la pubblicità basata sugli interessi.
L'esperimento dell'API Topics è disponibile per i partner RTB nelle richieste di offerta. Compila il modulo di richiesta per partecipare all'esperimento API Topics. Per saperne di più, rivolgiti al tuo account manager.
Rappresentazione della richiesta di offerta
Protocollo Google Authorized Buyers
Gli argomenti sono rappresentati nel campo topics
del messaggio BidRequest
. Questo campo è disponibile nella versione beta aperta del protocollo.
Ecco la definizione:
// 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;
Protocollo OpenRTB
Gli argomenti sono rappresentati come segmenti nel messaggio BidRequest.user.data
di OpenRTB.
Campo | Tipo | Descrizione |
---|---|---|
Data.ext.segtax
|
Numero intero | L'ID di una tassonomia registrata centralmente. Per Topics, è la versione della tassonomia pubblicitaria che definisce il significato semantico di ogni ID argomento. 600 viene utilizzato per la tassonomia iniziale di Topics di Chrome. |
Data.ext.segclass
|
Stringa | Equivalente a classifier_version .
|
Data.segment.id
|
Stringa | Equivale a id trasmesso in una stringa.
|
Data.ext
è un'estensione del messaggio BidRequest.user.data
. Questa estensione è disponibile nella versione beta aperta del protocollo.
Ecco la definizione:
// 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;
}
Esempi
Di seguito è riportato un esempio di come i protocolli Google Authorized Buyers e OpenRTB rappresentano gli argomenti restituiti dall'API Chrome Topics.
Risposta dell'API Chrome Topics, restituita da 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
}
]
Protocollo BidRequest di 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"
}
Richiesta di offerta OpenRTB:
{
"user": {
"data": [
{
"ext": {
"segtax": 600,
"segclass": "classifier_v1"
},
"segment": [
{ "id": "3" },
{ "id": "44" },
{ "id": "59" }
]
}
]
}
}
Nell'esempio precedente, taxonomy_version
implica che venga utilizzata
la mappatura tassonomia_v1. In base alla tassonomia, questi ID argomento corrispondono ai seguenti
argomenti:
ID argomento | Valore argomento |
---|---|
3 | /Arti e intrattenimento/Fumetti |
44 | /Arti e intrattenimento/Opera |
59 | /Auto e veicoli/Veicoli d'epoca |
Disponibilità
La presenza di argomenti nella richiesta di offerta è soggetta alle misure di protezione e ai controlli della privacy esistenti. Ad esempio, gli argomenti non sono disponibili se l'utente disattiva la pubblicità personalizzata o l'inventario di annunci non personalizzati.