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

功能介绍

事件基本构成

• event ID：自定义事件ID，指一个操作

  例如：您可定义“pause”或“play”作为一个事件。您也可更加具体，创建一个“music_willbe_finished”的事件，并设定在音乐播放了 90% 的那一刻触发；友盟+提供了两种自定义事件的形式：多参数类型事件和计算事件。

• key：自定义事件下的参数，一个可选的描述符，用于定义事件操作的属性信息

  例如，您可以定义“music_style”或“singer_name”作为“play”事件的参数，也可以定义“play_time”作为事件的参数。

• value：自定义事件参数下的参数值，用于描述事件属性的详细信息。

  例如，“play”事件下“music_style”的参数值可以是“slight”、“rock”等。数值型参数的取值是数字变量。值可以是明确的数字，如“23”；也可以是在其他位置定义的基于推断值的变量，如“downloadTime”。

使用自定义事件的依赖条件与限制

• 请先登陆 【友盟+】官网 ，进入选择“应用”->设置->事件 （子账户由于权限限制可能无法看到”设置”选项，请联系主帐号开通权限。）页面中添加相应的事件ID，然后服务器才会对相应的事件请求进行处理；

• 在页面注册事件类型时请选择“多参数类型事件”类型；

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

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

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

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

• 免费版、专业版、尊享版的事件、参数、参数值配额不同，若超过相应配额，则按历史上报顺序，取最早上报的有效事件、参数及参数值进行计算，开发者可以手动指定哪些参数需要计算、哪些参数停止计算。各版本配额如下：

• value不建议使用特殊字符定义（建议使用标准ASCII码中可见字符部分进行定义）；

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

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

注意事项

• event id长度不能超过128个字节，key不能超过128个字节，value不能超过256个字节

• id、ts、du、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_versio是保留字段，不能作为event id 及key的名称；

操作说明

操作路径：选择您要分析的App-应用设置-事件

页面元素

1. 添加事件：您可以通过手工添加、批量复制、批量导入的方法实现；

2. 计算中事件：此处展示正在计算的事件，提供编辑和暂停操作，支持批量操作

   1. 编辑：您可以编辑事件的显示名称或参数的显示名称，切换事件的类型（此操作影响基础看板-自定义事件报表的展示形式）；

   2. 暂停：您可以选择某一个或几个事件进行暂停操作，暂停后的事件不再进行数据计算，且同时不再页面中显示，暂停后，计算quota得到释放，可以添加更多的计算中事件

3. 暂停计算事件：暂停后的事件会展示在“暂停计算事件”列表中，用户也可通过暂停计算事件列表中的“还原”操作进行还原；还原后的事件显示到计算中事件列表中，暂停计算的事件不展示在前台页面中，支持批量操作；

4. 未注册事件：此处展示最近7天的前500个未注册事件，用户可选择想要加入到计算中的事件ID进行添加，支持批量操作；

5. 支持按照事件ID／显示名称进行模糊搜索

创建事件

手工添加事件

位置：添加事件-手工添加

说明：若添加的id个数较少，建议使用该方式

批量复制事件

操作路径：添加事件-批量复制

说明：将复制您选择的应用中的所有事件（位置：添加事件-批量复制）如下图所示：将复制app（名称为3）下的所有自定义事件到当前app

批量导入事件

操作路径：添加事件-批量导入

示例：

• event1,事件1,1

• event2,事件2,1

• event3,事件3,0（注意文本文件需要为utf-8编码）

  如何使用自定义事件

1. 统计-功能使用-自定义事件：查看事件的触发情况以及参数的触发情况

2. 分析-事件分析、漏斗分析、自定义留存、用户分群：可以基于自定义事件及参数进行行为分析、创建人群等。

FAQ：

1. 为什么要限制事件id或参数id的格式？

答：由于中文或者某些特殊字符在编码及解析上可能出现乱码，导致数据统计结果不够准确。请使用英文、数字、下划线、中划线、小数点及加号进行（事件id／参数id）定义。

2. 如果我不用中文进行事件id／参数id定义，使用起来会很不方便？

答：可通过显示名称进行重命名，事件id及参数id均可重命名；

3. 为什么有些参数没有显示出来？

其二，埋码定义的参数id是否符合格式（英文、数字、下划线、中划线、小数点及加号），不符合id的参数将被过滤，无法显示

4. 参数值是否有限制？

答：目前产品本身没有对参数值进行限制，可使用任意字符进行定义，建议使用标准ASC码进行定义（如英文、数字、下划线、中划线、小数点及加号）。

5. 对于统计数值型参数，计算型事件和多参数事件的区别是什么？

其三，该数值型变量，无法进入到用户洞察等功能进行深入分析；