Testes de origem de terceiros

Provedores de conteúdo incorporado podem testar recursos novos ou experimentais da plataforma da Web.

Os testes de origem são uma maneira de testar um recurso novo ou experimental da plataforma da Web.

Os testes de origem geralmente só estão disponíveis para domínios próprios: eles só funcionam para uma única origem registrada. Se um desenvolvedor quiser testar um recurso experimental em outras origens em que o conteúdo está incorporado, todas elas precisam ser registradas para o teste de origem, cada uma com um token de teste exclusivo. Essa não é uma abordagem escalonável para testar scripts incorporados em vários sites.

Os testes de origem de terceiros permitem que os provedores de conteúdo incorporado testem um novo recurso em vários sites fornecendo um token usando JavaScript.

Os testes de origem de terceiros não são adequados para todos os recursos. O Chrome só vai disponibilizar a opção de teste de origem de terceiros para recursos em que a incorporação de código em sites de terceiros é um caso de uso comum. O guia Primeiros passos com os testes de origem do Chrome fornece informações mais gerais sobre como participar de testes de origem do Chrome.

Se você participar de um teste de origem como provedor terceirizado, será sua responsabilidade notificar e definir as expectativas com os parceiros ou clientes cujos sites você pretende incluir no teste de origem. Os recursos experimentais podem causar problemas inesperados, e os fornecedores de navegadores podem não oferecer suporte para solução de problemas.

Observação: o suporte a testes de origem de terceiros permite uma participação mais ampla, mas também aumenta o potencial de uso excessivo ou abuso de recursos experimentais. Portanto, uma abordagem de "testador confiável" é mais adequada. O maior alcance dos testes de origem de terceiros exige um escrutínio e responsabilidade adicionais para os desenvolvedores da Web que participam como provedores terceirizados. As solicitações para ativar um teste de origem de terceiros podem ser analisadas para evitar que scripts de terceiros problemáticos afetem vários sites. O guia para desenvolvedores de testes Origin explica o processo de aprovação.

Confira as atualizações do status da plataforma do Chrome sobre os testes de origem de terceiros.

Fazer inscrição para um teste de origem de terceiros

1. Selecione um teste na lista de testes ativos.
2. Na página de registro do teste, ative a opção de solicitar um token de terceiros, se disponível.

3. Em alguns testes, há opções para diferentes restrições de uso ao se registrar para um token. Se disponível, selecione uma das opções para restringir o uso de um token de terceiros:

   1. Limite padrão: é o limite usual de 0,5% dos carregamentos de página do Chrome.

   2. Subconjunto de usuários: uma pequena porcentagem de usuários do Chrome sempre será excluída do teste, mesmo quando um token de terceiros válido for fornecido. A porcentagem de exclusão varia (ou pode não se aplicar) a cada teste, mas normalmente é menor que 5%.

      Não há limites de uso para testes de descontinuação, já que eles não introduzem novos recursos e, portanto, não representam um risco de tornar uma proporção significativa da Web dependente de um recurso de teste.

4. Clique no botão "Registrar" para enviar sua solicitação.

5. Seu token de terceiros será emitido imediatamente, a menos que uma análise mais detalhada da solicitação seja necessária. Dependendo do teste, as solicitações de token podem exigir revisão.

6. Se for necessário, você vai receber uma notificação por e-mail quando a análise for concluída e o token de terceiros estiver pronto.

   

   Página de registro para o teste da métrica de conversão.

Atenção: um token de terceiros precisa ser fornecido em um arquivo JavaScript externo incluído por um elemento <script>. Um token de terceiros não funciona em uma metatag, script inline ou cabeçalho HTTP.

Fornecer um token de teste de maneira programática

Para participar de um teste de origem, uma página precisa fornecer um token de teste válido. Se você quiser que um recurso de teste seja ativado em vários sites em que seu código está incorporado, use o JavaScript para injetar um token:

const otMeta = document.createElement('meta');
otMeta.httpEquiv = 'origin-trial';
otMeta.content = 'TOKEN_GOES_HERE';
document.head.append(otMeta);

Caso contrário, você precisará fazer com que todos os sites que incorporam seu código forneçam um token com um cabeçalho HTTP ou no HTML.

Observação: a demonstração em ot-3p.glitch.me acessa um recurso de teste de origem ativado por um token fornecido pelo JavaScript de uma origem diferente.

Compartilhar feedback

Se você estiver se inscrevendo em um teste de origem de terceiros e tiver feedback para compartilhar sobre o processo ou ideias de como podemos melhorar, crie um problema no repositório de testes de origem do GitHub.

Saiba mais

• Demonstração
• Exemplos de iframes entre origens
• Começar a usar os testes de origem do Chrome
• Guia de testes de origem para desenvolvedores da Web
• Status da Plataforma Chrome

Foto de Louis Reed no Unsplash.