面向中小商家的微信视频号小店关联小程序轻埋点全链路数据实操指南

一、前期准备清单

本次操作无需代码基础，100%面向中小商家落地，准备以下3项内容：

• 已开通视频号小店并完成关联认证的个人/企业微信小程序（非个人主体小程序无法获取用户信息）
• 轻量级免费开源埋点工具「神策数据埋点助手」（获取地址：https://github.com/sensorsdata/sa-sdk-miniprogram/releases/tag/v2.1.7）
• 微信开发者工具（获取地址：https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html）

二、埋点SDK安装与基础配置

1. 下载并解压埋点SDK

点击准备清单中的神策SDK链接，找到「sa-sdk-miniprogram-v2.1.7.zip」下载包，解压后得到核心文件「sensorsdata.min.js」。

2. 将SDK引入小程序

打开微信开发者工具，导入你的已关联视频号小店的小程序项目，按以下步骤操作：

• 在小程序根目录下新建文件夹，命名为sensors
• 将解压后的「sensorsdata.min.js」复制到「sensors」文件夹内

3. 完成基础初始化配置

找到小程序根目录的app.js文件，复制以下完整代码替换原有「App({」及之后的开头内容（保留原文件中除开头框架外的其他逻辑）：

```javascript // 引入SDK import sensors from './sensors/sensorsdata.min.js'; App({ onLaunch() { // 初始化神策埋点（无需修改以下必填字段，后续需替换接收数据的测试地址） sensors.init({ name: 'sensors', server_url: 'https://shenceyun.com/sa?project=mall_universe_test', // 后续替换为你的免费神策云项目地址 show_log: true, // 开发阶段开启日志，生产环境设为false appid: '你的小程序AppID', // 替换为你小程序后台的AppID allow_amend_share: true, // 支持获取分享链路信息 use_client_time: true }); // 自动采集小程序预置事件（启动、退出、页面浏览、点击、分享、支付） sensors.quick('autoTrack'); // 原有的其他onLaunch逻辑保留在此 } }) ```

三、配置免费神策云项目接收数据

1. 注册并创建测试项目

• 访问神策云官网（https://www.shenceyun.com/），点击「免费试用」注册账号，选择「基础版」免费套餐
• 登录后进入「项目管理」→「新建项目」，填写项目名称为「视频号小店全域运营」，数据接收方式选择「小程序SDK」，点击「创建」

2. 替换小程序内的数据接收地址

• 在神策云「项目设置」→「数据接入」→「小程序SDK」中，找到「Server URL」字段，复制完整地址
• 回到微信开发者工具的app.js文件，将原来的测试地址替换为刚复制的地址，保存文件

四、关联视频号小店的核心事件手动埋点

SDK自动采集的事件覆盖基础行为，但需手动埋点关联视频号小店跳转、从视频号小店返回小程序等核心全域行为：

1. 埋点「跳转视频号小店」事件

找到小程序内所有跳转到视频号小店的按钮/图片对应的代码页面（比如首页banner、商品详情页的「去视频号购买」按钮），替换原有跳转逻辑为以下代码：

```javascript // 假设原有跳转代码在某个点击事件函数onBuyVideoGoods中 onBuyVideoGoods: function(e) { // 先埋点记录跳转行为（手动采集自定义事件） const properties = { product_id: e.currentTarget.dataset.id, // 替换为你跳转商品的ID（从按钮dataset获取） product_name: e.currentTarget.dataset.name, // 替换为商品名称 entry_page: getCurrentPages()[getCurrentPages().length - 1].route // 自动获取当前跳转页面路径 }; sensors.track('jump_to_video_shop', properties); // 保留原有跳转到视频号小店的代码（原代码不要删除，放在埋点之后） wx.navigateToMiniProgram({ appId: 'wx2c856a2a6d42e839', // 微信视频号小店固定的关联小程序AppID path: 'pages/product/index?product_id=' + e.currentTarget.dataset.id // 替换为视频号小店的商品路径 }) } ```

2. 埋点「从视频号小店返回」事件

在小程序根目录的app.js文件中，找到或新建「onShow」生命周期函数，添加以下代码：

```javascript onShow: function(options) { // 判断是否是从视频号小店返回 if (options.scene === 1007 || options.scene === 1008 || options.referrerInfo.appId === 'wx2c856a2a6d42e839') { const properties = { return_reason: 'unknown' // 后续可结合神策预置事件完善，比如是否完成支付 }; sensors.track('return_from_video_shop', properties); } // 原有的其他onShow逻辑保留在此 } ```

五、开发阶段验证埋点数据

按以下步骤确保埋点数据正常发送：

• 在微信开发者工具顶部点击「编译」，再点击「预览」，用微信扫码在真机打开小程序
• 在真机小程序内依次操作：点击首页、浏览1个商品、点击「去视频号购买」、返回小程序
• 回到微信开发者工具底部的「调试器」→「Console」面板，搜索「sensors」，查看是否有「event send success」的日志输出
• 同时打开神策云「数据管理」→「实时数据」，查看是否有对应操作的实时数据（延迟不超过10秒）

六、生产环境部署与数据查看

1. 关闭开发日志并上传代码

• 回到微信开发者工具的app.js文件，将「show_log」字段的值改为false
• 点击顶部「上传」按钮，填写版本号（比如v1.0.1）和项目备注（比如“添加全域埋点”），上传到微信小程序后台

2. 提交审核并发布

• 登录微信小程序后台，进入「版本管理」→「开发版本」，找到刚上传的版本，点击「提交审核」
• 审核通过后，点击「发布」按钮完成部署

3. 查看全域运营核心数据

登录神策云，进入「数据看板」→「新建看板」，选择「视频号小店全域运营」项目，拖拽以下预置/自定义指标组成核心看板：

• 预置指标：小程序日活跃用户数、页面浏览量、分享次数
• 自定义指标（需先在「数据管理」→「事件管理」中审核通过自定义事件）：跳转视频号小店次数、从视频号小店返回次数