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 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).