API Topics: ferramentas de teste e análise

Saiba mais sobre as ferramentas disponíveis no Chrome para conferir informações da API Topics e entenda como os temas são atribuídos.

Conferir informações da API Topics

A página chrome://topics-internals fica disponível no Chrome para computador depois que você ativa a API Topics. Isso mostra os temas do usuário atual, os temas 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.

Página chrome://topics-internals com o painel "Estado dos tópicos" selecionado.
O painel "Estado dos tópicos" da página chrome://topics-internals mostra IDs de tópicos, atribuições de tópicos aleatórias e reais, além de versões de modelo e taxonomia.

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 Observed-by context domains (hashed) mostra o valor do hash de um nome de host em que um tema foi observado.

Conferir os tópicos inferidos para nomes de host

Também é possível conferir os temas inferidos pelo modelo de classificador dos tópicos para um ou mais nomes de host em chrome://topics-internals.

Página chrome://topics-internals com o painel "Classificador" selecionado.
O painel do classificador da página chrome://topics-internals mostra os tópicos selecionados, os hosts visitados e a versão e o caminho do modelo.

A implementação atual da API Topics infere temas apenas de nomes de host, e não de nenhuma outra parte de um URL.

Use apenas nomes de host (sem protocolo ou caminho) para conferir os tópicos inferidos do classificador chrome://topics-internals. chrome://topics-internals vai mostrar 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 dos parâmetros definidos na linha de comando. Isso pode ser útil para confirmar se as flags de linha de comando funcionaram conforme o esperado.

No exemplo, time_period_per_epoch foi definido como 15 segundos (o padrão é sete dias).

Página chrome://topics-internals com o painel "Recursos e parâmetros" selecionado.
O painel chrome://topics-internals Recursos e parâmetros mostra os recursos ativados, o tempo por época, o número de épocas a serem usadas para calcular tópicos, a versão da taxonomia e outras configurações.

Os parâmetros mostrados na captura de tela correspondem a flags que podem ser definidas ao executar o Chrome na linha de comando. Saiba mais sobre como controlar a API Topics com flags 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. Você vai encontrar as instruções na descrição do colab ou no vídeo de instruções. Observe que este colab usa a versão antiga da taxonomia.

Usar a API Topics em sites com o 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

Learn how users and developers can manage and customize the Topics API to suit user's preferences and needs.
Check out our resources for troubleshooting, technical support, filing bugs and asking questions.

See also

Check out our resources to better understand the Topics API on the Web.