/ 开发笔记

#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之类的网络库，所以下载后，解压，然后复制到工程里。

tapdb-sdk-integration-01

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客户端，然后在企业管理界面中，扫描二维码来添加测试设备。

tapdb-sdk-integration-02

tapdb-sdk-integration-03

2). 运行测试应用

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

tapdb-sdk-integration-04

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-sdk-integration-05

正确姿势
tapdb-sdk-integration-06

官方技术支持

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