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

amp-experiment

描述

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

必需脚本

<script async custom-element="amp-experiment" src="https://cdn.ampproject.org/v0/amp-experiment-1.0.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