Risorse di assistenza per l'API Topics sul Web

Trova consigli per il debug, la risoluzione dei problemi e le risorse di assistenza per Topics sul web.

Risoluzione dei problemi

Se effettui una chiamata document.browsingTopics() o una richiesta fetch() con l'intestazione Sec-Browsing-Topics impostata, ma ricevi un array vuoto come risposta, puoi eseguire una serie di passaggi di debug per identificare la causa principale del problema, sia nell'ambiente di sviluppo locale sia nel sistema in produzione.

Eseguire il debug in locale

Se esegui il test localmente, assicurati di eseguire Chrome con i parametri richiesti.

  • Per bypassare la registrazione, attiva il flag chrome://flags/#privacy-sandbox-enrollment-overrides e aggiungi l'URL del sito che chiama Topics.

  • Configura l'API Topics per i test utilizzando i flag delle funzionalità. Questi flag ti consentono di modificare parametri quali la durata dell'epoca, il numero di argomenti principali e altri ancora, in modo da poter testare comodamente Topics. Puoi utilizzare questi flag di funzionalità consigliati:

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

  • Prima di eseguire Chrome con i flag, assicurati di aver chiuso tutte le altre istanze e i processi di Chrome.

  • Accertati che:

    • Stai utilizzando Chrome 101 o versioni successive.
    • Lo script ha chiamato l'API Topics per osservare gli argomenti. Durante il test, puoi simulare il comportamento degli utenti visitando i siti in cui è incorporato lo script. Per un esempio pratico, consulta la demo.
    • Non hai un adblocker o un'app o un'estensione simile in esecuzione.
    • Non sei in modalità di navigazione in incognito.
    • A partire dal giorno chrome://settings/trackingProtection, l'opzione Block all third-party cookies è disattivata.

Eseguire il debug dell'implementazione in tempo reale

Se chiami l'API Topics da un'applicazione attiva entro la prima settimana di osservazione di un utente, è previsto un risultato vuoto, poiché l'applicazione potrebbe non aver ancora osservato gli argomenti per un utente. Puoi eseguire il debug della soluzione seguendo i nostri consigli.

  • Assicurati che il tuo sito sia registrato a Privacy Sandbox.
  • Testa il codice frontend per assicurarti che JavaScript funzioni come previsto.
  • Testa il tuo backend per ricevere i risultati degli argomenti.
    • Ricorda di assicurarti che i tipi di dati e i parametri dell'API di backend siano configurati correttamente.
    • Assicurati che il backend sia configurato per scalare in modo appropriato.
  • In base alla nostra esperienza, è necessario attendere almeno tre settimane prima di iniziare a ottenere risultati più pertinenti per gli argomenti.
  • Non tutti gli utenti avranno Topics abilitato:
    • Gli utenti possono disattivare esplicitamente l'API Topics.
    • Le pagine dei publisher possono controllare le norme relative alle autorizzazioni e disattivare i loro siti.
  • Aggiungi metriche e osservabilità a questo ambiente: ti serviranno per analizzare i primi risultati. Ecco alcuni esempi di metriche:
    • Latenza delle chiamate.
    • Errori HTTP nelle chiamate agli argomenti.
  • Cerca di limitare le modifiche all'implementazione durante le tre settimane iniziali.

Risorse