Prepara il tuo ambiente per utilizzare, testare e sviluppare applicazioni web con l'API Topics.
Crea build ed esegui test 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 procedere con l'implementazione.
Attivare l'API Topics nel browser
Per attivare l'API Topics nella tua istanza di Chrome per i test locali, hai due opzioni:
- Abilita tutte le API per la privacy degli annunci in
chrome://settings/adPrivacy. - (Consigliato) Esegui Chrome dalla riga di comando con i flag di Chromium utilizzando i parametri specifici dell'API Topics per 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 (il periodo di tempo utilizzato dall'API per calcolare gli interessi degli utenti) e configurare il comportamento dell'API in base alle tue esigenze.
Consigli chiave
- Assicurati di chiudere e interrompere tutti i processi di Chrome prima di avviarne uno nuovo utilizzando i flag.
- Assicurati che tutte le API per la privacy degli annunci siano abilitate in
chrome://settings/adPrivacy. - Se l'API non funziona come previsto, prova i nostri suggerimenti per la risoluzione dei problemi.
- In caso di domande, consulta le segnalazioni su GitHub relative alla 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 delle intestazioni 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 descrive ogni parametro, il relativo valore predefinito e il relativo scopo.
| Nome del contrassegno | Valore predefinito | Descrizione |
|---|---|---|
BrowsingTopics |
attivato | Indica se l'API Topics è abilitata. |
PrivacySandboxAdsAPIsOverride |
attivato | Attiva le API per gli annunci: Attribution Reporting, Protected Audience, Topics, Fenced Frame. |
PrivacySandboxSettings4 |
disabilitato | Attiva la quarta release delle impostazioni dell'interfaccia utente di Privacy Sandbox. |
OverridePrivacySandboxSettingsLocalTesting |
attivato | Se abilitato, il browser non richiede più l'attivazione delle impostazioni sottostanti per abilitare le funzionalità di Privacy Sandbox. |
BrowsingTopicsBypassIPIsPubliclyRoutableCheck |
disabilitato | Se attivata, la verifica dell'instradabilità pubblica dell'indirizzo IP verrà ignorata durante la determinazione dell'idoneità di una pagina all'inclusione nel calcolo degli argomenti. |
BrowsingTopics:number_of_epochs_to_expose |
3 | Il numero di epoche da cui calcolare gli argomenti da fornire a un contesto richiedente. 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 impostare questo valore su (ad esempio) 15 secondi, anziché sui sette giorni predefiniti. |
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 periodo sia uno restituito in modo casuale dall'intera tassonomia degli argomenti. La casualità è associata a un'epoca e a un sito. |
BrowsingTopics:number_of_epochs_of_observation_data_to_use_for_filtering |
3 | Quante epoche di dati di utilizzo dell'API (ovvero osservazioni degli 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 da conservare per ogni argomento principale. L'obiettivo è limitare la memoria in uso. |
BrowsingTopics:max_number_of_api_usage_context_entries_to_load_per_epoch |
100000 | Il numero massimo di voci che possono essere recuperate 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 l'utilizzo massimo 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. L'aggiornamento dei parametri di configurazione senza aggiornare config_version dovrebbe in genere essere sufficiente per i test locali, ma in alcune situazioni potrebbe lasciare il browser in uno stato incoerente e potrebbe causare un arresto anomalo del browser, ad esempio l'aggiornamento di number_of_top_topics_per_epoch. |
BrowsingTopics:taxonomy_version |
1 | La versione della tassonomia utilizzata dall'API. |
Prima di iniziare l'implementazione
Prima di iniziare l'implementazione, ti consigliamo di consultare queste risorse per acquisire familiarità con l'API Topics.
- Consulta la documentazione per gli sviluppatori:
- Comprendere lo scopo dell'API Topics e il suo ruolo nella pubblicità basata sugli interessi
- Scopri come funziona Topics sul web.
- Prova le demo e guarda il video dimostrativo di Topics, Colab e degli strumenti.
- Crea una fork delle demo ed eseguile dal tuo sito.
- Per saperne di più, leggi la spiegazione dell'API.
- Comprendi il ruolo dell'API nel supportare la pertinenza degli annunci in futuro, quando i cookie di terze parti non saranno disponibili per una percentuale crescente di utenti.
- Per ricevere una notifica delle modifiche di stato nell'API, iscriviti alla mailing list per gli sviluppatori e non perderti gli ultimi aggiornamenti di Topics.
- Partecipa alla conversazione sui problemi di GitHub o sulle chiamate W3C.
- Se riscontri termini sconosciuti, consulta il glossario di Privacy Sandbox.
- Per ulteriori informazioni sui concetti di Chrome, ad esempio i flag di Chrome, consulta i brevi video e gli articoli disponibili all'indirizzo goo.gle/cc.
Passaggi successivi
Implementare Topics
Consulta i dettagli di implementazione e gli esempi di codice per consentire agli utenti chiamanti di osservare e accedere agli argomenti.
Prova e pubblica
Scopri come eseguire il deployment, testare e scalare le soluzioni basate su Topics.