重要提示：此文档不适用于您当前选择的格式电子邮件！

amp-experiment

描述

用于在 AMP 页面上进行用户体验实验。

必需的脚本

<script async custom-element="amp-experiment" src="https://cdn.ampproject.org/v0/amp-experiment-0.1.js"></script>

用法

使用 amp-experiment 组件进行用户体验实验，例如 A/B 测试和多变量测试，并收集相应的数据。

<amp-experiment> 提供钩子来定义可自定义的变体，并根据配置将流量分配给每个变体。对于每个页面视图，变体分配也会暴露给 amp-pixel 和 amp-analytics，以便可以收集必要的数据以在变体之间执行统计比较。

支持用户粘性变体分配，以便为同一客户端提供一致的用户体验。此功能依赖于 AMP 的客户端 ID 功能来提供在页面视图中一致的随机值。请注意，使用此功能的行为可能需要更新您的隐私政策或在某些司法管辖区获得最终用户的同意。（如果这对您很重要，请参见下面的 consentNotificationId。）

多个实验可以在同一 AMP 文档中并行运行，并具有各自的变体集。在用户粘性模式下，不同实验之间的分配是正交的，这意味着来自不同实验的 2 个变体（用户组）之间不会有任何关联。

配置

实验的配置在 JSON 对象中指定。

<amp-experiment>
  <script type="application/json">
    {
      "aExperiment": {
        "sticky": true,
        "consentNotificationId": "consent-notif",
        "variants": {
          "treatment1": 12.5,
          "treatment2": 12.5,
          "treatment3": 25.0
        }
      },
      "bExperiment": {...}
    }
  </script>
</amp-experiment>

在顶层，JSON 是以实验名称为键的实验配置映射。在每个实验中，可用设置在下表中描述

名称	是必填字段吗？	描述
`sticky`	否，默认值=`true`	实验分配对用户是否具有粘性。
`consentNotificationId`	否，默认值=`undefined`	在进行粘性实验之前要关闭的 `amp-user-notification` 的元素 ID。为了不阻止页面渲染，如果同意是在当前访问之前没有提供，则将跳过指定了此字段的实验。也就是说，只有在用户同意的情况下返回的访问才能触发此类实验。此设置仅在 `sticky=true` 时相关。
`variants`	是	名称到百分比的映射，其中百分比是一个大于 0 且小于 100 的浮点数，表示将分配给变体的流量。变体的总和不必达到 100%。在这种情况下，一部分流量将分配给名为 `none` 的变体，这是一个保留关键字，表示未分配任何变体。
高级设置
`cidScope`	否，默认值=`amp-experiment`	用于用户粘性实验的 CID 范围。仅当您想重用现有 CID 时才有用。此设置仅在 `sticky=true` 时相关。
`group`	否，默认值=`{experimentName}`	具有相同组名称的实验将共享相同的 CID 空间。仅当多个实验希望具有相关的用户分组时才有用。此设置仅在 `sticky=true` 时相关。

实验名称和变体名称中使用的字符仅限于 [a-z,A-Z,0-9,-,_]。none 是一个保留关键字，不能使用。

分析

分配的变体可用作 URL 替换变量：VARIANT(experiment)

<amp-pixel
  src="https://example.com?xname=aExperiment&xvar=VARIANT(aExperiment)"
></amp-pixel>

对于没有分配变体的实验，此变量解析为字符串字面量 none。

变量 VARIANTS 返回以以下格式序列化的所有变体

{experiment1}.{variant}!{experiment2}.{variant}...

例如，URL https://example.com?variants=VARIANTS 扩展为

https://example.com?variants=aExperiment.treatmentA!bExperiment.treatmentB

覆盖变体分配

可以通过 URL 片段将实验强制设置为变体。这在开发中很有用。

https://example.com/amparticle#amp-x-experiment=treatment

请注意与 body 属性中使用的相同 amp-x- 前缀。

样式

设置变体样式

对于每个实验，分配的变体都作为文档的 body 元素的属性公开。

<body amp-x-aExperiment="treatment1" amp-x-bExperiment="treatment3"></body>

请注意，实验名称以 amp-x- 为前缀，以避免命名冲突。忽略未分配变体的实验。

使用 CSS 属性选择器设置文档样式。例如，下面的代码隐藏了实验 aExperiment 的 treatment1 组的测试横幅

body[amp-x-aExperiment='treatment1'] .test-banner {
  display: none;
}

验证

一个 AMP 文档最多只能有一个 amp-experiment 元素。请参阅 AMP 验证器规范中的 amp-experiment 规则。

需要更多帮助？

您已经阅读过此文档十几次，但它实际上并未涵盖您的所有问题？也许其他人也有同样的感受：在 Stack Overflow 上联系他们。

前往 Stack Overflow

发现错误或缺少功能？

AMP 项目强烈鼓励您的参与和贡献！我们希望您成为我们开源社区的长期参与者，但也欢迎您对您特别感兴趣的问题做出一次性贡献。

前往 GitHub

amp-experiment 1.0 0.1

描述

必需的脚本

用法

配置

分析

覆盖变体分配

样式

设置变体样式

验证

amp-experiment