#TapDB SDK接入指南

TapDB是心动/TapTap旗下的一个数据统计后台,可以用来统计游戏的数据。

官方网站
https://www.tapdb.com/

官方接入文档

TapDB的接入非常简单,以安卓游戏为例,详细接入步骤如下:

TapDB安卓SDK详细接入步骤

0. 在TapDB后台创建应用

  • 创建TapDB账号
  • 登录后台
  • 创建企业
  • 创建项目

获取项目的应用id,后边需要用到。

注意
新创建的项目是调试状态。

1.下载并添加TapDB SDK包

在TapDB官网下载SDK包
https://www.tapdb.com/docs/zh_CN/download/SDK.html

注意
认准官网标志哈,不要从第三方下载。

与很多sdk不同,TapDB的sdk提供的是aar的包,而不是maven之类的网络库,所以下载后,解压,然后复制到工程里。

2.在Gradle中引用TapDB SDK

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar', '*.aar'])
    // 其他lib...
}

3.在AndroidManifest.xml设置必要的权限

<!--必选权限-->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

<!--强烈建议权限  sdk 获取 IMEI 时会需要此权限;获取不到不影响功能正常使用,IMEI 用于辅助数据分析,使统计结果更加精确--> 
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

4.初始化TapDB SDK

注意
必须使用以下两个方法之一来初始化TapDB SDK

// 1). 
public static void init(Context context, String appId, String channel, String appVersion)

// 2). 
public static void init(Context context, String appId, String channel, String appVersion, JSONObject properties)

5.测试TapDB SDK

1). 添加测试设备

下载并安装TapDB客户端,然后在企业管理界面中,扫描二维码来添加测试设备。

2). 运行测试应用

使用添加到后台的测试设备进入游戏,如果一切正常,TapDB后台会显示激活的设备数量,并提示
调试完成,进入项目

6. 常见问题

6.1. TapDB后台显示项目一直处于调试状态,始终无法变成正式项目。

检查以下几点:

  • 1). 必须用测试设备进行游戏
  • 2). 保证测试设备可以联网
  • 3). 检查初始化TapDB时的id是否正确
  • 4). 检查初始化TapDB的init方法是否正确
    TapDB的初始化方法有好几个,必须用带version参数的那两个:
TapDB.init(app, TAPDB_ID, CHANNEL_ID, version, null);

如果在日志中看到以下信息,表示使用的init方法不对:

正确姿势

官方技术支持

如果接入一直遇到问题,可以联系TapDB的官方技术支持,在网站上可以找到他们的企业微信联系方式。