umengAnalytics


集成了友盟数据分析统计功能。 专业的移动开发者服务平台,为移动开发者提供免费的应用统计分析、社交分享、消息推送、自动更新、在线参数、移动推广效果分析、微社区等app开发和运营解决方案

如何获得Appkey

*特别提醒:我们建议开发者在注册账号时使用企业邮箱,避免使用个人邮箱注册,防止由于个人离职带来的问题,建议使用的账号形式 :umeng@企业域名、apps@企业域名、dev@企业域名。

1、集成友盟SDK之前,您首先需要到[友盟官网] 注册并且添加新应用,获得Appkey
image

2、添加新应用,如下图:
image

3、不同平台的应用禁止使用相同的Appkey,友盟后台的应用名与实际应用名和包名无关,建议命名为“应用名+平台”。
image

4、Android唯一Appkey 如下图:
image

5、IOS唯一Appkey 如下图:
image

常量:

发送类型(Number):

  • rd.umengAnalytics.REALTIME(1) : 值为 1,实时发送

  • rd.umengAnalytics.BATCH(2) : 值为 2,启动时发送

  • rd.umengAnalytics.SEND_INTERVAL(3) : 值为 3,最小间隔发送

方法:

关于iOS9支持:

setCrashReportEnabled


开启CrashReport收集。

rd.umengAnalytics.setCrashReportEnabled(value);    
说明:

开启CrashReport收集, 默认YES(开启状态)。

参数:
  • value: ( Boolen ) 必选 值为flase,表示关闭友盟CrashReport收集功能。
返回值:

无返回值

示例:
 rd.umengAnalytics.setCrashReportEnabled(true);

setEncryptEnabled


设置是否对日志信息进行加密, 默认flase(不加密)。

rd.umengAnalytics.setEncryptEnabled(value);    
说明:

设置是否对日志信息进行加密, 默认flase(不加密)。

参数:
  • value: ( Boolen ) 必选 value 设置为true, umeng SDK 会将日志信息做加密处理
返回值:

无返回值

示例:
 rd.umengAnalytics.setEncryptEnabled(true);

startWithAppkey


初始化友盟统计模块。

rd.umengAnalytics.startWithAppkey(appKey ,channelId,reportPolicy);
说明:

初始化友盟统计模块。

参数:
  • appKey: ( String ) 必选 友盟appKey
  • channelId: ( String ) 必选 渠道名称。对于iOS,为空字符串时, 默认为@"App Store"渠道
  • reportPolicy: ( 发送类型 ) 必选 发送策略, 默认值为:BATCH,即“启动发送”模式, 可设置值为:rd.umengAnalytics.REALTIME, rd.umengAnalytics.BATCH, rd.umengAnalytics.SEND_INTERVAL
返回值:

无返回值

示例:
 rd.umengAnalytics.startWithAppkey('55890ac367e58e24cf0010d0', '', rd.umengAnalytics.REALTIME);   

setLogSendInterval


当reportPolicy == SEND_INTERVAL 时设定log发送间隔。

rd.umengAnalytics.setLogSendInterval(second);
说明:

当reportPolicy == SEND_INTERVAL 时设定log发送间隔。

参数:
  • second: ( Number ) 必选 单位为秒,最小90秒,最大86400秒(24hour)
返回值:

无返回值

示例:
rd.umengAnalytics.setLogSendInterval(100);

setLatency


设置日志延迟发送。

rd.umengAnalytics.setLatency(second);
说明:

设置日志延迟发送。

参数:
  • second: ( Number ) 必选 设置一个延迟发送秒数,最大值1800s
返回值:

无返回值

示例:
rd.umengAnalytics.setLatency(30);

logPageView


手动页面时长统计, 记录某个页面展示的时长。

rd.umengAnalytics.logPageView(pageName, seconds);
说明:

手动页面时长统计, 记录某个页面展示的时长。

参数:
  • pageName: ( String ) 必选 统计的页面名称
  • seconds: ( Number ) 必选 单位为秒,统计的时长
返回值:

无返回值

示例:
rd.umengAnalytics.logPageView('pageOne',10);

startPageView


自动页面时长统计, 开始记录某个页面展示时长。

rd.umengAnalytics.startPageView(pageName);
说明:

自动页面时长统计, 开始记录某个页面展示时长。 必须配对调用startPageView:和endPageView:两个函数来完成自动统计,若只调用某一个函数不会生成有效数据。在该页面展示时调用startPageView,当退出该页面时调用endPageView

参数:
  • pageName: ( String ) 必选 统计的页面名称
返回值:

无返回值

示例:
rd.umengAnalytics.startPageView('pageTwo');

endPageView


自动页面时长统计, 结束记录某个页面展示时长。

rd.umengAnalytics.endPageView(pageName);
说明:

自动页面时长统计, 结束记录某个页面展示时长。

参数:
  • pageName: ( String ) 必选 统计的页面名称
返回值:

无返回值

示例:
rd.umengAnalytics.endPageView('pageTwo');

eventQuantity


自定义事件,数量统计。

rd.umengAnalytics.eventQuantity(eventId, label, accumulation);
说明:

自定义事件,数量统计。 使用前,请先到友盟App管理后台的设置->编辑自定义事件 中添加相应的事件ID,然后在工程中传入相应的事件ID

参数:
  • eventId: ( String ) 必选 网站上注册的事件Id
  • label: ( String ) 必选 分类标签。不同的标签会分别进行统计,方便同一事件的不同标签的对比,为nil或空字符串时后台会生成和eventId同名的标签
  • accumulation: ( Number ) 必选 累加值。为减少网络交互,可以自行对某一事件ID的某一分类标签进行累加,再传入次数作为参数
返回值:

无返回值

示例:
rd.umengAnalytics.eventQuantity('eventid', 'eventid', 10);

startEvent


开始自定义事件统计。

rd.umengAnalytics.startEvent(eventId, label);
说明:

开始自定义事件统计。

参数:
  • eventId: ( String ) 必选 网站上注册的事件Id
  • label: ( String ) 必选 分类标签。不同的标签会分别进行统计,方便同一事件的不同标签的对比,为nil或空字符串时后台会生成和eventId同名的标签
返回值:

无返回值

示例:
rd.umengAnalytics.startEvent('enventid', 'uuuuu');

endEvent


结束自定义事件统计。

rd.umengAnalytics.startEvent(eventId, label);
说明:

结束自定义事件统计。

参数:
  • eventId: ( String ) 必选 网站上注册的事件Id
  • label: ( String ) 必选 分类标签。不同的标签会分别进行统计,方便同一事件的不同标签的对比,为nil或空字符串时后台会生成和eventId同名的标签
返回值:

无返回值

示例:
rd.umengAnalytics.endEvent('enventid', 'uuuuu');

eventDuration


自定义事件,手动时长统计。

rd.umengAnalytics.eventDuration(eventId, label, durations);
说明:

自定义事件,手动时长统计。使用前,请先到友盟App管理后台的设置->编辑自定义事件 中添加相应的事件ID,然后在工程中传入相应的事件ID。

参数:
  • eventId: ( String ) 必选 网站上注册的事件Id(应用-->功能使用-->自定义事件) 如图所示:
    image

image

  • label: ( String ) 必选 分类标签。不同的标签会分别进行统计,方便同一事件的不同标签的对比,为nil或空字符串时后台会生成和eventId同名的标签
  • durations: ( Number ) 必选 自己计时需要的话需要传毫秒进来
返回值:

无返回值

示例:
rd.umengAnalytics.eventDuration('eventid', 'eventid', 1000);

关闭HTTPS请求协议


为了强制增强数据访问安全,iOS9默认会把大部分的HTTP请求都改为HTTPS请求。本插件基于友盟集成.目前官网没有针对iOS9的HTTPS协议做出更新操作. 所以,如果想在iOS9环境下使用本插件.则需要在pluginConfig.xml中进行配置。配置方式如下:

<!--找到InfoPlistEdit节点 在这里设置HTTPS相关参数.-->
<config pluginName="InfoPlistEdit">
    <ios>
        <!--true:表示开启http协议模式;false:表示关闭http协议模式,采用https请求协议.-->
         <param key="AllowAllHttpConnection" value="true"></param>
    </ios>
</config>
说明:

将以上配置参数拷贝至项目中的pluginConfig.xml文件中即可.若已有相同的配置项.则不需要再次拷贝.在原基础上添加即可.