视频号营销-小程序自行接入开发文档

注意：接入流程需贵公司具备开发资源，并由开发人员进行接入

一、资源准备

小程序帐号：需由贵司自行准备
若贵司还未申请小程序帐号，可点击开始 | 微信开放文档查看申请流程
小程序需和绑定在企业微信后台的公众号/小程序同属一个微信开放平台

二、接入

接入前建议先查看本文档内【四、FAQ-视频号营销实现逻辑】

以下提供视频号营销小程序最小实现 demo 源码供参考（注：请仔细查看源码中标记为 NOTE 的注释）

源码地址：

https://e.coding.net/nightingales-tech/external-link-demo/external-link-demo.git

// 可直接复制以下命令到命令行，按回车拉取项目

git clone https://e.coding.net/nightingales-tech/external-link-demo/external-link-demo.git

本地接入验证（可选）：

在您开发完成接入逻辑后，可先在本地进行接入验证，将原本从 pageParams 中取参数的逻辑改为直接赋值，（*以下验证代码为本地接入验证用，验证结束后需删除）：

// 本地接入验证用，验证结束需删除

const feed_id =

'export/UzFfAgtgekIEAQAAAAAAOhYYKlFtywAAAAstQy6ubaLX4KHWvLEZgBPE56MoRmYFZcKDzNPgMJq_I-iXMLCbG04dc8jtKtO0'

const finder_username = 'sphHmqDqeE5074r'

const _c = 'X1BnU11BR24LCQoIV1NtVVdDRw'

const hid = 'ucZWEb32RtN'

更改保存后手机扫码预览如下图所示正常渲染视频号营销页面，点击视频会弹出授权提示框，点击【允许】正常跳转到视频号视频播放界面，即本地接入验证成功：

三、提交审核&发布

完成接入逻辑后，即可提交小程序进行审核

1、上传代码

2、选为体验版本

小程序代码上传后，即可在小程序管理后台的版本管理页面看到先前上传的小程序。将其选为体验版本，再进行一次体验版本的接入验证：

复制以下参数拼接到小程序引流链接页面路径后：

?feed_id=export/UzFfAgtgekIEAQAAAAAAOhYYKlFtywAAAAstQy6ubaLX4KHWvLEZgBPE56MoRmYFZcKDzNPgMJq_I-iXMLCbG04dc8jtKtO0&finder_username=sphHmqDqeE5074r&_c=X1BnU11BR24LCQoIV1NtVVdDRw&hid=ucZWEb32RtN

点击切换为体验版本，保存后用手机扫描体验版二维码，若小程序如上述【本地接入验证】扫码预览所示正常加载，点击视频会弹出授权提示框，点击【允许】正常跳转到视频号视频播放界面，则体验版本接入验证成功。

3、提交审核

提交审核后请耐心等待。审核通过后系统会下发通知到小程序管理员个人微信

4、发布

审核通过后，小程序管理员会收到审核通过通知，请在小程序管理后台-版本管理界面进行小程序发布

小程序发布成功后，可于管理后台配置弹框获取测试链接，用于最终测试视频号营销小程序是否接入成功；

四、FAQ

开发相关（For 开发同学）

1、能描述下视频号营销整个实现逻辑吗？

a. 视频号营销创建逻辑：

进行配置（配置成功后无需重复配置）：企业在微伴管理后台视频号营销功能页点击右上角设置按钮根据教程进行配置

b.配置流程中需配置的内容及作用：

将小程序授权给微伴助手第三方开发平台。作用：授权微伴第三方开发平台的身份
配置服务器域名。作用：配置服务器域名后，视频号视频页面才能正常发起请求并打开
配置小程序路径(path)。作用：微伴打开视频号视频页面，需要指定打开小程序的 path

c.生成视频号视频

微伴助手根据授权的视频号以及添加的短视频，在选择视频号视频附件时生成链接，该链接即为最终小程序可正常打开的页面链接，以下为示例链接：

pages/videoAccount?feed_id=export/UzFfAgtgekIEAQAAAAAAOhYYKlFtywAAAAstQy6ubaLX4KHWvLEZgBPE56MoRmYFZcKDzNPgMJq_I-iXMLCbG04dc8jtKtO0&finder_username=sphHmqDqeE5074r&_c=X1BnU11BR24LCQoIV1NtVVdDRw&hid=ucZWEb32RtN

小程序中的 videoAccount.js 页面会获取参数 feed_id、finder_username、_c、hid，同时会调用 wx.login 获取 code，用 code 换取 unionId、openId，根据参数 _c 及 hid 调用微伴服务，获取选择的视频号视频信息展示；根据 _c、 hid、 unionId 及 openId 调用微伴服务进行相关数据统计；点击视频时根据 feed_id、finder_username 及微信小程序提供的

wx.openChannelsActivity(Object object) API 打开视频号相关视频。

wx.openChannelsActivity(Object object) | 微信开放文档

2、参数 _c、hid、unionId、openId、feed_id、finder_username 的作用分别是什么？

a. 参数 _c 和 hid 用于公司和视频号视频配置的匹配，必传

b. 参数 unionId、openId 用于视频号视频的访问数据统计，必传

c. 参数 feed_id、finder_username 用于访问视频号上对应的视频，必传

3、什么是 unionId、openId？

a. UnionID 机制说明 | 微信开放文档

b. openId 为用户唯一标识

运营相关（For 运营同学）

UnionID 机制说明 | 微信开放文档：如果开发者拥有多个移动应用、网站应用、和公众帐号（包括小程序），可通过 UnionID 来区分用户的唯一性，因为只要是同一个微信开放平台帐号下的移动应用、网站应用和公众帐号（包括小程序），用户的 UnionID 是唯一的。换句话说，同一用户，对同一个微信开放平台下的不同应用，UnionID是相同的。（划笔记！！！这是以下理解问题1和2很关键的重点，也是理解微伴很多营销/引流功能逻辑的重点）

1、为什么需要unionID和openId？

需通过 unionID 和 openId 将进入小程序页面的客户身份识别，从而进行客户数据统计。

2、为什么小程序需要和绑定在企业微信后台的公众号/小程序同属一个微信开发平台

a. unionID的机制是在同一个微信开放平台下的不同应用用户unionID相同

b. 如果视频号营销用的小程序和企业微信后台绑定的公众号/小程序对应的不是同一个开放平台，那么同一个客户通过视频号营销小程序打开视频号视频后，我们无法判断是同一个人，也就意味着将无法进行数据统计（简单点说就是无法进行数据统计）

3、企业自己接入视频号营销小程序后，是否就不会被封禁了？

还是会存在被封的风险，请遵守微信公众平台运营规范相关细则，具体规则参考

原则及相关说明 | 微信开放文档

4、为什么我按流程配置好了小程序，在创建视频号视频后打开提示：页面出现了问题？

通过视频号视频附件进入的小程序页面路径，必须是已经发布的小程序存在的页面

本篇目录