├── .gitignore ├── README.md ├── plugin.xml ├── src ├── android │ └── umeng-analytics-v5.2.3.jar └── ios │ ├── MobClick.h │ └── libMobClickLibrary.a └── www └── umeng_analytics.js /.gitignore: -------------------------------------------------------------------------------- 1 | .DS_Store 2 | source/*.popclipextz 3 | .idea/* -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Umeng Analytics(友盟统计SDK) PhoneGap plugin 2 | Work with PhoneGap 2.9.* 3 | 4 | ## How To Use 5 | 6 | #### Add Plugin 7 | 8 | ``` 9 | cordova plugin add https://github.com/hzlzh/phonegap-cordova-umeng-analytics-plugin.git 10 | ``` 11 | 12 | #### Remove Plugin 13 | ```` 14 | cordova plugin remove https://github.com/hzlzh/phonegap-cordova-umeng-analytics-plugin.git 15 | ```` 16 | 17 | ## 支持已经可以使用友盟统计 18 | 19 | 详情：[http://dev.umeng.com/analytics/ios/quick-start#1](http://dev.umeng.com/analytics/ios/quick-start#1) 20 | 21 | 例： 22 | 23 | ``` 24 | - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions 25 | { 26 | [MobClick startWithAppkey:@"xxxxxxxxxxxxxxx" reportPolicy:BATCH channelId:@"Web"]; 27 | } 28 | ``` -------------------------------------------------------------------------------- /plugin.xml: -------------------------------------------------------------------------------- 1 | 2 | 5 | 6 | UmengAnalyticsPlugin 7 | Phonegap / cordova plugin for Umeng Analytics SDK 8 | hzlzh 9 | Apache 2.0 License 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | -------------------------------------------------------------------------------- /src/android/umeng-analytics-v5.2.3.jar: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hzlzh/phonegap-cordova-umeng-analytics-plugin/d9203f8e30ce7151a2c7e914f56a392d42e49549/src/android/umeng-analytics-v5.2.3.jar -------------------------------------------------------------------------------- /src/ios/MobClick.h: -------------------------------------------------------------------------------- 1 | // 2 | // MobClick.h 3 | // MobClick 4 | // 5 | // Created by Aladdin on 2010-03-25. 6 | // Updated by Minghua on 2014-05-21. 7 | // Copyright (C) 2010-2014 Umeng.com . All rights reserved. 8 | // Version 3.1.2 , updated_at 2014-05-21. 9 | 10 | #import 11 | #import 12 | 13 | #define UMOnlineConfigDidFinishedNotification @"OnlineConfigDidFinishedNotification" 14 | #define XcodeAppVersion [[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleShortVersionString"] 15 | 16 | 17 | typedef enum { 18 | REALTIME = 0, //实时发送 19 | BATCH = 1, //启动发送 20 | SENDDAILY = 4, //每日发送 21 | SENDWIFIONLY = 5, //仅在WIFI下启动时发送 22 | SEND_INTERVAL = 6, //按最小间隔发送 23 | SEND_ON_EXIT = 7 //退出或进入后台时发送 24 | } ReportPolicy; 25 | 26 | @class CLLocation; 27 | 28 | /** MobClick是统计的核心类，本身不需要实例化，所有方法以类方法的形式提供. 29 | 目前发送策略有REALTIME,BATCH,SENDDAILY,SENDWIFIONLY,SEND_INTERVAL,SEND_ON_EXIT。 30 | 其中REALTIME,SENDWIFIONLY 只在模拟器和DEBUG模式下生效，真机release模式会自动改成BATCH。 31 | 关于发送策略的调整，请参见关于发送策略及发送策略变更的说明 32 | http://blog.umeng.com/index.php/2012/12/0601/ 33 | SEND_INTERVAL 为按最小间隔发送,默认为10秒,取值范围为10 到 86400(一天)， 如果不在这个区间的话，会按10设置。 34 | SEND_ON_EXIT 为退出或进入后台时发送,这种发送策略在App运行过程中不发送，对开发者和用户的影响最小。 35 | 不过这种发送策略只在iOS > 4.0时才会生效, iOS < 4.0 会被自动调整为BATCH。 36 | 37 | */ 38 | @interface MobClick : NSObject 39 | #pragma mark basics 40 | 41 | ///--------------------------------------------------------------------------------------- 42 | /// @name 设置 43 | ///--------------------------------------------------------------------------------------- 44 | 45 | /** 设置app版本号。由于历史原因需要和xcode3工程兼容,友盟提取的是Build号(CFBundleVersion),如果需要和App Store上的版本一致,需要调用此方法。 46 | 47 | @param appVersion 版本号，例如设置成`XcodeAppVersion`. 48 | @return void. 49 | */ 50 | + (void)setAppVersion:(NSString *)appVersion; 51 | 52 | 53 | /** 开启CrashReport收集, 默认是开启状态. 54 | 55 | @param value 设置成NO,就可以关闭友盟CrashReport收集. 56 | @return void. 57 | */ 58 | + (void)setCrashReportEnabled:(BOOL)value; 59 | 60 | 61 | /** 设置是否打印sdk的log信息,默认不开启 62 | @param value 设置为YES,umeng SDK 会输出log信息,记得release产品时要设置回NO. 63 | @return . 64 | @exception . 65 | */ 66 | 67 | + (void)setLogEnabled:(BOOL)value; 68 | 69 | 70 | ///--------------------------------------------------------------------------------------- 71 | /// @name 开启统计 72 | ///--------------------------------------------------------------------------------------- 73 | 74 | 75 | /** 开启友盟统计,默认以BATCH方式发送log. 76 | 77 | @param appKey 友盟appKey. 78 | @param reportPolicy 发送策略. 79 | @param channelId 渠道名称,为nil或@""时,默认会被被当作@"App Store"渠道 80 | @return void 81 | */ 82 | + (void)startWithAppkey:(NSString *)appKey; 83 | + (void)startWithAppkey:(NSString *)appKey reportPolicy:(ReportPolicy)rp channelId:(NSString *)cid; 84 | 85 | /** 当reportPolicy == SEND_INTERVAL 时设定log发送间隔 86 | 87 | @param second 单位为秒,最小为10,最大为86400(一天). 88 | @return void. 89 | */ 90 | 91 | + (void)setLogSendInterval:(double)second; 92 | 93 | 94 | ///--------------------------------------------------------------------------------------- 95 | /// @name 页面计时 96 | ///--------------------------------------------------------------------------------------- 97 | 98 | 99 | /** 页面时长统计,记录某个view被打开多长时间,可以自己计时也可以调用beginLogPageView,endLogPageView自动计时 100 | 101 | @param pageName 需要记录时长的view名称. 102 | @param seconds 秒数，int型. 103 | @return void. 104 | */ 105 | 106 | + (void)logPageView:(NSString *)pageName seconds:(int)seconds; 107 | + (void)beginLogPageView:(NSString *)pageName; 108 | + (void)endLogPageView:(NSString *)pageName; 109 | 110 | #pragma mark event logs 111 | 112 | 113 | ///--------------------------------------------------------------------------------------- 114 | /// @name 事件统计 115 | ///--------------------------------------------------------------------------------------- 116 | 117 | 118 | /** 自定义事件,数量统计. 119 | 使用前，请先到友盟App管理后台的设置->编辑自定义事件 中添加相应的事件ID，然后在工程中传入相应的事件ID 120 | 121 | @param eventId 网站上注册的事件Id. 122 | @param label 分类标签。不同的标签会分别进行统计，方便同一事件的不同标签的对比,为nil或空字符串时后台会生成和eventId同名的标签. 123 | @param accumulation 累加值。为减少网络交互，可以自行对某一事件ID的某一分类标签进行累加，再传入次数作为参数。 124 | @return void. 125 | */ 126 | + (void)event:(NSString *)eventId; //等同于 event:eventId label:eventId; 127 | /** 自定义事件,数量统计. 128 | 使用前，请先到友盟App管理后台的设置->编辑自定义事件 中添加相应的事件ID，然后在工程中传入相应的事件ID 129 | */ 130 | + (void)event:(NSString *)eventId label:(NSString *)label; // label为nil或@""时，等同于 event:eventId label:eventId; 131 | /** 自定义事件,数量统计. 132 | 使用前，请先到友盟App管理后台的设置->编辑自定义事件 中添加相应的事件ID，然后在工程中传入相应的事件ID 133 | */ 134 | + (void)event:(NSString *)eventId acc:(NSInteger)accumulation; 135 | /** 自定义事件,数量统计. 136 | 使用前，请先到友盟App管理后台的设置->编辑自定义事件 中添加相应的事件ID，然后在工程中传入相应的事件ID 137 | */ 138 | + (void)event:(NSString *)eventId label:(NSString *)label acc:(NSInteger)accumulation; 139 | /** 自定义事件,数量统计. 140 | 使用前，请先到友盟App管理后台的设置->编辑自定义事件 中添加相应的事件ID，然后在工程中传入相应的事件ID 141 | */ 142 | + (void)event:(NSString *)eventId attributes:(NSDictionary *)attributes; 143 | 144 | + (void)event:(NSString *)eventId attributes:(NSDictionary *)attributes counter:(int)number; 145 | 146 | /** 自定义事件,时长统计. 147 | 使用前，请先到友盟App管理后台的设置->编辑自定义事件 中添加相应的事件ID，然后在工程中传入相应的事件ID. 148 | beginEvent,endEvent要配对使用,也可以自己计时后通过durations参数传递进来 149 | 150 | @param eventId 网站上注册的事件Id. 151 | @param label 分类标签。不同的标签会分别进行统计，方便同一事件的不同标签的对比,为nil或空字符串时后台会生成和eventId同名的标签. 152 | @param primarykey 这个参数用于和event_id一起标示一个唯一事件，并不会被统计；对于同一个事件在beginEvent和endEvent 中要传递相同的eventId 和 primarykey 153 | @param millisecond 自己计时需要的话需要传毫秒进来 154 | @return void. 155 | 156 | 157 | @warning 每个event的attributes不能超过10个 158 | eventId、attributes中key和value都不能使用空格和特殊字符，且长度不能超过255个字符（否则将截取前255个字符） 159 | id， ts， du是保留字段，不能作为eventId及key的名称 160 | 161 | */ 162 | + (void)beginEvent:(NSString *)eventId; 163 | /** 自定义事件,时长统计. 164 | 使用前，请先到友盟App管理后台的设置->编辑自定义事件 中添加相应的事件ID，然后在工程中传入相应的事件ID. 165 | */ 166 | + (void)endEvent:(NSString *)eventId; 167 | /** 自定义事件,时长统计. 168 | 使用前，请先到友盟App管理后台的设置->编辑自定义事件 中添加相应的事件ID，然后在工程中传入相应的事件ID. 169 | */ 170 | 171 | + (void)beginEvent:(NSString *)eventId label:(NSString *)label; 172 | /** 自定义事件,时长统计. 173 | 使用前，请先到友盟App管理后台的设置->编辑自定义事件 中添加相应的事件ID，然后在工程中传入相应的事件ID. 174 | */ 175 | 176 | + (void)endEvent:(NSString *)eventId label:(NSString *)label; 177 | /** 自定义事件,时长统计. 178 | 使用前，请先到友盟App管理后台的设置->编辑自定义事件 中添加相应的事件ID，然后在工程中传入相应的事件ID. 179 | */ 180 | 181 | + (void)beginEvent:(NSString *)eventId primarykey :(NSString *)keyName attributes:(NSDictionary *)attributes; 182 | /** 自定义事件,时长统计. 183 | 使用前，请先到友盟App管理后台的设置->编辑自定义事件 中添加相应的事件ID，然后在工程中传入相应的事件ID. 184 | */ 185 | 186 | + (void)endEvent:(NSString *)eventId primarykey:(NSString *)keyName; 187 | /** 自定义事件,时长统计. 188 | 使用前，请先到友盟App管理后台的设置->编辑自定义事件 中添加相应的事件ID，然后在工程中传入相应的事件ID. 189 | */ 190 | 191 | + (void)event:(NSString *)eventId durations:(int)millisecond; 192 | /** 自定义事件,时长统计. 193 | 使用前，请先到友盟App管理后台的设置->编辑自定义事件 中添加相应的事件ID，然后在工程中传入相应的事件ID. 194 | */ 195 | 196 | + (void)event:(NSString *)eventId label:(NSString *)label durations:(int)millisecond; 197 | /** 自定义事件,时长统计. 198 | 使用前，请先到友盟App管理后台的设置->编辑自定义事件 中添加相应的事件ID，然后在工程中传入相应的事件ID. 199 | */ 200 | 201 | + (void)event:(NSString *)eventId attributes:(NSDictionary *)attributes durations:(int)millisecond; 202 | 203 | 204 | ///--------------------------------------------------------------------------------------- 205 | /// @name 按渠道自动更新 206 | ///--------------------------------------------------------------------------------------- 207 | 208 | 209 | /** 按渠道自动更新检测 210 | 检查当前app是否有更新，有更新弹出UIAlertView提示用户,当用户点击升级按钮时app会跳转到您预先设置的网址。 211 | 无更新不做任何操作。 212 | 您需要先在服务器端设置app版本信息，默认渠道是App Store. 213 | 如果您想自己控制自动更新操作流程，请实现MobClickDelegate的appUpdate方法。 214 | 215 | @param title 对应UIAlertView的title. 216 | @param cancelTitle 对应UIAlertView的cancelTitle. 217 | @param otherTitle 对应UIAlertView的otherTitle. 218 | @param delegate 需要自定义checkUpdate的对象. 219 | @param callBackSelectorWithDictionary 当checkUpdate事件完成时此方法会被调用,同时标记app更新信息的字典被传回. 220 | @return void. 221 | */ 222 | 223 | + (void)checkUpdate; 224 | /** 按渠道自动更新检测 225 | */ 226 | 227 | + (void)checkUpdate:(NSString *)title cancelButtonTitle:(NSString *)cancelTitle otherButtonTitles:(NSString *)otherTitle; 228 | /** 按渠道自动更新检测 229 | */ 230 | 231 | + (void)checkUpdateWithDelegate:(id)delegate selector:(SEL)callBackSelectorWithDictionary; 232 | 233 | 234 | ///--------------------------------------------------------------------------------------- 235 | /// @name 在线参数 236 | ///--------------------------------------------------------------------------------------- 237 | 238 | 239 | /** 使用在线参数功能，可以让你动态修改应用中的参数值, 240 | 检查并更新服务器端配置的在线参数,缓存在[NSUserDefaults standardUserDefaults]里, 241 | 调用此方法您将自动拥有在线更改SDK端发送策略的功能,您需要先在服务器端设置好在线参数. 242 | 请在[MobClick startWithAppkey:]方法之后调用; 243 | 如果想知道在线参数是否完成完成，请监听UMOnlineConfigDidFinishedNotification 244 | @param 无. 245 | @return void. 246 | */ 247 | 248 | + (void)updateOnlineConfig; 249 | 250 | /** 从[NSUserDefaults standardUserDefaults]获取缓存的在线参数的数值 251 | 带参数的方法获取某个key的值，不带参数的获取所有的在线参数. 252 | 需要先调用updateOnlineConfig才能使用,如果想知道在线参数是否完成完成，请监听UMOnlineConfigDidFinishedNotification 253 | 254 | @param key 255 | @return (NSString *) . 256 | */ 257 | 258 | + (NSString *)getConfigParams:(NSString *)key; 259 | 260 | /** 从[NSUserDefaults standardUserDefaults]获取缓存的在线参数 261 | @return (NSDictionary *). 262 | */ 263 | 264 | + (NSDictionary *)getConfigParams; 265 | 266 | + (NSString *)getAdURL; 267 | 268 | 269 | ///--------------------------------------------------------------------------------------- 270 | /// @name 地理位置设置 271 | ///--------------------------------------------------------------------------------------- 272 | 273 | 274 | /** 为了更精确的统计用户地理位置，可以调用此方法传入经纬度信息 275 | 需要链接 CoreLocation.framework 并且 #import 276 | @param latitude 纬度. 277 | @param longitude 经度. 278 | @param location CLLocation *型的地理信息 279 | @return void 280 | */ 281 | 282 | + (void)setLatitude:(double)latitude longitude:(double)longitude; 283 | /** 为了更精确的统计用户地理位置，可以调用此方法传入经纬度信息 284 | */ 285 | 286 | + (void)setLocation:(CLLocation *)location; 287 | 288 | 289 | ///--------------------------------------------------------------------------------------- 290 | /// @name helper方法 291 | ///--------------------------------------------------------------------------------------- 292 | 293 | 294 | /** 判断设备是否越狱，判断方法根据 apt和Cydia.app的path来判断 295 | */ 296 | + (BOOL)isJailbroken; 297 | /** 判断你的App是否被破解 298 | */ 299 | + (BOOL)isPirated; 300 | 301 | #pragma mark DEPRECATED methods from version 1.7 302 | 303 | /** 友盟模块启动 304 | [MobClick startWithAppkey:]通常在application:didFinishLaunchingWithOptions:里被调用监听 305 | App启动和退出事件，如果你没法在application:didFinishLaunchingWithOptions:里添加友盟的[MobClick startWithAppkey:] 306 | 方法，App的启动事件可能会无法监听，此时你就可以手动调用[MobClick startSession:nil]来启动友盟的session。 307 | 通常发生在某些第三方框架生成的app里，普通app使用不到. 308 | 309 | */ 310 | 311 | + (void)startSession:(NSNotification *)notification; 312 | 313 | @end -------------------------------------------------------------------------------- /src/ios/libMobClickLibrary.a: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/hzlzh/phonegap-cordova-umeng-analytics-plugin/d9203f8e30ce7151a2c7e914f56a392d42e49549/src/ios/libMobClickLibrary.a -------------------------------------------------------------------------------- /www/umeng_analytics.js: -------------------------------------------------------------------------------- 1 | var UmengAnalyticsPlugin = function() {}; 2 | 3 | UmengAnalyticsPlugin.prototype.say = function(success, fail) { 4 | cordova.exec(success, fail, "UmengAnalyticsPlugin","say", []); 5 | }; 6 | 7 | var umengAnalyticsPlugin = new UmengAnalyticsPlugin(); 8 | module.exports = umengAnalyticsPlugin; --------------------------------------------------------------------------------