Android开发实战总结Android开发经验谈Android开发

极光统计

2017-12-02  本文已影响34人  奔跑的佩恩

前言

极光统计可以独立使用,其配置和极光推送相似

具体配置请参考
极光推送(一)——配置

一.极光统计的配置

这里讲些配置方面的不同:

jcenter集成和极光推送的基本相同,唯一的区别在于:
在 module 的 gradle 中添加依赖和AndroidManifest的替换变量:

dependencies {
    ......

    
    //jpush
    compile 'cn.jiguang.sdk:jpush:3.1.0'
    compile 'cn.jiguang.sdk:jcore:1.1.8'
    //极光统计
    compile 'cn.jiguang.sdk:janalytics:1.1.1'// 此处以JAnalytics 1.1.1 版本为例。
    //    compile 'cn.jiguang.sdk:jcore:1.1.8' // 此处以JCore 1.1.8 版本为例。
    ......
}

若项目中已配置了极光推送,那么你只需要在app的mudel。gradle的依赖中加上以下依赖即可

compile 'cn.jiguang.sdk:janalytics:1.1.1'

若你的项目中之前没有极光推送的配置,则需要配置完极光统计的代码,然后在app的mudel.gradle中配置

compile 'cn.jiguang.sdk:janalytics:1.1.1'// 此处以JAnalytics 1.1.1 版本为例。
compile 'cn.jiguang.sdk:jcore:1.1.8' // 此处以JCore 1.1.8 版本为例。
二.编写极光统计方法类

和极光推送处理思路接近,我们一样希望有一个类能包含极光统计的所有方法,这样我们在使用的时候就可以很方便,现在看看极光统计类StatsConfig的代码:

package com.jpushdemo.stats;

import android.content.Context;
import android.content.pm.ApplicationInfo;
import android.content.pm.PackageManager;
import android.os.Bundle;

import com.jpushdemo.app.AppContext;
import com.jpushdemo.util.LogUtil;

import java.util.Map;

import cn.jiguang.analytics.android.api.BrowseEvent;
import cn.jiguang.analytics.android.api.CalculateEvent;
import cn.jiguang.analytics.android.api.CountEvent;
import cn.jiguang.analytics.android.api.Currency;
import cn.jiguang.analytics.android.api.Event;
import cn.jiguang.analytics.android.api.JAnalyticsInterface;
import cn.jiguang.analytics.android.api.LoginEvent;
import cn.jiguang.analytics.android.api.PurchaseEvent;
import cn.jiguang.analytics.android.api.RegisterEvent;

/**
 * Title:极光统计
 * Description:
 * <p>
 * Created by pei
 * Date: 2017/12/2
 */
public class StatsConfig {

    public static final String KEY_APP_KEY = "JPUSH_APPKEY";

    private Context mContext;

    private StatsConfig() {
        mContext= AppContext.getInstance();
    }

    private static class Holder {
        private static StatsConfig instance = new StatsConfig();
    }

    public static StatsConfig getInstance() {
        return StatsConfig.Holder.instance;
    }

    /**初始化极光,在Application的oncreate()方法中调用**/
    public void initStats(){
        //极光统计
        JAnalyticsInterface.setDebugMode(true);
        JAnalyticsInterface.init(mContext);
    }

    /**开启crashlog日志上报**/
    public void openCrashLog(){
        JAnalyticsInterface.initCrashHandler(mContext);
    }

    /**关闭crashlog日志上报**/
    public void closeCrashLog(){
        JAnalyticsInterface.stopCrashHandler(mContext);
    }

    /**
     * 页面启动接口。在页面(activity和fragment)的相关生命周期内调用,和onPageEnd需要成对调用
     * @param context activity的上下文
     * @param pageName 页面名称
     */
    public void onPageStart(Context context,String pageName){
        JAnalyticsInterface.onPageStart(context,pageName);
    }

    /**
     * 页面结束接口。在页面(activity和fragment)的相关生命周期内调用,和onPageStart需要成对调用
     * @param context activity的上下文
     * @param pageName 页面名称
     */
    public void onPageEnd(Context context,String pageName){
        JAnalyticsInterface.onPageEnd(context,pageName);
    }

    /**
     * 注册事件
     * @param context
     * @param extra map的key不能为"register_method","register_success"
     */
    public void onRegisterEvent(Context context,Map<String,String>extra){
        RegisterEvent registerEvent = new RegisterEvent("testRegisterMethod", true);
        //添加自己的Extra 信息
        for (Map.Entry<String,String> entry : extra.entrySet()){
            registerEvent.addKeyValue(entry.getKey(),entry.getValue());
        }
        JAnalyticsInterface.onEvent(context, registerEvent);
    }

    /**
     * 注册事件
     *
     * @param context
     * @param registerMethod 注册方式
     * @param isSuccess      是否成功
     * @param extra          附加信息 map的key不能为"register_method","register_success"
     */
    public static void onRegisterEvent(Context context,
                                       String registerMethod,
                                       boolean isSuccess,
                                       Map<String, String> extra) {
        Event registerEvent = new RegisterEvent()
                .setRegisterMethod(registerMethod) //注册方式
                .setRegisterSuccess(isSuccess) //是否成功
                .addExtMap(extra);
        JAnalyticsInterface.onEvent(context, registerEvent);
    }

    /**
     * 登陆事件
     * @param context
     * @param extra map的key不能为"login_method","login_success"
     */
    public void onLoginEvent(Context context,Map<String,String>extra){
        LoginEvent loginEvent = new LoginEvent("testLoginMethod", true);
        //添加自己的Extra 信息
        for (Map.Entry<String,String> entry : extra.entrySet()){
            loginEvent.addKeyValue(entry.getKey(),entry.getValue());
        }
        JAnalyticsInterface.onEvent(context, loginEvent);
    }

    /**
     * 登录事件
     *
     * @param context
     * @param loginMethod 登录方式
     * @param isSuccess   是否成功
     * @param extra       附加信息  map的key不能为"login_method","login_success"
     */
    public static void onLoginEvent(Context context,
                                    String loginMethod,
                                    boolean isSuccess,
                                    Map<String, String> extra) {
        Event loginEvent = new LoginEvent()
                .setLoginMethod(loginMethod) //login方式
                .setLoginSuccess(isSuccess) //是否成功
                .addExtMap(extra);
        JAnalyticsInterface.onEvent(context, loginEvent);
    }

    /**
     * 购买事件
     *
     * @param context
     */
    public static void onPurchaseEvent(Context context,Map<String,String>extra) {
        PurchaseEvent purchaseEvent = new PurchaseEvent("test_purchaseGoodsID", //商品ID
                "篮球", //商品名称
                300, //商品价格
                true, //商品购买是否成功
                Currency.CNY, //货币类型
                "sport",//商品类型
                1); //商品购买数量
        //添加自己的Extra 信息
        for (Map.Entry<String,String> entry : extra.entrySet()){
            purchaseEvent.addKeyValue(entry.getKey(),entry.getValue());
        }
        JAnalyticsInterface.onEvent(context, purchaseEvent);
    }

    /**
     * 购买事件
     *
     * @param context
     * @param purchaseGoodsid    物品id,开发者自己定义
     * @param purchaseGoodsname  购买物品名称(如lv ,香奈儿,劳力士表,安踏运动鞋 etc)
     * @param purchasePrice      购买价格
     * @param purchaseSuccess    购买是否成功
     * @param purchaseCurrency   购买货币类型(人民币(CNY),美元(USD) ,具体参考Currency)
     * @param purchaseGoodsCount 购买数量
     * @param purchaseGoodstype  购买物品类型(如衣服,手表,鞋子,家用电器etc)
     */
    public static void onPurchaseEvent(Context context,
                                       String purchaseGoodsid,
                                       String purchaseGoodsname,
                                       double purchasePrice,
                                       boolean purchaseSuccess,
                                       Currency purchaseCurrency,
                                       String purchaseGoodstype,
                                       int purchaseGoodsCount,
                                       Map<String, String> extra) {
        Event purchaseEvent = new PurchaseEvent()
                .setPurchaseGoodsid(purchaseGoodsid) //商品ID
                .setPurchaseGoodsname(purchaseGoodsname) //商品名称
                .setPurchasePrice(purchasePrice) //商品价格
                .setPurchaseSuccess(purchaseSuccess) //购买是否成功
                .setPurchaseCurrency(purchaseCurrency) //货币类型
                .setPurchaseGoodstype(purchaseGoodstype) //商品类型
                .setPurchaseGoodsCount(purchaseGoodsCount)
                .addExtMap(extra);
        JAnalyticsInterface.onEvent(context, purchaseEvent);
    }

    /**
     * 浏览事件
     *
     * @param context
     * @param browseId       浏览内容id,开发者自己定义
     * @param browseName     浏览的内容的名称(如内容标题等)
     * @param browseType     浏览的内容类型(如是热点,还是nba,还是cba,还是汽车,财经 etc)
     * @param browseDuration 浏览的内容时长,单位秒
     * @param extra          附加信息
     */
    public static void onBrowseEvent(Context context,
                                     String browseId,
                                     String browseName,
                                     String browseType,
                                     float browseDuration,
                                     Map<String, String> extra) {
        Event browseEvent = new BrowseEvent()
                .setBrowseId(browseId) //设置浏览内容id
                .setBrowseName(browseName) //设置浏览的内容的名称
                .setBrowseType(browseType) //设置浏览的内容类型
                .setBrowseDuration(browseDuration) //设置浏览的内容时长
                .addExtMap(extra);
        JAnalyticsInterface.onEvent(context, browseEvent);
    }

    /**
     * 计算事件
     *
     * @param context
     * @param eventId    事件ID
     * @param eventValue 事件对应的值
     * @param extra      附加信息
     */
    public static void onCalculateEvent(Context context,
                                        String eventId,
                                        double eventValue,
                                        Map<String, String> extra) {
        Event calculateEvent = new CalculateEvent()
                .setEventId(eventId)
                .setEventValue(eventValue)
                .addExtMap(extra);
        JAnalyticsInterface.onEvent(context, calculateEvent);
    }

    /**
     * 计数事件
     *
     * @param context
     * @param eventId   事件ID
     * @param extra     附加信息
     */
    public static void onCountEvent(Context context, String eventId, Map<String, String> extra) {
        Event countEvent = new CountEvent()
                .setEventId(eventId)
                .addExtMap(extra);
        JAnalyticsInterface.onEvent(context, countEvent);
    }

    // 取得AppKey
    public static String getAppKey(Context context) {
        Bundle metaData = null;
        String appKey = null;
        try {
            ApplicationInfo ai=context.getPackageManager().getApplicationInfo(context.getPackageName(),PackageManager.GET_META_DATA);
            if(ai!=null){
                metaData = ai.metaData;
            }
            if(null != metaData){
                appKey = metaData.getString(KEY_APP_KEY);
                if ((null == appKey) || appKey.length() != 24) {
                    appKey = null;
                }
            }
        } catch (PackageManager.NameNotFoundException e) {
            LogUtil.e(StatsConfig.class,"===error======"+e.getMessage());
        }
        return appKey;
    }

}

值得注意的是极光统计和极光推送的配置虽然相似,但他们的功能是单独的,也就是当我们如果只需要用到极光统计的代码的时候,完全可以在配置完极光统计后,只需要加入StatsConfig ,然后在需要的地方直接调用就好,而不必考虑是否需要加入极光推送的代码

三.极光统计的调用:

第一步当然是在自己项目的application中初始化自己的极光统计

public class AppContext extends Application{

    private static AppContext INSTANCE;

    public static synchronized AppContext getInstance() {
        return INSTANCE;
    }

    @Override
    public void onCreate() {
        super.onCreate();
        INSTANCE = this;

        //初始化极光统计
        StatsConfig.getInstance().initStats();
    }
}

然后是在需要使用的地方做调用,此处只做范例:

//                //注册事件
//                Map<String,String>registExtra=new HashMap<>();
//                registExtra.put("registf","注册事件啊");
//                StatsConfig.getInstance().onRegisterEvent(mContext,registExtra);
                //登录事件
                Map<String,String>loginExtra=new HashMap<>();
                loginExtra.put("loginf","登录事件啊");
                StatsConfig.getInstance().onLoginEvent(mContext,loginExtra);
四.极光统计查看
3.png 2.png

这里需要注意的是,不是你执行了统计代码后,你极光官网上立马就能看到统计数据的,需要过一段时间才有,至少10分钟吧,但并不是说10分钟以后立刻就有,反正是需要一段时间的

2.png

这个界面对于官网统计数据的刷新时间也只是一个大致时间而已。

ok,今天关于极光统计的知识就讲到这里了,谢谢诶

上一篇 下一篇

猜你喜欢

热点阅读