该文档适用于友盟+微信小程序统计SDK 2.3.2 及以上版本。
登录友盟+官网,按照引导注册友盟+账号
特别提醒:我们建议开发者在注册账号时使用企业邮箱,避免使用个人邮箱注册,防止由于个人离职带来的问题,建议使用的账号形式 :umeng@企业域名、apps@企业域名、dev@企业域名
进入小程序统计后台创建Appkey,按要求填写小程序名称及类型:
您也可通过OpenAPI批量申请Appkey,具体文档参考:https://developer.umeng.com/open-api/docs/com.umeng.umini/umeng.umini.createMiniApp/1
行业分类请参考:https://developer.umeng.com/docs/147615/detail/169442若创建应用数超过300,请联系在线客服
注:在微信小程序内使用npm请参考https://developers.weixin.qq.com/miniprogram/dev/devtools/npm.html
在app.js文件内,添加如下代码,即可进行基础指标的统计:
注意:切记一定要正确设置umengConfig,不要拼写错误
当时
方法一:开发者需要额外添加代码上传openid,否则数据不会上报
参数:
- id(string): 开发者获取到的用户openid
返回值:
- 无
方法二:开启并在友盟后台设置有效appId及secret信息。友盟后台配置地址:https://mp.umeng.com/setting/appset
在微信开发者后台添加request合法域名:umini.shujupie.com
操作步骤:登录微信公众平台,进入小程序的 设置->开发->开发设置->服务器域名,把 umini.shujupie.com 加入 request合法域名,如图:
具体集成方式可参考demo:https://github.com/umeng/mp-demos
如需使用其他API,需要添加如下代码:
开发者自行设置用户的unionid
参数:
- id(string): 开发者获取到的用户unionid
返回值:
- 无
参数:
- id(string): 事件ID需在官网申请,长度在128个字符内
- params(object|string):object不能为数组
- 当params为object类型时,每个key长度不能超过256个字符
- 当params为object类型时,其携带key的个数不能超过100个
- 存在规则不合法情况时,丢弃整条事件
返回值:
* 无
注意:
- params为object类型时,属性值仅支持字符串和数值两种类型;
- 请在App.onLaunch之后调用事件。
- 进入U-MiniProgram后台“自定义事件”页面,点击“事件管理”;
- 点击“添加事件”,输入小程序埋点的事件ID和名称;
- 返回小程序自定义事件页面查看该事件数据。
当用户在您的小程序上注册以后,您的应用服务端会在用户数据库里添加一条记录并且分配一个用户ID,可以通过 接口设置该用户ID,以便后续做数据打通或基于应用用户ID做计算时使用。
参数:
- userId(string): 您的应用为用户生成的唯一ID
开发者可通过在配置中添加 选项来使友盟自动上报用户信息。将 设置为 则取消上报用户信息。上传的用户信息为小程序平台公开可获取的用户基础信息,例如昵称、头像、性别、地区、语言等,这些信息将用于U-MiniProgram产品中与用户相关的功能统计中。示例:
该方案仅提供验证是否集成成功的方法,由于在开发环境下可能会存在数据不完整的情况,请您正式发布小程序后在验证数据正确性。
- 按照上述描述方法引入SDK;
- 进入IDE打开调试工具中的选项,若看到有 提示 即表示SDK集成成功。
- 慎重调用以及接口!SDK会将用户相关操作数据缓存在客户端数据存储模块,在特定时间启动发送策略。若调用该接口可导致数据统计不准确的问题;
- 若用户在使用小程序过程强制关闭微信有可能会造成统计数据丢失的情况。
目前小程序SDK支持以下第三方框架,具体使用方法请参考demo:https://github.com/umeng/mp-demos
- uniapp
- taro
- chameleon
- mpvue
- wepy2
- 微信小游戏
目前只有2.2.0及以上版本的SDK才支持以上第三方框架
视频引导教程
- Q: 注册应用时,提示应用名称已存在
- A:【友盟+】后台的应用名与实际应用名和包名无关,建议命名为应用名+平台,例如:友盟+小程序(微信)、友盟+小程序(支付宝)
- Q: 我忘记我的Appkey了,在哪里能查到
- A:进入小程序统计-应用设置页面,可看到当前小程序的Appkey
https://developers.weixin.qq.com/miniprogram/dev/devtools/npm.html