详细跟踪微信组件中的wx. shareAppMessage事件的转发分享数据，开启后可使用分享分析功能。
默认为关闭false
| | ----------- | ---- | ---------------------------------------------------------------------------- | ```java var gio = require("utils/gio-ming.js"); // version 是你的小游戏的版本号，发版时请调整 gio('init', '9c76fe4756c3404d', 'wx87c6f4a3a6cf31e7', { version: '1.0', followShare: true }); //将微信的wx.OnShareAppMessage替换成gio("gioOnShareAppMessage", function(){}) //分享，监听用户点击右上角菜单的“转发”按钮时触发的事件 gio("gioOnShareAppMessage", function(){ return { title: "试试我的小游戏" } }) //将微信的wx. shareAppMessage替换成gio("gioShareAppMessage", {}) //分享，主动拉起转发，进入选择通讯录界面 gio("gioShareAppMessage", { title: "试试我的小游戏" } ) ``` 如果您希望采用微信的原生接口，那么需要在分享触发事件上做以下配置操作，这样GrowingIO才能采集到分享的数据。 ```java //设置follwShare gio('init', '', '', { version: '1.0', debug: true, followShare: true}); //分享，监听用户点击右上角菜单的“转发”按钮时触发的事件 //调用 pageShareInfo 发送分享事件以及处理分享追踪信息 wx.onShareAppMessage(function () { var obj = { title: "试试我的小游戏" } obj = gio('pageShareInfo', obj); return obj; }) //分享，主动拉起转发，进入选择通讯录界面 //调用 pageShareInfo 发送分享事件以及处理分享追踪信息 obj = gio('pageShareInfo', obj); wx.shareAppMessage(obj) ``` #### forceLogin forceLogin 是一个需要特别注意的参数。GrowingIO 默认会在小游戏里面设置用户标识符，存储在微信 Storage 里面。这个用户标识符潜在可能会被 `clearStorage` 清除掉，所以有可能不同的用户标识符对应同一个微信里的 openid。 如果你的微信小游戏在用户打开后会去获取 `openID` ，可以设置 `forceLogin` 为 true。当 forceLogin 为 true 的时候，用户标识符会使用 `openID`，潜在风险是如果用户没有获取到`openID`，数据不会发送，**所以请特别注意这个参数的设置。** 集成示例 ```javascript gio('init', '你的 GrowingIO 项目ID', '你的微信小程序的 AppID', { version: '1.0', forceLogin: true }); ... // 当获取到 openid 后，调用以下方法gio("identify", openid, unionid); ``` ## 2. 微信用户信息的配置 上报微信信息，支持按照OpenID、UnionID进行用户分群，以及使用微信推送等高级功能。 ### SDK微信用户属性设置 作为用户行为数据分析工具，用户信息的完善会给后续的分析带来很大的帮助。在小程序中，微信用户属性是非常重要的设置，只有完善了微信用户属性信息，微信的访问用户变量（如下表）才可以在分析工具中使用，交互数据定义、数据校验功能才会方便通过用户微信相关的信息（微信姓名和头像）定位用户。 | 微信访问用户变量 | | -------- | | 微信用户所在城市 | | 微信用户所在省 | | 微信用户所在国家 | | 微信用户的性别 | ### 用户接口 下面介绍专门针对用户的接口： #### 绑定微信用户ID（identify） 当用户在你的小程序上登录获取到 OpeniID后，可以用过 `identify` 接口绑定微信用户ID，后续在 GrowingIO 中获取更准确的微信访问用户量。 示例代码： ```java wx.request({ url: 'https://YOUR_HOST_NAME/wechat/code2key', method: 'GET', data: { code: res.code } success: res => var openid = res.data.openid; var unionid = res.data.unionid; // ... gio('identify', res.data.openid, res.data.unionid) }) ``` #### 设置微信用户信息（setVisitor） 当用户在你的小程序上绑定微信信息后，可以通过 `setVisitor` 接口设置微信用户信息，后续在 GrowingIO 中分析这个数据。 示例代码： ```java wx.getUserInfo({ success: res => // ... gio('setVisitor', res.userInfo); }) ``` {% hint style="info" %} 微信用户信息包含**微信昵称**、**微信头像**、**性别**、**微信所填国家**、**微信所填省份**、**微信所填城市**。 用户画像中的部分数据，只有在设置微信用户信息后，才可以统计。 {% endhint %} #### 设置登录用户ID 当用户在你的小游戏上注册以后，你的产品应用服务端会在用户数据库里添加一条记录并且分配一个 ID，可以通过 setUserId 接口设置注册用户ID，后续在 GrowingIO 中分析登录用户这个数据。示例代码如下。设置了注册用户ID后，才可以使用**登录用户变量**。 ```java gio('setUserId', YOUR_USER_ID); ``` #### 清除登录用户ID 用户退出登录时，清除登录用户ID。 ```java gio('clearUserId'); ``` #### 设置登录用户属性 当用户在你的小游戏上传了注册用户ID后，可以通过 setUser 接口设置注册用户信息，后续在 GrowingIO 中分析这个数据。示例代码如下： ```java gio('setUserId', user.id); gio('setUser', { id: user.id, name: user.name }); ``` ## 3. 添加请求服务器域名 要正常采集微信小程序的数据并发送给 GrowingIO，需要在微信小程序里事先设置一个通讯域名，允许跟 GrowingIO API 服务器进行网络通信。具体步骤如下： 1. 登陆微信小程序后台，进入开发。 2. 打开开发设置，到服务器域名配置部分。 3. 在**request合法域名**中添加：