O Sandbox de privacidade inclui uma seleção de propostas para ativar casos de uso de publicidade sem a necessidade de rastreamento entre sites. Os testes de origem oferecem a oportunidade para que os desenvolvedores avaliem e forneçam feedback sobre novas tecnologias da Web por meio de testes do mundo real. Em testes de origem anteriores, os sites puderam testar APIs individuais. Para as APIs Topics, FLEDGE e Attribution Reporting, oferecemos um teste de origem único que permite que os sites executem experimentos unificados em todas as APIs, criando uma versão inicial do ciclo de vida completo do anúncio. As APIs estão disponíveis para testes no Chrome 101 Beta e versões mais recentes. A versão Beta do Chrome 101 também vê atualizações nos controles do usuário enquanto continuamos a iterar as opções de configuração.
Como desenvolvedor, você poderá se inscrever nesse teste de origem único que vai permitir que você faça testes nas APIs Topics, FLEDGE e Attribution Reporting. Neste guia, apresentamos as etapas de configuração para acessar as APIs, explicamos como validar sua configuração e fornecemos outros recursos para testar nas APIs.
O que há no teste de origem?
O objetivo desse teste é permitir testes significativos em todo o ciclo de vida do anúncio em vários sites. Para abranger essa jornada, o teste de origem inclui:
- Topics para observar e acessar os
temas de um navegador via
document.browsingTopics()
. - FLEDGE para gerenciar os grupos de interesse
de um navegador, além de lances e seleção de anúncios com base nesses
grupos e outros indicadores.
- Neste teste de origem, o FLEDGE está disponível em computadores e inclui um subconjunto específico de todas as funcionalidades propostas. Leia os detalhes do teste de origem do FLEDGE para saber mais.
- Frames isolados para renderizar o URL opaco do vencedor do leilão de anúncios do FLEDGE.
- Use a API Attribution Reporting para
medir e gerar relatórios sobre a performance durante o ciclo de vida do anúncio.
- Como parte da API Attribution Reporting, os relatórios agregáveis precisam ser processados e agregados por um serviço de agregação para produzir relatórios de resumo. Em breve, vamos publicar outras ferramentas e guias para testes locais e de origem.
- Se você já participou de testes de origem anteriores para o Attribution Reporting, saiba que vai precisar fazer a atualização de acordo com as mudanças mais recentes da API. Para mais detalhes, consulte o Guia de migração.
Essa configuração permite testes unificados em todas essas APIs, mas é possível escolher quais aspectos implementar, o quanto for necessário.
Como os desenvolvedores se inscrevem no teste de origem?
Inscreva-se no teste Relevância e medição do Sandbox de privacidade. Com as seguintes tags HTML, forneça um token de teste em cada página onde você gostaria de executar o código de API:
- tag
<meta>
na seção<head>
da página de nível superior:<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
- Cabeçalho HTTP na resposta da página de nível superior:
Origin-Trial: TOKEN_GOES_HERE
Algumas funcionalidades disponíveis no teste de origem são destinadas ao uso em
contextos entre sites, como quando você fornece um serviço como terceiro
no site de nível superior. Se você precisar ativar o teste de origem para esses outros contextos, selecione a opção de "Correspondência de terceiros".
Para ativar o teste de origem com JavaScript de terceiros, injete a tag <meta>
na página de nível superior (ou seja, na página própria, e não no seu 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);
Saiba mais no guia sobre os primeiros passos com os testes de origem do Chrome.
Como os desenvolvedores testam localmente?
A documentação individual do desenvolvedor para Topics, FLEDGE e Attribution Reporting fornece orientações específicas sobre os testes de desenvolvedores locais para cada API. As APIs não são ativadas por padrão e precisam ser ativadas com sinalizações para testes.
Para ativar APIs para testes, é preciso:
- Use o Chrome 101 Beta ou mais recente.
- O FLEDGE exige o Chrome para computador.
- As APIs não estão disponíveis nas versões do Chrome para iOS.
- Ative as APIs usando a sinalização
chrome://flags/#privacy-sandbox-ads-apis
.- Essa flag força as APIs para facilitar os testes. Se você quiser
replicar um usuário de teste de origem qualificado em que as configurações
adicionais ainda possam desativar as APIs, inicie o Chrome
usando as flags da CLI:
--enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs
. - APIs individuais podem ter mais flags para uma configuração mais refinada. Confira os guias individuais para saber mais detalhes.
- Outras flags podem entrar em conflito com essa. Portanto, considere configurar essa apenas se encontrar problemas.
- Essa flag força as APIs para facilitar os testes. Se você quiser
replicar um usuário de teste de origem qualificado em que as configurações
adicionais ainda possam desativar as APIs, inicie o Chrome
usando as flags da CLI:
- Ative os testes do Sandbox de privacidade nas configurações do Chrome: Configurações >
Segurança e privacidade > Sandbox de privacidade. Ele também pode ser acessado
em
chrome://settings/adPrivacy
. - Ative os cookies de terceiros nas configurações do Chrome: Configurações > Segurança e privacidade. Defina a opção Cookies e outros dados do site como
"Permitir todos os cookies" ou "Bloquear cookies de terceiros na navegação anônima". Isso
também pode ser acessado em
chrome://settings/cookies
. - Estar em uma sessão de navegação padrão. Não use o modo de navegação anônima.
Como os desenvolvedores verificam se o teste de origem está configurado corretamente?
A Solução de problemas de testes de origem do Chrome fornece uma lista de verificação detalhada para validar sua configuração do teste de origem.
![DevTools mostrando o status do teste de origem em "Aplicativos"](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/blog/devtools-showing-origin-t-ca92b0341055a.png?authuser=7&hl=pt)
O DevTools mostra o status de um teste de origem na guia "Applications" em Frames.
Embora o teste de origem só seja exibido como ativo para usuários qualificados, conforme detalhado abaixo, também é possível usar as sinalizações do desenvolvedor para testar no seu próprio site de produção.
Quais usuários estão qualificados para o teste de origem?
Por padrão, os testes de origem são projetados para ser executados apenas em uma pequena parte do tráfego geral do Chrome. Sendo assim, sempre presuma que, mesmo que você tenha ativado o teste de origem no seu site, o usuário pode não ter a API ativa. O grupo experimental ativo no teste de origem vai começar com uma proporção baixa de usuários e provavelmente aumentar à medida que o teste avança. A porcentagem de usuários do Chrome no experimento pode não corresponder à porcentagem de usuários ativados no site.
No entanto, para permitir o teste unificado em vários sites, esse conjunto de usuários qualificados precisa permanecer consistente. Por exemplo, se um usuário estiver qualificado para o teste de origem ao visualizar um anúncio no site de um editor participante, esse mesmo usuário ainda estará qualificado quando fizer a conversão em um site de anunciante participante.
Para que um usuário seja qualificado, ele precisa:
- usar o Chrome 101 Beta ou posterior.
- O FLEDGE exige o Chrome para computador.
- nenhum teste de origem está disponível nas versões do Chrome para iOS.
- navegar durante o período ativo de teste de origem.
- ative os testes do Sandbox de privacidade em Configurações > Segurança e
privacidade > Sandbox de privacidade, que também podem ser acessados em
chrome://settings/adPrivacy
. - ter cookies de terceiros ativados em "Configurações > Segurança e privacidade > Cookies e outros dados do site" definidos como "Permitir todos os cookies" ou "Bloquear cookies de terceiros em navegação anônima", também acessível pelo
chrome://settings/cookies
. - estar em uma sessão de navegação padrão, e não no modo de navegação anônima.
- estar no grupo experimental ativo no Chrome.
Como os desenvolvedores podem detectar o suporte à API?
Como acontece com qualquer recurso de plataforma da Web, é necessário detectar se o recurso é compatível antes de usá-lo.
Tópicos
Procure a função browsingTopics()
em document
e
a política de permissões](https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowedfeature)
em relação a "browsing-topics".
if ('browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics')) {
// Topics enabled
}
FLEDGE
Se você quiser participar de um grupo de interesse de anúncios, verifique a função joinAdInterestGroup
em navigator
e a política de permissões para "join-ad-interest-group".
if ('joinAdInterestGroup' in navigator && document.featurePolicy.allowsFeature('join-ad-interest-group')) {
// FLEDGE interest group enabled
}
Se você quiser realizar um leilão, procure a função runAdAuction
no navigator
e a política de permissões "run-ad-auction".
if ('runAdAuction' in navigator && document.featurePolicy.allowsFeature('run-ad-auction')) {
// FLEDGE auction enabled
}
Relatórios de atribuição
Verifique o objeto attributionReporting
em window
e
a política de permissões para "atribuição de relatórios".
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// Attribution Reporting API enabled
}
Onde os desenvolvedores podem dar feedback e receber suporte?
A página de visão geral do feedback detalha as várias rotas para enviar feedback sobre diferentes aspectos do Sandbox de privacidade. Há seções específicas para Topics, FLEDGE e Attribution Reporting que fornecem os links individuais para cada API.
Também enviamos atualizações frequentes sobre o progresso da série Sandbox de privacidade, com um resumo de notícias importantes.