帮助产品上报自定义行为事件。
如果游戏需要接入统计功能,需要额外导入GamesabaAnalysis的Sdk,并且按照步骤接入。
Gradle集成
在SDK文件下的 附件/libs
目录下存以下的文件:
gamesamba-analytics-sdk-3.3.4.aar(GameSamba 统计SDK)
将以上这个aar文件导入到主工程libs
目录下
配置主工程的 build.gradle
在主工程的 build.gradle 文件中 dependencies下,添加依赖即可。
dependencies {
...
// 统计功能SDK (必需)
compile(name: 'gamesamba-analytics-sdk-3.3.4', ext: 'aar')
// Appsflyer模块
compile 'com.appsflyer:af-android-sdk:4+@aar'
compile 'com.android.installreferrer:installreferrer:1.0'
}
Note: 如果你使用 Gradle 3.0.0 或者更高版本
, 务必使用 implementation
关键字替代 compile
如下:
dependencies {
...
// 统计功能SDK (必需)
implementation(name: 'gamesamba-analytics-sdk-3.3.4', ext: 'aar')
// Appsflyer模块
implementation 'com.appsflyer:af-android-sdk:4+@aar'
implementation 'com.android.installreferrer:installreferrer:1.0'
}
权限和组件
在 AndroidManifest.xml
中加入以下配置:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="您的应用包名">
...
<application
...>
...
<!--Appsflyer Key,接入统计SDK需要-->
<meta-data
android:name="com.ngames.analytics.AppsflyerKey"
android:value="@string/appsflyer_key" />
<!--Google统计追踪ID,接入统计SDK需要-->
<meta-data
android:name="com.ngames.analytics.GoogleTrackingId"
android:value="@string/google_tracking_id" />
<!--货币代码,例如: USD(美元),接入统计SDK需要-->
<meta-data
android:name="com.ngames.analytics.CurrencyCode"
android:value="@string/currency_code" />
<!-- Appsflyer广播接收器 -->
<receiver
android:name="com.appsflyer.MultipleInstallBroadcastReceiver"
android:exported="true">
<intent-filter>
<action android:name="com.android.vending.INSTALL_REFERRER" />
</intent-filter>
</receiver>
</application>
</manifest>
在 res/values
中配置string.xml
, 配置如下 :
<!--统计模块-->
<!--Appflyer的KEY,请将 appsflyer_key 替换为自己的Appflyer的KEY-->
<string name="appsflyer_key">appsflyer_key</string>
<!--货币代码,例如: USD(美元)-->
<string name="currency_code">USD</string>
<!--Google统计追踪ID,,请将 google_tracking_id 替换为自己的谷歌统计的tracking_id-->
<string name="google_tracking_id">google_tracking_id</string>
接入统计必须配置以上配置:
1.Appsflyer配置:
(1)appsflyer_key
2.货币代码:
(1)currency_code
3.Google 统计sdk配置:
(1) google_tracking_id
混淆配置
如果你的apk最终会经过代码混淆,请在proguard配置文件中额外再加入以下代码:
-dontwarn com.android.installreferrer
初始化
(1)Application
在项目中的Application#onCreate初始化
//是否是调试模式
private boolean isDebug = false;
...
@Override
protected void onCreate() {
super.onCreate();
...
//初始化统计SDK
NgamesAnalyticsSdk.init(this, isDebug);
}
API原型
/**
* 初始化
* @param application
* @param isDebug 调试模式
*/
public static void init(Application application, boolean isDebug)
参数
Application application :应用的 Application
如果接入统计功能,第一步必须在 Application 初始化
(2)Activity
在主Activity#onCreate初始化
private NgamesAnalyticsSdk ngamesAnalyticsSdk;
...
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
...
//初始化Ngames统计SDK
ngamesAnalyticsSdk = NgamesAnalyticsSdk.getInstance(this);
}
API原型
/**
* 初始化SDK
* @param activity 当前Activity
* @return NgamesAnalyticsSdk
*/
public static NgamesAnalyticsSdk getInstance(Activity activity)
参数
Activity activity :当前Activity
记录统计事件
API介绍
记录统计事件
API原型
/**
* 记录统计事件
* @param eventName 事件名称,注意:应用内事件名称长度不得超过 45 个字符
* @param eventValues 记录内容(字典)
*/
public void recordEvent(String eventName, HashMap eventValues)
示例
//记录事件,购买
HashMap<String, Float> map = new HashMap<>();
map.put("goods_id", 1);
map.put("goods_count", 10);
ngamesAnalyticsSdk.recordEvent("purchase", map);
记录谷歌统计事件
API介绍
记录谷歌统计事件
API原型
/**
* 记录GoogleAnalysis事件
* @param categoryId 事件类别
* @param actionId 事件操作
* @param labelId 事件标签
* @param value 事件值
*/
public void recordGAEvent(String categoryId, String actionId, String labelId, long value)
示例
//记录事件:Google Analytics
String categoryId = "game";
String actionId = "level";
String labelId = "level up";
long value = 2;
ngamesAnalyticsSdk.recordGAEvent(categoryId, actionId, labelId, value);
设置用户ID
API介绍
设置用户ID,便于统计平台统计
API原型
/**
* 设置客户用户ID
* 可以帮助您交叉引用自己的独有 ID 以及 AppsFlyer 的独有 ID 和其他设备的 ID。该 ID 与回传 IP 一同出现在 AppsFlyer CSV 报告中,用于与您的内部 ID 交叉引用。
* @param userId 用户ID
*/
public void setUserId(String userId)
示例
//设置用户ID
ngamesAnalyticsSdk.setUserId("100");