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.

Engage and share feedback

Note that the Select URL API proposal is under active discussion and development and subject to change.

We're eager to hear your thoughts on the Select URL API.