Teste de origem unificado de relevância e medição

Topics, Fenced Frames e Shared Storage. keywords: product:PrivacySandbox, docType:Guide, topicAd Setup, contentTypeSolution, Category:Web, apiGroupAds, audienceAdBuyer, audienceAdSeller, audienceAdMeasurementProvider, skill:Beginner

O Sandbox de privacidade inclui uma seleção de propostas que permitem o uso publicitário casos sem o rastreamento entre sites. Origem de teste oferecem aos desenvolvedores a oportunidade de avaliar e fornecer feedback sobre novas tecnologias da Web por meio de testes reais. A Relevância e Teste de origem da medição oferece um único teste que permite que os sites façam experimentos unificados no Attribution Reporting, API Protected Audience, Topics, Fenced Frames e Shared Cloud Storage. Os desenvolvedores podem se inscrever nesse teste de origem única, que permite testar nas APIs Topics, Protected Audience e Attribution Reporting. Isso guia você pelas etapas de configuração para acessar as APIs, informando como validar sua configuração e oferece mais recursos para testes com as APIs.

Termo-chave: tráfego se refere à porcentagem de instâncias do navegador Chrome incluído no teste, não a porcentagem de solicitações feitas para sites individuais.

Verificar o status do teste de origem

Junho de 2023

Aumento de 7% na agregação particular no modelo Stable

A API Private Aggregate será disponível em 7% do tráfego do Chrome Stable a partir de terça-feira, 6 de junho de 2023. A API vai estar disponível no grupo principal de testes de origem unificada (5%), Protected Grupo isolado de público-alvo (1%) e grupo isolado de armazenamento compartilhado (1%). A a alocação de tráfego para as APIs Protected Audience e Shared Storage não vai mudar já que a agregação privada está sendo adicionada aos experimentos isolados existentes.

Alocação de tráfego a partir de terça-feira, 6 de junho:

API	Alocação de tráfego	Status
Relatórios de atribuição	Unificado: 5%	6% do tráfego estável a partir de 13 de março de 2023
	Isolado - 1% - somente ARA
Molduras cercadas	Unificado: 5%	7% do tráfego estável a partir de 13 de março de 2023
	Isolado - 1% - apenas armazenamento compartilhado + agregação privada + frames isolados
	Isolado - 1% - somente Protected Audience + agregação particular + Fenced Frames
Público-alvo protegido	Unificado: 5%	6% do tráfego estável a partir de 13 de março de 2023
	Isolado - 1% - somente Protected Audience + agregação particular + Fenced Frames
Agregação particular	Unificado: 5%	7% do tráfego estável a partir de 6 de junho de 2023
	Isolado - 1% - somente Protected Audience + agregação particular + Fenced Frames
	Isolado - 1% - apenas armazenamento compartilhado + agregação privada + frames isolados
Armazenamento compartilhado	Unificado: 5%	6% do tráfego estável a partir de 13 de março de 2023
	Isolado - 1% - apenas armazenamento compartilhado + agregação privada + frames isolados
Tópicos	Unificado: 5%	6% do tráfego estável a partir de 13 de março de 2023
	Isolado - 1% - somente tópicos

Atualizações anteriores

Confira as atualizações anteriores do teste de origem.

Abril de 2023

Aumento de 1% na agregação particular no modelo Stable

A página Privado O teste de origem da API Aggregate estará disponível em 1% do Chrome Stable tráfego unificado do experimento de segunda-feira, 17 de abril. O sendHistogramReport() da agregação privada está disponível para uso na API Protected Audience e Armazenamento compartilhado worklets.

A alocação de tráfego será semelhante ao exemplo a seguir, a partir de segunda-feira, 17 de abril:

API	Alocação de tráfego	Status
Relatórios de atribuição	Unificado: 5%	6% do tráfego estável a partir de 13 de março de 2023
	Isolado - 1% - somente ARA
Molduras cercadas	Unificado: 5%	7% do tráfego estável a partir de 13 de março de 2023
	Isolado - 1% - Armazenamento compartilhado (seleção de URL) + Somente frames isolados
	Isolado - 1% - apenas API Protected Audience + Fenced Frames
API Protected Audience	Unificado: 5%	6% do tráfego estável a partir de 13 de março de 2023
	Isolado - 1% - apenas API Protected Audience + Fenced Frames
Agregação particular	Unificado: 1%	1% do tráfego estável a partir de 17 de abril de 2023
Armazenamento compartilhado (seleção de URL)	Unificado: 5%	6% do tráfego estável a partir de 13 de março de 2023
	Isolado - 1% - Armazenamento compartilhado (seleção de URL) + Somente frames isolados
Tópicos	Unificado: 5%	6% do tráfego estável a partir de 13 de março de 2023
	Isolado - 1% - somente tópicos

Março de 2023

Atualização da linha do tempo

Inicialmente, comunicamos que começaremos os experimentos isolados na segunda-feira, 13 de março de 2023, mas os novos experimentos vão começar na quinta-feira, 16 de março, em 2023 devido ao tempo extra necessário para configurar os experimentos. O 1% A otimização da API Protected Audience de 4% para 5% também vai ocorrer na quinta-feira. 16 de março de 2023.

Backup da API Protected Audience 1%

No mês passado, reduzimos temporariamente o tráfego do teste de origem da API Protected Audience de 5% para 4% do Chrome estável para testes. O teste inicial foi concluído, e planejamos aumentar a API Protected Audience em 5%, em vez de 4% para o experimento unificado na quinta-feira, 16 de março de 2023.

Os usuários adicionados será o mesmo grupo que teve a experiência reduzida. No entanto, os grupos de interesse anteriores expiraram, já que se passaram mais de 30 dias desde a redução.

Experimentos isolados

Para melhorar nosso processo de testes e continuar observando as métricas das APIs de teste de origem, estamos criando experimentos isolados para cada API, além do experimento unificado atual. Serão criados novos experimentos para a API Attribution Reporting, Topics, uma combinação da API Protected Audience e de Fenced Frames, além de uma combinação da operação de seleção de URL do Armazenamento compartilhado e de Fenced Frames. Em cada experimento isolado, somente as APIs atribuídas vão estar disponíveis para os usuários desse grupo.

API	Alocação de tráfego do experimento isolado
Relatórios de atribuição	1%
API Protected Audience + Fenced Frames	1%
Armazenamento compartilhado (seleção de URL) + frames isolados	1%
Tópicos	1%

A partir de quinta-feira, 16 de março, você começará a receber mais 1% dos Tráfego Stable do Chrome para as APIs listadas acima, além dos 5% do tráfego que você que estão recebendo do experimento unificado atual. Novos usuários serão alocados a cada experimento.

Alocação de tráfego

A atual alocação de tráfego dos testes de origem unificados na terça-feira, 28 de fevereiro, é a seguinte:

API	Alocação de tráfego do experimento unificado atual
Relatórios de atribuição	5%
Molduras cercadas	5%
API Protected Audience	4%
Armazenamento compartilhado (seleção de URL)	5%
Tópicos	5%

A alocação de tráfego vai ficar assim a partir de quinta-feira, 16 de março, depois que a API Protected Audience for retomada e os novos experimentos isolados começarem:

API	Nova alocação de tráfego	Status
Relatórios de atribuição	Unificado: 5%	6% do tráfego estável a partir de 16 de março de 2023
	Isolado - 1% - somente ARA
Molduras cercadas	Unificado: 5%	7% do tráfego estável a partir de 16 de março de 2023
	Isolado - 1% - Armazenamento compartilhado (seleção de URL) + Somente frames isolados
	Isolado - 1% - apenas API Protected Audience + Fenced Frames
API Protected Audience	Unificado: 5% (4% de alocação atual + 1% de recuperação)	6% do tráfego estável a partir de 16 de março de 2023
	Isolado - 1% - apenas API Protected Audience + Fenced Frames
Armazenamento compartilhado (seleção de URL)	Unificado: 5%	6% do tráfego estável a partir de 16 de março de 2023
	Isolado - 1% - Armazenamento compartilhado (seleção de URL) + Somente frames isolados
Tópicos	Unificado: 5%	6% do tráfego estável a partir de 16 de março de 2023
	Isolado - 1% - somente tópicos

Essas mudanças não vão afetar a configuração atual do token de teste de origem, e você não vai precisar renovar ou gerar um novo.

Janeiro de 2023

Como parte de uma investigação de regressão do Chrome, vamos reduzir temporariamente o tráfego de testes de origem da API Protected Audience de 5% para 4% do Chrome Stable a partir de 26 de janeiro de 2023. Estimamos que a investigação leve cerca de um mês, e vamos notificar você quando o tráfego for recuperado.

Essa mudança vai acontecer automaticamente e não vai afetar seus tokens de teste de origem atuais. Para os usuários do 1% de tráfego que diminuirá, os grupos de interesse permanecerão nos seus navegadores. Os mesmos usuários vão fazer parte do reforço, e os grupos de interesse deles poderão ser reutilizados. No entanto, os grupos de interesse expiram em 30 dias, e a investigação de regressão pode levar mais tempo que isso.

Além disso, o teste de origem da API URL Selection do Shared Storage vai aumentar para 5% do tráfego do Chrome Stable a partir de 26 de janeiro de 2023.

API	Observações
API Attribution Reporting (link em inglês)	Disponível na versão estável, aumentou para 5% a partir de 26 de outubro de 2022.
Temas	Disponível na versão estável, aumentou para 5% a partir de 26 de outubro de 2022.
API Protected Audience	Disponível no canal estável, com redução temporária para 4% a partir de 26 de janeiro de 2023.
Frames isolados	Disponível na versão estável, aumentando para 5% a partir de 9 de novembro de 2022.
Armazenamento compartilhado	Disponível na versão estável, com aumento de 5% a partir de 26 de janeiro de 2023.

Novembro de 2022

A API `selectURL` do armazenamento compartilhado vai participar do teste de origem em 1% do tráfego do Chrome Stable a partir de 9 de novembro.

Conforme anunciado anteriormente na postagem do blog Aumentar o teste de origem da medição e relevância do Sandbox de privacidade para 5%, a API Attribution Reporting e a Topics agora estão em 5% com a API Protected Audience e o Fenced Frames, que também ocorrerá em 9 de novembro.

API	Observações
API Attribution Reporting (link em inglês)	Disponível na versão estável, aumentou para 5% a partir de 26 de outubro.
Temas	Disponível na versão estável, aumentou para 5% a partir de 26 de outubro.
API Protected Audience	Disponível na versão estável, aumentando para 5% a partir de 9 de novembro.
Frames isolados	Disponível na versão estável, aumentando para 5% a partir de 9 de novembro.
Armazenamento compartilhado	Estará disponível no modo estável a partir de 1% a partir de 9 de novembro.

Outubro de 2022: aumento de 5%

No momento, as APIs Attribution Reporting, Topics, Protected Audience e Fenced Frames estão disponíveis no Chrome Stable e farão parte do aumento do tráfego.

Vamos aumentar o tráfego de API Attribution Reporting e Topics a partir desta semana. Já a API Protected Audience e Fenced Frames vão aumentar a partir de 9 de novembro.

Leia mais na postagem do blog Aumento do teste de origem da relevância e medição do Sandbox de privacidade para 5% (em inglês).

API	Observações
API Attribution Reporting (link em inglês)	Disponível na versão estável, aumentando para 5% após 26 de outubro.
Temas	Disponível na versão estável, aumentando para 5% após 26 de outubro.
API Protected Audience	Disponível na versão estável, aumentando para 5% a partir de 9 de novembro.
Frames isolados	Disponível na versão estável, aumentando para 5% a partir de 9 de novembro.
Armazenamento compartilhado	Por enquanto, disponível apenas nas versões Canary, Dev e Beta da versão M105+.

Outubro de 2022

• O teste de origem foi estendido para o Chrome 110.
• O artigo Como começar os testes de origem do Chrome explica como renovar a inscrição. Isso inclui fornecer um novo token para origens participantes, que é o mesmo processo seguido por qualquer outra extensão de teste de origem.

Essa extensão foi concedida para dar tempo ao ecossistema no Canal Stable para continuar testando e validando melhorias da API, além de fornecer feedback de acordo com nosso cronograma público atual.

O cronograma geral do Sandbox de privacidade não vai mudar.

APIs incluídas no teste:

API	Observações
Atribuição Geração de relatórios	Desenvolvedor guia do teste de origem.
API Protected Audience	Desenvolvedor guia do teste de origem.
Temas	Desenvolvedor guia do teste de origem.
Cercado Armações	Consulte as orientações da API Protected Audience para usar o teste de origem.
Compartilhados Armazenamento	Por enquanto, disponível apenas nas versões Canary, Dev e Beta da versão M105+.

Agosto de 2022

• A disponibilidade dos testes de origem aumenta em até 1% dos usuários de computadores com o Chrome Stable 104.
• As atualizações serão disponibilizadas quando a disponibilidade incluir usuários de dispositivos móveis.
• Os canais pré-estáveis (Canary, Beta) permanecem com 50% dos usuários.
• As APIs não estão disponíveis no Chrome para iOS.

Maio de 2022

A disponibilidade dos testes de origem aumenta para 50% dos usuários a partir do Chrome 102 Beta.

APIs incluídas no teste:

API	Observações
Atribuição Geração de relatórios	Desenvolvedor guia do teste de origem.
API Protected Audience	Desenvolvedor guia do teste de origem.
Temas	Guia do desenvolvedor para o teste de origem. A API Topics foi desativada brevemente no teste de origem devido a um bug que afetaram a estabilidade do navegador.
Cercado Armações	Fenced Frames adicionados ao teste de origem. Consultar as orientações da API Protected Audience para uso experimental.

Abril de 2022

O teste de origem começa com uma proporção limitada de usuários do Chrome 102 Beta.

APIs incluídas no teste:

API	Observações
Atribuição Geração de relatórios	Intenção individual para o experimento (I2E). A API Attribution Reporting também está disponível um teste de origem individual.
API Protected Audience	Intenção individual para o experimento (I2E). A API Protected Audience só está disponível em computadores com um subconjunto de funcionalidades.
Temas	Intenção individual para o experimento (I2E).

Inscrever-se e configurar o teste de origem

Para ativar o teste de origem no seu site, você precisa se registrar e incorporar o token de teste de origem atribuído (uma string baseada em tempo para seu acesso específico o teste de origem). Saiba mais em Introdução à origem do Chrome testes.

Observação: inscreva-se no webinar Relevância e medição do Sandbox de privacidade teste.

Os tokens de teste de origem são concedidos imediatamente e podem ser revogados ou recriados a qualquer momento.

Para cada página em que você quiser usar o teste de origem, será necessário incluir um token de teste com o HTML ou a resposta dessa página específica.

Use uma tag <meta> na seção <head> da página:

<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">

Se preferir, inclua o seguinte cabeçalho HTTP na resposta da página:

Origin-Trial: TOKEN_GOES_HERE

Configurar com um iframe

Se você estiver usando recursos de teste de origem em um iframe (como as APIs Protected Audience) joinAdInterestGroup()), o token precisa ser fornecido no iframe. e corresponder à origem do iframe.

Configurar vários sites com JavaScript

Se estiver usando recursos de teste de origem via JavaScript entre sites, como você está o provedor de JavaScript de terceiros incluído na página de nível superior, faça o seguinte:

• Selecione a opção Correspondência de terceiros ao registrar a origem. julgamento.
• O campo Origem da Web deve ser a origem do seu script.
• Injete a tag <meta> na página de nível superior (ou seja, na página página, não seu próprio conteúdo) do seu script. Exemplo:

const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);

Depurar o teste de origem

É possível verificar o status de um teste de origem em DevTools > Aplicativos do painel de controle.

Status de sucesso do token e ativado.

1. Role para baixo até o painel Frames.
2. Selecione o frame em que você espera definir o token. Por exemplo, o top para a página de nível superior ou o iframe específico para páginas incorporadas.
3. No painel à direita, role para baixo até a seção Testes de origem.
4. Você vai encontrar uma entrada para o teste de PrivacySandboxAdsAPIs.
5. Abra essa entrada para conferir o status do teste de origem e suas tokens.

O teste de origem é limitado a uma fração dos usuários do Chrome, e seu navegador pode não estar no grupo experimental. Como resultado, você poderá ver um TrialNotAllowed vermelho contra PrivacySandboxAdsAPIs. Ao abrir a entrada para verificar Status do token, se mostrar uma mensagem verde Success, seu teste de origem está correta. Os usuários qualificados verão a mensagem definida como Enabled.

Status do token bem-sucedido e não ativado.

Se você receber mensagens diferentes, consulte Solução de problemas de origem do Chrome. testes para um lista de verificação detalhada para validar sua configuração do teste de origem.

Detectar recursos

Como acontece com todos os recursos da Web, é necessário verificar se eles estão disponíveis no no navegador antes de tentar usá-los. Você pode fazer isso verificando se a API relevante está no local correto:

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // Attribution Reporting enabled
}

if ('runAdAuction' in navigator) {
  // Protected Audience API enabled
}

if ('browsingTopics' in document) {
  // Topics enabled
}

if ('HTMLFencedFrameElement' in window) {
  // Fenced Frames enabled
}

if ('sharedStorage' in window) {
  // Shared Storage enabled
}

if (window?.sharedStorage?.selectURL instanceof Function) {
  // optionally check specifically for the selectURL function in Shared Storage
}

Determinar a elegibilidade do usuário

O teste de origem está sendo realizado para uma fração dos usuários do Chrome. Eles também devem ter a funcionalidade relevante ativada em suas configurações para estar qualificada para período de teste:

Configurações do navegador

Os usuários só podem se qualificar para o teste:

• usar uma versão e um canal do Chrome em que o teste de origem esteja; em execução.

  • Consulte Status do teste de origem para conferir as configurações atuais.

• Estar no grupo experimental ativo no Chrome.

Configurações do usuário

Para se qualificar para o teste, o usuário também precisa:

• ter o teste do Sandbox de privacidade ativado em "Configurações" > Segurança e privacidade > Sandbox de privacidade, também acessível pelo chrome://settings/adPrivacy
• ativaram cookies de terceiros em "Configurações" > Segurança e privacidade > Cookies e outros dados do site definidos como "Permitir todos os cookies" ou "Bloquear cookies de terceiros no modo de navegação anônima", também pode ser acessado pelo chrome://settings/cookies
• estar em uma sessão de navegação padrão, e não no modo de navegação anônima.

O teste de origem só vai aparecer como ativo para usuários qualificados, mas você também pode use as sinalizações do desenvolvedor para testar em relação à sua própria produção site.

Controlar sua participação no teste de origem

A mecânica do teste de origem permanece a mesma: você recebe o teste de origem. para os contextos em que deseja experimentar as APIs. Com o população de teste expandida, monitore ativamente e controlar o nível de tráfego em que o teste será ativado.

Observação: 5% do tráfego estável do Chrome não corresponderá diretamente a 5% do seu do tráfego de entrada. A proporção real do tráfego recebido por seus sites e serviços dependerá a composição dos seus visitantes.

Uma boa abordagem é:

1. Inclua os tokens de teste de origem por padrão em todos os contextos em que quiser experimento.
2. Use a detecção de recursos para verificar se há APIs ativas.
3. Se as APIs estiverem ativas (e, portanto, o navegador estiver qualificado para essa experimento), escolha se quer usá-los com base em seu próprio experimento. critérios. Por exemplo, se você já tem uma infraestrutura de teste A/B para fazer experimentos com uma porcentagem do tráfego, amostragem ou algum outro atributo, então, neste ponto, você pode decidir quais recursos usará ativamente.

É possível impedir completamente a participação no teste de origem de qualquer navegador instância ao não incluir o token na resposta. Por exemplo, se você tiver atingiu sua própria cota para um experimento ou precisa resolver um problema durante teste, não incluir o token garante que nenhuma funcionalidade experimental seja disponível ou ativo na página.

Controle do teste de origem por região geográfica

Não é possível desativar um teste de origem para regiões específicas. Os testes de origem são ativos em páginas que contenham token, incluído por cabeçalhos HTTP (do lado do servidor) ou metatags HTML (do lado do cliente).

Se você consegue determinar a localização do usuário, é possível escrever o código para incluir o token de teste de origem com base nas informações de localização. Por exemplo, pode tentar usar endereços IP para determinar o local de um usuário. Endereços IP pode ser falsificado, então essa não é uma solução garantida.

No entanto, uma origem geográfica específica pode definir um objeto Permissões política para controlar quais recursos são utilizáveis. Por exemplo, us.example.com e uk.example.com são origens específicas de uma região geográfica que podem ser controladas. Isso não significa que um região desistiu do teste de origem.

Com uma política de permissões, um site adiciona um pequeno snippet de código às páginas. que fornece instruções ao navegador. Quando a página é carregada, o navegador ler as instruções da Política de permissões e permitir ou bloquear recursos (ou APIs) conforme descrito na Política de permissões. Se um site quiser restringir uma API em uma região específica, o desenvolvedor pode definir uma política para todas as páginas solicitadas, da região.

Aviso: os usuários podem visitar uma origem de uma região diferente de onde eles estão. Em outras palavras, um usuário nos Estados Unidos pode ser pode acessar uk.example.com. Esses usuários veriam recursos e funções para o site dos Estados Unidos que foram bloqueados para o site do Reino Unido.

Renove seu token

Os tokens de teste de origem expiram seis semanas após a data de emissão (ou ao final do de teste, se acontecer antes).

É muito importante que você renove e implante seus novos tokens nessa janela para sem interrupções dos recursos de teste de origem.

A renovação de tokens leva apenas alguns minutos, e você pode implantar vários tokens para o mesmo teste na mesma página. É possível implantar um token renovado antes que o token atual expira, então não há interrupção do serviço para os usuários.

Atenção :a renovação de um token no final de outubro abrange apenas o início de dezembro. Se você tiver um congelamento de código no final do ano, convém implante um token atualizado ou planeje pausar a participação no teste de origem durante esse período.

Testar localmente

Para orientações específicas sobre testes de desenvolvedores locais, consulte:

• Temas
• API Protected Audience
• API Attribution Reporting (link em inglês)

As APIs não estão ativadas por padrão e devem ser ativadas com flags para testes. Verifique se as mesmas definições de configuração estão ativadas acima e depois:

• Usar uma versão e um canal do Chrome em que os recursos estejam disponíveis.
• Ative todas as APIs de privacidade de anúncios em chrome://settings/adPrivacy.

Consulte os guias do desenvolvedor para conferir a disponibilidade de APIs e recursos específicos e mais sinalizações para uma configuração mais detalhada.