Urchin Tracking Module（UTM）参数是附加在页面 URL 上的文本字符串，用于帮助追踪流量来源。SmartPush 支持在 邮件营销活动、短信营销活动、自动化流程以及弹窗表单 中使用自定义 UTM 追踪，从而帮助商家更准确地分析营销效果。
本指南将介绍 UTM 参数在 SmartPush 中的工作方式，以及如何在不同营销场景中进行配置。
UTM 概览
UTM 参数用于识别流量的来源、媒介和活动。标准参数如下：
| 参数 | 说明 | 默认值 |
| utm_source | 标识流量来源（例如：newsletter、Google Ads） | smartpush |
| utm_medium | 标识流量渠道（例如：email、SMS） | email / sms（取决于节点类型） |
| utm_campaign | 标记特定营销活动 | Email/SMS 活动 ID，或自动化：[[FlowID]]_[[NodeID]] |
| 注意： SmartPush 会自动将这些参数附加到邮件、短信、自动化流程以及弹窗按钮中的所有链接。您可以通过【高级设置】模块自定义这些参数值。 |
如何设置 UTM 参数
适用于邮件营销活动
对于 邮件营销活动，您可以在活动的【高级设置】中配置 UTM 参数。设置步骤如下：
- 在 SmartPush 应用中，前往 【营销活动】>【活动列表】。
- 创建新的邮件营销活动，或从列表中选择已有活动。
在设置页面中，向下滚动至【高级设置】>【UTM 数据追踪】区块。系统默认会应用以下参数值：
- utm_source: smartpush
- utm_medium: email
- utm_campaign: [活动ID]
启用【数据追踪参数自定义】后即可根据需要编辑这些参数。
适用于 A/B 测试活动
对于 A/B 测试活动，您可以在活动的【高级设置（选填）】中配置 UTM 参数。设置步骤如下：
- 在 SmartPush 应用中，前往【营销活动】>【活动列表】。
- 创建新的 A/B 测试活动，或从列表中选择已有活动。
在完成 A/B 测试版本设置后，进入【高级设置（选填）】>【UTM 数据追踪】区块。系统默认会应用以下参数值：
- utm_source: smartpush
- utm_medium: email
- utm_campaign: [活动ID]
启用 【数据追踪参数自定义】 后即可根据需要编辑这些参数。
适用于短信营销
对于 短信营销活动，您可以在活动设置页面中配置 UTM 参数。设置步骤如下：
- 在 SmartPush 应用中，前往【营销活动】>【活动列表】。
- 创建新的短信活动，或从列表中选择已有活动。
在设置页面中向下滚动至【UTM 数据追踪】区块。系统默认会应用以下参数值：
- utm_source: smartpush
- utm_medium: sms
- utm_campaign: [活动ID]
启用【数据追踪参数自定义】后即可根据需要编辑这些参数。
适用于自动化流程
对于 自动化流程，每个节点都会自动附加 UTM 参数。若需自定义参数，请按照以下步骤操作：
- 在 SmartPush 应用中，前往【自动化】>【任务列表】。
- 创建新的自动化流程，或从列表中选择已有的自动化任务。
- 在流程编辑器中，点击需要配置 UTM 参数的【发送邮件】或【发送短信】节点。
在节点设置面板中找到【UTM 数据追踪】区块。系统默认会应用以下参数值：
- utm_source: smartpush
- utm_medium: email / sms（取决于节点类型）
- utm_campaign: automation:[自动化任务ID]_[节点ID]
启用 【数据追踪参数自定义】 后即可根据需要修改参数。
适用于弹窗表单
对于 弹窗表单，当启用 UTM 追踪后，弹窗中的链接可以附带 UTM 参数。设置步骤如下：
- 前往【弹窗表单】>【弹窗列表】。
- 创建新的弹窗表单，或从列表中选择已有表单。
在弹窗编辑器中，进入【表单设置】标签页。找到【UTM 数据追踪】区块并启用开关。启用后，系统会自动为弹窗触发的链接附加以下参数：
- utm_source: smartpush
- utm_medium: popup
- utm_campaign: [弹窗ID]
默认 UTM 参数
如果未启用自定义 UTM 设置，SmartPush 会自动应用以下默认参数：
| 场景 | utm_source | utm_medium | utm_campaign |
| 邮件营销活动 | smartpush | Email Campaign ID | |
| 短信营销活动 | smartpush | sms | SMS Campaign ID |
| 自动化流程 | smartpush | email / sms | automation:[[FlowID]]_[[NodeID]] |
| 弹窗表单 | smartpush | popup | Popup ID |
高级设置与自定义 UTM 追踪
UTM 追踪默认已启用。SmartPush 提供进阶 UTM 设置，允许您自定义 UTM 追踪参数。
- 自定义 UTM 参数： 此自定义选项默认关闭。用户启用后，可覆盖系统默认参数值。
- 折叠视图： 当未选择自定义选项时，UTM 参数字段将保持隐藏。
- 展开视图： 当启用该选项时，所有 UTM 配置字段将显示，并可进行自定义。
- 提示 / FAQ： 将鼠标悬停在问号图标（?）上，可查看以下说明：
UTM 参数会附加到页面 URL 中，用于追踪流量来源。如果未启用自定义 UTM 追踪，SmartPush 会自动应用默认参数值。请谨慎修改这些设置。
可配置的 UTM 字段
以下 UTM 字段可以自定义：
- utm_source
- utm_medium
- utm_campaign
在创建新节点或节点尚未编辑时，系统会自动填充以下默认值：
- Utm_source: smartpush
- utm_medium
- email（邮件节点）
- sms（短信节点）
- Utm_campaign
- 营销活动：[活动ID]
- 自动化流程：[自动化任务ID]_[节点ID]
变量逻辑（仅适用于自动化）
- 只有 utm_campaign 支持变量：[自动化任务ID]_[节点ID]。
- 变量可通过正确格式手动输入。无效变量将被视为普通文本。
- 删除变量时，该变量会作为一个整体被移除。
输入验证
UTM 字段会进行以下验证：
- 最大长度
- 非法字符
复制与 A/B 测试
- 当复制启用了自定义 UTM 追踪的 自动化任务或营销活动 时，其 UTM 配置也会自动复制。
- 使用 A/B 测试 的弹窗表单，以及包含链接按钮（例如 加入购物车）的弹窗，也支持 UTM 追踪。
查看 UTM 数据
要查看 UTM 追踪数据，请前往 SmartPush 后台的 【数据分析】 页面。
在 【自动化】 或 【营销活动】 的数据视图中，【UTM 数据追踪】 列会显示每个节点或活动使用的最新 UTM 参数。
对于子节点，点击父节点旁的 展开图标（+），即可查看各个子节点的 UTM 数据。
最佳实践
为确保追踪结果准确，建议遵循以下实践：
- 仅在了解追踪需求的情况下修改 UTM 参数
- 使用一致的活动命名规则，以便更清晰地分析数据
- 在设置 UTM 参数后始终测试链接，以确认追踪正常运行