Um mecanismo de desativação do período de carência do teste de descontinuação de cookies de terceiros

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.