适用范围

• 该文档适用于友盟+微信小程序统计SDK 2.3.2 及以上版本

• 统计由模板生成的小程序，请访问：https://developer.umeng.com/docs/147615/detail/170056

微信小程序统计SDK快速集成

1. 注册友盟+账号

登录友盟+官网，按照引导注册友盟+账号

特别提醒：我们建议开发者在注册账号时使用企业邮箱，避免使用个人邮箱注册，防止由于个人离职带来的问题，建议使用的账号形式 ：umeng@企业域名、apps@企业域名、dev@企业域名

2. Appkey申请

进入小程序统计后台创建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，请联系在线客服

3. 创建微信小程序并接入SDK

3.1 安装SDK

可以使用npm安装或SDK包下载方式；下载地址请查看文档：

https://developer.umeng.com/docs/147615/detail/184228

首次集成推荐使用正式版SDK

3.2 集成

在app.js 文件的顶部添加以下JS代码，即可进行基础指标的统计：

import 'umtrack-wx';

App({
  umengConfig:{
    appKey:'YOUR_UMENG_APPKEY',//由友盟分配的APP_KEY
    useOpenid:true,// 是否使用openid进行统计，此项为false时将使用友盟+随机ID进行用户统计。使用openid来统计微信小程序的用户，会使统计的指标更为准确，对系统准确性要求高的应用推荐使用OpenID。
    autoGetOpenid:true,// 是否需要通过友盟后台获取openid，如若需要，请到友盟后台设置appId及secret
    debug:true,//是否打开调试模式
    uploadUserInfo:true// 上传用户信息，上传后可以查看有头像的用户分享信息，同时在查看用户画像时，公域画像的准确性会提升。
}
});

3.3 使用 OpenID（可选）

当useOpenid: true时

方法一：开发者需要额外添加代码上传openid，否则数据不会上报

// 开启后必须额外添加代码上传OpenID，否则数据不会上报
wx.uma.setOpenid(openid)

参数：

• id(string): 开发者获取到的用户openid

返回值：

• 无

方法二：开启autoGetOpenid: true并在友盟后台设置有效appId及secret信息。友盟后台配置地址：https://mp.umeng.com/setting/appset

App({
  umengConfig:{
    appKey:'YOUR_UMENG_APPKEY',//由友盟分配的APP_KEY

    useOpenid:true,

// 授权友盟+通过后台自动获取openid，可防止数据统计过程中因未采集到OpenID而造成
// 数据丢失的情况。开启后请到友盟+小程序应用设置中添加appId及secret信息
    autoGetOpenid:true
}
})

3.4 增加友盟+数据服务域名

在微信开发者后台添加request合法域名：umini.shujupie.com操作步骤：登录微信公众平台，进入小程序的 设置->开发->开发设置->服务器域名，把 umini.shujupie.com 加入 request合法域名，如图：

3.5 SDK配置项总结及注意事项

3.6 demo

具体集成方式可参考demo：https://github.com/umeng/mp-demos

高级功能

如需使用其他API，需要添加如下代码：

import uma from 'umtrack-wx';

App({
  umengConfig:{
    appKey:'test5d886faf4ca357bfc900',
    useOpenid:true,
    autoGetOpenid:false,
    debug:true
},
  globalData:{
    uma // 请将uma模块绑定在gloabalData下，以便后续使用
}
});

1. setUnionid

开发者自行设置用户的unionid

setUnionid(id)

参数：

• id(string): 开发者获取到的用户unionid

返回值：

• 无

2. 自定义事件

参考：小程序自定义事件文档

3. 设置应用用户ID

当用户在您的小程序上注册以后，您的应用服务端会在用户数据库里添加一条记录并且分配一个用户ID，可以通过 setUserid 接口设置该用户ID，以便后续做数据打通或基于应用用户ID做计算时使用。

setUserid(userId, provider)

参数：

• userId(string): 您的应用为用户生成的唯一ID

• provider(string): ID提供方，兼容老接口使用，无特殊需要应忽略该参数返回值：无示例：

  wx.uma.setUserid('custom_userid');

4. 上传用户信息

开发者可通过在配置中添加 uploadUserInfo: true 选项来使友盟自动上报用户信息。将 uploadUserInfo 设置为 false 则取消上报用户信息。上传的用户信息为小程序平台公开可获取的用户基础信息，例如昵称、头像、性别、地区、语言等，这些信息将用于U-MiniProgram产品中与用户相关的功能统计中。示例：

import 'umtrack-wx';
App({
  umengConfig:{
    appKey:'YOUR_UMENG_APPKEY',//由友盟分配的APP_KEY
    useOpenid:false,// 是否使用openid进行统计，此项为false时将使用友盟+随机ID进行用户统计。使用openid来统计微信小程序的用户，会使统计的指标更为准确，对系统准确性要求高的应用推荐使用OpenID。
    autoGetOpenid:false,// 是否需要通过友盟后台获取openid，如若需要，请到友盟后台设置appId及secret
    debug:true,//是否打开调试模式
    uploadUserInfo:true// 自动上传用户信息，设为false取消上传，默认为false
}
});

5. 超级属性

使用「行业」功能时，请使用超级属性来上报分组结构中最低层级的属性值。具体功能使用请查看功能使用文档。https://developer.umeng.com/docs/147615/detail/180890注1: 超级属性设置上报时机：1.在打开获取到属性值时，上报；在发生属性值变化时，也进行上报；（例如由a->b; 由 null -> a)一旦被设置，后续的所有自定义事件，页面浏览等都带有该属性。注2: 超级属性的生命周期：用户调用 setSuperProperty 至 session_end注3: 如需删除时，可在调用 setSuperProperty 方法时传入 null, undefined 等空值，或不传参数。

wx.uma.setSuperProperty(property);

参数：

• property(string): 超级属性

返回值：无示例：

wx.uma.setSuperProperty('123456');

SDK成功接入验证方法

该方案仅提供验证是否集成成功的方法，由于在开发环境下可能会存在数据不完整的情况，请您正式发布小程序后在验证数据正确性。

1. 按照上述描述方法引入SDK；

2. 进入IDE打开调试工具中的console选项，若看到有 SDK集成成功和[umeng] -- 数据发送成功提示 即表示SDK集成且数据发送成功。

说明事项

1. 慎重调用wx.clearStorage()以及wx.clearStorageSync()接口！SDK会将用户相关操作数据缓存在客户端数据存储模块，在特定时间启动发送策略。若调用该接口可导致数据统计不准确的问题；

2. 若用户在使用小程序过程强制关闭微信有可能会造成统计数据丢失的情况。

第三方框架支持

目前小程序SDK支持以下第三方框架，具体使用方法请参考demo：https://github.com/umeng/mp-demos

• uniapp

• taro

• chameleon

• mpvue

• wepy1.x

• wepy2

• 微信小游戏

视频引导

微信小程序SDK集成视频教程

FAQ:

• Q: 注册应用时，提示应用名称已存在

• A：【友盟+】后台的应用名与实际应用名和包名无关，建议命名为应用名+平台，例如：友盟+小程序（微信）、友盟+小程序（支付宝）

• Q: 我忘记我的Appkey了，在哪里能查到

• A：进入小程序统计-应用设置页面，可看到当前小程序的Appkey

https://developers.weixin.qq.com/miniprogram/dev/devtools/npm.html