API Topics: ferramentas de teste e análise

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

Ver 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 ajudar a desenvolver a API Topics enviando seu feedback como um bug do Chromium.

Ver os temas observados no seu navegador

Os usuários podem conferir informações sobre os temas observados no navegador durante a época atual e as anteriores em chrome://topics-internals.

A 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 aleatórias e reais de tópicos, 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 por (hash) fornece o valor hash de um nome de host em que um tema foi observado.

Ver temas inferidos para nomes de host

Também é possível ver os temas inferidos pelo modelo classificador da API Topics em um ou mais nomes do host em chrome://topics-internals.

A página chrome://topics-internals com o painel "Classificador" selecionado.
O painel "Classificador de páginas" da 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 qualquer outra parte de um URL.

Use apenas nomes de host (sem protocolo ou caminho) para ver os temas inferidos pelo classificador chrome://topics-internals. O chrome://topics-internals vai mostrar um erro se você tentar incluir um "/" no campo "Host".

Ver informações da API Topics

Você pode encontrar 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 flags da linha de comando funcionaram conforme o esperado.

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

Página chrome://topics-internals com o painel "Recursos e parâmetros" selecionado.
O painel "Recursos e parâmetros chrome://topics-internals" mostra os recursos ativados, o tempo por época, o número de épocas usadas para calcular os temas, 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 como controlar a API Topics com as 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 saber como carregar o modelo do TensorFlow Lite usado pelo Chrome para inferir tópicos de nomes de host. As instruções estão na descrição do Colab ou no vídeo explicativo. Este Colab usa a versão antiga da taxonomia.

Usar a API Topics em sites com prebid.js

Conforme observado no lançamento da Prebid 7, a comunidade desenvolveu ativamente uma integração com a API Topics usando um novo módulo. Esse módulo foi mesclado em dezembro de 2022. Leia a documentação do módulo da API Topics da Prebid. Para mais informações sobre a integração, entre em contato com o Prebid.js pelo canal padrão oferecido.

Próximas etapas

Saiba como usuários e desenvolvedores podem gerenciar e personalizar a API Topics de acordo com as preferências e necessidades do usuário.
Confira nossos recursos para solução de problemas, suporte técnico, registro de bugs e perguntas.

Consulte também

Confira nossos recursos para entender melhor a API Topics na Web.