本指南介绍了如何将您提供的第三方 A/B 实验工具与 Google Analytics（分析）集成，以便用户在您的工具中运行 A/B 实验变体，然后在 Google Analytics（分析）中解读结果。
适用对象
本指南适用于第三方 A/B 实验解决方案提供商。如果您想了解 Google Analytics（分析）与第三方 A/B 实验解决方案之间的集成，请参阅与第三方实验工具集成。
概览
要将您提供的第三方实验工具与 Google Analytics（分析）集成，您需要：
- 使用 Google Analytics（分析）4 事件向变体添加用户
- 使用 Google Analytics Admin API 为已添加到各个变体的用户创建受众群体
- 使用 OAuth 2.0 征得用户同意，以代表用户创建受众群体。详细了解 OAuth 2.0
此外，用户若要在您的工具中启动实验，则必须在 Google Analytics（分析）媒体资源中具有编辑者（或更高级别）角色。
将 exp_variant_string 参数添加到事件
您需要为每个变体创建一个标识符，然后将此标识符添加到以下 experience_impression 事件中的 exp_variant_string 参数。您将使用该参数来创建受众群体，以便将用户与变体相关联。
gtag('event', 'experience_impression', {
// Replace the value with the Experiment-variant ID
exp_variant_string: "ABC-F2948574-3495F49"
});
当用户被添加到某个变体中时（例如，当实验页面加载时），发送 experience_impression 事件。
设置该参数的格式
为避免该参数在实验之间以及与其他合作伙伴的参数出现雷同，建议您为 exp_variant_string 参数值使用 XXX-YYYYYYYYY-ZZZZZZZZ 格式，其中：
XXX是您提供的第三方工具的 IDYYYYYYYYY是体验的 IDZZZZZZZZ是变体的 ID
您可以为自己的工具、体验和变体使用任意数量的字符。
使用 exp_variant_string 参数定义受众群体
通过使用受众群体，您可以根据 exp_variant_string 参数将已添加到特定变体的用户分为一组。通过将此参数用作受众群体的成员资格条件，您可以根据用户已被添加到的变体将用户添加到相应的受众群体中。
如要为新体验创建受众群体，并为已结束的体验归档受众群体，请使用 Google Analytics Admin API 中的 properties.audiences 资源。
创建受众群体
下面的请求正文使用 properties.audiences.create 方法为已添加到指定变体（ID 为 ABC-F2948574-3495F49）的用户创建了一个受众群体。请注意，您可以根据体验的时长来调整成员资格有效期（最长为 540 天）。
我们建议您将 atAnyPointInTime 参数设置为 true，以减少各实验之间的数据差异。如果将该参数设置为 true，则分配到通过的实验的用户可以分配到新实验。如果将该参数设置为 false 或未设置，则分配到通过的实验的用户就不能添加到新实验中。
{
"displayName": "Audience ABC - experiment F2948574 variant 3495F49",
"membershipDurationDays": 30,
"filterClauses": [
{
"clauseType": "INCLUDE",
"simpleFilter": {
"scope": "AUDIENCE_FILTER_SCOPE_ACROSS_ALL_SESSIONS",
"filterExpression": {
"andGroup": {
"filterExpressions": [
{
"orGroup": {
"filterExpressions": [
{
"eventFilter": {
"eventName": "experience_impression",
"eventParameterFilterExpression": {
"andGroup": {
"filterExpressions": [
{
"orGroup": {
"filterExpressions": [
{
"dimensionOrMetricFilter": {
"fieldName": "exp_variant_string",
"stringFilter": {
"matchType": "EXACT",
"value": "ABC-F2948574-3495F49"
},
"atAnyPointInTime": true
}
}
]
}
}
]
}
}
}
}
]
}
}
]
}
}
}
}
]
}
上述代码段会创建以下受众群体：
- 受众群体名称：“受众群体 ABC - 实验 F2948574 变体 3495F49”
- 受众群体定义：“符合以下条件时包含用户：事件的名称为‘experience_impression’，具有名为‘exp_variant_string’的参数，且其值与‘ABC-F2948574-3495F49’完全匹配”
- 成员资格有效期：30 天
归档受众群体
体验结束后，您需要使用 properties.audiences.archive 方法归档相应受众群体。通过归档受众群体，您可以释放空间，从而为用户创建更多体验。用户将仍然可以使用 Google Analytics（分析）中的历史数据访问其归档受众群体中的数据。
受众群体定位
借助受众群体定位，您的客户可以将实验重点对准在其网站上表现出特定行为的一组用户。例如，客户可以使用受众群体定位通过特别优惠和激励措施定位高价值客户。使用受众群体定位后，系统只会对相应受众群体中的用户展示实验。
您可以帮助客户设置受众群体定位，方法是从 Google Analytics（分析）中导入相应受众群体中的用户，然后将 Google Analytics（分析）中的用户 ID 或设备标识符与您系统中的标识符进行比较。如果这些标识符相匹配，系统就会将该用户添加到实验中。
如要将用户从 Google Analytics（分析）中导出然后导入您的客户端中，请使用 Audience List API。Audience List API 提供了相应受众群体中用户的每日快照，方便您导出受众群体中的用户 ID 或设备标识符。
我们建议每日仅为每个受众群体请求一次 Audience List API。
限制
暂停体验
Google Analytics（分析）4 中未提供暂停受众群体的功能。
为了让用户能够暂停体验，您必须：
- 停止发送在用户成为变体成员时触发的事件
- 在体验暂停期间忽略任何事件
- 向 Google Analytics（分析）报告添加报告过滤器，以排除暂停的时间
或者，您也可以向用户提供一个链接，供其在 Google Analytics（分析）中手动更改日期。
重新处理体验数据
如果用户缺少事件信息，Analytics（分析）可以重新处理其体验数据。Google Analytics（分析）在重新处理体验数据时，不会统计来自已结束体验的已归档受众群体的数据。不过，用户仍然可以在“探索”部分通过带有 exp_variant_string 的事件检索其体验数据。但通过这种方式得到的数据的准确性要低于使用受众群体时获得的数据的准确性，因为体验前和体验后发生的事件都会出现在探索中。
体验数据抽样
如果用户可以分配至多个并发受众群体，那么客户将面临基数问题，该问题可能会导致出现“（其他）”行。这种情况发生的概率将随着并发体验数量的增加以及用于其他目的（例如 Google Ads 出价）的受众群体数量的增加而增加。
但是，如果客户使用 Google Analytics 360，当数据汇总到“（其他）”行下时，Google Analytics（分析）将启用自动展开式数据集，以便客户更完整地查看数据。
对比项上限
Google Analytics（分析）4 报告一次最多可显示 4 个对比项。用户如果有 4 个以上的变体，则可以更换对比项中的受众群体。此时，应优先考虑转化率最高的变体。