Effectuez des tests A/B

Utilisez un Worklet de stockage partagé pour exécuter des tests A/B.

L'API Shared Storage est un service Proposition de bac à sable pour le stockage intersites à usage général, cas d'utilisation possibles. Les tests A/B, par exemple, permettent de tester dans Chrome 104.0.5086.0 et versions ultérieures.

Vous pouvez affecter un utilisateur à un groupe de test, puis stocker ce groupe dans l'onglet "Partagés". Stockage accessible dans un environnement intersites

Essayer les tests A/B

Pour effectuer des tests A/B avec Shared Storage, vérifiez que vous utilisez Chrome 104.0.5086.0 ou une version ultérieure. Activez toutes les API Ad Privacy sous chrome://settings/adPrivacy.

Vous pouvez également activer le stockage partagé à l'aide de l'option --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames dans la ligne de commande.

Tester des exemples de code

Pour déterminer si un test a l'effet souhaité, vous pouvez effectuer des tests A/B sur plusieurs sites. En tant qu'annonceur ou producteur de contenu, vous pouvez choisir d'afficher différents contenus ou annonces en fonction du groupe auquel l'utilisateur est affecté. L'attribution du groupe est enregistrée dans l'espace de stockage partagé, mais ne peut pas être exfiltrée.

Dans cet exemple :

  • ab-testing.js doit être intégré dans un cadre qui fait correspondre le contenu d'un groupe de contrôle et de deux contenus de test. Le script appelle le Worklet de stockage partagé pour le test.
  • ab-testing-worklet.js est le Worklet de stockage partagé qui renvoie le groupe auquel l'utilisateur est attribué et qui détermine l'annonce à afficher.

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);

Use cases

All available use cases for Select URL API can be found in this section. We'll continue to add examples as we receive feedback and discover new test cases.

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.

Stay Informed

  • Mailing List: Subscribe to our mailing list for the latest updates and announcements related to the Select URL and Shared Storage APIs.

Need Help?