概述
外部内容对接的操作说明。
开始之前
[!IMPORTANT]
使用有权访问本功能的账号。按下方步骤准备对应的业务数据或配置资料。
操作说明
当官网、外部商城、第三方活动页或第三方小程序承载实际内容时，可以通过外部内容对接，把推广来源带到外部页面，并将外部产生的访问、注册、加购、下单等结果回传到 CRM，方便市场人员查看不同活动、渠道和推广人员带来的效果。
这不是单纯的文章编辑操作，通常需要营销运营人员、营销通管理员和外部系统开发人员共同完成。
适用场景
- 官网承载产品介绍、资料下载或试用申请；
- 外部商城承载商品详情、加购和订单；
- 第三方活动页承载报名或预约；
- 第三方小程序承载商品、服务或会员页面；
- 使用外部系统生成海报和二维码，并开展全员推广。
对接前先明确三件事
- 外部页面在哪里承载：确认官网、商城、活动页或小程序的页面地址和负责人。
- 要跟踪哪些来源：确认市场活动、推广活动、推广人员等来源信息是否需要记录。
- 要回传哪些结果：确认要回传访问、注册、加购、下单等行为，以及订单和订单明细等交易数据。
基本对接流程
- 在营销通中准备市场活动、推广活动或全员推广任务。
- 由开发人员确认外部系统接收来源参数的接口。
- 在活动、内容或外部海报中配置外部页面或二维码。
- 外部系统保存来源参数，并在用户访问或完成业务动作时记录对应用户。
- 外部系统按约定接口把行为或交易结果回传到 CRM。
- 使用测试链接、测试二维码和测试账号验证来源、行为和交易是否关联正确。
- 验收通过后再用于正式推广。
来源参数
外部系统通常需要接收并保存以下系统参数：
| 参数名称 | 用途 |
|---|---|
marketingEventId |
市场活动 ID，用于追溯用户来自哪场市场活动。 |
marketingActivityId |
推广活动 ID，用于追溯活动下的某次推广任务。 |
outerQrcodeSpreadFsUid |
营销通中的推广员工 ID。 |
mobile |
推广人员手机号，用于匹配推广员工并统计员工推广效果。 |
外部系统也可以根据实际业务接收自定义参数，例如小程序 ID、商品详情页链接或产品编号。具体参数名称、字段格式和接口方式由开发人员根据实际 API 确认，运营人员不需要手工修改代码。
外部海报和二维码
在活动营销、会议营销或直播营销中使用外部系统生成海报时：
- 选择由外部系统生成二维码或海报；
- 填写外部系统需要的自定义参数；
- 确认外部系统能够接收营销活动和推广人员等来源参数；
- 如需全员推广，创建推广任务并下发给员工；
- 员工在 APP 或企业微信端接受任务，生成自己的专属海报；
- 先使用测试员工和测试二维码验证来源是否正确，再正式发布。
[!NOTE]
外部二维码能够带来来源信息的前提，是外部系统能够接收、保存并继续传递这些参数。只生成二维码但没有保存来源参数，后续无法准确做推广溯源。
行为数据回传
外部系统可以把用户在外部页面上的行为回传到 CRM 的“用户行为记录”对象，例如：
- 访问商品或活动页面；
- 注册或提交预约；
- 加入购物车；
- 下单或完成支付；
- 观看内容或完成其他业务动作。
回传时至少需要明确：用户如何识别、发生了什么行为、行为发生时间、对应的活动或推广来源。用户识别可以使用外部系统的用户唯一标识，或在业务允许时使用可匹配的手机号。
常见记录内容包括：
| 内容 | 说明 |
|---|---|
| 用户编号 | 外部系统中能识别用户的唯一编号。 |
| 行为动作 | 例如访问商品、注册、加入购物车、下单支付。 |
| 行为时间 | 行为实际发生的时间。 |
| 对象类型和名称 | 例如产品、优惠券、活动及其具体名称。 |
| 市场活动 | 对应的市场活动 ID。 |
| 推广活动 | 对应的推广活动 ID。 |
| 推广用户 | 对应的推广员工或手机号。 |
如需在市场活动详情页查看这些记录，需要由管理员把“用户行为记录”配置到相应页面或报表中。是否进一步同步到营销用户动态，要根据实际项目配置工作流或接口。
交易数据回传
如果外部商城或小程序产生订单，可以通过接口将订单、订单明细和关联产品等数据同步到 CRM，用于分析活动、内容和推广人员带来的交易结果。订单字段、数据匹配方式和接口权限由开发人员与管理员共同确认。
运营、管理员和开发人员的分工
- 运营人员：明确活动、内容、渠道和要统计的行为，准备测试场景并验收结果。
- 营销通管理员：确认市场活动、推广任务、CRM 对象、权限、安全域名和白名单配置。
- 外部系统开发人员：接收来源参数、保存参数、生成二维码、开发行为/交易回传接口，并处理数据匹配。
[!WARNING]
外部页面、二维码和接口在 HTTPS、安全域名、白名单或参数回传未完成前，不要直接用于正式推广。外部内容能打开，不代表来源和行为已经能够被 CRM 正确记录。
相关内容：
外部内容对接操作说明
使用场景
自有内容或第三方系统制作的内容需要通过营销通推广时，可以通过营销通将外部系统的 H5 链接或者二维码海报推送出去，并下发推广参数（市场活动、当前推广任务、推广员工等）到外部系统，若外部系统支持记录这些参数后，支持回传到营销通做全链路跟踪
营销通对应功能入口
外部 H5 内容推广
在市场活动详情页中，推广内容栏点击新增外部推广内容，进行外部内容配置，比如可以使用易企秀、兔展等外部系统的推广页面，配置完成后可以针对这些外部内容发起全员推广或群发推送。也会记录相关推广人信息
微页面中跳转外部小程序或者 H5 内容
企微欢迎语、消息群发中外部内容推广
外部海报内容推广（灰度功能，使用需联系客户经理）
对接外部系统的内容进行推广，比如动态生成外部商品二维码，推广后跟踪在自建商城中的访问、注册、下单等全链路数据，精准评估活动价值。 操作路径：系统设置>营销插件>外部推广码对接，首先在开通插件配置后，需要设置外部系统的二维码生成地址，在直播、会议等活动中配置外部推广二维码海报并下发推广任务 > 员工推广相关内容 > 客户访问外部内容 >系统回传外部推广数据 > 查看推广转化详情，完成全链路数据跟踪。对接配置中需要提供二维码生成接口，营销通在生成海报时，会自动调用并动态生成到海报中。后期外部系统接收的参数可以再回传到 CRM 对象，进行整体数据分析。
插件配置：
首先在系统设置>营销插件>外部推广码对接中配置二维码生成地址，用于后期自动生成海报上的二维码。此地址无需做授权处理，支持在创建海报地方再传递个性化参数，见下方文档，比如链接后加当前账号信息等，后期会传递到二维码接口中。接口返回数据格式如下
{
"msg": "",
"result": 1,
"retVal": {
"imageUrl": "http://-.com/**"
}
}
返回的图片链接访问图片格式为 png、jepg、jpg 任意一种，可以直接在浏览器访问到。如果是小程序的圆形码，需要设置为透明背景，否则贴到海报上的效果不佳。
- 制作海报
在活动营销会议营销直播营销中制作外部海报时，选择外部系统生成，可以支持外部参数设置，比如小程序 ID、商品详情页链接、产品编号等，这些自定义参数会回传给二维码接口，后续外部系统接收到这些参数后可以执行自定义业务逻辑。比如生成的小程序二维码就是指定跳转某个商品详情页的。除此自定义参数外，营销通还会将部分系统预置参数传递到外部系统，用于后续回传做 ROI 评估。
系统预置参数如下：
| 参数名称 | 类型 | 示例及作用 |
|---|---|---|
| marketingEventId | 文本 | 市场活动 ID，用与整个活动溯源 |
| marketingActivityId | 文本 | 推广活动 ID，用于活动下的某个全员推广溯源 |
| outerQrcodeSpreadFsUid | 文本 | 营销通中推广员工 ID |
| mobile | 文本 | 推广人员手机号，用户后续查询匹配对应员工，做员工推广溯源 |
- 下发全员推广任务
鼠标 hover 到海报上时，会出现推广按钮，进入后选择全员营销，配置全员营销相关信息，确认下发。
- 员工接受任务并推广
任务下发后，员工在 APP 或企微端会收到任务通知卡片。点击进入后，实时绘制自己的专属海报，此时会调用配置的图片生成接口，将生成二维码贴到海报上，保存或一键转发到微信或好友。
行为及交易数据回传到 CRM 中展示
行为数据上报及展示
客户识别二维码后，直接进入第三方系统，进入页面时，外部系统可以从链接中，直接获取到营销通第一步中，预设的系统参数，活动、推广及员工手机号。并记录需要上报的行为。如访问、注册、加购、下单事件，基于自有需求自定义上报。营销通中使用 CRM 中的用户行为记录对象来承载用户的所有行为记录，外部系统的行为记录可以直接使用此对象进行数据存储。API 接口可以参考 https://open.fxiaoke.com/ ，以下参数仅做参考，也可以完全在此对象上新增一些自定义字段，存储更多信息。
| 回传参数 | 参数说明，具体参数 apiName 请在开发平台中通过 API 获取 |
|---|---|
| 用户编号 | 必填文本，请直接使用小程序获取的用户 unionid，或者能识别用户唯一身份的手机号 |
| 用户名称 | 非必填文本，小程序注册用户的名称或者是昵称 |
| 渠道平台 | 非必填文本，可以统一写小程序商城 |
| 渠道账号 | 非必填文本，可以写小程序的名称如A 商城 |
| 行为动作 | 必填单选，需要提前新增自定义行为，比如访问商品、加入购物车、下单支付 |
| 行为分类 | 必填单选，固定值选用户动态 |
| 对象类型 | 必填单选，可以使用现有的产品优惠券活动等 |
| 对象名称 | 必填文本，按需要填写，比如产品具体名称，优惠券具体名称 |
| 行为时长 | 非必填数字，分钟总数 |
| 行为时间 | 必填时间日期，如 2099-12-31 16:31 |
| 营销场景 | 非必填单选，可以默认是活动营销 |
| 市场活动 | 非必填文本，使用上方传递给商城的市场活动 ID 插入即可 |
| 推广活动 | 非必填文本，使用上方传递给商城的推广活动 ID 插入即可 |
| 推广方式 | 非必填单选，默认全员营销 |
| 推广用户 | 非必填文本，可以直接填写上方传递给商城的推广用户手机号 |
展示行为数据到活动中：
- 在营销通系统设置>市场活动设置>市场活动业务布局组件中，将用户行为记录配置到活动详情页展示，也可以基于用户行为记录表做独立数据报表
- 若需要将用户行为记录再同步到用户的营销动态中，需要基于用户行为记录对象，创建工作流，执行 APL，写到营销通用户库，APL 可以联系营销通团队提供。
交易数据上报及展示
CRM 中预制有产品和订单、订单产品等对象，可以通过 API 将第三方系统的具体交易明细同步到 CRM 业务对象中，做端到端的营销推广溯源统计。
预期结果与验证
完成上述操作后，在对应页面检查处理结果，并与本步骤的目标核对。
常见问题与故障排除
无法继续操作时，先核对上文说明的条件和输入信息；遇到权限提示时，请管理员确认访问权限。