运行 A/B 测试

使用共享存储空间 worklet 运行 A/B 测试。

Shared Storage API 是一项 Privacy Sandbox 提案，旨在提供通用的跨网站存储空间，支持许多可能的用例。其中一个示例是 A/B 测试，该测试可在 Chrome 104.0.5086.0 及更高版本中进行。

您可以将用户分配到实验组，然后将该组存储在共享存储空间中，以便在跨网站环境中访问。

试用 A/B 测试

如需通过 Shared Storage 试用 A/B 测试，请确认您使用的是 Chrome 104.0.5086.0 或更高版本。启用 chrome://settings/adPrivacy 下的所有广告隐私权 API。

您还可以在命令行中使用 --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames 标志启用共享存储空间。

试用代码示例

若要了解实验是否具有预期效果，您可以跨多个网站运行 A/B 测试。作为广告客户或内容制作者，您可以选择根据用户所属的群组呈现不同的内容或广告。群组分配信息会保存在共享存储空间中，但无法被窃取。

在此示例中：

  • ab-testing.js 应嵌入到框架中，该框架会映射一个对照组和两个实验内容。脚本会调用实验的共享存储空间 worklet。
  • ab-testing-worklet.js 是共享存储区 worklet，用于返回用户所属的组，从而确定要展示的广告。

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.