Conduzir testes A/B

Use um objeto de armazenamento compartilhado para executar testes A/B.

A API Shared Storage é uma proposta do Sandbox de privacidade para armazenamento entre sites de uso geral, que oferece suporte a muitos casos de uso possíveis. Um exemplo é o teste A/B, que está disponível para teste no Chrome 104.0.5086.0 e versões mais recentes.

Você pode atribuir um usuário a um grupo de experimento e armazenar esse grupo no armazenamento compartilhado para acesso em um ambiente entre sites.

Teste A/B

Para testar o Teste A/B com o Shared Storage, confirme se você está usando o Chrome 104.0.5086.0 ou uma versão mais recente. Ative todas as APIs de privacidade de anúncios em chrome://settings/adPrivacy.

Você também pode ativar o armazenamento compartilhado com a flag --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames na linha de comando.

Testar exemplos de código

Para saber se um experimento tem o efeito desejado, faça um teste A/B em vários sites. Como anunciante ou produtor de conteúdo, você pode renderizar diferentes conteúdos ou anúncios com base no grupo a que o usuário foi atribuído. A atribuição de grupo é salva no armazenamento compartilhado, mas não pode ser exfiltrada.

Neste exemplo:

  • ab-testing.js precisa ser incorporado em um frame, que mapeia um controle e dois conteúdos de experimento. O script chama o objeto de armazenamento compartilhado para o experimento.
  • ab-testing-worklet.js é o worklet de armazenamento compartilhado que retorna a qual grupo o usuário foi atribuído, determinando qual anúncio é mostrado.

ab-testing.js

// Randomly assigns a user to a group 0 or 1
function getExperimentGroup() {
  return Math.round(Math.random());
}

async function injectContent() {
  // Register the Shared Storage worklet
  await window.sharedStorage.worklet.addModule('ab-testing-worklet.js');

  // Assign user to a random group (0 or 1) and store it in Shared Storage
  window.sharedStorage.set('ab-testing-group', getExperimentGroup(), {
    ignoreIfPresent: true,
  });

  // Run the URL selection operation
  const fencedFrameConfig = await window.sharedStorage.selectURL(
    'ab-testing',
    [
      { url: `https://your-server.example/content/default-content.html` },
      { url: `https://your-server.example/content/experiment-content-a.html` }
    ],
    {
      resolveToConfig: true
    }
  );

  // Render the chosen URL into a fenced frame
  document.getElementById('content-slot').config = fencedFrameConfig;
}

injectContent();

ab-testing-worklet.js

class SelectURLOperation {
  async run(urls, data) {
    // Read the user's experiment group from Shared Storage
    const experimentGroup = await sharedStorage.get('ab-testing-group');

    // Return the corresponding URL (first or second item in the array)
    return urls.indexOf(experimentGroup);
  }
}

register('ab-testing', SelectURLOperation);

Casos de uso

Todos os casos de uso disponíveis para a API Select URL podem ser encontrados nesta seção. Vamos continuar adicionando exemplos à medida que recebermos feedback e descobrirmos novos casos de teste.

Engajamento e como compartilhar feedback

A proposta da API Select URL está em discussão e desenvolvimento ativos e está sujeita a mudanças.

Queremos saber o que você acha da API Select URL.