当前位置：网站首页 > 创业 > 正文

个推应用统计产品（个数）Android集成实践

张子豪 2025-10-11 16:33 1

前段时候，我们公司的产物又双叒叕给我们提了新需求，要求我们把APP相关的数据统计阐发一下，这些指标包罗但不限于应用每日的新增、活跃、留存率等等，最好天天都能供给数据报表。这种工作真是想想就麻烦，大师最后仍是决议交给专业的团队来解决。我们一向在用个推推送，比拟于其他第三方推送，个推的达到率比力高，刚好他们旗下有一条目叫“个数·应用统计”的产物，很是合适我们的需求。颠末一段时候的体验，我们发现个数结果仍是很不错的，集当作操作简单便利，数据快准狠。好工具当然要拿出来分享出来了，下面就手把手教大师快速集当作个数Android SDK。

东西/原料

-个推开辟者平台账号
-Android Studio

一、登录账号并建立应用

1
拜候个推开辟者中间，点击当即注册（若是已有账号了可以直接进入步调3）：
2
按照小我环境填写并注册账号：
3
注册好了之后就可以登录啦，选择本家儿界面左边菜单栏的个数·应用统计：
4
进入个数·应用统计面板后，选择右上角的“新增应用”添加新的应用：
5
填写应用相关信息，勾选Android，点击提交：
6
提交后，页面主动返回应用列表，我们就能看到方才添加的应用了。点击应用设置装备摆设：
7
在应用设置装备摆设界面可以看到APPID，我们可以将其复制保留下来，它在后续的集当作环节会被用到：

二、设置装备摆设个数SDK

1
个数Android SDK供给两种集当作体例，别离是maven集当作和aar包手动集当作（本人保举利用maven集当作，加倍简单便利）。

三、maven集当作体例

1
添加maven库地址

在以项目名定名的顶层 build.gradle 文件中，添加个推 maven 库地址，如下所示：
maven{
url 'http://mvn.gt.igexin.com/nexus/content/repositories/releases'
}
2
设置装备摆设依靠

在 app/build.gradle 文件中引用个数SDK依靠库，如下图所示:
dependencies{
compile 'com.getui:gssdk:2.2.3.0'
}

四、aar包集当作体例

1
去官网下载SDK文档

将资本文件中的 GSSDKxxx.aar 以及 GTCxxx.aar 一路复制到 app 模块下的 libs 文件中，打开 app/build.gradle ，在 dependencies 中添加响应包的引用 :

dependencies {
implementation files('libs/GTC-2.0.0.aar')
implementation files('libs/GSSDK-2.2.2.0.aar')
}

GTC为个推平台的公共代码库，若是你已经接入过个推其他包含GTC的产物，则无需再次引入。

五、SDK设置装备摆设

1
这一步需要设置装备摆设混合。起首需要在混合文件中插手如下设置装备摆设：

-dontwarn com.getui.**
-keep class com.getui.**{*;}

然后设置装备摆设个数应用参数：

在 app/build.gradle 文件中的 android.defaultConfig 下添加 manifestPlaceholders ，设置装备摆设个数相关的应用参数，如下图所示：
manifestPlaceholders = [
GS_APPID : "APP_ID",
GT_INSTALL_CHANNEL : "APP_CHANNEL"
]
2
APP_ID为步调1中从官方网站获取到的值，APP_CHANNEL为将要发布的渠道。
APP_CHANNEL也可以经由过程Gsconfig类中setInstallChannel的方式来设置。需要注重的是，若利用这个方式，需要在SDK初始化之前设置装备摆设，不然不克不及生效。

做完了这一步，SDK集当作工作就完当作啦。

六、SDK初始化

1
个数SDK的初始化操作很是简单，只需在Application的onCreate体例中添加如下代码即可：

GsManager.getInstance().init(Context context);

初始化后SDK产物功能就能正常利用了。新增、日活、留存率、人均拜候时长、各个页面的浏览次数……APP数据统计涉及到的各类指标，都可以或许经由过程个数SDK主动统计完当作。

七、一些自界说的功能

1
1. 应用时长统计：

应用时长统计功能本家儿要用于统计APP的启动次数和真实活跃时长，集当作个数SDK 后不需要开辟者挪用额外的接口。此中Android平台一次完整的启动指的是如下两种环境之一：
（1）从启动应用到封闭应用。
（2）从启动应用到应用退至后台，且在后台运行时候跨越默认值30s。这个默认值撑持点窜：

void GsConfig.setSessionTimoutMillis(long time);

注重：GsConfig设置装备摆设类的操作需要在SDK初始化之前完当作。
2.自界说事务功能：

自界说事务可以统计某些用户自界说埋点的发生时候以及次数，例如告白点击、短信数目等。凡是 event_id 用于暗示某种行为或功能的统计（如统计“发送”按钮被触发几多次），而参数properties则用于标识被统计的具体对象（如功能为“下载”的按钮）。经由过程event_id 和 properties ，我们可觉得一个事务打上独一标识。
自界说事务本家儿要分为两种：
（1）次数统计：统计指心猿意马行为被触发的次数。
（2）时长统计：统计指心猿意马行为耗损的时候，单元为秒。需要 eventBegin 和 eventEnd 接口当作对利用才可生效。
此中每类事务都撑持利用 properties 参数类型。
注重：event_id 需要先在个数网站上面设置装备摆设，才能介入正常的数据统计。event_id 不克不及包含空格或转义字符，如下：
2

（1）点击侧边菜单栏事务列表。
3
（2）点击新增事务按钮。
4
按照事务类型别离输入响应的事务ID以及事务名称。
5
今朝个数的自界说事务有两种：

1. 次数统计事务

在事务执行起头时挪用次数统计方式，SDK会按照事务ID，统计该事务被点击的次数。

void GsManager.getInstance().onEvent(String eventId, Properties properties)

参数：
· eventId :自界说事务ID，用于标识独一的事务
· properties : key-value ，自界说属性，用于扩展统计需求
· key和value都是string类型

利用代码：
6
2.事务时长统计

在事务起头和竣事时挪用对应的方式，可以获取并上传事务的时候。

void GsManager.getInstance().onBeginEvent(String eventId, Properties properties)

void GsManager.getInstance().onEndEvent(String eventId, Properties properties)

参数：
· eventId :自界说事务ID，用于标识独一的事务
· properties : key-value ，自界说属性，用于扩展统计需求，key和value都是string 类型
利用代码：
7
3.数据上传策略

开辟者可按照自身应用需求，设置分歧的数据上报策略，从而有用地节制用户流量开销。
8
个数量前撑持的上报策略包罗以下5种：

void GsConfig.setUploadStrategyType(GsConfig.GESHU_STRATEGY_REAL_TIME);
今朝默认的法则是：在毗连WIFI的环境下及时上传，未毗连WIFI则每隔 1 小时上报一次数据。开辟者也可以手动封闭WIFI情况下及时上传数据的开关。

void GsConfig.setEnableSmartReporting(boolean isEnable);
9
数据上传相关的设置接口

1）（仅在发送策略为GESHU_STRATEGY_PERIOD时有用）设置距离时候（默认为60，单元是分钟，即 1 小时）

void GsConfig.setUploadPeriodMinutes(int minutes);

2）（仅在发送策略为GESHU_STRATEGY_BATCH时有用）设置最多量量发送动静的个数（默认值为32）

void GsConfig.setMaxBatchReportCount(int maxCount);

注重：GsConfig设置装备摆设类需要在SDK初始化之前完当作。

以上内容就是本人集当作个推应用统计产物（个数）的经验总结，但愿对你有帮忙！若是大师在集当作过程中碰到问题了，可以在个推官网底部找到他们的手艺撑持，或者在评论区给我留言，大师一路解决，一路前进。