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 tokens de teste.
O Chrome também oferece um mecanismo para permitir que sites desativem o período de carência para uma porcentagem de usuários. O mecanismo de desativação 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 do teste e avançar para soluções de longo prazo.
Por que os desenvolvedores precisam do mecanismo de desativação
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 haja tempo para a implantação dos tokens. 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 configurar uma sinalização do Chrome para desativar o período de carência e testar localmente a implantação do token, mas isso não é adequado para testes em escala. Para permitir a implantação de tokens de teste de produção em 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 participar da desativação, forneça um arquivo de configuração
acessível publicamente no diretório
.well-known
do seu site em /.well-known/tpcd/grace-period.json
. O
arquivo grace-period.json
fornece porcentagens de desativação para um ou ambos
os períodos de carência de teste de descontinuação:
FirstPartyOptOutPercentage
ThirdPartyOptOutPercentage
Eles podem ter valores de 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 a implantar 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 conforme esperado, sem afetar a ativação do período de carência. Quando estiver tudo pronto, aumente a porcentagem. No futuro, planejamos
fornecer ferramentas para que os desenvolvedores consultem o status de ativação do período de carência dos
sites acessados pelo navegador.
O arquivo grace-period.json
precisa ser formatado corretamente para ter efeito. Para
evitar erros, verifique seu arquivo com a
ferramenta de validação de recusa do período de carência.
Depurar o mecanismo de desativação
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 desativação poderão 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 de ativação do período de carência no painel "Problemas" do Chrome DevTools para entender quando uma desativação está em vigor.
Exemplos
Exemplo de terceiros
No exemplo a seguir, third-party.example
se registrou para o
teste de descontinuação de terceiros, e o período de carência foi ativado para eles.
Eles hospedam o seguinte arquivo em
third-party.example/well-known/tpcd/grace-period.json:
{
"ThirdPartyOptOutPercentage": 25
}
Com esse arquivo, o período de carência será desativado para 25% dos
clientes Chrome que acessam sites
ou serviços do third-party.example
. Para clientes do Chrome sujeitos à
Proteção contra rastreamento,
os cookies de terceiros do 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
se registrou para o
teste de descontinuação próprio, e o período de carência foi ativado para ele.
Eles hospedam o seguinte arquivo em
first-party.example/well-known/tpcd/grace-period.json:
{
"FirstPartyOptOutPercentage": 50
}
Com isso, o período de carência será desativado para 50% dos clientes do Chrome que acessarem o site. Para qualquer um dos clientes Chrome que fazem parte do grupo de proteção contra rastreamento, os cookies de terceiros serão
Saiba mais
Se tiver dúvidas sobre o mecanismo de recusa, registre um problema no repositório de suporte do Sandbox de privacidade.
- 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 do cookie de terceiros
- Teste de descontinuação próprio
- Teste de descontinuação de terceiros
- Começar a fazer testes de origem
- Resolver problemas de testes de origem do Chrome
- URI conhecido
- RFC 8615: identificadores uniformes de recursos (URIs) conhecidos (em inglês)