埋点API

1 如何查看埋点方案

在进行埋点前，需要确定在哪里埋点、埋哪些点等，即需要梳理清楚明确的埋点需求。在QuickTracking平台中将明确的埋点需求称为埋点方案，并为埋点方案设计了规范模板。如下：

在埋点方案中，明确的所需埋点内容有：

1、事件主体：指“谁”触发了这个事件，分为设备ID和账号ID，上报的事件务必具备其中之一。

• 设备ID：Android设备和iOS设备的默认设备ID为应用级别唯一的设备ID，由Quicktracking自动生成：

  • Android9及以下设备：SDK自动采集imei、wifimac、androidid、SN生成设备ID，生成后存入本地，只有卸载应用或者删除应用数据才会重新生成设备ID。

  • Android10级以上设备：SDK自动采集oaid、gaid、androidid、SN生成设备ID，生成后存入本地，只有卸载应用或者删除应用数据才会重新生成设备ID。

  • iOS设备：SDK自动采集openudid生成设备ID，生成后放入keychain中，只有恢复出厂设置或者删除应用数据才会重新生成设备ID。

  • 使用应用的C端用户同意采集idfa和oaid，QuickTracking SDK才会采集，只有QuickTracking app SDK可以采集到oaid、gaid、imei、wifimac、androidid、SN、idfa、idfv。

• 账号ID：客户端用户登录后账号标识，当一个用户在不同的设备进行登录时，设备ID会发生变化，但是账号ID不会发生变化。例如一个用户使用手机和pad分别登录。

2、用户属性：针对账号ID的属性，例如账号ID为“testdemo@111”的用户，“生日”为“1999-02-13”，“会员等级”为“铂金”等。“生日”和“会员”等级就为用户属性。

3、渠道属性：广告投放的属性，例如投放渠道、投放方式、投放内容等。

4、全局属性：在全局设置一次后，每一个事件都会携带的属性

5、页面浏览事件：页面加载时上报的事件（埋点方案中页面编码和事件编码相等的事件，也是标记为蓝色的事件）

6、点击、曝光、自定义事件：客户端用户与客户端发生任意交互时上报的事件。

2 设置设备ID&账号ID

2.1 设备ID设置

SDK 在com.quick.qt.commonsdk 包路径下实现了默认的设备标识符采集工具类DefaultDeviceInfo，此默认实现类默认会采集如下标识。

如果开发者希望针对上表中的某几个设备标识符采集行为做控制，如：不采集IMEI字段和Serial字段，自行实现OAID的采集方法。就可以实现一个DefaultDeviceInfo类的子类，重载getImei，getSerial，getOaid三个采集方法，如下示例：

public class CustomDeviceInfo extends DefaultDeviceInfo {

	@Override
	public String getImei(Context context) {
		return null;
	}

	@Override
	public String getSerial() {
		return null;
	}

	@Override
	public String getOaid(Context context) {
		String oaid = "";
        // oaid = getOaidMethod(); // 您自己的 oaid 获取方法
        return oaid;
	}

}

请注意：如果不进行重载，则默认由QuickTracking SDK采集，请谨慎决定是否实现对应方法，一旦您选择自己实现采集方法，此设备标识的采集工作就由您全权接管了，SDK不会再试图采集此设备标识。SDK能采集到的设备标识越少，对统计数据的准确性和稳定性的负面影响越大。

自定义工具类注册：

// 请在设置收数域名之前，调用SDK预初始化函数之前，先调用采集工具类注册函数
// 如果不需要对设备标识采集行为做控制，就不需要实现自定义工具类并注册它。
QtConfigure.setDeviceInfo(new CustomDeviceInfo());
QtConfigure.setCustomDomain("您的收数服务域名", null);

SDK支持自定义设备ID，如果要使用自定义设备ID需要在初始化前（即init前） 设置setCustomDeviceId 接口为有效值（非空）。

public static void setCustomDeviceId(Context var0, String var1)

使用示例：

QtConfigure.setCustomDeviceId(this, "xxxxxx");

注意：因此功能在未获取设备ID时生效，本地如果已存在设备ID，设置后无效。如果本地已获取到设备ID可以通过卸载重装方式验证此功能。

设备ID的获取

可使用下述方法获取：

QtConfigure.getUMIDString()

2.2 账号ID设置

1、在统计用户时以设备为标准，如果需要统计应用自身的账号，请使用以下接口：

public static void onProfileSignIn(String ID);

注意：账号ID设置后将被存入本地存储，只有卸载App、清空应用数据或者调用下述的登录接口时，账号ID才会失效，否则每一个事件都将携带账号ID。

2、账号登出时需调用此接口，调用之后不再发送账号相关内容。

public static void onProfileSignOff();

示例：

//当用户使用自有账号登录时，可以这样统计：
QtTrackAgent.onProfileSignIn("userID");

//登出
QtTrackAgent.onProfileSignOff();

3 设置用户属性

通过预置事件编码 $$_user_profile 上报用户属性。

在上报用户属性之前，需要先设置_user_id上报用户账号，否则QuickTracking流量分析对用户属性不会进行关联计算。确认上报用户的账号ID后，上报用户属性示例如下：

Map<String, Object> user = new HashMap<String, Object>();
user.put("sex", "girl");//性别
user.put("age", "8"); //年龄
QtTrackAgent.onEventObject(mContext, "$$_user_profile", user);

4 渠道属性

4.1 H5链接唤起App

渠道属性无需进行任何埋点，但是需要唤起小程序或App的URL中携带这些渠道属性，且属性key务必以“utm_”开头，因为SDK识别的关键字为“utm_”。例如：

<URL scheme>?utm_channel=gzh

PS：如果渠道属性已经与市面上渠道投放公司进行了合作，无法使用utm_开头，可以使用全局属性API将渠道属性进行埋点上报（属性key依然需要以“utm_”开头）。

4.2 H5链接唤起应用市场下载并启动App

该场景下，如果仅是H5链接中携带“utm_”参数，已经无法做到下载App后的启动事件携带“utm_”参数。所以需要进行“H5唤起事件”与“应用激活事件”做关于“IP地址和浏览器UserAgent”的模糊匹配。

1. 当用户在H5中点击「唤起/下载App」的按钮时，上报“应用唤起事件（$$_app_link）”，在事件中需要携带唤起App的appkey和渠道属性。

//示例
aplus_queue.push({
  action:'aplus.recordAppLink',
  arguments:[{
    targetAppKey: '要唤起的应用appKey',  // 必填，要唤起的应用appKey
    custom1: 'custom1', // 选填，自定义参数
    ...
  }]
})

2. App下载后的第一次启动事件“应用激活事件（$$_app_install）”由QT App SDK自动采集上报。

3. QuickTracking系统进行应用唤起事件（$$_app_link）和应用激活事件（$$_app_install）关于“IP地址和浏览器UserAgent”的模糊匹配。您使用时，可以直接在app应用中分析“应用激活（预置）”的渠道属性即可。

4.3 App各应用市场活跃数据统计

在初始化函数中的第三个入参Channel即为设置该应用的应用市场：QtConfigure.preInit(this,"您的appkey","Channel-华为");，QtConfigure.init(this,"您的appkey","Channel-华为",QtConfigure.DEVICE_TYPE_PHONE, "");

5 全局属性

注册全局属性后，后续触发的所有事件都将自动包含这些属性；且这些属性及属性值存入缓存，APP退出后清除。在分析数据时，可根据此属性进行查看和筛选。

5.1 注册一个全局属性

public static void registerGlobalProperties(Context var0, Map<String, Object> var1);

注意：

1. 属性名、String类型的属性值，只支持大小写字母、数字及下划线！

2. 属性值可以是如下几种Java类型之一：String、Long、Integer、Float、Double、Short。

3. 如果和已经存在的全局属性key重复，则更新已有值；如果和已经存在的全局属性key不一致，则插入新的全局属性。

   示例：

   Map firstMap = new HashMap<String, Object>();
   firstMap.put("a", "1");
   firstMap.put("b", "2");
   QtTrackAgent.registerGlobalProperties(mContext, firstMap);//当前globalproperty为a:1和b:2
   
   Map secondMap = new HashMap<String, Object>();
   secondMap.put("b", "3");
   secondMap.put("c", "4");
   QtTrackAgent.registerGlobalProperties(mContext, secondMap);//当前globalproperty为a:1、b:3和c:4

5.2 删除一个全局属性

public static void unregisterGlobalProperty(Context context, String propertyName);

示例：

删除一个特定的全局属性，删除后，后续触发的所有事件都不再携带该属性。

QtTrackAgent.unregisterGlobalProperty(mContext, "lnch_Source");

5.3 根据Key获取单个全局属性

public static Object getGlobalProperty(Context context, String propertyName);

示例：

String userId = QtTrackAgent.getGlobalProperty(mContext, "lnch_Source");

5.4 获取所有全局属性

public static String getGlobalProperties(Context context);

示例：

String allSuperProp = QtTrackAgent.getGlobalProperties(mContext);

5.5 清除所有的全局属性

public static void clearGlobalProperties(Context context);

示例：

QtTrackAgent.clearGlobalProperties(mContext);

6 页面浏览事件API

6.1 页面手动采集

开发者如果希望对Activity、Fragment、CustomView及其它自定义页面的页面路径和页面停留时长进行采集和统计。可以通过调用QtTrackAgent.onPageStart/QtTrackAgent.onPageEnd这组接口进行手动埋点。

public static void onPageStart(String viewName);
public static void onPageEnd(String viewName);

手动统计Fragemnt页面路径的例子代码：

// 一次成对的 onPageStart -> onPageEnd 调用，对应一次非Activity页面(如：Fragment)生命周期统计。

// Fragment页面onResume函数重载
public void onResume() {
    super.onResume();
    QtTrackAgent.onPageStart("MainScreen"); //统计页面("MainScreen"为页面编码，可自定义)   
}

// Fragment页面onResume函数重载
public void onPause() {
    super.onPause();
    QtTrackAgent.onPageEnd("MainScreen");
}

注意：

onPageStart 是SDK记录页面进入的信息，onPageStart不会上报事件，只有调用onPageEnd的时候才会上报页面浏览事件。

onPageStart和onPageEnd必须成对调用，且传值的page_name需要保持一致，如果没有onPageEnd或者onPageEnd与onPageStart传值的page_name不一致，则onPageStart记录的信息不会生效。

6.1.1 页面属性上传

QtTrackAgent.setPageProperty()，支持给当前页面附加自定义属性。

接口：QtTrackAgent.setPageProperty

参数：

示例：

Activity页面开始展现时进行当前页面属性设置示例：

private static final String PAGE_NAME = "page_home"; // 页面名
 
 @Override
 public void onResume() {
    super.onResume();
   
    QtTrackAgent.onPageStart(PAGE_NAME); // 页面开始展现打点
    Map<String, Object> params = new HashMap<>();
    params.put("home_param_1", "value11"); // 当前页面相关属性设置
    QtTrackAgent.setPageProperty(mContext, PAGE_NAME, params);
 }

请注意：页面属性设置只支持页面手动埋点

6.1.2 透传页面属性

此外，QuickTracking SDK提供了SpmAgent.updateNextPageProperties接口，该接口支持给下一个页面附加自定义属性。

接口：SpmAgent.updateNextPageProperties

参数：

/**
* 
当需要将当前坑位属性透传给⽬标⻚⾯时调用
* 
此函数在通过坑位跳转到下⼀个⽬标⻚⾯时调⽤。
*/
public static void updateNextPageProperties(Map<String, Object> params)

示例：

public class PageHome extends Activity {
    private Context mContext;
    private static final String PAGE_NAME = "page_home"; // 页面名
    private static final String PAGE_SPM_CNT = "1.1.0.0"; // 页面spm编码

    // 跳转到news的坑位 spm 编码
    private static final String PAGE_SPM_TO_NEWS = "1.1.0.1"; // 按钮控件mGoNewsWithHole spm编码
    private Button mGoNewsWithHole;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setTitle("QuickTracking统计Home页");
        setContentView(R.layout.activity_u4a_home);

        mContext = this;

        mGoNewsWithHole = (Button)findViewById(R.id.u4a_goto_page_news2);
        mGoNewsWithHole.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                // 带坑位spm的跳转
                SpmAgent.updateCurSpm(mContext, PAGE_SPM_TO_NEWS); // 跳转按钮控件spm编码
                Map<String, Object> params = new HashMap<String, Object>();
                
                params.put("my_transfer_arg1", "transfer_value1");
                SpmAgent.updateNextPageProperties(params); // 
                startActivity(new Intent(mContext, PageNews.class));
            }
        });
    }

请注意：透传页面属性只支持页面手动埋点

6.2 Activity页面自动采集（全埋点）

Activity页面默认开启页面自动采集，无须集成全埋点的gradle 插件。SDK在采集会话数据时，默认会主动采集每个Activity页面的路径和页面访问时长数据并上报。如果开发者同时调用页面路径手动采集API QtTrackAgent.onPageStart/onPageEnd，则会导致页面数据重复上报，产生冗余页面路径数据，可以在调用QtConfigure.preInit预初始化函数后紧接着调用QtTrackAgent.disableActivityPageCollection()函数禁止SDK自动采集Activity页面路径数据。

public static void disableActivityPageCollection();

若只需禁止某activity页面的自动采集上报的接口，需要在activity的onCreate函数中调用此函数：

QtTrackAgent.skipMe(this, null); 

6.3 Fragment页面自动采集（全埋点）

Fragment页面默认没有自动采集，需要集成全埋点的插件并开启自动采集开关才可以。具体操作可以查看

8.1 全埋点gradle插件引入和开启Fragment PV数据全埋点。

7 事件埋点

自定义事件可以用于追踪用户行为，记录行为发生的具体细节。

7.1 事件埋点

使用onEventObject接口进行事件的统计，参数值可以是如下几种类型之一：String、Long、Integer、Float、Double、Short。

接口：

public static void onEventObject(Context context, String eventID, Map<String, Object> map)

public static void onEventObject(Context context, String eventID, Map<String, Object> map, String pageName)

事件上传数量限制：

• 自定义属性key字符串长度上限：1024

• 自定义属性value字符串长度上限：1024*4

• 自定义属性map长度（参数个数）：100 个键值对

• 当自定义属性值value为数组元素时，属性值的数组长度上限：100

示例：

Map<String, Object> music = new HashMap<String, Object>();
music.put("music_type", "popular");//自定义参数：音乐类型，值：流行
music.put("singer", "JJ"); //歌手：(林俊杰)JJ
music.put("song_name","A_Thousand_Years_Later"); //歌名：一千年以后
music.put("song_price",100); //价格：100元
QtTrackAgent.onEventObject(this, "play_music", music, "home_page");

备注：

• 当前拉取事件采样率配置依赖于自动采集开关，使用SDK时需要调用setAutoEventEnabled()方法；

  示例：

  public class MyApplication extends Application {
  
      @Override
      public void onCreate() {
          super.onCreate();
  	QtConfigure.setCustomDomain("您的收数服务域名", null);
          // 打开调试log
          QtConfigure.setLogEnabled(true);
          // 采样率拉取依赖全埋点开关设置，如需要事件采样率控制功能，请按需调用此API
          QtTrackAgent.setAutoEventEnabled(false);        
          //...
      }
      //... 
  }

• 多参数类型事件能满足原来计算事件/计数事件的分析场景；

• 对于计算型事件不同的参数类型对应不同的计算方式，总共可以分为两大类，数值型和字符型

  • 数字型：支持累加值、最大值、最小值、平均值和去重数计算

  • 字符型：支持去重数计算

7.2 子进程埋点

SDK仅支持子进程自定义事件埋点，页面等其他类型采集暂不支持。子进程埋点需要在SDK初始化完成后调用函数QtConfigure.setProcessEvent。

示例：

public class UmengApplication extends Application{
    @Override
    public void onCreate(){
        super.onCreate();
        // 初始化SDK
        QtConfigure.preInit(this, "您的appkey", "应用市场");
        
        // 支持在子进程中统计自定义事件
        QtConfigure.setProcessEvent(true);
        // ...

注意：

• 如果需要在某个子进程中统计自定义事件，则需保证在此子进程中进行SDK初始化。

8 全埋点（自动埋点）

8.1 全埋点gradle插件引入

在 project 级别的 build.gradle 文件中添加 android-gradle-plugin插件依赖：

buildscript {
    repositories {
        maven { url 'https://repo1.maven.org/maven2/' } // QuickTracking仓库
        jcenter()
            google()
        }
    
    dependencies {
        classpath 'com.android.tools.build:gradle:3.5.4'
            
            // 添加QuickTracking插件 android-gradle-plugin 依赖
            //classpath 'com.umeng.umsdk:android-gradle-plugin:1.0.1' 
            classpath 'com.lydaas.qtsdk:quick-gradle-plugin2:1.0.2'
            // 适配 gradle 8+版本
            // classpath 'com.lydaas.qtsdk:quick-gradle-plugin2:2.0.0'
        }
}

allprojects {
    repositories {
        maven { url 'https://repo1.maven.org/maven2/' } // QuickTracking仓库
        jcenter()
            google()
        }
}

8.2 依赖使用gradle编译插件

在主 module 的 build.gradle 配置中应用全埋点插件：

apply plugin: 'com.android.application'
//apply plugin: 'com.qt.analytics.plugin' // P版本插件（全埋点场景）
apply plugin: 'com.quick.analytics.plugin' // PX版本插件（全埋点场景）

dependencies {
   // 添加 QuickTracking 统计SDK，SDK版本需要与上述的gradle版本匹配
   //implementation 'com.umeng.umsdk:qt-common:1.4.4.P' //P版本（SDK版本为x.x.x.P）
   implementation 'com.lydaas.qtsdk:qt-px-common:1.4.9.PX'  // PX版本（SDK版本为x.x.x.PX）
}

8.3 全埋点API

8.3.1 全埋点开关

开启Fragment PV数据全埋点

通过 enableFragmentPageCollection() 方法可以开启全部 Fragment 页面浏览事件的自动采集功能。

/**
* Fragment 页面数据自动采集开关，SDK默认关闭
* @param enable true-开启; false-关闭
*/
public static void enableFragmentPageCollection(boolean enable);

示例：

public class MyApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
	QtConfigure.setCustomDomain("您的收数服务域名", null);
        // 打开调试log
        QtConfigure.setLogEnabled(true);
        // 开启全部 Fragment 页面浏览事件的自动采集功能
        QtTrackAgent.enableFragmentPageCollection(true);
        //...
    }
    //... 
}

开启Activity PV数据开关

默认开启Activity页面自动采集，SDK在采集会话数据时，默认会主动采集每个Activity页面的路径和页面访问时长数据并上报。如果开发者同时调用页面路径手动采集API QtTrackAgent.onPageStart/onPageEnd，则会导数页面数据重复上报产生冗余页面路径数据，可以在调用QtConfigure.preInit预初始化函数后紧接着调用QtTrackAgent.disableActivityPageCollection()函数禁止SDK自动采集Activity页面路径数据。

public static void disableActivityPageCollection();

若只需禁止某activity页面的自动采集上报的接口，需要在activity的onCreate函数中调用此函数：

QtTrackAgent.skipMe(this, null); 

关闭某个页面的自动采集

若只需禁止某activity页面的自动采集上报的接口，需要在activity的onCreate函数中调用此函数：

QtTrackAgent.skipMe(this, null); 

开启控件点击数据全埋点

/**
 * 拉取事件采样率配置。
 * 设置是否自动采集控件点击事件, SDK默认不自动采集。
 * @param enable true-自动采集; false-不自动采集
 */
public static void setAutoEventEnabled(boolean enable);

示例：

public class MyApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();
	QtConfigure.setCustomDomain("您的收数服务域名", null);
        // 打开调试log
        QtConfigure.setLogEnabled(true);
        QtTrackAgent.enableFragmentPageCollection(true);
        // 开启控件点击事件的自动采集功能。
        QtTrackAgent.setAutoEventEnabled(true);
        //...
    }
    //...
    
}

支持自动监控的控件类型列表：

8.3.2 自动Activity/Fragment PV设置自定义属性

通过给特定Activity/Fragment 实现接口 com.umeng.analytics.autotrack.PageAutoTracker，可以给自动采集的Activity/Fragment页面定制化属性、页面名、或者来源页面名。

public interface PageAutoTracker {
    /**
     * 返回当前页面名
     * @return 如果不需要自定义页面名则返回null或者空字符串
     */
    String getPageName();

    /**
     * 返回来源页面名
     * @return 如果不需要自定义来源页面名则返回null或者空字符串
     */
    String getRefPageName();

    /**
     * 返回自定义属性键值对，Key和Value都需要是字符串类型，如果没有自定义属性请返回null
     *
     * @return 如果没有自定义属性请返回null
     */
    Map<String, String> getTrackProperties();
}

示例：

// 给FragmentContacts指定 自定义页面名 及 自定义页面属性
public static class FragmentContacts extends Fragment implements PageAutoTracker {
        private final String mPageName = "FragmentContacts";

        static FragmentSimple newInstance(int num) {
            FragmentSimple f = new FragmentSimple();

            // Supply num input as an argument.
            Bundle args = new Bundle();
            args.putInt("num", num);
            f.setArguments(args);

            return f;
        }

        /**
         * The Fragment's UI is just background simple text view showing its instance
         * number.
         */
        @Override
        public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {

            FrameLayout fl = new FrameLayout(getActivity());
            fl.setLayoutParams(new FrameLayout.LayoutParams(FrameLayout.LayoutParams.MATCH_PARENT,
                    FrameLayout.LayoutParams.MATCH_PARENT));
            fl.setBackgroundColor(Color.LTGRAY);
            TextView tv = new TextView(getActivity());
            tv.setText("Fragment Contacts");
            tv.setTextColor(Color.BLACK);
            tv.setOnClickListener(new View.OnClickListener() {
                @Override
                public void onClick(View v) {
                    QtTrackAgent.ignoreView(v); // 禁止TextView控件的自动采集数据上报
                    Toast.makeText(getActivity(), "文本框被点击了", Toast.LENGTH_LONG).show();
                }
            });
            fl.addView(tv);
            return fl;
        }

        // 自定义FragmentContacts页面名
        @Override
        public String getPageName() {
            return "FragmentContacts";
        }

    	// 不需要自定义FragmentContacts的来源页面名，所以直接返回null
        @Override
        public String getRefPageName() {
            return null;
        }

    	// 自定义FragmentContacts页面自定义属性
        @Override
        public Map<String, String> getTrackProperties() {
            Map<String, String> properties = new HashMap<>();
            properties.put("fragment_arg1", "fragment_value111");
            properties.put("fragment_arg2", "fragment_value222");
            return properties;
        }
    }

8.3.3 设置控件点击事件自定义属性

通过 setViewProperties() 方法，可以对特定控件设置自定义属性，自定义属性可以设置多个K-V键值对，Key和Value都需要是字符串类型。自定义属性和值会包含在此控件全埋点点击事件数据中。

/**
* 设置控件自定义属性，自定义属性可以设置多个K-V键值对，Key和Value都需要是字符串类型
* @param view 控件对象
* @param properties 自定义属性
*/
public static void setViewProperties(View view, JSONObject properties);

示例：

	@QtDataTrackViewOnClick
    public void onButtonClick(View v) {
        int id = v.getId();
        Intent in = null;
        if (id == R.id.normal) {
        	// 对Resource ID为 normal 的Button控件设置自定义事件ID ekv_normal。
        	// 设置后，点击此控件是SDK上报数据中事件ID就为"ekv_normal"。
            QtTrackAgent.setViewEventID(v, "ekv_normal");
            // 针对 normal Button控件点击事件(即ekv_normal 事件)，设置自定义属性值。
            // customArgs内属性和属性值会包含在"ekv_normal"事件数据中一起上报。
            JSONObject customArgs = new JSONObject();
            try {
                customArgs.put("customArg1", "value1111");
                customArgs.put("customArg2", "value2222");
            } catch (JSONException e) {

            }
            QtTrackAgent.setViewProperties(v, customArgs);

8.3.4 给控件点击事件设置自定义事件编码

通过 setViewEventID() 方法，给特定控件的点击事件设置自定义事件编码。

/**
* 针对自动采集的控件点击事件，设置自定义事件编码
* @param view 控件对象
* @param eventID 自定义事件编码
*/
public void setViewEventID(View view, String eventcode);

示例：

    @QtDataTrackViewOnClick
    public void onButtonClick(View v) {
        int id = v.getId();
        Intent in = null;
        if (id == R.id.normal) {
        	// 对Resource ID为 normal 的Button控件设置自定义事件编码 ekv_normal。
        	// 设置后，点击此控件是SDK上报数据中事件编码就为"ekv_normal"。
            QtTrackAgent.setViewEventID(v, "ekv_normal");
            	//...

8.3.5 处理通过 onClick 属性设置的点击事件

通过布局文件中 android:onClick 属性配置的点击回调方法执行时无法自动触发控件点击事件。此时可以给 android:onClick 属性对应的方法加上 @QtDataTrackViewOnClick 注解，这样在方法执行时，SDK就可以自动触发控件点击事件。例如：

布局文件：

<Button
        android:id="@+id/normal"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="24dp"
        android:onClick="onButtonClick"
        android:text="@string/ana_name"/>

onClick事件自定义处理函数：

import com.umeng.analytics.autotrack.QtDataTrackViewOnClick;

	@QtDataTrackViewOnClick
    public void onButtonClick(View v) {
         //...
    }

8.3.6 忽略特定类型控件点击事件的自动采集

通过 ignoreViewType() 方法忽略特定类型控件点击事件的自动采集。

/**
* 忽略viewType类型控件点击事件的自动采集行为。
* 该方法支持多次调用，对设置结果合集进行忽略。
* @param viewType
*/
public static void ignoreViewType(Class viewType);

示例：

// 忽略Button类型控件点击事件
QtTrackAgent.ignoreViewType(Button.class);

8.3.7 忽略特定控件点击事件的自动采集

通过 ignoreView() 方法忽略特定控件点击事件的自动采集。

/**
* 忽略某个 View 对象的点击事件自动采集行为。
*
* @param view 对象
*/
public static void ignoreView(View view);

示例：

Button myButton = (Button)findViewById(R.id.testButton);
// 忽略myButton控件点击事件
QtTrackAgent.ignoreView(myButton);