Talkingdata：集成文档微信小游戏

微信小游戏适用范围

TalkingData Analytics微信小游戏SDK适用于全部微信小游戏版本。

集成准备-创建应用并获取App ID

AppKey是TalkingData分析平台标识一款独立应用的唯一标识，集成SDK前需要在TalkingData报表中创建应用并获取相应的AppKey。

步骤：

1）注册并登录https://www.talkingdata.com/ ，选择App Analytics产品线

2）创建应用时，选择微信小程序平台，并选择 应用类型 为 游戏， 并获取AppKey

第一步：创建应用

第二步：下载SDK

3）如果已创建的应用，请从“应用管理->基本信息”中查看AppKey。 说明： TalkingData支持多平台使用相同的AppKey。

集成准备-统计标准说明

基础统计指标定义：

1）新增用户：微信小程序统计中，“用户”是根据微信用户的openid作为唯一标识。若两次获取openid失败，则自动生成uuid作为本次及以后访问唯一标识。

2）用户的一次使用：指用户从打开小程序到退出小程序的全过程，如果用户切出小程序后30s内再次返回小程序，则认为是上一次使用的延续，不会算作新的小程序使用。如果用户切出小程序后，30s内通过其他场景值进入小程序，会记为新的会话。

3）自定义事件：指用户在小程序中进行了特定的操作或达成了特定的条件。例如：用户点击了广告栏、用户进行付费等。 自定义事件用于收集任意您期望跟踪的数据。

4）场景：微信小程序后台提供的用户使用小程序时入口ID及说明。用以区分用户每次打开小程序时的入口。

集成准备-配置request合法域名

使用TalkingData小程序统计分析时，需要您在微信小程序后台进行相应的配置：

1） 以管理员或开发者身份登录微信公众平台：https://mp.weixin.qq.com/

2） 在设置中选择开发设置，在request合法域名中添加域名信息。

3） 需配置的域名： https://h5.udrig.com、https://api.talkingdata.com

该域名用于获取和接受微信小程序的统计信息，非常重要，请勿填错。

说明：

微信小程序合法域名一个月内最多可修改5次。

配置安全域名后，请检查开发者工具，以保证配置生效。

快速集成-SDK初始化

为了提高集成效率，我们对一些微信公开的标准功能做了自动统计处理，这样可以减少您的代码部署量。

初始化配置：

1）下载的SDK包解压后，将其中的tdweapp-conf.js和tdweapp.js文件放在您的项目的同一文件夹中；

2）在game.js文件开始，引入tdweapp.js文件，示例如下：

var tdweapp = require(‘./sdk/tdweapp.js’);

3）在tdweapp-conf.js文件中作初始化配置：

{   
 appkey: '您在TalkingData创建的小游戏App ID',
 appName: '您的应用名称',
 versionName: 'versionName',
 versionCode: 'versionCode',
 wxAppid: '微信管理后台分配的appid',
 getLocation: false, // 默认不获取用户位置
}

说明：

1、AppKey是TalkingData分析平台标识一款独立应用的唯一标识，请确保在创建应用时已正确填写小程序appid及secretId。secretId重置时，请及时从报表中更新secretId避免获取openid失败。

2、如果小程序本身在进入应用时不需要获取位置，请勿将getLocation置为true。

基础统计

正确按照集成步骤集成完SDK之后，自动完成应用启动。详情可以参考集成步骤。

渠道统计

1、用途和用法

跟踪每个分发渠道或推广活动给小游戏带来的流量，可以使用渠道网址构建的方式来实现。

重要说明：

1）如果您的地址中已经有了”?”参数，不需写多个问号，只需要在渠道参数前增加”&”符号。如：?XXXXX=XXXX(其他参数)&TDChannelId=channelname；用户从渠道地址跳转进应用后，当次完整的访问数据都归给对应的渠道；

2）”channelname”最多包含64个字符，支持英文、数字、下划线，但不能包含空格或其他的转义字符；

3）请将TDChannelId这个参数加在”?”之后，”#”之前。

2、接口及参数

接口： 在配置页面路径时，在路径后面加上TDChannelId作为参数，会当作渠道来处理 。

参数：

自定义事件

1、用途和用法

自定义事件用于统计任何您期望跟踪的数据，如：用户点击某功能按钮、填写某个输入框、触发了某个广告等。 完成这些自定义事件统计后可以在报表对其进行统计分析并进行关键路径转化分析。

2、接口及参数

sdk.event(Object);

Object参数说明：

// js
var sdk = GameGlobal.tdAppSdk;
 sdk.event({
 id: 'eventId',
 label: 'eventLabel',
 params: {
 key1: 'value1',
 key2: 'value2'
 }
 });

标准事件（分享）

1、用途及用法

在微信小游戏中，提供了特定事件，如分享，用以追踪用户使用小游戏的行为。针对这些行为，我们提供了相应的标准事件，便于提供更多特定分析。

2、分享事件调用说明

接口：

GameGlobal.tdAppSdk.share();

注意：如果用到分享监测，执行wx.onShareAppMessage 方法return之前调用GameGlobal.tdAppSdk.customShare，示例如下：

wx.showShareMenu({
 success(res) {
 // 用户点击了“转发”按钮
 wx.onShareAppMessage(function () {
 GameGlobal.tdAppSdk.share({
 title: '转发标题',
 path: '转发路径'
 });
 return {
 title: '转发标题',
 imageUrl: canvas.toTempFilePathSync({
 destWidth: 500,
 destHeight: 400
 })
 }
 })
 }
})