推广参数的创建和使用

概述

推广参数用于为营销内容生成可追踪的推广链接和二维码，并支持下载物料、导出推广链接。本指南说明推广参数的配置入口、创建与维护、内容推广使用、生成状态、下载导出规则和 UTM 行为记录。

一期功能覆盖以下范围：

• 在 系统设置 > 线索与来源设置 > 推广参数 中维护推广渠道或 UTM 参数。
• 在营销内容推广面板中批量生成推广链接和二维码。
• 查看、复制、下载推广二维码，并导出 XLSX 链接清单。
• 在用户行为、线索和推广来源记录中保存 UTM 参数。

文中截图来自 Wiki 产品方案附件。为避免公开租户信息，截图顶部的企业和租户标识已做像素化处理。

开始之前

• 你需要具备营销管理或系统管理员权限，才能维护推广参数。
• 推广人员需要具备营销内容推广权限，才能在内容推广面板中选择参数并生成推广记录。
• 确认企业已完成营销内容、线索来源和用户行为记录的基础配置。
• 确认市场、销售和数据运营团队已经统一推广渠道和 UTM 字段口径。

[!IMPORTANT]
推广渠道和 UTM 参数是两种互斥的租户级推广参数类型。系统同一时间只启用一种类型，生成一条推广记录时不能同时选择推广渠道和 UTM 参数。

第一步：选择推广参数类型

1. 进入 系统设置 > 线索与来源设置 > 推广参数。
2. 在推广参数类型中选择 推广渠道 或 UTM 参数。
3. 点击 保存，将选择的类型设置为当前启用类型。
4. 根据当前类型维护可供推广人员选择的配置项。

推广渠道用于标记传播渠道，UTM 参数用于保存可复用的投放标记。两类配置分别保存；切换类型只影响后续新建推广链接，不会删除另一类配置，也不会改写历史推广记录、链接或二维码。

图 1：选择推广渠道或 UTM 参数作为当前租户级类型。

推广渠道

推广渠道用于表示内容通过什么渠道传播。管理员可以新建、编辑和删除自建渠道。已删除的渠道不再供新推广记录选择，但历史记录继续保留，并显示“推广渠道已删除”。

UTM 参数

UTM 参数至少包含参数名称和 utm_source，其余字段按当前校验规则填写：

字段	说明
参数名称	租户内唯一，用于在推广面板中识别配置项
utm_source	必填，表示流量来源
utm_medium	可选，表示流量媒介
utm_campaign	可选，表示活动或投放计划
utm_content	可选，表示内容或创意
utm_term	可选，表示关键词

删除 UTM 参数后，它不再供新生成选择；历史推广链接仍然有效，生成记录中显示“UTM 参数已删除”。编辑配置只影响后续生成，历史记录使用生成时保存的参数快照。

图 2：推广渠道列表与维护入口。

图 3：UTM 参数列表。

第二步：维护推广参数

新建 UTM 参数

1. 在 推广参数 页面选择 UTM 参数。
2. 点击 新建。
3. 填写参数名称和 UTM 字段。
4. 检查参数名称在当前租户内没有重复。
5. 点击 保存。

图 4：新建 UTM 参数。

编辑或删除参数

1. 在参数列表中找到目标推广渠道或 UTM 参数。
2. 点击 编辑，修改配置后保存；或点击 删除，确认删除。
3. 删除前确认没有正在执行的推广计划依赖该配置。
4. 删除后检查历史推广记录仍可查看，且新建推广链接时不再出现该配置。

[!NOTE]
配置删除不会删除已经生成的链接或二维码。历史推广记录保留生成时的参数快照，便于复盘和导出。

第三步：在营销内容中生成推广链接

1. 打开要推广的营销内容。
2. 进入内容的 推广 面板。
3. 点击 新增。
4. 在选择器中选择当前启用类型下的一个或多个推广渠道或 UTM 参数。
5. 确认已选择至少一个参数。
6. 点击 提交。

针对一个内容选择 N 个参数时，系统创建 N 条推广记录，每条记录对应一个链接和二维码。推广渠道与 UTM 参数不会交叉组合生成。

提交后，系统逐条异步生成推广链接和二维码。系统会先创建“生成中”记录，再生成短链和二维码。重复提交不会重复生成；原先“超过 10 组转后台生成”的阈值已取消，所有记录均按逐条异步方式处理。

图 5：从营销内容的推广面板进入推广二维码与链接。

图 6：推广渠道模式下选择一个或多个渠道。

图 7：UTM 模式下选择一个或多个参数。

第四步：查看生成状态并处理失败记录

推广记录按实际生成状态展示：

生成状态	说明	二维码下载	链接导出	可执行操作
生成中	已创建记录，正在生成链接和二维码	不可下载	保留记录，推广链接为空	等待
生成成功	链接和二维码均已生成	可以下载	导出完整推广链接	查看、下载、删除
生成失败	链接或二维码生成失败，记录保留	不可下载	保留记录，推广链接为空	重试、删除

1. 打开内容的推广记录列表。
2. 查看记录的生成状态和参数名称。
3. 对生成成功的记录执行查看、复制链接或下载二维码。
4. 对生成失败的记录点击 重试。
5. 重试仍失败时，检查短链和二维码服务状态，并保留失败记录供排查。

历史记录按 推广渠道 和 UTM 参数 分类展示，不受当前启用类型影响。如果没有历史记录，页面只展示当前启用的推广参数类型，不显示空的历史页签。

图 8：推广渠道历史记录及下载、导出入口。

图 9：UTM 历史记录及生成结果。

图 10：营销内容中按 UTM 参数查看推广记录。

图 11：营销内容中按推广渠道查看推广记录。

第五步：下载二维码

二维码下载范围由当前列表、勾选状态和操作入口决定：

操作状态	处理范围
已勾选记录	只处理勾选记录
未勾选记录	导出当前内容、当前类型页签和当前筛选范围内的全部分页记录
单条记录下载	只处理当前记录
当前列表为空	提示暂无可下载记录

• 单条二维码下载为 PNG。
• 多条二维码下载为 ZIP。
• 只下载生成成功且二维码有效的记录；生成中、生成失败或二维码无效的记录会被跳过。
• 下载完成后提示成功下载数量和跳过数量。
• PNG 文件名格式为“参数名称_H5/小程序_生成时间.png”。
• 二维码压缩包文件名格式为“内容名称_推广二维码_下载时间.zip”。
• 下载使用记录中已经保存的二维码，不重新拼接链接或重新生成物料。

第六步：导出推广链接

1. 在当前内容的推广记录列表中选择要导出的记录；不勾选时，系统导出当前类型页签和当前筛选范围内的全部分页记录。
2. 点击 导出链接。
3. 下载生成的 XLSX 文件。
4. 打开文件，检查记录状态和完整推广链接。

导出文件名格式为“内容名称_推广链接_导出时间.xlsx”。每条推广记录占一行，包含以下字段：

导出字段	说明
内容名称	当前推广内容名称
参数类型	推广渠道或 UTM 参数
参数名称	推广渠道名称或 UTM 参数名称
utm_source	UTM 来源；推广渠道记录为空
utm_medium	UTM 媒介；推广渠道记录为空
utm_campaign	UTM 活动；推广渠道记录为空
utm_content	UTM 内容；推广渠道记录为空
utm_term	UTM 关键词；推广渠道记录为空
推广链接	记录中保存的完整推广链接
生成时间	推广记录生成时间
生成状态	记录实际生成状态

未成功生成的记录会保留在导出结果中，但推广链接为空。导出文件不包含推广记录编号、内容编号或内部对象 ID。当前列表为空时，页面提示暂无可导出记录。

[!WARNING]
导出使用生成时保存的参数快照和完整链接，不根据当前配置重新拼接。修改或删除推广参数不会改变历史导出结果。

第七步：检查 UTM 行为记录

系统在采集用户行为时解析访问链接中的 UTM 参数，并将参数写入用户行为记录：

字段	记录规则
utm_source 来源	优先读取当前访问链接；当前访问未携带参数时，沿用该访客本次会话已记录的值；都没有则留空
utm_medium 媒介	按当前访问链接或会话记录写入
utm_campaign 活动	按当前访问链接或会话记录写入
utm_content 内容	按当前访问链接或会话记录写入
utm_term 关键词	按当前访问链接或会话记录写入

线索对象、营销推广来源和用户行为记录对象在保存数据时，应根据营销内容携带的推广参数写入 UTM 字段和推广渠道字段。普通内容推广链接或二维码中的 UTM 参数用于记录推广来源，不触发广告市场活动匹配或自动创建。

预期结果与验证

完成配置后，至少验证以下场景：

1. 切换推广渠道和 UTM 参数类型，确认同一时间只有一种类型可用于新建推广链接。
2. 在一个内容中选择多个参数，确认每个参数生成一条独立记录。
3. 检查生成中、生成成功和生成失败状态是否正确展示。
4. 对生成失败记录执行单条重试，确认不会重复生成成功记录。
5. 勾选部分记录下载二维码和导出链接，确认只处理勾选范围。
6. 不勾选记录下载或导出，确认处理当前内容、当前页签和当前筛选条件下的全部分页。
7. 检查 XLSX 文件字段、生成状态和失败记录的空链接。
8. 使用带 UTM 参数的链接访问内容，确认用户行为和推广来源记录保存对应参数。

常见问题与故障排除

为什么推广面板中看不到刚创建的参数？

检查租户当前启用的推广参数类型。推广面板只展示当前启用类型下的配置项；如果刚创建的是 UTM 参数，但当前启用的是推广渠道，就不会出现在选择器中。

删除参数后，历史推广链接会失效吗？

不会。删除只会阻止新记录继续选择该配置，历史推广记录仍保留原参数快照、链接和二维码。

为什么生成记录一直显示“生成中”？

异步任务仍在处理。先刷新列表并检查短链、二维码服务状态；长时间不变化时，记录保留为生成中，需由管理员结合服务日志排查。

生成失败的记录如何处理？

确认短链和二维码服务正常后，在记录行点击 重试。单条重试只处理当前记录，不影响其他已成功记录。

为什么导出的推广链接为空？

生成中或生成失败的记录不会伪造链接，导出时保留记录状态但链接为空。等待生成完成或重试成功后再导出。

UTM 参数会自动创建广告市场活动吗？

普通内容推广链接和二维码中的 UTM 参数只记录推广来源，不触发广告市场活动匹配或自动创建。广告投放场景使用单独的广告 UTM 设置和市场活动关联规则。

相关主题

• 用户行为记录与来源分析配置
• 线索来源分类配置
• 营销对象与线索池配置