Testes facilitados pelo Chrome

Para nos prepararmos para a descontinuação dos cookies de terceiros, apresentamos Modos de teste facilitados pelo Chrome que permitem visualizar o comportamento dos sites e os recursos funcionam sem cookies de terceiros. Este guia oferece uma visão geral dos modos de teste que o Chrome planeja oferecer e como acessá-los rótulos do grupo experimental.

Navegador Chrome neste contexto se refere a um cliente Chrome: um 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 dos ambientes facilitados pelo Chrome, teste, um conjunto de navegadores para os quais são definidos marcadores.

Rótulo: neste contexto, um 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:a partir de novembro de 2023, as organizações que vão testar as APIs PS R&M optaram por receber marcadores consistentes em um subconjunto do Chrome navegadores para permitir testes coordenados entre diferentes testadores.
  • Modo B:a partir de 4 de janeiro de 2024, o Chrome será desativado globalmente 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.

Nós trabalhamos com a CMA para garantir que esses modos de teste estejam alinhados com a estrutura de teste (e cronograma) para terceiros, conforme estabelecido nos orientações sobre testes do setor. Como resultado, a CMA prevê que os resultados dos testes nesses modos pode ser usada na avaliação do Sandbox de privacidade. A CMA indicou que provavelmente colocarão mais peso nos resultados do Projeto Experimental 2, que usa os rótulos Modo B e Modo A controle 1. 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 Cookie-Deprecation temporário disponível. de um cabeçalho HTTP ou da API JavaScript. Consulte a próxima seção Como acessar rótulos usando o valor de descontinuação de cookies para conferir detalhes de implementação.

Também enviaremos essa proposta por meio do Processo de desenvolvimento do Blink, em que o projeto técnico e o marco de versão do Chrome serão finalizados. Embora esta seja a implementação que gostaríamos de enviar, outras discussões e aprovação significa que esses detalhes ainda estão sujeitos a alterações. 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 permanente para um subconjunto de navegadores Chrome, possibilitando experimentos coordenados em diferentes adtechs no mesmo conjunto de navegadores. Por exemplo, se um navegador se enquadrar no grupo experimental label_only_3 (conforme mostrados na tabela a seguir), todas as adtechs participantes vão poder veja o mesmo rótulo label_only_3 e coordene de acordo: use a propriedade R&M, mas evite usar cookies de terceiros. Esperamos que os participantes na página para garantir que os rótulos sejam encaminhados a outros participantes, a fim de permitir experimentação consistente em todo o processo de seleção de anúncios e de medida.

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

Os marcadores não afetam o 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 testar o efeito da remoção de cookies de terceiros, então cada participante é responsável por excluir dados de cookies de terceiros para navegadores com esses 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á cenários raros em que redefinir totalmente um navegador também pode redefinir o marcador atual.

Planejamos incluir 8,5% dos navegadores Chrome Stable no Modo A, e nossos a 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.

Rótulo % de tráfego estável
control_1.1 0,25
control_1.2 0,25
control_1.3 0,25
control_1.4 0,25
label_only_1 1.5
label_only_2 1.5
label_only_3 1.5
label_only_4 1.5
label_only_5 1.5

Os grupos de navegador label_only_ do modo A estão disponíveis desde novembro de 2023. Os grupos control_1_* do modo A foram disponibilizados em 4 de janeiro de 2024.

Modo B: desativar 1% dos cookies de terceiros

O Chrome desativou os cookies de terceiros em aproximadamente 1% do Chrome Stable navegadores a partir de 4 de janeiro de 2024 (e também nas versões Dev, Canary e Beta) no 4o trimestre de 2023). As organizações que testam as APIs PS R&M não precisam ativar esse modo, pois ele será aplicado de maneira uniforme em todo o navegador população. Há, claro, a possibilidade de que alguns recursos do site sejam afetados caso o site ainda não tenha 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 está com as APIs PS R&M desativadas. Outras APIs, como conjuntos de sites relacionados, CHIPS e O FedCM não será desativado. Acreditamos que essa combinação será útil para estabelecer uma linha de base de desempenho para navegadores sem cookies de terceiros e sem as APIs PS R&M.

Como parte do Modo B, também disponibilizamos marcadores para os navegadores afetados. A os rótulos ficam disponíveis ao mesmo tempo que as APIs são desativadas. Vamos começar que se propõe a dividir a população em três grupos treatment_1.*, em que cookies de terceiros estão desativados, mas as APIs PS R&M estão disponíveis, e uma Grupo control_2 em que ambos os cookies de terceiros e as APIs PS R&M estão desativado.

Ajuda 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. Relatórios de depuração ainda serão desativados junto com a descontinuação gradual de cookies de terceiros.

  • Para a API Attribution Reporting, como os cookies de terceiros estão desativados, a origem de relatórios não poderá para definir o cookie ar_debug e vai depender da configuração dos campos debug_key. (para relatórios de atribuição concluída) e debug_reporting (para relatórios detalhados) ) para ativar ou desativar o recebimento desses relatórios.
  • 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 devem continuar considerar como as obrigações regulamentares podem ser aplicadas ao uso da Atribuição API Reporting e API Private Aggregate, 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 em um usuário estará no modo A, no modo B ou em nenhum deles. Testar participantes precisa usar o tráfego control_1.* como um grupo de controle que representa o status quo com cookies de terceiros.

Rótulo % de tráfego estável
treatment_1.1 0,25
treatment_1.2 0,25
treatment_1.3 0,25
control_2 0,25

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

Rótulo % de tráfego pré-estável
prestable_treatment_1 10%
prestable_control_2 10%

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 aplicativos de terceiros os cookies de um site.

Monitoramento de experimentos

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

Recomendamos ter cuidado com o tráfego que contém rótulos 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: um período para que o Chrome possa 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.

Para a duração dos modos A e B, apresentamos uma implementação O valor Cookie-Deprecation pode ser acessado usando um cabeçalho HTTP de ativação e JavaScript. API, que fornece o rótulo para o modo A ou B aplicável do navegador grupo experimental (conforme definido pelas porcentagens acima), se estiver em um dos essas.

O acesso a rótulos envolve o acesso a 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ê.

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

Por exemplo, se 3p-example.site quiser receber o Sec-Cookie-Deprecation cabeçalho nos recursos incorporados em example.com, o 3p-example.site precisa defina 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. Os outros atributos: Domain, Path, Expires e Max-Age podem ser definida da forma mais adequada às suas necessidades, embora Path=/ seja um bom padrão. O exemplo aqui 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, nenhum cabeçalho 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 se destina a uso contínuo após os cookies de terceiros foram totalmente descontinuados. Isso significa que os cookies Partitioned podem ser definido quando cookies de terceiros forem bloqueados.

Acessar a API JavaScriptDeprecationLabel

Também é possível acessar o valor Cookie-Deprecation usando o método API navigator.cookieDeprecationLabel.getValue() JavaScript. Isso retornará uma promise que é resolvida em uma string contendo o rótulo de grupo aplicável. Para Por exemplo, se o navegador estiver 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 permitir que desenvolvedores locais o teste 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 são prefixados com fake_ para diferenciá-los dos rótulos reais. Ativar a sinalização não desativa o navegador para qualquer um dos grupos experimentais.

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

Como o registro é aplicado para relevância e medição do Sandbox de privacidade APIs, talvez seja necessário substituir a aplicação dos testes locais usando chrome://flags/#privacy-sandbox-enrollment-overrides e fornecer a demonstração origem. Como alternativa, inclua a seguinte sinalização de linha de comando se você executando o Chrome em um terminal: --args --disable-features=EnforcePrivacySandboxAttestations

chrome://flags/#tpc-phase-out-facilitated-testing
Configurações de sinalização de teste facilitada pelo Chrome

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

Para testar somente os rótulos do grupo experimental, selecione "Controle de força ativado 1" ou "Force LabelOnly ativado". Isso fará com que o navegador envie a "fake_control_1.1" ou "fake_label_only_1.1" rótulos.

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

Para testar o bloqueio de cookies de terceiros, selecione "Tratamento forçado ativado". 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ê também pode criar novas perguntas ou discussões no repositório usando o modelo "Testes facilitados pelo Chrome" modelo.