页面git

移动数据分析开发指南开发指南iOSSDK手册移动数据分析MobileAnalyticsiOSSDK开发指南1.
前言本文档介绍了移动数据分析(MobileAnalytics)iOSSDK的使用方式.
MobileAnalyticsiOSSDK是阿里云面向移动开发者提供的iOS平台下的数据统计与监控服务.
通过该SDK,开发者可以在自己的APP中便捷地进行数据埋点,监控日常的业务数据与性能数据,并通过阿里云控制台界面观察对应的数据报表展现.
另外,用户可以通过设定自定义的数据解析规则实现定制化的数据图表展现.
您可以通过获取alicloud-ios-demo工程源码获得移动数据分析服务的使用例程.

2.
安装MobileAnalyticsiOSSDK2.
1注意使用1.
0.
7及之前版本请在【Crash分析】板块查看crash信息.
使用1.
0.
8版本及之后的版本,请在【新版Crash分析】板块查看crash信息.
推荐使用1.
0.
8及之后的版本,crash数据更加准确,丢包率更小.
移动数据分析开发指南11.
2.
3.
4.
1.
2.
3.
4.
5.
--删除-(ALBBMANTracker*)getTracker:(NSString)trackerId方法,请使用-(ALBBMANTracker*)getDefaultTracker代替.
删除-(void)setCrashCaughtListener:(id)aListener方法,1.
0.
8及之后的版本使用新的crash模块,无需再调用次方法设置参数.
2.
2手动集成SDK将下载的包加至LinkBinaryWithLibraries,包括:AlicloudMobileAnalytics.
frameworkUTMini.
frameworkUTDID.
frameworkCrashReporter.
framework注意:因移动数据分析依赖CrashReporter.
framework,如果同时使用奔溃分析,必须把pod'AlicloudMAN'改为pod'AlicloudMANLight'才能解决依赖冲突.
加载系统必须依赖的包:libz.
tbdlibresolv.
tbdlibsqlite3.
tbdCoreTelephony.
frameworkSystemConfiguration.
framework2.
3Pod集成指定Master仓库和阿里云仓库:添加依赖:(~>为模糊指定版本号方式,~>1.
0.
12表明引用版本位于1.
0.
12使用奔溃分析,必须把pod'AlicloudMAN'改为pod'AlicloudMANLight'才能解决依赖冲突.
source'https://github.
com/CocoaPods/Specs.
git'source'https://github.
com/aliyun/aliyun-specs.
git'pod'AlicloudMAN','~>1.
0.
12'pod'AlicloudUT','~>5.
2.
0.
8'移动数据分析开发指南2--2.
4下载SDK统一配置文件在控制台产品概览页面,下载App的配置文件AliyunEmasServices-Info.
plist,如下图所示:Xcode中,把下载的AliyunEmasServices-Info.
plist文件拖入对应AppTarget下即可,在弹出框勾选Copyitemsifneeded.
【附】AliyunEmasServices-Info.
plist配置文件,包含SDK初始化所需的配置信息,用户只需要调用无需手动输入配置信息的autoInit初始化接口,参考第3节描述.
2.
5引用头文件特别说明:应用的targets->BuildSettings->linking->OtherLinkerFlags,请加上-ObjC这个属性.
3.
获取MobileAnalytics服务在您使用MobileAnalyticsiOSSDK进行数据统计与监控前,您需要首先获取MobileAnalytics服务,然后可以进行版本和渠道的配置.
手动输入配置信息,初始化接口:自动初始化接口:#import-(void)initWithAppKey:(NSString*)appKeysecretKey:(NSString*)secretKey;-(void)autoInit;移动数据分析开发指南3-MANSDK初始化实例:4.
业务数据统计数据统计的准确性依赖被监控APP的常规生命轨迹,比如应用启动次数依赖于用户正常退出应用触发的上报策略.
4.
1登录/注册会员4.
1.
1登录会员接口:功能:获取登录会员,然后会给每条日志添加登录会员字段是否必须调用:否调用时机:登录时调用备注:阿里云平台上的登录会员UV指标依赖该接口4.
1.
2注册会员接口:功能:产生一条注册会员事件日志是否必须调用:否调用时机:注册时调用备注:阿里云平台上注册会员指标依赖该接口//获取MAN服务ALBBMANAnalytics*man=[ALBBMANAnalyticsgetInstance];//打开调试日志,线上版本建议关闭//[manturnOnDebug];//初始化MAN,无需输入配置信息[manautoInit];//appVersion默认从Info.
list的CFBundleShortVersionString字段获取,如果没有指定,可在此调用setAppversion设定//如果上述两个地方都没有设定,appVersion为"-"[mansetAppVersion:@"2.
3.
1"];//设置渠道(用以标记该app的分发渠道名称),如果不关心可以不设置即不调用该接口,渠道设置将影响控制台【渠道分析】栏目的报表展现.
[mansetChannel:@"50"];-(void)updateUserAccount:(NSString*)pNickuserid:(NSString*)pUserId;-(void)userRegister:(NSString*)pUsernick;移动数据分析开发指南44.
1.
3代码示例完成上述埋点后,您就可以在阿里云控制台看到相应统计信息,例如下图显示实时统计里的登录会员和新注册会员.
4.
2页面埋点使用ALBBMANPageHitHelper可以进行ViewController级别的页面埋点,ALBBMANPageHitHelper为页面埋点辅助类,可以自动完成页面名称(默认获取ViewController名称并去除后缀Controller)、来源页面和页面停留时间的统计,如需使用更为灵活的页面埋点方案,可使用ALBBMANPageHitBuilder页面打点基础类进行页面埋点,详情见4.
3节.
【注意】:如果App中没有进行页面埋点,活跃用户参数不能正常统计.
4.
2.
1页面进入接口:功能:记录页面进入时的一些状态信息,但不发送日志,和pageDisappear配合使用入参:UIViewController或者其子类指针是否必须调用;需要对页面埋点时调用调用时机:viewDidAppear备注:必须和pageDisappear搭配使用ALBBMANAnalytics*man=[ALBBMANAnalyticsgetInstance];[manuserRegister:@"userNick"];[manupdateUserAccount:@"userNick"userid:@"userId"];-(void)pageAppear:(UIViewController*)pViewController;移动数据分析开发指南54.
2.
2页面离开接口:功能:页面离开发送页面事件日志,和pageAppear配合使用入参:UIViewController或者其子类指针是否必须调用:当调用了pageAppear后,必须调用pageDisappear调用时机:viewDidDisAppear备注:必须和pageAppear搭配使用4.
2.
3设置页面扩展参数接口:功能:设置页面扩展参数是否必须调用:否调用时机:调用pageDisAppear之前4.
2.
4代码示例4.
3页面事件ALBBMANPageHitBuilder类也是用来产生页面事件日志的,虽然4.
2节中可以通过pageAppear和pageDisAppear来进行页面埋点,但是它针对的只是UIViewController级别的页面,并不能满足一些场景的页面事件,例如UIView,如果用户需要将一个UIView当做一个页面,那么就可以通过ALBBMANPageHitBuilder来进行页面事件的埋点,即用户自己采集页面事件相关的信息(如页面的refer、页面停留时间等),通过ALBBMANPageBuilder构造出一条页面事件的日志map,最后通过某个-(void)pageDisAppear:(UIViewController*)pViewController;-(void)updatePageProperties:(UIViewController*)pViewControllerproperties:(NSDictionary*)pProperties;//进入页面[[ALBBMANPageHitHelpergetInstance]pageAppear:self];//设置页面事件扩展参数NSDictionary*properties=[NSDictionarydictionaryWithObject:@"pageValue"forKey:@"pageKey"];[[ALBBMANPageHitHelpergetInstance]updatePageProperties:selfproperties:properties];//离开页面[[ALBBMANPageHitHelpergetInstance]pageDisAppear:self];移动数据分析开发指南6ALBBMANTracker埋点实例的sendAPI发送上传.
ALBBMANTracker是一个用于对埋点数据进行上报的工具,下文提到的ALBBMANPageHitBuilder等事件类都是通过ALBBMANTracker进行事件件上报的.
其中ALBBMANTracker的获取如下所示:埋点数据上报都是通过ALBBMANTracker进行,我们可以设定/删除上报数据的全局字段,全局字段设定后在所有的上报日志中都可以查看,如下所示:4.
3.
1设置页面名称接口:功能:设置页面名称入参:页面名称,pPageName不能为空是否必须调用:是,在已经创建了ALBBMANPageHitBuilder实例后,必须调用该方法调用时机:创建ALBBMANPageHitBuilder后,必须调用setPageName,否则调用build后返回为nil备注:页面名称是页面事件的基础,必须设置4.
3.
2设置页面refer接口:功能:设置页面的refer,即当前页面的来源页面入参:refer页面名称,需要在setPageName的PageName集合中,也可以为空是否必须调用:否4.
3.
3设置页面停留时间接口://获取默认ALBBMANTracker实例ALBBMANTracker*tracker=[[ALBBMANAnalyticsgetInstance]getDefaultTracker];ALBBMANTracker*tracker=[[ALBBMANAnalyticsgetInstance]getDefaultTracker];//设定全局字段[trackersetGlobalProperty:@"globalKey1"value:@"globalValue1"];//删除全局字段[trackerremoveGlobalProperty:@"globalKey1"];-(void)setPageName:(NSString*)pPageName;-(void)setReferPage:(NSString*)pReferPageName;移动数据分析开发指南7功能:记录页面从展现到页面离开的停留时间入参:页面停留时间是否必须调用否调用时机:需要记录当前页面停留时间4.
3.
4设置页面事件扩展参数接口:功能:给单条日志添加一个扩展参数入参:key和value都不能为nil,其中key不能为PAGE/EVENTID/ARG1/ARG2/ARG3/ARGS,否则build返回nil是否必须调用:否调用时机:需要给ALBBMANPageHitBuilder实例添加扩展参数时4.
3.
5组装单条日志map接口:功能:将塞入的参数组成map返回入参:无是否必须调用:否调用时机:创建ALBBMANPageHitBuilder或者ALBBMANCustomHitBuilder实例,塞入一些业务字段后,调用build组装业务字段生成日志map,通过某个ALBBMANTracker埋点实例send接口发送备注:build函数返回的日志map,必须通过ALBBMANTracker埋点上报工具的send接口上传数据完成打点4.
3.
6代码示例-(void)setDurationOnPage:(longlong)durationTimeOnPage;-(void)setProperty:(NSString*)pKeyvalue:(NSString*)pValue;-(NSDictionary*)build;ALBBMANPageHitBuilder*pageHitBuilder=[[ALBBMANPageHitBuilderalloc]init];//设置页面refer[pageHitBuildersetReferPage:@"pageRefer"];//设置页面名称[pageHitBuildersetPageName:@"pageName"];移动数据分析开发指南8上述的页面埋点与页面事件将影响控制台【页面路径分析】、【关键漏斗】、【控件点击】、【页面留存】等指标的报表展现,页面路径如下图所示.
5.
自定义事件自定义事件埋点可用于满足用户的定制化需求.
5.
1设置自定义事件的标签接口:功能:区分不同自定义事件的标签,同一种自定义事件的pEventId相同入参:自定义事件标签,相当于自定义事件的业务ID,不能为空,只能为字母、数字和下划线组成是否必须调用:是调用时机:创建ALBBMANCustomHitBuilder后,必须调用setEventLabel,否则调用build后返回为nil备注:对于自定义事件,必须设置标签,pEventId需要事先在wdm上申请5.
2设置自定义事件的页面名称接口://设置页面停留时间[pageHitBuildersetDurationOnPage:100];//设置页面事件扩展参数[pageHitBuildersetProperty:@"pagePropertyKey1"value:@"pagePropertyValue1"];[pageHitBuildersetProperty:@"pagePropertyKey2"value:@"pagePropertyValue2"];ALBBMANTracker*tracker=[[ALBBMANAnalyticsgetInstance]getDefaultTracker];//组装日志并发送[trackersend:[pageHitBuilderbuild]];-(void)setEventLabel:(NSString*)pEventId;移动数据分析开发指南9功能:设置该自定义事件发生在哪个页面入参:自定义事件的页面名称,可以为空,这种情况日志中默认页面名称为"UT"是否必须调用:否调用时机:需要明确该自定义事件发生时的页面,不调用情况下默认为"UT"5.
3设置自定义事件停留时间接口:功能:设置自定义事件持续时间,跟ALBBMANPageHitBuilder中的页面停留时间类似入参:自定义事件停留时间是否必须调用:否调用时机:需要记录自定义事件的停留时间5.
4设置自定义事件扩展参数接口:功能:给单条日志添加一个扩展参数入参:key和value都不能为nil,其中key不能为PAGE/EVENTID/ARG1/ARG2/ARG3/ARGS,否则build返回nil是否必须调用:否调用时机:需要给ALBBMANCustomHitBuilder实例添加扩展参数时5.
5代码示例-(void)setEventPage:(NSString*)pPageName;-(void)setDurationOnEvent:(longlong)durationOnEvent;-(void)setProperty:(NSString*)pKeyvalue:(NSString*)pValue;ALBBMANCustomHitBuilder*customBuilder=[[ALBBMANCustomHitBuilderalloc]init];//设置自定义事件标签[customBuildersetEventLabel:@"test_event_label"];//设置自定义事件页面名称[customBuildersetEventPage:@"test_Page"];//设置自定义事件持续时间[customBuildersetDurationOnEvent:12345];移动数据分析开发指南10--自定义事件扩展参数在控制台【自定义事件】-【详细数据】-【参数分析】中可查看,但查看之前请在【管理设置】-【自定义事件管理】中添加要在控制台显示的事件ID.
如果您需要对自定义事件进行实时监控,请参考【5.
3自定义性能事件】章节.
6.
如何实时验证数据是否正常上报您当前可以通过以下两种方式进行验证:打开移动数据分析log,查看是否会出现如*****UTMCEngine*****UTMCUploader:upload::uploadresponse:{"t":1464532326870,"ret":"","success":"success"}的日志;注意:SDK的日志上报会有缓存和聚合,因此上报时机会比API调用时机滞后一些,可耐心等待30-60s或将应用切到后台查看.
登录控制台查看活跃用户等实时报表;注意:活跃用户的统计依赖页面埋点,移动数据分析后台会将零星的页面埋点处理为噪点,进行过滤,因此请确保您有足量的页面埋点事件上报(>5),另外控制台的实时报表大概会有5min的延迟.
7.
H5页面数据的采集H5页面采集并没有单独的SDK,依赖native进行上传,通过JSBridge通知给native,然后调用MAN的相应方法,进行数据的上报.
可运行demo请参考:alicloud-ios-demo7.
1代码示例H5进行自定义事件的上报:JavaScript代码://设置自定义事件扩展参数[customBuildersetProperty:@"ckey0"value:@"value0"];[customBuildersetProperty:@"ckey1"value:@"value1"];[customBuildersetProperty:@"ckey2"value:@"value2"];ALBBMANTracker*traker=[[ALBBMANAnalyticsgetInstance]getDefaultTracker];//组装日志并发送NSDictionary*dic=[customBuilderbuild];[trakersend:dic];//通过iframe发起请求,然后在native端进行捕获.
variframe=document.
createElement("IFRAME");//通过自定义scheme,来判断是正常请求还是H5通信.
//参数可以放在url中,然后在native解析.
移动数据分析开发指南11Objective-cAndroidSDK手册移动数据分析iframe.
setAttribute("src","jsbridge://custom");document.
documentElement.
appendChild(iframe);iframe.
parentNode.
removeChild(iframe);iframe=null;-(BOOL)webView:(UIWebView*)webViewshouldStartLoadWithRequest:(NSURLRequest*)requestnavigationType:(UIWebViewNavigationType)navigationType{NSURL*url=[requestURL];NSString*scheme=[urlscheme];//js通信if([@"jsbridge"isEqualToString:scheme]){if([@"custom"isEqualToString:url.
host]){ALBBMANCustomHitBuilder*customBuilder=[[ALBBMANCustomHitBuilderalloc]init];//设置自定义事件标签[customBuildersetEventLabel:@"test_event_label"];//设置自定义事件页面名称[customBuildersetEventPage:@"test_Page"];//设置自定义事件持续时间[customBuildersetDurationOnEvent:12345];//设置自定义事件扩展参数[customBuildersetProperty:@"ckey0"value:@"value0"];[customBuildersetProperty:@"ckey1"value:@"value1"];[customBuildersetProperty:@"ckey2"value:@"value2"];ALBBMANTracker*traker=[[ALBBMANAnalyticsgetInstance]getDefaultTracker];//组装日志并发送NSDictionary*dic=[customBuilderbuild];[trakersend:dic];}returnNO;}returnYES;}移动数据分析开发指南12MobileAnalyticsAndroidSDK开发指南1.
前言本文档介绍了移动数据分析(MobileAnalytics)AndroidSDK的使用方式.
MobileAnalyticsAndroidSDK是阿里云面向移动开发者提供的Android平台下的数据统计与监控服务.
通过该SDK,开发者可以在自己的APP中便捷地进行数据埋点,监控日常的业务数据与网络性能数据,并通过阿里云控制台界面观察对应的数据报表展现.
另外,用户后续可以通过设定自定义的数据解析规则实现定制化的数据图表展现.
您可以通过获取alicloud-android-demo工程源码获得移动数据分析服务的使用例程.

2.
安装MobileAnalyticsAndroidSDK2.
1注意使用1.
1.
5及之前版本请在【Crash分析】板块查看crash信息.
使用1.
1.
6版本及之后的版本,请在【新版Crash分析】板块查看crash信息.
推荐使用1.
1.
6及之后的版本,crash数据更加准确,丢包率更小.
1.
1.
6之后的版本如果用手动设置channel的方式,请在manService.
getMANAnalytics().
init方法之前调用,具体请看下方初始化代码.
通过mainfest.
xml设置的话不影响.
2.
2手动集成SDK2.
2.
1SDK目录结构OneSDK|--libs|--|--jniLibs|||--armeabilibMotu.
so-crash捕获的so包|||--armeabi-v7alibMotu.
so|||--x86libMotu.
so||--alicloud-android-sdk-man-1.
1.
6.
jar-移动数据分析主功能包||--alicloud-android-ut-5.
4.
0.
jar-UT基础包||--utdid4all-1.
1.
5.
3_proguard.
jar-设备Id生成包移动数据分析开发指南13----2.
2.
2SDK集成手动拷贝OneSDK目录下的jniLibs到以下目录:src->main在build.
gradle配置中添加如下配置项:2.
3Maven依赖build.
gradle中添加Maven仓库地址:gradle添加依赖:(开发时可以如上所述指定完整的版本号,也可以指定模糊版本号,gradle自动拉取满足条件的最新版本SDK,如compile'com.
aliyun.
ams:alicloud-android-man:1.
+')2.
4EMAS产品统一接入要求sdk版本>=1.
2.
2版本,使用统一接入方式后,将无需在AndroidManifest中指定appKey/appSecret,并且初始化时,可直接使用manService.
getMANAnalytics().
init(this,getApplicationContext());即可.
具体请参考:Emas统一接入文档(Android)3.
应用程序初始化android{.
.
.
defaultConfig{.
.
.
ndk{moduleName"jniLibs"abiFilters"armeabi","armeabi-v7a","x86"}}}allprojects{repositories{maven{url'http://maven.
aliyun.
com/nexus/content/repositories/releases/'}}}dependencies{compile'com.
aliyun.
ams:alicloud-android-man:1.
2.
0'}移动数据分析开发指南14在您使用MobileAnalyticsAndroidSDK进行数据统计与监控前,您需要对SDK的上下文进行一些初始化配置,如权限声明、传递应用上下文、访问控制等.
其中权限声明在AndroidManifest.
xml文件中进行.

3.
1权限声明及配置AppKey,AppSecret以下是MobileAnalyticsAndroidSDK所需要的Android权限及配置AppKey,AppSecret,请把这些权限配置到您的AndroidManifest.
xml文件,否则,SDK将无法正常工作.
3.
2初始化及参数设置示例在Application的实现类中,添加初始化SDK的代码.
MobileAnalyticsAndroidSDK初始化部分的接口如下:.
.
.
publicclassYourApplicationextendsApplication{@OverridepublicvoidonCreate(){super.
onCreate();/*【注意】建议您在Application中初始化MAN,以保证正常获取MANService*///获取MAN服务MANServicemanService=MANServiceProvider.
getService();//打开调试日志,线上版本建议关闭//manService.
getMANAnalytics().
turnOnDebug();//若需要关闭SDK的自动异常捕获功能可进行如下操作(如需关闭crashreport,建议在init方法调用前关闭crash),详见文档5.
4manService.
getMANAnalytics().
turnOffCrashReporter();//设置渠道(用以标记该app的分发渠道名称),如果不关心可以不设置即不调用该接口,渠道设置将影响控制台【渠道分析】栏目的报表展现.
如果文档3.
3章节更能满足您渠道配置的需求,就不要调用此方法,按照3.
3进行配置即可;1.
1.
6版本及之后的版本,请在init方法之前调用此方法设置channel.
manService.
getMANAnalytics().
setChannel("某渠道");移动数据分析开发指南153.
3配置渠道信息您可以在AndroidManifest.
xml中配置您的渠道信息,您只需要将替换您的渠道信息即可.
【注意】SDK执行初始化时会自动获取AndroidManifest.
xml中的字段,并到填充渠道字段;初始化完成后.

若同时调用了setChannel方法,则以setChannel方法中的参数为准.
3.
4SDK调试说明在控制台中观察到的【今日实时】、【系统质量】-【实时Crash信息】、【新版crash分析】、【系统质量】-【性能分析】部分均为实时数据,调试时可参考该数据,验证环境配置及初始化是否正确.
数据统计的准确性依赖APP的常规生命轨迹,比如应用启动次数依赖于用户正常退出应用触发的上报策略.

4.
业务数据统计4.
1会员账号信息埋点4.
1.
1用户注册埋点在用户注册成功之后,可使用userRegister完成用户注册埋点.
//MAN初始化方法之一,从AndroidManifest.
xml中获取appKey和appSecret初始化,若您采用上述2.
3中"统一接入的方式",则使用当前init方法即可.
manService.
getMANAnalytics().
init(this,getApplicationContext());//MAN另一初始化方法,手动指定appKey和appSecret//若您采用上述2.
3中"统一接入的方式",则无需使用当前init方法.
//StringappKey//StringappSecret//manService.
getMANAnalytics().
init(this,getApplicationContext(),appKey,appSecret);//通过此接口关闭页面自动打点功能,详见文档4.
2manService.
getMANAnalytics().
turnOffAutoPageTrack();//若AndroidManifest.
xml中的android:versionName不能满足需求,可在此指定//若在上述两个地方均没有设置appversion,上报的字段默认为nullmanService.
getMANAnalytics().
setAppVersion("3.
1.
1");}}">移动数据分析开发指南164.
1.
2用户登录及注销埋点用户登录埋点:用户注销埋点:如果不进行4.
1会员账号信息埋点,此时不能在今日实时里看到【登录会员】和【新注册会员】的统计信息,而设备相关的统计【活跃用户】和【新增用户】可以看到.
完成上述埋点后,您就可以在阿里云控制台看到相应统计信息,例如下图所示为用户周活跃度.

4.
2页面埋点说明:MobileAnalyticsSDK默认会自动采集Android4.
0及以上系统的Activity页面,如果不需要自动采集可使用下面方法关闭自动页面打点.
打开页面自动埋点时,默认页面名称为class.
getSimpleName()并去除Activity后缀.
MANServicemanService=MANServiceProvider.
getService();//注册用户埋点manService.
getMANAnalytics().
userRegister("usernick");MANServicemanService=MANServiceProvider.
getService();//用户登录埋点manService.
getMANAnalytics().
updateUserAccount("usernick","userid");//用户注销埋点manService.
getMANAnalytics().
updateUserAccount(//关闭自动打点MANServicemanService=MANServiceProvider.
getService();manService.
getMANAnalytics().
turnOffAutoPageTrack();移动数据分析开发指南17为了满足Android4.
0以下系统的页面采集需求,您可按照如下的说明进行手动埋点.
【注意】:如果App中没有进行页面埋点,活跃用户参数不能正常统计.
4.
2.
1手动Activity页面埋点在Activity的onReasume以及onPause中分别加入pageAppear和pageDisAppear代码,建议下述代码可以在一个基类中做,让其它所有的activity类都继承这个基类,就完成了所有子类页面埋点.

代码示例如下:页面埋点将影响控制台【页面路径分析】、【关键漏斗】、【页面留存】等指标的报表展现.