统计

帮助产品上报自定义行为事件。

如果游戏需要接入统计功能，需要额外导入GamesabaAnalysis的Sdk，并且按照步骤接入。

Gradle集成

在SDK文件下的 附件/libs目录下存以下的文件：

1. gamesamba-analytics-sdk-3.3.3.aar（GameSamba 统计SDK）

将以上这个aar文件导入到主工程libs 目录下

配置主工程的 build.gradle

在主工程的 build.gradle 文件中 dependencies下，添加依赖即可。

dependencies {
    ...

    // 统计功能SDK (必需)
    compile(name: 'gamesamba-analytics-sdk-3.3.3', 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.3', 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

• boolean isDebug ：调试模式

如果接入统计功能，第一步必须在 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");

注意：此方法需要在登录成功的回调中，进行设置