Os usuários e desenvolvedores precisam ajustar a API Topics para melhorar a relevância do conteúdo. Esta página é um guia sobre como gerenciar e personalizar a API Topics de acordo com as preferências e necessidades do usuário.
Desativar como usuário
Os usuários precisam conseguir:
- Entender a finalidade da API Topics.
- Reconhecer quais temas estão associados à atividade de navegação do usuário.
- Saiba quando a API está em uso.
- Ter controles para ativar ou desativar a API.
- Controle quais temas são compartilhados com os autores de chamadas de API.
A taxonomia legível da API Topics permite que os usuários aprendam e controlem os temas que podem ser sugeridos pelo navegador. O Chrome oferece informações e configurações da API Topics em chrome://settings/adPrivacy/interests.
O usuário pode bloquear categorias de temas que não quer compartilhar com os autores das chamadas de API das seguintes maneiras:
- Bloquear um tópico que já foi atribuído a eles pelo navegador.
- Bloquear proativamente uma categoria ampla de temas que não são do interesse deles em
chrome://settings/adPrivacy/interests/manage. Nesse caso, o usuário não precisa esperar que um tópico seja atribuído antes de bloqueá-lo.
Os temas não ficam disponíveis para autores de chamadas de API no modo de navegação anônima, e os temas são apagados quando o histórico de navegação é apagado.
A lista de temas retornada vai estar vazia nos seguintes cenários:
- O usuário desativa a API Topics nas configurações do navegador em
chrome://settings/adPrivacy/interests. - O usuário limpou os temas (nas configurações do navegador em
chrome://settings/adPrivacy/interests) ou os cookies. - O navegador está no modo de navegação anônima.
- O usuário bloqueia todos os temas possíveis.
A explicação fornece mais detalhes sobre as metas de privacidade e como a API tenta alcançá-las.
Desativar como desenvolvedor
Para desativar o cálculo de temas em páginas específicas do site, inclua o cabeçalho Permissions-Policy: browsing-topics=() Permissions-Policy em uma página para impedir o cálculo de temas para todos os usuários da página. As visitas subsequentes a outras páginas do site não serão afetadas: se você definir uma política para bloquear a API Topics em uma página, isso não vai afetar outras páginas.
Também é possível controlar quais terceiros têm acesso aos tópicos na sua página usando o cabeçalho Permissions-Policy para controlar o acesso de terceiros à API Topics. Como parâmetros do cabeçalho, use self e todos os domínios que você quer permitir o acesso à API. Por exemplo, para desativar completamente o uso da API Topics em todos os contextos de navegação, exceto na sua própria origem e https://example.com, defina o seguinte cabeçalho de resposta HTTP:
Permissions-Policy: browsing-topics=(self "https://example.com")
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.