# 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)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helps.ptengine.com/cn/experience/campaign/shopify-theme-redirect-test.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.