Testes facilitados pelo Chrome

Em preparação para a descontinuação dos cookies de terceiros, vamos disponibilizar modos de teste facilitados pelo Chrome que permitem conferir o comportamento e a funcionalidade dos sites sem esses cookies. Este guia apresenta uma visão geral dos modos de teste que o Chrome planeja oferecer e como acessar os rótulos de grupo experimental.

Navegador Chrome, neste contexto, se refere a um cliente do Chrome: uma instalação do Chrome em um dispositivo. Os dados de cada usuário diretório constitui um cliente distinto.

Grupo experimental: um conjunto de navegadores Chrome que inclui determinados recursos estejam ativados, desativados ou configurados. No contexto de testes facilitados pelo Chrome, um conjunto de navegadores para os quais os rótulos são definidos.

Rótulo: neste contexto, um valor de cabeçalho de solicitação definido para um navegador que pertence a um grupo experimental. Cada navegador de um grupo experimental vai permanecer no mesmo grupo durante todo o período. durante os testes facilitados pelo Chrome, garantindo que o rótulo navegador permanece consistente entre os testadores.

Oferecemos dois modos distintos:

• Modo A: desde novembro de 2023, as organizações que testam as APIs R&M do Sandbox de privacidade podem ativar o recebimento de rótulos consistentes em um subconjunto de navegadores Chrome para permitir testes coordenados entre diferentes testadores.
• Modo B: a partir de 4 de janeiro de 2024, o Chrome desativou globalmente os cookies de terceiros para uma parte dos navegadores Chrome.

Onde estão os cookies de terceiros desativadas no modo B, elas permanecerão desativadas durante toda a fase cookies de terceiros.

Trabalhamos com a CMA para garantir que esses modos de teste estejam alinhados ao framework (e cronograma) de testes de terceiros, conforme definido nas orientações sobre testes do setor. Como resultado, a CMA espera que os resultados dos testes nesses modos possam ser usados na avaliação do Sandbox de privacidade. A CMA indicou que provavelmente vai dar mais importância aos resultados do Design Experimental 2, que usa os rótulos do Modo B e do controle 1 do Modo A. Consulte a Orientação da CMA para 26 de outubro para mais informações sobre o Projeto Experimental 2.

Os rótulos podem ser acessados usando o valor Sec-Cookie-Deprecation temporário disponível. de um cabeçalho HTTP ou da API JavaScript. Para detalhes de implementação, consulte a Acessar rótulos usando o valor Sec-Cookie-Deprecation nesta seção.

Também vamos enviar essa proposta pelo processo de desenvolvimento do Blink, em que o design técnico e o marco de lançamento do Chrome serão finalizados. Essa é a implementação que gostaríamos de lançar, mas outras discussões e aprovações significam que esses detalhes ainda estão sujeitos a mudanças. Vamos continuar para atualizar a página à medida que os planos avançam, e você pode continuar enviar feedback ou fazer perguntas.

Modo A: grupos de navegadores rotulados

As organizações participantes dos testes poderão ativar o recebimento de um de rótulos persistentes para um subconjunto de navegadores Chrome, possibilitando experimentos coordenados em diferentes adtechs no mesmo conjunto de navegadores. Por exemplo, se um navegador estiver no grupo de experimentos label_only_3 (conforme mostrado na tabela a seguir), todas as adtechs participantes vão poder acessar o mesmo rótulo label_only_3 e fazer a coordenação de forma adequada: use as APIs R&M do PS, mas não use cookies de terceiros. Esperamos que os participantes da página garantam que os rótulos sejam encaminhados a outros participantes para permitir a experimentação consistente em todo o processo de seleção e medição de anúncios.

Por exemplo, isso permite que vários participantes executem API Protected Audience leilões sem cookies de terceiros em um grupo consistente de navegadores. Os participantes do leilão do vendedor encaminhariam o rótulo observado aos compradores para facilitar os testes coordenados.

Os rótulos não afetam nenhum comportamento nessas instâncias do Chrome, incluindo a disponibilidade de cookies de terceiros. Os rótulos dão agrupamento para experimentos independentes e coordenados, mas isso depende dos partes participantes para aplicar os parâmetros relevantes para o experimento. Se você estiver testando o efeito da remoção de cookies de terceiros, cada participante será responsável por excluir os dados de cookies de terceiros para navegadores com esse rótulo.

O objetivo é ter grupos que representem o tráfego normal do Chrome. Isso significa que cookies de terceiros e as APIs PS R&M devem estar disponíveis, embora parte dos usuários pode ter usado configurações ou extensões para alterar ou desativar atributos de machine learning.

Os rótulos geralmente são persistentes durante toda a sessão de navegação no Chrome. entre sessões. No entanto, isso não é garantido, já que há casos raros em que a redefinição completa de um navegador também pode redefinir o rótulo atual.

Planejamos incluir 8,5% dos navegadores Chrome Stable no Modo A, e nossa proposta inicial divide essa população em nove grupos. Os subgrupos menores foram criados para permitir que as adtechs tenham flexibilidade ao combinar rótulos para criar próprios experimentos de tamanhos variados. Os grupos não se sobrepõem.

Os rótulos control_1.* foram criados para serem usados como "Controle 1" quando descritos na documentação da CMA, orientações sobre testes do setor, para que os participantes do teste não usem a API Topics nem executem públicos-alvo protegidos. para esse tráfego. Como os marcadores não afetam o comportamento do navegador, os participantes não podem passar em temas observados nem realizar leilões com Protected Audience quando detectam os rótulos do grupo control_1.*.

Aceitamos comentários de saber se essa seleção de grupos atende às necessidades organizações.

Os grupos de navegadores label_only_ do Modo A estão disponíveis desde novembro de 2023, e os grupos control_1_* do Modo A foram disponibilizados a partir de 4 de janeiro de 2024.

Modo B: desativar 1% dos cookies de terceiros

O Chrome desativou cookies de terceiros para aproximadamente 1% dos navegadores Chrome estáveis a partir de 4 de janeiro de 2024 (e também nos navegadores de desenvolvedor, Canary e Beta no quarto trimestre de 2023). As organizações que testam as APIs R&M do PS não precisam ativar esse modo, já que ele é aplicado de forma uniforme em toda a população de navegadores. Alguns recursos do site podem ser afetados se ele ainda não tiver adotado uma solução alternativa, como CHIPS ou conjuntos de sites relacionados.

Além disso, planejamos fornecer uma pequena fração do tráfego no Modo B que tem APIs de R&M do PS desativadas. Outras APIs, como conjuntos de sites relacionados, CHIPS e O FedCM não será desativado. Prevemos que essa combinação será útil para estabelecer um valor de referência de desempenho para navegadores sem cookies de terceiros e sem as APIs R&M do PS.

Como parte do Modo B, também oferecemos rótulos para os navegadores afetados. O os rótulos ficam disponíveis ao mesmo tempo que as APIs são desativadas. Estamos propondo dividir a população em três grupos treatment_1.* em que os cookies de terceiros estão desativados, mas as APIs PS R&M estão disponíveis, e um grupo control_2 em que ambos os cookies de terceiros e as APIs PS R&M estão desativados.

Ajudar na depuração da API Attribution Reporting e da agregação particular integrações de API e ajudar os participantes do teste a entender melhor o ruído impacto, os relatórios de depuração de ARA e de depuração de agregação privada vão ainda estão disponíveis para navegadores no modo B, desde que o usuário não tenha cookies de terceiros explicitamente bloqueados. Os relatórios de depuração não vão estar disponíveis nos seguintes países: control_2, já que as APIs PS R&M não estão disponíveis nessa fração. Os relatórios de depuração ainda serão desativados junto com o encerramento do uso de cookies de terceiros.

• Na API Attribution Reporting, como os cookies de terceiros estão desativados, a origem do relatório não vai conseguir definir o cookie ar_debug e vai precisar definir os campos debug_key (para relatórios de atribuição concluída) e debug_reporting (para relatórios detalhados) para ativar ou desativar o recebimento de relatórios de depuração.
• Para a API Private Aggregate, a origem do relatório precisa se basear na chamada enableDebugMode() para controlar a ativação do recebimento de relatórios de depuração. As empresas precisam continuar considerando como as obrigações regulatórias podem ser aplicadas ao uso da API Attribution Reporting e da API Private Aggregation, incluindo relatórios de depuração.

O Modo A continua sendo executado, e esses grupos são diferentes dos grupos do Modo A, já que um usuário está no Modo A, no Modo B ou em nenhum dos dois. Testar participantes precisa usar o tráfego control_1.* como um grupo de controle que representa o status quo com cookies de terceiros.

O Chrome também restringiu os cookies para 20% dos clientes Canary, de Desenvolvedor e Beta.

A inclusão em um desses grupos experimentais terá o mesmo efeito que os equivalentes estáveis.

Assim como no modo A, não há garantia de que as APIs PS R&M estarão disponíveis, pois os usuários podem desativá-las nas configurações de Privacidade e segurança do Chrome. Da mesma forma, não há garantia de que os cookies de terceiros serão desativados para todos os membros da control_2, já que os usuários podem acessar a interface do navegador para permitir que terceiros os cookies de um site.

Monitoramento de experimentos

Monitore o volume de tráfego relativo de cada tratamento e controle rótulo. O treatment_1.1 precisa ter aproximadamente a mesma quantidade de tráfego que treatment_1.2 e treatment_1.3.

Recomendamos usar a discrição em relação ao tráfego com rótulos provenientes de versões do Chrome anteriores à 120. Se sua equipe que normalmente lida o tráfego inválido identifica user agents que têm características de tráfego, faria sentido filtrá-los dos resultados do teste.

Rótulos antes do período

Até janeiro de 2024, usamos pré-períodos para vários grupos experimentais. Essas conversões antes do período vezes, o Chrome conseguiu dimensionar e selecionar estatisticamente grupos imparciais. Esses períodos anteriores foram executados para todos os grupos que foram programados para começar em janeiro: os grupos Modo B e Control_1.*. Não é necessário para ações no site ou no desenvolvedor aqui. Esses grupos pré-período não terão nenhuma no comportamento ou na disponibilidade da API, mas você pode ver um rótulo preperiod retornado em algumas situações. Embora os navegadores que recebem o O rótulo preperiod pode fazer a transição para um dos grupos experimentais, mas ele não está é garantido, por isso recomendamos não presumir que os navegadores com esse marcador no experimento.

Um grupo experimental é um subconjunto da população em estudo. neste caso, um dos grupos rotulados.

Acessar rótulos usando o valor "Sec-Cookie-deprecation"

Durante o Modo A e o Modo B, introduzimos um valor Sec-Cookie-Deprecation temporário acessível usando um cabeçalho HTTP de ativação e uma API JavaScript, que fornece o rótulo para o grupo de experimentos do Modo A ou B aplicável do navegador (conforme definido pelas porcentagens acima), se ele se enquadra em um deles.

O acesso aos marcadores envolve o acesso às informações armazenadas no dispositivo do usuário. Em algumas jurisdições (como UE e Reino Unido), entendemos que essa atividade é semelhante ao uso de cookies e, portanto, o acesso a rótulos provavelmente exige o consentimento do usuário. Antes de começar a solicitar rótulos, recomendamos que você busque aconselhamento jurídico para saber se essa obrigação de consentimento se aplica a você.

Acessar o cabeçalho HTTP Sec-Cookie-Deprecation

Para receber o cabeçalho de solicitação Sec-Cookie-Deprecation, um site precisa primeiro definir o cookie receive-cookie-deprecation. Esse cookie precisa usar o atributo Partitioned, o que significa que a permissão para receber o cabeçalho precisa ser feita por site de nível superior.

Por exemplo, se 3p-example.site quiser receber o cabeçalho Sec-Cookie-Deprecation nos recursos incorporados em example.com, 3p-example.site precisará definir o cookie a seguir nesse contexto.

Set-Cookie: receive-cookie-deprecation=1; Secure; HttpOnly; Path=/; SameSite=None; Partitioned;  Max-Age=15552000

Os atributos de cookie Secure, HttpOnly, SameSite e Partitioned são obrigatórios. É possível definir os atributos Domain, Path, Expires e Max-Age de acordo com suas necessidades, embora Path=/ seja um bom padrão. O exemplo define Max-Age=15552000 para que o cookie não expire antes de 180 dias.

Comece a definir o cookie receive-cookie-deprecation=1 antes do início do período de testes facilitado pelo Chrome, para garantir que navegadores em um grupo experimental incluem Sec-Cookie-Deprecation cabeçalho da solicitação assim que estiver disponível.

Por exemplo, supondo que o navegador esteja no grupo example_label_1, as sequências solicitações que incluem esse cookie também vão incluir o Sec-Cookie-Deprecation cabeçalho.

Sec-Cookie-Deprecation: example_label_1

Se o navegador não fizer parte de um grupo, o cabeçalho não será enviado. Os rótulos são vinculados à presença do cookie. Portanto, se o cookie for excluído, totalmente bloqueados ou bloqueados para o site específico, os marcadores não serão enviada. Como o atributo Partitioned é destinado ao uso contínuo após a descontinuação total dos cookies de terceiros, isso significa que os cookies Partitioned podem ser definidos quando os cookies de terceiros são bloqueados.

Acessar a API JavaScriptDeprecationLabel

Também é possível acessar o valor Sec-Cookie-Deprecation usando o método API navigator.cookieDeprecationLabel.getValue() JavaScript. Isso retorna uma promise que é resolvida em uma string contendo o rótulo de grupo aplicável. Por exemplo, se o navegador estivesse no grupo example_label_1:

// Feature detect temporary API first
if ('cookieDeprecationLabel' in navigator) {
 // Request value and resolve promise
 navigator.cookieDeprecationLabel.getValue().then((label) => {
   console.log(label);
   // Expected output: "example_label_1"
 });
}

Se o navegador não fizer parte de um grupo, a API não estará disponível ou o valor será uma string vazia, portanto, certifique-se de realizar a detecção de atributos.

A API JavaScript pode ser chamada independentemente da presença do receive-cookie-deprecation. No entanto, se os cookies forem completamente bloqueados ou especificamente para o site, a API vai ficar indisponível ou retornar uma string vazia.

Como acontece com qualquer valor fornecido pelo cliente, limpe e valide os do cabeçalho ou da API JavaScript antes do uso.

Demonstração e teste

A partir do Chrome 120, há flags disponíveis para ativar testes de desenvolvedores locais de solicitação e leitura dos rótulos.

Com a sinalização chrome://flags/#tpc-phase-out-facilitated-testing, ativar uma seleção de rótulos de teste. Esses rótulos têm o prefixo fake_ para diferenciar os rótulos reais. Ativar a flag não ativa o navegador em nenhum dos grupos experimentais.

Veja os marcadores em ação em goo.gle/cft-demo.

Como a inscrição é aplicada às APIs de relevância e medição do Sandbox de privacidade, pode ser necessário substituir a aplicação para testes locais usando chrome://flags/#privacy-sandbox-enrollment-overrides e fornecendo a origem da demonstração. Como alternativa, inclua a seguinte flag de linha de comando se você estiver executando o Chrome em um terminal: --args --disable-features=EnforcePrivacySandboxAttestations

O menu suspenso de sinalizações inclui várias opções. Os testadores vão estar principalmente interessados nas entradas marcadas como "Forçar", porque elas garantem que o comportamento do experimento seja ativado independentemente de outras configurações do dispositivo.

Para testar apenas os rótulos do grupo de experimentos, selecione "Ativar controle forçado 1" ou "Ativar somente rótulo forçado". Isso vai fazer com que o navegador envie os rótulos "fake_control_1.1" ou "fake_label_only_1.1".

No Chrome M120 ou mais recente, você também pode usar as seguintes entradas.

Para testar o bloqueio de cookies de terceiros, selecione "Ativação forçada do tratamento". Isso enviará "fake_treatment_1.1" rótulo do grupo experimental, além de modificar página de configurações de cookies e da configuração atual para bloquear cookies de terceiros.

Para testar o bloqueio de cookies de terceiros sem APIs de anúncios particulares, selecione "Forçar Controle 2". Isso enviará o erro "fake_control_2" rótulo do grupo experimental, atualizar na página de configurações de cookies, bloquear cookies de terceiros e também suprimir os novos APIs de anúncios particulares.

Observe que há um problema em que o navegador permanece com a nova página de configuração de cookies e da configuração que bloqueia cookies de terceiros, mesmo que você desativar a sinalização. Estamos trabalhando para corrigir esse problema. Enquanto isso, você pode testar esses valores de flag em um diretório de dados separado do Chrome iniciando Chrome com a sinalização de linha de comando --user-data-dir=<new dir>.

Feedback

Usamos o parâmetro "chrome-testing" no repositório de suporte ao desenvolvedor no GitHub para gerenciar perguntas. Aceitamos seu feedback e discussão sobre as perguntas iniciais:

• Você pretende usar o modo A, B ou ambos?
• Escolher tamanhos de rótulos para testes facilitados do Chrome
• Uso de dicas do cliente para testes facilitados pelo Chrome

Você também pode fazer novas perguntas ou discussões no repositório usando o modelo "Testes facilitados pelo Chrome".