下载文档

uexUmeng
更新时间:2016-09-21

1、简介

友盟插件

1.1、说明

封装了友盟sdk的相关功能,包括启动次数、事件、页面等app数据的统计。APP接入集成友盟统计之前需要配置config,您首先需要到友盟官网注册并且添加新应用,获得Appkey用于统计。

config.xml配置插件的方法,示例配置代码如下:

  1. <config desc="uexUmeng" type="KEY">
  2. <param platform="iOS" name="$uexUmeng_APPKey$" value="562df76b67e58e0592003544"/>
  3. <param platform="iOS" name="$uexUmeng_channel$" value="uex_umeng_plugin_channel"/>
  4. </config>
  5. <config desc="uexUmeng" type="KEY">
  6. <param platform="Android" name="$uexUmeng_APPKey$" value="562df76b67e58e0592003544"/>
  7. <param platform="Android" name="$uexUmeng_channel$" value="uex_umeng_plugin_channel"/>
  8. </config>

其中562df76b67e58e0592003544改成您自己申请到的友盟应用AppKey,uex_umeng_plugin_channel为应用推广渠道,用户自定义,替换为您应用的推广渠道名称
注意;渠道会作为一个数据细分的维度,例如在豌豆荚渠道推广此包,代码示例
<param platform="Android" name="$uexUmeng_channel$" value="Wandoujia"/>默认不填为unknown
渠道命名规范:
1.可以由英文字母、阿拉伯数字、下划线、中划线、空格、括号组成,可以含汉字以及其他明文字符,但是不建议使用中文命名,会出现乱码。
2.首尾字符不可以为空格
3.不要使用纯数字作为渠道ID
4.最多256个字符
5.”unknown” 及其各种大小写形式,作为友盟保留的字段,不可以作为渠道名

1.2、开源源码

点击至插件详情页(插件测试用例与插件包已经提供)


2、 API预览

2.1、 方法

onEvent 发送事件

uexUmeng.onEvent(eventName, jsonString);

说明

  • onEvent方法是向友盟平台发送自定义事件

参数

param为json字符串,包含的参数如下

参数名称 参数类型 是否必选 说明 默认值
eventName String 事件的名称
jsonString String 事件的属性

平台支持

Android 2.2+
iOS 7.0+

版本支持

Android 3.0.0+
iOS 3.0.0+

示例

  1. var eventName = "sell_event"
  2. var data = {"item":"apple"}
  3. var json = JSON.stringify(data);
  4. uexUmeng.onEvent(eventName, json)

getDeviceInfo 获取设备的基本信息

uexUmeng.getDeviceInfo();

说明
获取设备的基本信息,根据用户的需求,可以将某个设备指定为测试设备,测试设备所产生的数据不会污染真实数据。测试设备的配置在http://mobile.umeng.com/test_devices

相关 cbGetDeviceInfo 返回设备信息的回调方法

参数

平台支持

Android 2.2+
iOS 7.0+

版本支持

Android 3.0.0+
iOS 3.0.0+

示例

  1. uexUmeng.getDeviceInfo();

2.2、 回调方法

cbGetDeviceInfo 返回设备信息

uexUmeng.cbGetDeviceInfo(param);

说明

  • 获取设备基本信息的回调

参数

param为json字符串,包含的参数如下

参数名称 参数类型 是否必选 说明
param String 设备基本信息,格式如:Android格式:{“device_id”: “your_device_id”, “mac”: “your_device_mac”} ;iOS格式:{“oid”: “your_device_id”}

平台支持

Android 2.2+
iOS 7.0+

版本支持

Android 3.0.0+
iOS 3.0.0+

示例

  1. window.uexOnload=function(type){
  2. uexUmeng.cbGetDeviceInfo = function(info){
  3. alert(info);
  4. }
  5. }

3、更新历史

API 版本:uexUmeng-3.0.0(iOS) uexUmeng-3.0.0(Android)

最近更新时间:2015-10-23

历史发布版本 iOS更新 安卓更新
3.0.0 uexUmeng 发布 uexUmeng 发布