Configurazione dell'API Topics

Prepara il tuo ambiente per utilizzare, testare e sviluppare applicazioni web con l'API Topics.

Crea e testa in locale

Questa sezione descrive come configurare l'ambiente locale per provare l'API Topics come singolo sviluppatore. Ti consigliamo di esplorare le demo per capire come funziona Topics prima di approfondire l'implementazione.

Attivare Topics nel browser

Per attivare l'API Topics nella tua istanza di Chrome per i test locali, hai due opzioni:

  1. Attiva tutte le API di privacy per gli annunci in chrome://settings/adPrivacy.
  2. (Consigliato) Esegui Chrome dalla riga di comando con i flag di Chromium utilizzando i parametri specifici dell'API Topics per eseguire la configurazione in base alle esigenze. Hai un controllo più granulare sulle funzionalità di Topics eseguendo Chrome dalla riga di comando. Ad esempio, è possibile impostare le epoche di Topics (l'intervallo di tempo utilizzato dall'API per calcolare gli interessi degli utenti) e configurare il comportamento dell'API in base alle tue esigenze.

Suggerimenti chiave

  1. Assicurati di chiudere e interrompere tutte le procedure di Chrome prima di avviare il nuovo browser utilizzando i flag.
  2. Assicurati che tutte le API di privacy per gli annunci siano attivate in chrome://settings/adPrivacy.
  3. Se l'API non funziona come previsto, prova i nostri suggerimenti per la risoluzione dei problemi.
  4. Se hai domande, consulta la sezione sui problemi di GitHub per la spiegazione.

Controllare l'API Topics con i flag di Chrome

I flag di Chrome possono modificare il comportamento dell'API Topics. Esegui Chrome dalla riga di comando con i parametri specificati per facilitare i test. Ad esempio, la demo degli header consiglia di utilizzare i seguenti flag:

--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

La tabella seguente illustra ogni parametro, il relativo valore predefinito e lo scopo.

Nome della segnalazione Valore predefinito Descrizione
BrowsingTopics abilitata Indica se l'API Topics è abilitata.
PrivacySandboxAdsAPIsOverride abilitata Attiva le API Google Ads: Attribution Reporting, Protected Audience, Topics, Fenced Frames.
PrivacySandboxSettings4 disattivata Attiva la quarta release delle impostazioni dell'interfaccia utente di Privacy Sandbox.
OverridePrivacySandboxSettingsLocalTesting abilitata Se questa opzione è attiva, il browser non richiede più l'attivazione delle impostazioni sottostanti per abilitare le funzionalità di Privacy Sandbox.
BrowsingTopicsBypassIPIsPubliclyRoutableCheck disattivata Se questa opzione è attivata, il controllo dell'indirizzo IP instradabile pubblicamente verrà ignorato per determinare l'idoneità di una pagina per l'inclusione nel calcolo degli argomenti.
BrowsingTopics:number_of_epochs_to_expose 3 Il numero di epoche in cui calcolare gli argomenti da assegnare a un contesto di richiesta. Il browser manterrà internamente fino a N+1 epoche.
BrowsingTopics:time_period_per_epoch 7d-0h-0m-0s Durata di ogni epoca. Per il debug, può essere utile impostarlo su 15 secondi, anziché sul valore predefinito di sette giorni.
BrowsingTopics:number_of_top_topics_per_epoch 5 Numero di argomenti calcolati per epoca.
BrowsingTopics:use_random_topic_probability_percent 5 Probabilità che un singolo argomento all'interno di un'epoca sia quello restituito in modo casuale dall'intera tassonomia degli argomenti. La casualità è fissata a un'epoca e a un sito.
BrowsingTopics:number_of_epochs_of_observation_data_to_use_for_filtering 3 Quante epoche di dati sull'utilizzo delle API (ad es. osservazioni argomenti) verranno utilizzate per filtrare gli argomenti per un contesto di chiamata.
BrowsingTopics:max_number_of_api_usage_context_domains_to_keep_per_topic 1000 Il numero massimo di domini di contesto osservati per contesto da conservare per ogni argomento principale. L'intento è quello di limitare la memoria in uso.
BrowsingTopics:max_number_of_api_usage_context_entries_to_load_per_epoch 100000 Il numero massimo di voci che è possibile recuperare dal database per ogni query per i contesti di utilizzo dell'API. La query verrà eseguita una volta per epoca al momento del calcolo degli argomenti. L'obiettivo è limitare il picco di utilizzo della memoria.
BrowsingTopics:max_number_of_api_usage_context_domains_to_store_per_page_load 30 Il numero massimo di domini di contesto di utilizzo dell'API consentiti per caricamento di pagina.
BrowsingTopics:config_version 1 Codifica i parametri di configurazione dell'API Topics. Ogni numero di versione deve essere mappato a un solo set di configurazione. In genere, l'aggiornamento dei parametri di configurazione senza aggiornare config_version non è un problema per i test locali, ma in alcune situazioni potrebbe lasciare il browser in uno stato incoerente e causare un arresto anomalo del browser, ad esempio aggiornando number_of_top_topics_per_epoch.
BrowsingTopics:taxonomy_version 1 La versione della tassonomia utilizzata dall'API.

Prima di iniziare a implementare

Prima di iniziare l'implementazione, ti consigliamo di consultare queste risorse per acquisire familiarità con l'API Topics.

  1. Esamina la documentazione per gli sviluppatori:
    1. Comprendere lo scopo dell'API Topics e il suo ruolo nella pubblicità basata sugli interessi
    2. Scopri come funziona Topics sul web.
    3. Prova le demo e guarda il video dettagliato sulle demo, su Colab e sugli strumenti di Topics.
    4. Esegui il fork delle demo ed eseguile dal tuo sito.
    5. Leggi la spiegazione dell'API per saperne di più.
  2. Comprendere il ruolo dell'API nel supportare la pertinenza degli annunci in futuro, laddove i cookie di terze parti non saranno disponibili per una percentuale crescente di utenti.
  3. Per ricevere notifiche sui cambiamenti dello stato nell'API, iscriviti alla mailing list per gli sviluppatori e continua a seguirci per non perderti gli ultimi aggiornamenti su Topics.
  4. Contribuisci alla conversazione sui problemi di GitHub o sulle chiamate W3C.
  5. Se trovi termini non familiari, consulta il glossario di Privacy Sandbox.
  6. Per ulteriori informazioni su concetti di Chrome, come i flag di Chrome, guarda i brevi video e gli articoli disponibili all'indirizzo goo.gle/cc.

Passaggi successivi

Consulta i dettagli di implementazione e gli esempi di codice per consentire agli utenti chiamanti di osservare e accedere agli argomenti.
Scopri come eseguire il deployment, testare e scalare le soluzioni basate su Topics.