A/B-Tests durchführen

Ein Worklet mit gemeinsam genutztem Speicher zum Ausführen von A/B-Tests verwenden

Bei der Shared Storage API handelt es sich um eine Sandbox-Angebot für allgemeine Zwecke, websiteübergreifende Speicherung, die viele mögliche Anwendungsfälle. Ein solches Beispiel sind A/B-Tests, in Chrome 104.0.5086.0 und höher.

Sie können einen Nutzer einer Testgruppe zuweisen und diese Gruppe dann unter „Freigegeben“ speichern Speicher, auf den in einer standortübergreifenden Umgebung zugegriffen werden kann.

A/B-Tests ausprobieren

Wenn Sie A/B-Tests mit gemeinsam genutztem Speicher testen möchten, müssen Sie Chrome 104.0.5086.0 oder höher verwenden. Alle APIs zum Datenschutz bei Werbung unter chrome://settings/adPrivacy aktivieren.

Sie können freigegebenen Speicher auch mit dem Flag --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames in der Befehlszeile aktivieren.

Mit Codebeispielen experimentieren

Um zu sehen, ob ein Test die gewünschte Wirkung erzielt, können Sie A/B-Tests für mehrere Websites durchführen. Als Werbetreibender oder Ersteller von Content können Sie je nach der Gruppe, der der Nutzer zugewiesen ist, unterschiedliche Inhalte oder Anzeigen rendern. Die Gruppenzuweisung wird im freigegebenen Speicher gespeichert, kann aber nicht exfiltriert werden.

In diesem Fall gilt Folgendes:

  • ab-testing.js sollte in einen Frame eingebettet werden, der eine Kontroll- und zwei Testinhalte abbildet. Das Skript ruft das Worklet mit freigegebenem Speicher für den Test auf.
  • ab-testing-worklet.js ist das Worklet mit freigegebenem Speicher, das angibt, welcher Gruppe der Nutzer zugewiesen ist und bestimmt, welche Anzeige ausgeliefert wird.

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?