Para sites que participam de um dos testes de descontinuação de cookies de terceiros, o Chrome oferece um período de carência para reativar temporariamente os cookies de terceiros. Durante esse período, os sites podem acessar cookies de terceiros no Chrome, mesmo que ainda não tenham implantado os tokens de teste.
O Chrome também oferece um mecanismo para permitir que os sites desativem o período de carência para uma porcentagem dos usuários. O mecanismo de recusa permitirá que os sites executem os próprios lançamentos graduais para ajudá-los a deixar de depender do período de carência, a fim de testar a implantação do token de teste de descontinuação e avançar para soluções de longo prazo.
Por que os desenvolvedores precisam do mecanismo de recusa
Quando um site ou serviço é aprovado para testes de descontinuação de próprios ou terceiros, o Chrome fornece um token de teste e inicia um período de carência para que os tokens sejam implantados. O período de carência continua em vigor até a expiração, mesmo após a implantação dos tokens. Isso pode ser problemático para testar se a implantação do token de teste de descontinuação foi bem-sucedida.
Os desenvolvedores podem definir uma sinalização do Chrome para desativar o período de carência para testar localmente a implantação do token, mas isso não é adequado para testes em grande escala. Para permitir a implantação de tokens de teste de produção nos sites, o Chrome agora oferece um mecanismo para desativar o período de carência para uma porcentagem dos usuários.
Configurar porcentagens de recusa do período de carência
Para desativar, forneça um arquivo de configuração de acesso público no diretório .well-known
do seu site em /.well-known/tpcd/grace-period.json
. O
arquivo grace-period.json
fornece porcentagens de recusa para um ou ambos os
períodos de carência do teste de descontinuação:
FirstPartyOptOutPercentage
ThirdPartyOptOutPercentage
que podem ter os valores 0, 25, 50 ou 100. Exemplo:
{
"ThirdPartyOptOutPercentage": 25
}
Testar implantação
Se você quiser aproveitar a desativação do período de carência, recomendamos começar implantando grace-period.json
assim que possível, com um valor de 0
para uma ou ambas as chaves. Isso permitirá que você valide se o Chrome está processando o arquivo como esperado, sem afetar a ativação do período de carência. Você
pode começar a aumentar a porcentagem quando estiver tudo pronto. No futuro, planejamos fornecer ferramentas para que os desenvolvedores consultem o status de ativação do período de carência para sites acessados pelo navegador.
O arquivo grace-period.json
precisa estar bem formado para entrar em vigor. Para
evitar erros, verifique seu arquivo com a
ferramenta de validação de recusa do período de carência.
Depurar o mecanismo de recusa
Os servidores do Google verificam regularmente o arquivo grace-period.json
(se houver) em cada site em que o período de carência está ativo. As porcentagens de recusa podem ser distribuídas para todos os clientes do Chrome, embora esse processo possa levar de 24 a 48 horas para ser concluído. O Chrome fornecerá uma ferramenta para que os desenvolvedores de sites possam verificar o status
da ativação do período de carência no painel "Problemas do Chrome DevTools" para entender
quando uma recusa está em vigor.
Exemplos
Exemplo de terceiros
No exemplo a seguir, third-party.example
se registrou no
teste de descontinuação de terceiros, e o período de carência foi ativado para ele.
Ele hospeda o arquivo abaixo em
third-party.example/well-known/tpcd/grace-period.json:
{
"ThirdPartyOptOutPercentage": 25
}
Com esse arquivo ativo, o período de carência será desativado para 25% dos
clientes do Chrome que acessam sites
ou serviços em third-party.example
. Para clientes do Chrome sujeitos à
Proteção antirrastreamento,
os cookies de terceiros de third-party.example
serão restritos, a menos que o
teste de descontinuação de terceiros esteja ativo.
Exemplo próprio
No exemplo a seguir, first-party.example
foi registrado no
teste de descontinuação de uso próprio, e o período de carência foi ativado para ele.
Ele hospeda o arquivo abaixo em
first-party.example/well-known/tpcd/grace-period.json:
{
"FirstPartyOptOutPercentage": 50
}
Com isso em vigor, o período de carência será desativado para 50% dos clientes do Chrome que acessarem os sites deles. Em qualquer cliente do Chrome que faça parte do grupo de Proteção antirrastreamento, os cookies de terceiros
Saiba mais
Se você tiver dúvidas sobre o mecanismo de desativação, registre um problema no repositório de suporte do Sandbox de privacidade (link em inglês).
- Explicação sobre a desativação do período de carência de cookies de terceiros
- O identificador de recurso conhecido "tpcd/grace-period.json"
- Intenção de envio: desativação do período de carência de cookies de terceiros
- Teste de descontinuação de uso próprio
- Teste de descontinuação de terceiros
- Introdução aos testes de origem
- Resolver problemas em testes de origem do Chrome
- URI conhecido
- RFC 8615: identificadores uniformes de recursos (URIs, na sigla em inglês) conhecidos