帮助中心

安卓管理SDK集成

更新时间:2019-07-17 15:52:56

第一部分:基础SDK集成

 1.  导入SDK

1.1 使用Android Studio导入

⾸先需要将 pttracksdk_v**.aar ⽂件放⼊Module 的 libs ⽬录下。然后在 build.gradle 配置⽂件中加⼊代码:

1. repositories{

2. flatDir{

3. dirs 'libs'

4. }

5. }

6. 

7. dependencies {

8. 

9. 

10. compile(name:'pttracksdk-v2.0.0',ext:'aar')

11. }

 

 

2.  添加权限

权限

用途

INTERNET

允许程序联网和发送统计数据的权限。

ACCESS_NETWORK_STATE

允许应用检测网络连接状态,在网络异常状态下避免数据发送,节省流量和电量。

READ_PHONE_STATE

允许应用以只读的方式访问手机设备的信息,通过获取的信息来唯一标识用户。

ACCESS_WIFI_STATE

获取设备的MAC地址,同样用来标识唯一用户。

AndroidManifest.xml 中的代码如下:

1. <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

2. <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

3. <uses-permission android:name="android.permission.INTERNET" />

4. <uses-permission android:name="android.permission.READ_PHONE_STATE" />

注意:上面4个权限都是数据采集必须的,请务必都添加这些权限,否则将可能导致数据采集出现异常

· 

3.  集成基础采集代码

· 

在项目的Application.java中添加如下代码,如果您的项目没有Application.java,请添加一个

1. public class PtApplication extends Application {

2. 

3. @Override

4. public void onCreate() {

5. super.onCreate();

6. //调用采集SDK,

7. //其中"0345045caf264c4d"为您在我们的网站上创建APP时生成的AppKey,"360 Market"为您要发布APP的渠道

8. PtAgent.getInstance(this).setAppKey("0345045caf264c4d").setChannel("360 Market").start();

9. }

10. }

只需要部署这么一行代码,就可以实现APP的用户统计,启动次数统计,使用时长统计,PV统计,APP崩溃统计。如果你需要更多的统计,请参考下面的‘自定义事件’

注意:每台设备仅记录⾸次安装激活的渠道,如果该设备再次安装其他渠道包, 则数据仍会被记录在初始的安装渠道上。

 第二部分:自定义代码集成

4.  ⾃定义事件

在程序中想要采集事件的地⽅添加如下代码:

1. //eventName为事件名称;paraMap 为事件的⾃定义变量。

2. PtAgent.advancedEvent(context,"eventName",paraMap);

注意如果在代码不同位置部署两个eventName⼀样的事件名,系统会视为 同⼀个事件,数据会进⾏合并处理。

例:在⼀个购买事件中,可以设置如下⾃定义变量

1. Map paraMap = new HashMap();

2. paraMap.put("name",“Pork”);

3. paraMap.put("price",12.2);

4. paraMap.put("quantity",10);

· APP登录信息统计

1. //userId为区分登录用户的标识

2. PtAgent.trackLoginInfo("userId")

· APP时长统计

1. 在需要开始统计时长的地方部署如下代码:

2. //其中eventName为事件名称,如播放时长、阅读时长等

3. PtAgent.ptBeginEvent("eventName");

4. 

5. 在需要结束时长统计的地方部署如下代码:

6. //其中properties为Map类型实例,可以在其中添加一些属性,如果不需要添加属性,properties传null值即可

7. Map properties= new HashMap();

8. properties.put("type","游戏");

9. PtAgent.ptEndEvent("eventName",parameters);

 

5.  App错误信息统计

 

当开发者想监听⾃定义的错误异常信息时,可在开发者想实现监听的地⽅ 调⽤如下⽅法:

1. // errorCode为错误类型; errorMessage为错误内容

2. PtAgent.trackException("errorCode","errorMessage");

注意:系统默认捕获的应⽤错误类型为“Crash”关键字,⾃定义的错误类型请不要使⽤“Crash”关键字。