跳转到主要内容
PRODUCT DOCUMENTS

快速找到所需文档,高效完成接入与排障

浏览产品文档与友盟 Skill,展开目录并阅读正文。

基础功能

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为空的话,打印日志如下图:

UMCommLog_invalidAppkeyLog
  • 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];
}

集成视频引导