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 di tecnologia pubblicitaria) 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 leggibile per l'utente corrente 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 nelle ultime tre epoche.
• Un'epoca è un periodo di calcolo degli argomenti, che per impostazione predefinita è di 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 dedurre 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.

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.

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 dal 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 scelto in modo casuale tra i cinque argomenti principali dell'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 dai nomi host delle pagine visitate dall'utente. Ad esempio, l'argomento dedotto per il sito web cani.example potrebbe essere /Animali e animali domestici/Animali domestici/Cani.

Il seguente diagramma mostra un esempio semplificato per dimostrare 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 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.

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 seguente tabella mostra un esempio (anche se irrealisticamente piccolo) di una cronologia di navigazione ipotetica per un utente durante un singolo periodo, che mostra gli argomenti associati ai siti che ha visitato e i chiamanti dell'API presenti su ogni sito (le entità che chiamano document.browsingTopics() nel codice JavaScript incluso nel sito).

Sito	Argomenti	Chiamanti 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	[nessuno]

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

• adtech1.example ora può ricevere gli argomenti Running & Walking, Athletic Shoes e Dogs, perché li ha osservati su running.example e anche su dogs.example.
• adtech1.example non può ricevere l'argomento Hotels & Accommodations per l'utente in questione 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	Chiamanti dell'API sul sito
cameras.example	Camera & Photo Equipment	adtech2.example

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

Sito	Argomenti	Chiamanti 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 tali argomenti contenenti codice di adtech2.example.

Modello di classificazione

Topics utilizza un modello di classificatore che mappa i nomi host dei siti web a nessun argomento o a 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 sufficientemente piccola da consentire l'associazione dei 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 e rimanere aggiornati. La tassonomia utilizzata da Chrome è stata selezionata da persone fisiche per escludere categorie generalmente considerate sensibili, come orientamento sessuale o etnia.

Classificazione degli argomenti

Gli argomenti vengono selezionati manualmente per 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 accessibili dall'elenco di override anziché utilizzando il modello di classificazione. Puoi visualizzare l'elenco di override localmente sul tuo computer.

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 viene assegnato a un bucket "di utilità elevata" o "di utilità standard" in base al feedback dell'ecosistema pubblicitario. Il browser ordina innanzitutto gli argomenti in base all'assegnazione del bucket. Tutti gli argomenti secondari ereditano l'assegnazione del bucket dell'argomento principale. Viene data la priorità agli argomenti di "utilità elevata".
   • Il browser ordina quindi gli argomenti per frequenza all'interno di ogni bucket.
   • I primi cinque argomenti di questo elenco ordinato vengono selezionati come argomenti principali dell'utente per quell'epoca.

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 attuale nella pagina chrome://topics-internals.

Passaggi successivi

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.