iOS 启动来源分析

概述

使用启动来源分析功能,需要集成“应用分析(无埋点)”类型的SDK。

启动来源分析是MTJ新推出的功能,帮助用户分析App的启动来源:自然打开、应用跳转、推送唤醒等场景。

具体的产品功能,可以查看启动来源分析

版本支持

支持系统iOS 8.0+。

集成步骤

  • 下载并集成MTJ最新版的“应用分析(无埋点)”类型的SDK,您可以前往SDK中心下载对应的版本,并按照本文档的集成步骤进行集成。
  • 当您完成上述“集成步骤”之后,SDK已经自动开启启动来源分析功能。

功能使用与测试

您可以前往启动来源分析

(可选)其他个性化参数设置

  • 开启或关闭推送文案采集设置

    A) 接口声明:

  1. /**
  2. 设置是否允许推送文案的采集,用于启动来源分析(V4.9.5新增)
  3. 默认为YES
  4. */
  5. @property (nonatomic, assign) BOOL enableGetPushContent;

B)接口调用举例:

  1. [BaiduMobStat defaultStat].enableGetPushContent = NO;

C) 调用位置:

在程序入口函数didFinishLaunchingWithOptions中调用如上示例。(如果您使用手动初始化方式,则本行设置需要在startWithAppID调用之前)。

D) 调用场景:

  • 默认情况下,该属性值为YES,即SDK采集推送文案,用于更精确的分析。

  • 如果您处于隐私等考虑,不希望SDK采集推送文案,可以将该属性设置为NO。

  • 开启或关闭整个启动来源分析功能

    A) 接口声明:

  1. /**
  2. 设置是否使用启动来源分析功能(V4.9.5新增)
  3. 默认为YES
  4. */
  5. @property (nonatomic, assign) BOOL enableLaunchRefererTrack;

B)接口调用举例:

  1. [BaiduMobStat defaultStat].enableLaunchRefererTrack = NO;

C) 调用位置:

在程序入口函数didFinishLaunchingWithOptions中调用如上示例。(如果您使用手动初始化方式,则本行设置需要在startWithAppID调用之前)。

D) 调用场景:

  • 默认情况下,该属性值为YES,即SDK统计App的启动来源信息。

  • 如果您不希望SDK统计启动来源信息,可以将属性设置为NO。

(可选)特殊说明

SDK分析应用跳转场景时,需要依赖开发者实现的回调函数,来获取跳转的来源App信息。建议开发者实现如下两种openURL的回调函数:

  1. //9.0以后新的回调函数
  2. - (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options NS_AVAILABLE_IOS(9_0);
  3. //9.0以前的回调函数
  4. - (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(nullable NSString *)sourceApplication annotation:(id)annotation NS_DEPRECATED_IOS(4_2, 9_0, "Please use application:openURL:options:") __TVOS_PROHIBITED;

如果只实现如下老版本的openURL回调函数,则获取不到跳转来源App信息。

  1. //不建议使用该回调函数
  2. - (BOOL)application:(UIApplication *)application handleOpenURL:(NSURL *)url NS_DEPRECATED_IOS(2_0, 9_0, "Please use application:openURL:options:") __TVOS_PROHIBITED;