快速找到所需文档，高效完成接入与排障

2.1.自动采集-AUTO模式

2.1.1如果开发者选择了自动采集模式，无需做任何则在页面埋点，在App下次启动时，会默认上报本次App使用的所有activity页面信息。判断activity页面的启动、退出方式如下：

2.1.2只要选择了自动采集模式，就会上报所有的页面访问信息，如果不使用该功能可以选择手动采集模式，可减少App端用户流量。

例子：

public class UmengApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        // 初始化SDK
        UMConfigure.init(this, "5ab2xxxxxxxxxxxxx002f8", "Umeng", UMConfigure.DEVICE_TYPE_PHONE, null);
        // 选用AUTO页面采集模式
        MobclickAgent.setPageCollectionMode(MobclickAgent.PageMode.AUTO);

2.2手动采集-Manual

如果需要统计非activity页面，例如fragment、自定义View等，则需要选择手动采集。手动采集模式不会采集activity信息，仅采集开发者埋点页面的信息，埋点接口为：

public static void onPageStart(String viewName);

public static void onPageEnd(String viewName);

注意：以上接口对于一个页面必须成对调用！！！ 不同页面间仅支持串行调用！！！

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

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

}

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

3.1埋点接口

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

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

3.1.1接口:

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

3.1.2参数说明

• eventID：自定义事件ID，指一个操作 例如：您可定义“pause”或“play”作为一个事件。您也可更加具体，创建一个“music_willbe_finished”的事件，并设定在音乐播放了 90% 的那一刻触发；

• key：自定义事件下的参数，一个可选的描述符，用于定义事件操作的属性信息 例如，您可以定义“music_style”或“singer_name”作为“play”事件的参数，也可以定义“play_time”作为事件的参数。

• value：自定义事件参数下的参数值，用于描述事件属性的详细信息。 例如，“play”事件下“music_style”的参数值可以是“slight”、“rock”等。数值型参数的取值是数字变量。值可以是明确的数字，如“23”；也可以是在其他位置定义的基于推断值的变量，如“downloadTime”。

3.1.3示例：

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元
MobclickAgent.onEventObject(this, "play_music", music);

3.1.4备注：

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

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

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

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

• 参数类型根据第一次上传的参数类型为准，后续即使App工程上更改，也无法改变，只能创建新的参数。

3.2注意事项

• 自定义事件ID不可更改，需与代码中“String event_id”保持一致，参数（key）无须手动注册；

• 请在SDK初始化之后调用事件统计接口；

• event id长度不能超过1024个字节，key不能超过4096个字节，当自定义属性值value为数组元素时，数组长度上限为100

• 请不要将事件属性key以"_"开头。"_"开头的key属于SDK保留字

• id、ts、du、ds、duration、pn、token、device_name、device_model 、device_brand、country、city、channel、province、appkey、app_version、access、launch、pre_app_version、terminate、no_first_pay、is_newpayer、first_pay_at、first_pay_level、first_pay_source、first_pay_user_level、first_pay_version、type、是保留字段，不能作为event id 及key的名称；

• 如果需要在子进程中对自定义事件进行统计，需要在SDK初始化完成后调用函UMConfigure.setProcessEvent。

• event ID或者key请使用英文、数字、下划线、中划线及加号进行定义，使用其中一种或者几种都可以，不能以“数字”开头，避免使用中文。具体限制请查看下文注意事项 为保证数据计算的准确性，非这些“合法”以外的字符无法添加，具体限制请查看下文注意事项；

• 不同版本下，自定义事件数量

  功能/版本	免费版	专业版	尊享版
  自定义事件量（个）	100	500	2000
  事件参数量（个）	50	200	200
  事件参数值量（个）	1000	2000	5000

• 为方便使用者理解及使用，可通过显示名称进行重命名（支持中文），进入【应用设置-事件-编辑】进行操作；

• 埋码完成后，建议使用集成测试进行验证；

3.3子进程埋点

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

3.3.1示例：

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

3.3.2注意：

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