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.
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.
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.
- Role para baixo até o painel Frames.
- 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.
- No painel à direita, role para baixo até a seção Testes de origem.
- Você vai encontrar uma entrada para o teste de
PrivacySandboxAdsAPIs. - 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.
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.
Uma boa abordagem é:
- Inclua os tokens de teste de origem por padrão em todos os contextos em que quiser experimento.
- Use a detecção de recursos para verificar se há APIs ativas.
- 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.
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.
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.