相关文档推荐:为App添加CNZZ统计iOS SDK使用说明教程示例Demo

CNZZ安卓SDK及打包工具使用说明

在控制面板页面添加完应用以后,系统会自动给出应用密钥,获取应用密钥后,可以同时下载SDK,密钥必须和SDK绑定才能生效。
[dl href=’http://mobile.cnzz.com/?mo=analysis&fo=analysis_down’]CNZZ Android SDK及打包工具下载(官方地址)[/dl]
[dl href=’http://mobile.cnzz.com/?mo=analysis&fo=analysis_down&type=1′]CNZZ Android SDK案例下载(官方地址)[/dl]

SDK使用说明如下:

CNZZ Android SDK使用流程
导入JAR包
对于使用Eclipse进行开发的用户,请首先将下载的MobileProbe.jar解压到本地工程目录下的libs子目录里面(例如,您的工程目录为,D:\workspace\XXproject\,请将MobileProbe.jar放入D:\workspace\XXproject\libs目录中),然后在Eclipse中打开您开发的App应用所在项目工程。 在Package Explorer中右键点击工程的根目录,选择Properties(如图二所示),然后点击Java Build Path -> Libraries -> Add External JARs, 选择本地的MobileProbe.jar文件(如图三所示),最后点击OK,即可导入成功。其他用户请根据自身的开发方式自行添加JAR包。
右键点击properties截图
导入路径演示

配置AndroidManifest.xml

版本要求:
android:minSdkVersion = 8:需要Android 2.2及以上版本支持。

权限要求:

[red_box]android.permission.ACCESS_NETWORK_STATE:用于获取网络链接状态,发送统计数据。
android.permission.ACCESS_WIFI_STATE:用于获取网络链接状态,发送统计数据。
android.permission.INTERNET:用于网络通信,发送统计数据。
android.permission.READ_PHONE_STATE:用于获取手机的硬件信息,主要用于区分用户。
android.permission.ACCESS_COARSE_LOCATION:用于获取粗略的地理信息。[/red_box]

Meta数据:

CNZZ_APP_KEY:请填入注册App时得到的App Key。
CNZZ_CHANNEL_ID:可以根据App不同的发行渠道填入相应的渠道名称,用于后端统计渠道发布的数据。 (如果您使用打包工具自动打包,您可以不填写渠道名称)
代码:













数据采集埋点

在代码中引入数据采集包。
import com.cnzz.mobile.android.sdk.MobileProbe;

基本统计

在每个Activity类中的onResume和onPause方法中分别调用对应的采集函数: MobileProbe.onResume(Activity)和MobileProbe.onPause(Activity)。当前Activity的引用作为参数传入。
示例代码:
public class DemoActivity extends Activity … {

@Override
public void onResume() {
super.onResume();
MobileProbe.onResume(this);

}
@Override
public void onPause() {
super.onPause();
MobileProbe.onPause(this);

}

}

自定义事件统计

[yellow_box]用户的自定义事件分两种类型:

  • 触发事件:这个事件是触发型的,例如:一个立刻会返回的按键,只记录被触发的次数。
  • 持续事件:这个事件是有起始和结束的一个持续过程,在起始和结束处埋了相应的数据采集点。例如,一个向服务器发起数据查询的按键,如果您很关心数据的返回时间,就应该将它定义成为一个持续性事件,在这里,我们就会提供这个事件被触发的次数以及每次完成所花费的时间。

[/yellow_box]

触发事件

调用以下函数接口记录触发型事件。
void onEvent(Context activity, String name, long acc);
参数:

  • activity:该事件发生时所在的Activity。如果发生在异步线程中,可以为null。
  • name:事件名称。
  • acc:事件附加的累积值。

添加代码后,相关的统计结果即可在功能分析中看到。

持续事件

以下2个函数用于记录持续型事件。持续型事件必须成对调用,事件名称一致。持续型事件只用于记录区间内的时间差。
void onEventBegin(Context activity, String name);
void onEventEnd(Context activity, String name);

参数:

  • activity:该事件发生时所在的Activity。如果发生在异步线程中,可以为null。
  • name:事件名称。

添加代码后,相关的统计结果即可在功能分析中看到。

错误信息

开发者将自己需要记录的Error Message通过调用onError()接口进行记录,最终可以在web端查看到记录的错误信息。
代码:
public static void onError(Context context, String errorMsg);
参数:

  • context:一个Context变量,可以是ApplicationContext。
  • errorMsg:需记录的错误信息。

添加代码后,相关的统计结果即可在错误信息中看到。

实时发送

默认的发送方式会对一些数据进行缓存后发送。如果需要将每次应用启动的统计数据都实时发送到服务器端。可以在应用退出时,调用onExit()接口。
代码:
public static boolean onExit(Context context);
参数:

  • context:一个Context变量,可以是ApplicationContext。
  • 测试

    [yellow_box]快速排错清单:

    • 是否正确导入JAR包
    • 是否在Androidmanifest.xml中添加了正确的权限:ACCESS_NETWORK_STATE、ACCESS_WIFI_STATE、INTERNET、READ_PHONE_STATE、ACCESS_COARSE_LOCATION
    • 是否在Androidmanifest.xml中添加了正确的AppKey
    • 是否在所有Activity类中onResume,onPause函数中都调用对应的埋点函数
    • 确认Android模拟器(或测试手机)联网状态
    • 启动应用程序,多做一些尝试操作(切换页面,打开关闭应用程序)

    [/yellow_box]

    打包工具产品介绍

    对于应用来说,最重要的不仅仅是把应用本身做好,而是尽可能的在多个渠道发布,只有充分的曝光,才能赢得更多的用户。对于开发者来说,必定要知道在哪个渠道上发布才能获取最多的用户。因此只有分渠道统计才能获取来自不同渠道的统计数据。但是分渠道统计在配置SDK的时候需要每个渠道分别打一个包,在配置起来有些麻烦。
    为了能更好的服务广大移动开发者,CNZZ 移动统计推出了“SDK下载及打包工具”。开发者仅需要点击下载按钮就可以同时下载SDK包及打包工具。开发者在按照SDK使用说明(请见帮助文档中的SDK使用说明部分)配置好SDK后,直接打开autobuilder.jar文件,在界面上需要填入的内容,例如:工程目录,开发包路径,以及各个渠道的名称,点击build,系统就根据您所填写的渠道自动为您跟根据不同的渠道打成不同的包,这样您就可以根据不同的包到各个渠道上去发布了,发布后等着看数据就可以啦。
    如果您不需要自动打包,您仅需要按照SDK使用说明(请见帮助文档中的SDK使用说明部分)配置SDK即可,但注意,如果您未使用打包工具,需要您在配置SDK时,配置好渠道信息。
    “SDK下载及打包工具”使您在配置SDK的过程中,减少了配置错误的机率,也为您节省了分别打包的时间。并且在您应用更新的时候,仅需重复操作一下即可,非常省时省力。

    使用说明:

    • 工程目录(Project Path):Android工程的目录路径。注意,需要按照Android标准的要求,将所有使用的第三方lib(包括MobileProble.jar)放在libs文件夹中。
    • 安卓开发包路径(Android SDK Path):Android SDK的路径,通常这个文件默认会以android-sdks命名。
    • 密钥文件(Key Store Path):用于签名App的密钥文件。
    • 密钥密码(Key Store Password):密钥文件的密码。
    • 签名(Key Alias):签名名称。
    • 签名密码(Key Alias Password):签名密码。
    • 渠道(Channels):需要分发的渠道名称,建议使用英文名称,使用,(半角逗号)分割。

    注意:该工具暂不支持JAVA 7。可能需要配置JAVA_HOME环境变量。
    如果您在使用上还有疑问,请参考附带的样例或者与CNZZ 移动统计联系。

    安卓SDK绑定案例

    我们为您准备了安卓SDK绑定的具体实例,帮助您更好的理解在下载SDK后绑定的方法
    [dl href=’http://mobile.cnzz.com/?mo=analysis&fo=analysis_down&type=1′]安卓SDK绑定案例下载(官方地址)[/dl]

    应该如何下载CNZZ移动统计Android SDK并使用说明视频