> For the complete documentation index, see [llms.txt](https://helps.ptengine.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helps.ptengine.com/cn/experience/campaign/shopify-theme-redirect-test.md).

# Shopify 主题测试

Shopify 主题测试是**重定向测试**针对 Shopify 店铺的专用模式。它不改变页面 URL，而是通过 Shopify 参数（如 `preview_theme_id`）向不同访客展示不同主题，让您可以安全地对比现有上线主题与新主题的业绩表现。

{% hint style="info" %}
普通的[重定向测试](/cn/experience/campaign/redirect-test.md)会将访客从页面 A 完全跳转到另一个 URL 的页面 B；Shopify 主题测试则**保持 URL 不变，仅切换访客看到的主题**。这样可以在不破坏商品页 / 购物车 / 结算页 URL 结构的前提下，对整个店铺的视觉进行 A/B 测试。
{% endhint %}

## 适用场景 <a href="#use-cases" id="use-cases"></a>

* 新主题正式发布前，先向一部分访客投放，验证对转化率和浏览深度的影响
* 节日 / 大促 / 新品上线时的季节性主题与现有主题进行对比
* 店铺整体改版（配色、排版、商品顺序）的综合效果验证

## 前提条件 <a href="#requirements" id="requirements"></a>

1. 当前档案已开通 **Shopify 主题测试权限**（未开通时设置弹窗中不会出现此模式切换，请联系销售 / 客户成功）
2. 已在 Shopify 店铺部署 Ptengine 基础代码，参考 [在 Shopify 中设置代码](/cn/start-guide/othertag/tag-shopify.md)
3. 已在 Shopify 管理后台上传待测试主题，并取得对应预览参数（如 `preview_theme_id=123456789`）

## 设置步骤 <a href="#setup" id="setup"></a>

1. 在左侧菜单进入 **Experience > 新建体验**
2. 体验类型选择 **「重定向测试」**
3. 在创意设置弹窗中，开启 **「Shopify 主题测试模式」**
4. 在 **「重定向参数」** 输入 Shopify 主题指定参数
   * 例：`preview_theme_id=123456789`
   * 仅填写 `键=值` 的部分，不要带 `?` 或 `&`
5. 在 **「预览页面 URL」** 填入用于管理端截图 / 预览 / 热图的 URL
6. 设置投放条件（URL 匹配）、流量分配比例、对照组
7. 保存并发布上线

{% hint style="warning" %}
新旧主题必须部署相同的 Ptengine 基础代码。只部署在一个主题中会导致闪烁或数据缺失。
{% endhint %}

## 运行机制 <a href="#how-it-works" id="how-it-works"></a>

* 访客首次访问命中投放条件的页面时，会按设定比例被随机分配到某一版本
* 分配结果保存在该访客的浏览器本地存储中，后续回访始终看到相同主题（版本粘性）
* 重定向（追加参数）**仅在首次访问时执行**。再次访问不再重定向，仅记录曝光
* SPA 型店铺在路由切换时也会重新评估投放条件
* 被分配到对照组的访客不会被切换主题，仅作为参照记录曝光

## 查看数据 <a href="#report" id="report"></a>

主题测试的效果与普通重定向测试一致，可在体验报告中对比各版本的会话数、转化率等核心指标。详见[体验报告详情页](/cn/experience/campaign/experience-report-detail.md)。

## 注意事项与常见问题 <a href="#faq" id="faq"></a>

**Q. Shopify 预览参数有有效期吗？**

A. Shopify 预览 URL / 参数可能有时效。上线前请使用未登录 Shopify 管理员的其他浏览器 / 无痕窗口打开链接，确认匿名访客也能正常看到待测试主题。

**Q. 中途调整流量比例，已分配的访客会受影响吗？**

A. 不会。已分配访客的版本信息保存在其浏览器本地，比例调整仅对新访客生效。如需完全重置，需要清理浏览器本地存储。

**Q. 体验停止后，已分配的访客会怎样？**

A. 停止后不会再发生任何重定向，已分配访客恢复看到您当前公开上线的主题。停止前积累的业绩数据仍可查看。

**Q. 是否需要同时启用 Shopify 数据连接？**

A. 仅做主题测试时，只需在店铺中安装基础代码即可。如需把表单提交等数据同步到 Shopify 顾客列表，请另参考 [Shopify 连接](/cn/integrations/shopify.md)。

## 相关页面 <a href="#related" id="related"></a>

* [重定向测试](/cn/experience/campaign/redirect-test.md)
* [在 Shopify 中设置代码](/cn/start-guide/othertag/tag-shopify.md)
* [Shopify 连接](/cn/integrations/shopify.md)
* [体验报告详情页](/cn/experience/campaign/experience-report-detail.md)