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 camposdebug_key
. (para relatórios de atribuição concluída) edebug_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.
Acessar rótulos usando o valor de descontinuação de cookies
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ê.
Acessar o cabeçalho HTTP Sec-Cookie-Deprecation
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](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/cft-flag.png?authuser=8&hl=pt-br)
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ê pretende usar o modo A, B ou ambos?
- Escolha de tamanhos de rótulos para testes facilitados pelo Chrome
- Uso de dicas de cliente para testes facilitados pelo Chrome
Você também pode criar novas perguntas ou discussões no repositório usando o modelo "Testes facilitados pelo Chrome" modelo.