Android统计SDK API规范调研

Android

@author ASCE1885的 Github 简书 微博 CSDN

本次调研主要对三款主流的统计SDK进行：TaklingData，友盟，百度。

TalkingData

1）初始化SDK

//如果不想在AndroidManifest里的meta-data申明了TD_APP_ID，请调用:
init(final Context context, final String appId,  final String partnerid)
//如果已经在AndroidManifest里的meta-data申明了TD_APP_ID，请调用:
init(final Context context)

2）统计Activity

@Override
protect void onResume() {
    super.onResume();
    TCAgent.onResume(this); 
}
@Override
protect void onPause() {
    super.onPause();
    TCAgent.onPause(this); 
}

3）跟踪自定义的页面（如Fragment, View等）

TCAgent.onPageStart(Context ctx, String pageName);
TCAgent.onPageEnd(Context ctx, String pageName);

4）自定义事件

TCAgent.onEvent(Context ctx, String EVENT_ID);
TCAgent.onEvent(Context ctx, String EVENT_ID, String EVENT_LABEL);
TCAgent.onEvent(Context ctx, String EVENT_ID, String EVENT_LABEL, Map<string, object=""> kv);
TCAgent.setGlobalKV(String key, Object value);
TCAgent.removeGlobalKV(String key);

5）收集应用错误日志

TCAgent.setReportUncaughtExceptions(Boolean enabled)
TCAgent.onError(Activity activity, Throwable throwable)

友盟

1）统计Activity

public void onResume() {
    super.onResume();
    MobclickAgent.onResume(this);
}
public void onPause() {
    super.onPause();
    MobclickAgent.onPause(this);
}

2）跟踪自定义的页面（如Fragment, View等）

public void onResume() {
    super.onResume();
    MobclickAgent.onPageStart("SplashScreen"); //统计页面(仅有Activity的应用中SDK自动调用，不需要单独写)
    MobclickAgent.onResume(this);          //统计时长
}
public void onPause() {
    super.onPause();
    MobclickAgent.onPageEnd("SplashScreen"); // （仅有Activity的应用中SDK自动调用，不需要单独写）保证 onPageEnd 在onPause 之前调用,因为 onPause 中会保存信息 
    MobclickAgent.onPause(this);
}

3）自定义事件

MobclickAgent.onEvent(Context context, String eventId);
MobclickAgent.onEvent(Context context, String eventId, HashMap<String,String> map);

4）收集应用错误日志

public static void reportError(Context context, String error)   
//或  
public static void reportError(Context context, Throwable e)

百度

1）统计Activity

public void onResume() {
    super.onResume();
    /**
     * 页面起始（每个Activity中都需要添加，如果有继承的父Activity中已经添加了该调用，那么子Activity中务必不能添加）
    * 不能与StatService.onPageStart以及onPageEnd函数交叉使用
     */
    StatService.onResume(this);
}
public void onPause() {
    super.onPause();
    /**
     * 页面结束（每个Activity中都需要添加，如果有继承的父Activity中已经添加了该调用，那么子Activity中务必不能添加）
     * 不能与StatService.onPageStart以及onPageEnd函数交叉使用
     */
    StatService.onPause(this);
}

4）跟踪自定义页面（Fragment，View等）

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

public void onResume() {
    Log.w(Conf.TAG, "DemoDialogActivity.OnResume()");
    super.onResume();
    /**
     * 页面起始（每个Activity中都需要添加，如果有继承的父Activity中已经添加了该调用，那么子Activity中务必不能添加）
     * 与StatService.onResume(this)类似;
     */
    StatService.onPageStart(this, "DemoDialogActivityp");//(this);
}
public void onPause() {
    Log.w(Conf.TAG, "DemoDialogActivity.onPause()");
    super.onPause();
    /**
     * 页面结束（每个Activity中都需要添加，如果有继承的父Activity中已经添加了该调用，那么子Activity中务必不能添加）
     * 与StatService.onPause(this)类似;
     */
    StatService.onPageEnd(this, "DemoDialogActivityp");//(this);
}

3）自定义事件

void onEvent(Context context, String event_id, String label)
void onEvent(Context context, String event_id, String label, int acc)
void onEventStart(Context context, String event_id, String label)
void onEventEnd(Context context, String event_id, String label)
void onEventDuration(Context context, String event_id, String label, int milliseconds)