基础功能
1.说明和用途
初始化
1.说明和用途
组件化SDK用来聚合(移动统计 SDK,消息推送 SDK,社会化分享 SDK等)业务的初始化接口,方便对各个业务的初始化统一调用。
2.接口函数
接口:
/** 初始化友盟所有组件产品
@param appKey 开发者在友盟官网申请的appkey.
@param channel 渠道标识,可设置nil表示"App Store".
*/
+ (void)initWithAppkey:(NSString *)appKey channel:(NSString *)channel;参数:
参数 | 类型 | 描述 | 备注 |
appKey | NSString | 在 App Analytics 创建应用后,进入数据报表页中, 在“统计分析->设置->应用信息” 页面查看。 | AppKey为必需,为了根据您的AppKey查看后台的实时和离线统计数据,帮助您了解目前您的产品的详细情况。 |
channel | NSString | channel为您应用的推广渠道。channel为nil或@””时,默认会被当作@”App Store”渠道 | 渠道命名规范:可以由英文字母、阿拉伯数字、下划线、中划线、空格、括号组成,可以含汉字以及其他明文字符,但是不建议使用中文命名,会出现乱码。 首尾字符不可以为空格 最多256个字符 “App Store” 及其各种大小写形式,作为友盟保留的字段,不可以作为渠道名。 |
提示每台设备仅记录首次安装激活的渠道,如果该设备再次安装其他渠道包,则数据仍会被记录在初始的安装渠道上。 所以在测试不同的渠道时,请使用不同的设备来分别测试。也可使用集成测试功能进行测试,了解更多集成测试请点击这里。
3.示例代码
#import <UMCommon/UMCommon.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[UMConfigure initWithAppkey:@"Your appkey" channel:@"App Store"];
}Appkey填写
将[UMConfigure initWithAppkey:@”Your appkey” channel:@”App Store”]; 中的”Your appkey”替换为您在【友盟+】后台申请的应用Appkey(Appkey可在统计后台 “管理->应用管理->应用列表” 页面查看,或在 “我的产品”选择某应用->设置->应用信息 查看Appkey)。
Channel填写
将[UMConfigure initWithAppkey:@”Your appkey” channel:@”App Store”] 中的App Store 替换为您应用的推广渠道。channelId为nil或@””时,默认会被当作@”App Store”渠道。
渠道命名规范:
可以由英文字母、阿拉伯数字、下划线、中划线、空格、括号组成,可以含汉字以及其他明文字符,但是不建议使用中文命名,会出现乱码。首尾字符不可以为空格最多256个字符“App Store” 及其各种大小写形式,作为友盟保留的字段,不可以作为渠道名。
提示:每台设备仅记录首次安装激活的渠道,如果该设备再次安装其他渠道包,则数据仍会被记录在初始的安装渠道上。 所以在测试不同的渠道时,请使用不同的设备来分别测试。也可使用集成测试功能进行测试,了解更多集成测试[请点击这里]
设置上报用户账号
账号统计及用户属性上报【友盟+】在统计用户时以设备为标准,如果需要统计应用自身的账号,请参考 高级功能 「账号统计功能」 完成账号统计的集成。
设置上报用户上报后,在U-App中的应用及实践场景可参考文档:用户账号及用户属性
U-App以友盟生成的设备ID(友盟ID)为唯一标识进行指标计算,因此我们强烈建议您同时完成账号统计的集成,集成后,用户使用您App时登录的用户账号将和行为日志同时上报,方便后续分析、导出明细日志时您能通过用户登录账号识别用户,并扩展、关联到您业务的其他系统中。
IDFA说明
从组件化产品开始,【友盟+】SDK默认采集idfa标识,用来更准确的分析核对数据。对于应用本身没有获取idfa的情况,建议将应用提交至AppStore时按如下方式配置:(以避免被苹果以“应用不含广告功能,但获取了广告标示符IDFA”的而拒绝其上架。)
设置日志
1.说明和用途
设置是否在console输出sdk的log信息。详细集成
2.接口函数
接口:
/** 设置是否在console输出SDK的log信息.
@param bFlag 默认NO(不输出log); 设置为YES, 输出可供调试参考的log信息. 发布产品时必须设置为NO.
*/
+ (void)setLogEnabled:(BOOL)bFlag;注意:在统计iOS SDK7.2.0及以上版本查看Crash Log时,需要断开Xcode调试,然后打开控制台,看iPhone日志,当App产生crash后再启动会发送。在Log中会有Crash Log Start 和Crash Log End中间就是上次产生的crash。
日志格式如下:
举例:如果用户传入的AppKey为空的话,打印日志如下图:

2018-02-08 20:19:44: 指当前的打印的时间;
UMengCommon: 指组件化SDK(UMCommon.framework)的名字;
<1.4.3>: 指组件化SDK(UMCommon.framework)的版本号;
(Error): 指日志等级是Error的日志;
[CIE10001]: 指日志的FAQ的代号,也可通过FAQ文档找到对应的解决方法;
用户传入的AppKey不合法,请到官网申请AppKey,以免影响自己App的统计数据。: 指提示开发者的错误信息,帮助开发者找到错误原因。
3.示例代码
#import <UMCommonLog/UMCommonLogHeaders.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Override point for customization after application launch.
//开发者需要显式的调用此函数,日志系统才能工作
[UMCommonLogManager setUpUMCommonLogManager];
}