跳到主要内容
版本:3.x

接入腾讯有数无痕埋点能力

Taro 引入了腾讯有数的微信小程序无痕埋点能力,为 Taro 的开发者提供真·零开发的 8 大无痕埋点能力以及自定义埋点能力,包含小程序启动、显示、隐藏、页面浏览、页面离开、分享、下拉刷新、上拉触底八大自动化埋点能力以及搜索、商品归因等定制化埋点,以及经营分析、直播分析、导购分析等能力。

腾讯有数简介

腾讯有数是由腾讯智慧零售推出,为品牌商、零售商打造的数据分析与管理平台,融合腾讯数据、技术与生态优势,提供全链路经营数据分析、消费者洞察、精准营销等能力,让企业经营更“有数”。

更多介绍请关注:https://mp.zhls.qq.com/youshu-docs/start/youshu_intro.html

功能介绍

腾讯有数 & Taro 合作开发的微信小程序模板,可以快速的通过 taro init myApp 选择 default-youshu 模板即可快速拥有无痕埋点能力,无需任何开发即可拥有小程序启动、显示、隐藏、页面浏览、页面离开、分享、下拉刷新、上拉触底等八大自动化埋点能力。

零开发快速体验指南

需要升级 Taro 到 2.x 或 3.x

  1. taro init myApp
  2. 选择default-youshu模板
  3. npm run dev:weapp
  4. 微信小程序开发者工具控制台即可看到 8 大行为日志上报
  5. 访问 https://docs.qq.com/form/fill/DUkZHalR0RUJCVkVj#/fill 申请有数数据查看权限

通过上述流程已经让你的微信小程序拥有了 8 大用户行为埋点的体验能力,体验完成后,只需要更换有数的 Token 和微信小程序 appid,即可拥有有数的正式版功能。正式账号获取路径:https://docs.qq.com/form/fill/DUkZHalR0RUJCVkVj#/fill

现存小程序的有数 SDK 接入

1. 安装

  • 通过 npm 安装 SDK npm i sr-sdk-wxapp
  • 在 app.jsx 中通过 import 引入 SDK import sr from 'sr-sdk-wxapp'

2. 添加可信域名

登录微信公众平台,进入<开发><开发设置><服务器域名>,将 https://zhls.qq.com 添加为 request 合法域名。

在开发环境中还有 SDK 版本检查,所以会提示 https://sr-home-1257214331.cos.ap-guangzhou.myqcloud.com 不在以下 request 合法域名列表中 , 可以通过设置不校验域名来处理。

3. init 初始化

init(options: object)

配置接口,用来调整 SDK 的基础机制。应该在App()调用之前调用。

首次调用初始化 SDK,再次调用覆盖之前传入的配置,可多次调用。

名称类型必填描述
appidstringY微信小程序 appId
tokenstringY通过接入申请后,有数提供的凭证字符串
usePluginbool是否使用了小程序插件,默认是:false
debugbool是否打印日志,默认是:false
openSdkShareDepthbool是否打开分享链路记录功能,默认值为 false,打开后,将记录用户分享链路 A->B->C->D
serverUrlstring传入自定义的后台上报接口,若传入则 token 将无意义, 默认是:'https://zhls.qq.com/api/report'
trackAppbool是否开启自动跟踪 APP 的曝光事件(APP 相关预置事件,如 APP - onLuanch),默认是:true
proxyPagebool是否开启自动代理 Page,默认是:false。SDK 负责上报页面的 browse 、leave、share 等事件可以使用 sr.page 代替 Page(sr.page(options))
autoStartbool是否开启自动开始上报,默认是:false,open_id 无法自动获取,一般在 login 业务之后手动调用 sr.startReport 方法开启上报

4. 示例

import sr from 'sr-sdk-wxapp'
sr.init({
/**
* 有数 - ka‘接入测试用’ 分配的 app_id,对应的业务接口人负责
*/
token: 'bi72fccc7184ef4xxx',
/**
* 微信小程序appID,以wx开头
*/
appid: 'wx195745e8e342bxxx',
/**
* 如果使用了小程序插件,需要设置为 true
*/
usePlugin: false,
/**
* 开启打印调试信息, 默认 false
*/
debug: true,
/**
* 建议开启-开启自动代理 Page, 默认 false
* sdk 负责上报页面的 browse 、leave、share 等事件
* 可以使用 sr.page 代替 Page(sr.page(options))
* 元素事件跟踪,需要配合 autoTrack: true
*/
proxyPage: true,
/**
* 建议开启-开启组件自动代理, 默认 false
* sdk 负责上报页面的 browse 、leave、share 等事件
*/
proxyComponent: true,
// 建议开启-是否开启页面分享链路自动跟踪
openSdkShareDepth: true,
// 建议开启-元素事件跟踪,自动上报元素事件,入tap、change、longpress、confirm
autoTrack: true,
})