启动来源分析

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

概述

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

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

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

版本支持

支持系统iOS 9.0+。

集成步骤

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

功能使用与测试

您可以前往启动来源分析

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

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

    A) 接口声明:

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

    B)接口调用举例:

     [BaiduMobStat defaultStat].enableGetPushContent = NO;
    

    C) 调用位置:

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

    D) 调用场景:

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

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

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

    A) 接口声明:

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

    B)接口调用举例:

     [BaiduMobStat defaultStat].enableLaunchRefererTrack = NO;
    

    C) 调用位置:

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

    D) 调用场景:

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

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

(可选)特殊说明

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

//9.0以后新的回调函数
- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options NS_AVAILABLE_IOS(9_0); 
//9.0以前的回调函数
- (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信息。

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