API Topics per il web

L'API Topics consente la pubblicità basata sugli interessi senza utilizzare cookie di terze parti.

Come funziona l'API Topics

L'API Topics può essere utilizzata per osservare e fornire l'accesso agli argomenti che sembrano essere di interesse per l'utente, in base alla sua attività. L'API Topics può quindi concedere agli utenti che la richiamano (ad esempio le piattaforme ad tech) l'accesso agli argomenti di interesse di un utente, ma senza rivelare ulteriori informazioni sulla sua attività.

Concetti fondamentali

• Un argomento è un argomento di interesse per l'utente corrente leggibile da una persona e fa parte della tassonomia di Topics.
• Un chiamante è un'entità, ad esempio un'app, un SDK di terze parti, un sito web o un servizio, che invia una richiesta all'API Topics per osservare o accedere agli interessi di un utente.
• Un argomento viene osservato da un chiamante se quest'ultimo ha effettuato una richiesta all'API Topics da una pagina web o un'app associata a questo argomento durante le ultime tre epoche.
• Un'epoca è un periodo di calcolo degli argomenti, che per impostazione predefinita è pari a una settimana.
• Una tassonomia è un elenco gerarchico di categorie, che include, ad esempio, categorie come /Arts & Entertainment/Music & Audio/Soul & R&B e /Business & Industrial/Business Services/Corporate Events.
• Gli argomenti vengono dedotti utilizzando un modello di classificazione che mappa l'attività utente a zero o più argomenti.

Passaggi principali del flusso dell'API Topics

Il ciclo di vita dell'API Topics prevede tre passaggi principali:

• Osserva l'attività degli utenti, ad esempio quando visitano la pagina web https://cats.example/tabby/index.html o scaricano l'app cats.
• Dedurre gli argomenti dall'attività utente, ad esempio /Pets & Animals/Pets/Cats.
• Accedere agli argomenti osservati in precedenza per l'utente, ad esempio come indicatore per selezionare la pubblicità pertinente (ad esempio una promozione di cibo per gatti).

Osservare gli argomenti

I chiamanti possono accedere solo agli argomenti di interesse che hanno osservato. Un chiamante osserva un argomento quando effettua una richiesta all'API Topics da un contesto associato a questo argomento. Per illustrare questo concetto, prendi in considerazione il seguente esempio semplificato.

• Supponiamo che esistano due chiamanti dell'API Topics: A e B.
• Esistono due contesti:
  • Greenhouse, ad esempio un'app denominata Greenhouse o un sito web greenhouse.example, associato all'argomento Home & Garden.
  • Esercizi di tennis, ad esempio un'app denominata Esercizi di tennis o un sito web tennis.example, associato all'argomento Sports/Tennis.
• Sia l'utente che chiama A sia B sono presenti nel contesto di Greenhouse.
• Solo il chiamante B è presente nel contesto di Esercizi di tennis.
• Per semplificare, supponiamo che non siano stati osservati argomenti per l'utente prima dell'epoca 1.
• L'utente visita l'app Greenhouse e i chiamanti A e B effettuano una chiamata all'API Topics per registrare la visita dell'utente alla pagina o all'app (consulta la guida all'implementazione suggerita in Passaggi successivi per scoprire come chiamare l'API Topics). Questo record (un nome host o dati dell'app) viene successivamente utilizzato per ricavare gli argomenti di interesse. In un secondo momento, l'API Topics contrassegnerà l'argomento Home & Garden come osservato da entrambi i chiamanti A e B.
• L'utente visita l'app Esercizi di tennis. Solo il chiamante B invia una richiesta all'API Topics. In un secondo momento, l'API Topics contrassegnerà l'argomento Sports/Tennis come osservato dal chiamante B.
• Al termine del periodo, l'API Topics aggiorna gli argomenti principali dell'utente e determina i chiamanti che li hanno osservati in base all'attività utente.
• In un secondo momento, quando l'utente chiamante B effettua un'altra chiamata all'API Topics, può ottenere l'argomento Home & Garden o Sports/Tennis (o, con una probabilità del 5%, un argomento casuale) per questo utente nell'array di risposta.
• Il chiamante A può accedere solo all'argomento Home & Garden, in quanto non ha mai osservato l'argomento Sports/Tennis. Ciò significa che una terza parte verrà a conoscenza dell'argomento di interesse di un utente solo nel contesto specifico (app o sito web) in cui è presente.

Nota: gli argomenti sono specifici per ciascun dispositivo dell'utente (e per i client di Chrome), e queste informazioni vengono memorizzate localmente e non condivise tra i dispositivi. Se un utente ha più dispositivi e tende a consumare tipi diversi di contenuti su ciascuno, gli argomenti potrebbero essere diversi su ogni dispositivo.

L'API Topics contrassegna gli argomenti osservati solo dai chiamanti che sono presenti nel contesto di questi argomenti. I chiamanti potranno accedere solo agli argomenti che hanno osservato.

Argomenti derivati

Topics ricava gli argomenti di interesse dall'attività utente. Gli argomenti vengono selezionati da una tassonomia open source predefinita. Una volta per epoca, Topics aggiorna i cinque argomenti principali dell'utente e i chiamanti che li hanno osservati durante l'epoca. Il modello di classificatore di Topics ricava gli argomenti dall'attività utente: nome host per una visita alla pagina web, informazioni sull'app su Android.

Nota: l'API Topics include gli argomenti principali come se fossero stati osservati. Ad esempio, se un chiamante ha osservato /Autos & Vehicles/Motor Vehicles (By Type)/Hatchbacks, Topics lo considera anche come se avesse osservato Autos & Vehicles e Motor Vehicles.

Chiama accede agli argomenti di interesse dell'utente

L'API restituisce solo gli argomenti che sono stati osservati dal chiamante nei tre periodi più recenti. A un chiamante possono essere restituiti un massimo di tre argomenti,uno per ciascuna delle tre epoche recenti (se il chiamante ha osservato argomenti per quell'epoca). Gli argomenti restituiti possono essere utilizzati dall'utente chiamante per integrare eventuali informazioni contestuali e possono essere combinati per contribuire a trovare un annuncio più pertinente per l'utente.

Epoche

L'API Topics deve garantire che gli argomenti di interesse forniti siano sempre aggiornati. Gli argomenti vengono dedotti per un utente in base alla sua attività durante un periodo di tempo noto come epoca, una settimana per impostazione predefinita. Ogni utente ha le proprie epoche (le epoche sono "per utente") e l'ora di inizio iniziale è casuale.

Una volta per ogni epoca, l'API Topics calcola i cinque argomenti principali dell'utente e determina quali chiamanti li hanno osservati utilizzando le informazioni sul dispositivo. L'argomento selezionato per ogni epoca viene selezionato in modo casuale tra i cinque argomenti principali dall'utente per il periodo di tempo in questione. Per aumentare ulteriormente la privacy e garantire che possano essere rappresentati tutti gli argomenti, esiste una probabilità del 5% che un argomento venga selezionato casualmente da tutti gli argomenti possibili presenti nella tassonomia degli interessi.

Argomenti sul web nella pratica

Sul web, gli argomenti vengono dedotti dagli hostname delle pagine visitate dall'utente. Ad esempio, l'argomento dedotto per il sito web dogs.example potrebbe essere /Animali e animali domestici/Animali domestici/Cani.

Il seguente diagramma mostra un esempio semplificato che dimostra in che modo l'API Topics può aiutare una piattaforma di tecnologia pubblicitaria a selezionare un annuncio appropriato. L'esempio presuppone che il browser dell'utente abbia già un modello per mappare i nomi host dei siti web agli argomenti.

Il diagramma del ciclo di vita dell'API Topics illustra le fasi delle azioni dell'API da un punto di vista generale.

Il browser determina l'origine del chiamante dal contesto del codice che chiama l'API Topics. In pratica, ciò significa che gli utenti di Topics chiamano l'API in un iframe dalla loro origine o includono gli argomenti in un recupero alla loro origine.

Ad esempio, una supply-side platform (SSP) può essere incorporata su più siti di publisher. L'SSP potrebbe quindi chiamare l'API Topics all'interno di un iframe dalla sua origine, consentendo di osservare gli argomenti associati a un utente sui siti di questi publisher. Questi argomenti potrebbero poi essere condivisi con una Demand-Side Platform (DSP) per aiutarla a selezionare un annuncio pertinente per l'utente.

Nota: le SSP possono ricevere Topics associati ai loro publisher. Le DSP possono ricevere gli argomenti associati ai propri inserzionisti se rilevano argomenti sui siti web degli inserzionisti visitati dagli utenti. Poiché le SSP sono presenti solo lato publisher, le DSP potrebbero voler condividere gli argomenti osservati sui siti degli inserzionisti con le SSP partner. A tal fine, chiamando fetch() con l'intestazione degli argomenti per le SSP. In cambio, la SSP può trasmettere questi argomenti alla DSP al momento dell'asta.

In che modo l'API decide quali chiamanti vedono quali argomenti

I chiamanti dell'API ricevono soltanto gli argomenti che hanno osservato di recente e gli argomenti per un utente vengono aggiornati una volta per ogni periodo: un intervallo di tempo impostato su una settimana nell'implementazione di Chrome. Ciò significa che l'API fornisce una finestra temporale in cui un determinato chiamante può ricevere gli argomenti osservati.

La tabella seguente illustra un esempio (sebbene non realisticamente piccolo) di una cronologia di navigazione ipotetica per un utente durante un singolo periodo, che mostra gli argomenti associati ai siti visitati e i chiamanti dell'API presenti su ogni sito (le entità che chiamano document.browsingTopics() nel codice JavaScript incluso nel sito).

Sito	Argomenti	Chiama dell'API sul sito
running.example	Running & Walking Athletic Shoes	adtech1.example adtech2.example
dogs.example	Dogs	adtech1.example
holiday.example	Hotels & Accommodations	adtech2.example
sunglasses.example	Sunglasses	[none]

Alla fine del periodo (per impostazione predefinita una settimana), l'API Topics genera gli argomenti più apprezzati del browser per la settimana.

• adtech1.example può ora ricevere gli argomenti Running & Walking, Athletic Shoes e Dogs perché li ha osservati su running.example e anche su dogs.example.
• adtech1.example non è idoneo a ricevere l'argomento Hotels & Accommodations per questo utente perché non è presente su alcun sito visitato di recente dall'utente e associato all'argomento.
• adtech2.example ha visto gli argomenti Running & Walking, Athletic Shoes e Hotels & Accommodations, ma non l'argomento Dogs.

L'utente ha visitato sunglasses.example, che ha l'argomento Sunglasses, ma per questo sito non ci sono state chiamate all'API Topics. Ciò significa che l'argomento Sunglasses non verrebbe restituito dall'API per alcun chiamante.

Nella seconda settimana, l'utente visita un altro sito:

Sito	Argomenti	Chiama dell'API sul sito
cameras.example	Camera & Photo Equipment	adtech2.example

Inoltre, il codice di adtech2.example viene aggiunto a sunglasses.example:

Sito	Argomenti	Chiama dell'API sul sito
sunglasses.example	Sunglasses	adtech2.example

Oltre a Running & Walking, Athletic Shoes e Hotels & Accommodations della settimana 1, adtech2.example potrà ora ricevere gli argomenti Camera & Photo Equipment e Sunglasses, ma soltanto nel periodo successivo, ossia la settimana 3. In questo modo le terze parti non possono apprendere maggiori informazioni sul passato di un utente (in questo caso un interesse per la moda) rispetto a quelle che apprenderebbero con i cookie.

Dopo altre due settimane, Running & Walking, Athletic Shoes e Hotels & Accommodations potrebbero scomparire dall'elenco di argomenti idonei di adtech2.example, se l'utente non visita siti con questi argomenti contenenti codice di adtech2.example.

In che modo l'API osserva e accede agli argomenti.

Modello di classificazione

Topics utilizza un modello di classificatore che mappa i nomi host dei siti web a zero o più argomenti (l'analisi di informazioni aggiuntive, come gli URL completi o i contenuti delle pagine, potrebbe consentire la visualizzazione di annunci più pertinenti, ma potrebbe anche ridurre la privacy).

Tassonomia

Gli argomenti vengono selezionati da una tassonomia. Questi argomenti sono stati selezionati da Chrome, con l'obiettivo di far diventare la tassonomia una risorsa gestita da collaboratori fidati dell'ecosistema. La tassonomia deve essere abbastanza piccola da associare i browser di molti utenti a ogni argomento. L'obiettivo finale è che la tassonomia provenga da una terza parte che incorpori feedback e idee provenienti da tutto il settore.

Per evitare categorie sensibili, gli argomenti devono essere pubblici, selezionati da persone fisiche ed essere sempre aggiornati. La tassonomia utilizzata da Chrome è stata selezionata da persone fisiche per escludere categorie considerate generalmente sensibili, come etnia o orientamento sessuale.

Classificazione degli argomenti

Gli argomenti vengono selezionati manualmente per i 50.000 siti principali e questo elenco di override selezionato di nomi host e argomenti viene utilizzato per addestrare il modello del classificatore. Per i siti principali, gli argomenti vengono visualizzati dall'elenco di override anziché utilizzando il modello di classificazione. Puoi visualizzare l'elenco delle sostituzioni localmente sul tuo computer.

Il riquadro Classificatore della pagina chrome://topics-internals elenca la versione del modello, il relativo percorso e gli argomenti associati a ogni host elencato.

L'implementazione dell'API Topics di Chrome scarica un file TensorFlow Lite che rappresenta il modello in modo che possa essere utilizzato localmente sul dispositivo dell'utente.

Come vengono selezionati i cinque argomenti più apprezzati dall'utente

L'API restituisce un argomento per ogni periodo, fino a un massimo di tre. Se vengono restituiti tre argomenti, sono inclusi gli argomenti relativi al periodo corrente e ai due precedenti.

1. Alla fine di ogni periodo, il browser compila un elenco di pagine che soddisfano i seguenti criteri:
   • La pagina è stata visitata dall'utente durante il periodo in questione.
   • La pagina include codice che chiama document.browsingTopics().
   • L'API è stata attivata (ad esempio, non è stata bloccata dall'utente o da un'intestazione della risposta).
2. Il browser sul dispositivo dell'utente utilizza il modello del classificatore fornito dall'API Topics per mappare il nome host di ogni pagina a un elenco di argomenti.

3. Il browser genera un elenco dei cinque argomenti più apprezzati.

   • Ciascuno dei 22 argomenti principali della tassonomia è assegnato a un bucket "utilità elevata" o "utilità standard" in base al feedback dell'ecosistema pubblicitario. Il browser ordina prima gli argomenti in base all'assegnazione ai bucket. Tutti gli argomenti discendenti ereditano l'assegnazione del bucket dell'argomento principale padre. Gli argomenti "Utilità elevata" hanno la priorità.
   • Il browser ordina quindi gli argomenti in base alla frequenza all'interno di ciascun bucket.
   • I cinque argomenti principali di questo elenco ordinato vengono selezionati come argomenti principali dell'utente per l'epoca in questione.

Il metodo document.browsingTopics() restituisce poi un argomento casuale tra i cinque più apprezzati di ogni periodo, con una probabilità del 5% che ognuno di questi possa essere scelto in modo casuale dalla tassonomia completa di argomenti. In Chrome, gli utenti possono anche rimuovere singoli argomenti o cancellare la cronologia di navigazione per ridurre il numero di argomenti restituiti dall'API. Gli utenti possono anche disattivare l'API.

Puoi visualizzare le informazioni sugli argomenti osservati durante l'epoca corrente dalla pagina chrome://topics-internals.

Passaggi successivi

Configurazione

Prepara l'ambiente per testare e sviluppare applicazioni web con l'API Topics.

Implementa Topics

Dai un'occhiata ai dettagli di implementazione e agli esempi di codice che i chiamanti potranno osservare e accedere agli argomenti.

Vedi anche

Consulta le nostre risorse per comprendere meglio l'API Topics sul web.

• Dai un'occhiata a demo, collaborazioni e video tutorial su Topics.
• Consulta l'elenco di flag di Chrome che consentono agli sviluppatori di personalizzare l'API Topics per i test.
• Scopri in che modo utenti e sviluppatori possono controllare l'API.
• Consulta le risorse per spiegazioni e assistenza tecnica. Fai domande, interagisci e condividi feedback.