手动集成

优质
小牛编辑
178浏览
2023-12-01

版本支持

支持系统iOS 9.0+

集成步骤

  1. 下载SDK

  2. 创建一个新的XCode iOS开发工程,选择Objective C作为开发语言。

  3. 在XCode左侧的树中右键单击项目选择Add Files to "ProjectName"..,将BaiduMobStat.hlibBaiduMobStat.aUserFeedBack.framework加入到项目中。

    (V5.3.5及以上版本需要添加上述3部分文件到工程中,V5.3.5以下的版本只需要添加BaiduMobStat.h、libBaiduMobStat.a两部分文件。)

    Add File 1

    Add File 2

    添加完成后:

    Add File 3

  4. 在项目的Build Target添加Linked Frameworks and Libraries,添加列表如下:

     Foundation.framework
     UIKit.framework
     CoreGraphics.framework
     CoreTelephony.framework
     SystemConfiguration.framework
     CoreLocation.framework
     Security.framework
     AdSupport.framework (V4.6.4版本更新后,新增IDFA采集)
     libc++.tbd
     libz.1.2.5.tbd
     // 使用“无埋点”版本的SDK,需要额外引用以下两个系统库
     libicucore.tbd
     WebKit.framework(Optional)
    

    添加后的Linked Frameworks and Libraries如下图所示:

    Add Library 2

  5. 初始化SDK:

    • 添加初始化代码

      在AppDelegate类头部添加引用#import "BaiduMobStat.h"didFinishLaunchingWithOptions:方法的开始处添加如下代码:

        [[BaiduMobStat defaultStat] startWithAppId:@"APP KEY"]; // 设置您在mtj网站上添加的app的appkey,此处AppId即为应用的appKey
      
    • 若使用的是全埋点版本SDK,除了以上方式初始化sdk之外,还可以通过如下方式初始化(二种方式任选其一):

      编辑info.plist配置文件:打开主工程下Supporting Files文件夹下的info.plist文件,按照如下示例,新增mtj_appkey、mtj_deubglog两行参数,并写入您的appkey。

      图片

      再到主Target下,切到Build Settings,找到Linking部分的Other Linker Flags条目,双击后加入-ObjC配置。

      -ObjC

  6. 编译项目并启动运行,5分钟左右后即可在百度移动统计网站上看到对应的启动数据!

  7. IDFA采集注意事项

    MTJ iOS SDK从V4.6.4版本起,支持采集IDFA。

    使用IDFA,理论上需要集成任意一家的广告服务,如果您的App并未使用任何广告,可以采用以下方法通过Appstore审核:

    在itunesConnect提交新版本审核时,在Advertising Identifier选项中选择YES,同时勾选子选项,如下图。

    Add Library 3

    a) Serve advertisements within the app

    服务应用中的广告。如果你的应用中集成了广告,需要勾选这一项,应用中没有广告则不勾选。

    b) Attribute this app installation to a previously served advertisement

    跟踪广告带来的安装。需要勾选。

    c) Attribute an action taken within this app to a previously served advertisement

    跟踪广告带来的用户的后续行为。需要勾选。

    d) Limit Ad Tracking setting in iOS

    此项属于确认项,需要勾选。

    如果您仍因为采集IDFA被Appstore审核拒绝,建议您集成任意一家广告或选用MTJ的无IDFA版本SDK