Saiba mais sobre as ferramentas disponíveis no Chrome para conferir informações da API Topics, entender como os temas são atribuídos e depurar sua implementação.
Conferir informações da API Topics
A página chrome://topics-internals está disponível no Chrome no computador depois que você ativa a API Topics. São exibidos tópicos para o usuário atual, tópicos inferidos para nomes de host e informações técnicas sobre a implementação da API. Estamos iterando e melhorando o design da página com base no feedback dos desenvolvedores. Você pode moldar a API Topics enviando seu feedback como um bug do Chromium.
Conferir os tópicos observados no seu navegador
Os usuários podem conferir informações sobre os temas observados no navegador durante as épocas atuais e anteriores em chrome://topics-internals.
chrome://topics-internals mostra IDs, atribuições de temas aleatórios e reais, além de versões de taxonomia e modelo.Esta captura de tela mostra que os sites visitados recentemente incluem topics-demo-cats.glitch.me e cats-cats-cats-cats.glitch.me. Isso faz com que a API Topics selecione Pets e Cats como dois dos principais temas da época atual. Os três temas restantes foram escolhidos aleatoriamente, já que não há histórico de navegação suficiente (em sites que observam temas) para fornecer cinco temas.
A coluna Domínios de contexto observados (com hash) fornece o valor em hash de um nome do host para o qual um tópico foi observado.
Conferir os tópicos inferidos para nomes de host
Também é possível visualizar os temas inferidos pelo modelo de classificador da API Topics para um ou mais nomes de host em chrome://topics-internals.
chrome://topics-internals mostra os tópicos selecionados, os hosts visitados, a versão do modelo e o caminho.A implementação atual da API Topics infere temas apenas com base em nomes de host. de qualquer outra parte de um URL.
Use somente nomes de host (sem protocolo ou caminho) para ver os tópicos inferidos do classificador chrome://topics-internals. chrome://topics-internals exibirá um erro se você tentar incluir um "/" no campo Host.
Conferir informações da API Topics
Confira informações sobre a implementação e as configurações da API Topics, como a versão da taxonomia e a duração da época, em chrome://topics-internals. Esses valores refletem as configurações padrão da API ou os parâmetros definidos na linha de comando. Isso pode ser útil para confirmar se as sinalizações de linha de comando funcionaram conforme o esperado.
No exemplo, time_period_per_epoch foi definido como 15 segundos (o padrão é sete dias).
chrome://topics-internals "Recursos e parâmetros" mostra os recursos ativados, o tempo por época, o número de períodos usados para calcular os temas, a versão da taxonomia e outras configurações.Os parâmetros mostrados na captura de tela correspondem às sinalizações que podem ser definidas ao executar o Chrome na linha de comando. Saiba mais sobre como controlar a API Topics com sinalizações do Chrome na seção de configuração dedicada.
--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting
Colab
Execute o Colab para aprender a carregar o modelo do TensorFlow Lite usado pelo Chrome para inferir tópicos de nomes de host. Veja as instruções na descrição do Colab ou no tutorial em vídeo. Este Colab usa a versão antiga da taxonomia.
Usar a API Topics em sites com prebid.js
Conforme observado na versão do Prebid 7, a comunidade desenvolveu ativamente uma integração com a API Topics usando um novo módulo. Este módulo foi mesclado em dezembro de 2022. Leia a documentação do módulo da API Topics do Prebid. Para mais informações sobre a integração, entre em contato com a Prebid.js pelo canal padrão oferecido.
Next steps
Control & transparency
Support
See also
Check out our resources to better understand the Topics API on the Web.
- Check out Topics demos, collab and walkthrough videos.
- See the list of Chrome flags that allow developers to customize the Topics API for testing.
- See how users and developers can control the API.
- Check out the resources for technical explainers and support. Ask questions, engage and share feedback.