Show Menu
主题×

配置方法

以下是 iOS 库提供的方法列表。
SDK 当前支持多个 Adobe Experience Cloud 解决方案,包括 Analytics、Target、Audience Manager 和 Adobe Experience Platform Identity Service。
  • setAppExtensionType
    配置 Adobe Mobile SDK 设置以确定当前正在执行的扩展类型。
    设置为以下值之一:
    • ADBMobileAppExtensionTypeRegular - 扩展与容器应用程序捆绑在一起.
    • ADBMobileAppExtensionTypeStandAlone - 扩展未与容器应用程序捆绑在一起.
    ​当您的应用程序具有扩展或本身是独立扩展时,才应使用此方法。有关更多信息,请参阅下面的“ADBMobileAppExtensionType”**。
    • 以下是此方法的语法:
      + (void) setAppExtensionType:(ADBMobileAppExtensionType)type;
      
      
    • 以下是此方法的代码示例:
      [ADBMobile setAppExtensionType:ADBMobileAppExtensionTypeStandAlone]; 
      
      
  • version
    返回 Adobe Mobile 库的当前版本。
    • 以下是此方法的语法:
      +(NSString*) version;
      
      
    • 以下是此方法的代码示例:
      NSString*libraryVersion = [ADBMobileversion];
      
      
  • privacyStatus
    返回当前用户隐私状态的枚举表示形式。
    • ADBMobilePrivacyStatusOptIn - 立即发送点击。
    • ADBMobilePrivacyStatusOptOut - 丢弃点击。
    • ADBMobilePrivacyStatusUnknown - 如果启用了离线跟踪,将会保存点击,直到隐私状态更改为选择启用(发送点击)或选择禁用(丢弃点击)。如果未启用离线跟踪,则将丢弃点击,直到隐私状态更改为选择启用。默认值在 ADBMobileConfig.json 文件中设置。
    • 以下是此方法的语法:
      + (ADBMobilePrivacyStatus) privacyStatus;
      
      
    • 以下是此方法的代码示例:
      ADBMobilePrivacyStatus privacyStatus = [ADBMobileprivacyStatus];
      
      
  • setPrivacyStatus
    将当前用户的隐私状态设置为 status
    设置为以下值之一:
    • ADBMobilePrivacyStatusOptIn - 立即发送点击。
    • ADBMobilePrivacyStatusOptOut - 丢弃点击。
    • ADBMobilePrivacyStatusUnknown - 如果启用了离线跟踪,将会保存点击,直到隐私状态更改为选择启用(发送点击)或选择禁用(丢弃点击)。如果未启用离线跟踪,则将丢弃点击,直到隐私状态更改为选择启用。
    • 以下是此方法的语法:
      + (void) setPrivacyStatus:(ADBMobilePrivacyStatus)status;
      
      
    • 以下是此方法的代码示例:
      [ADBMobile setPrivacyStatus:ADBMobilePrivacyStatusOptIn];
      
      
  • lifetimeValue
    返回当前用户的生命周期值。默认值为 0
    • 以下是此方法的语法:
      + (NSDecimalNumber *) lifetimeValue;
      
      
    • 以下是此方法的代码示例:
      NSDecimalNumber *lifeValue = [ADBMobile lifetimeValue];
      
      
  • trackingIdentifier
    返回自动生成的访客标识符。这是由 Adobe 服务器生成的特定于应用程序的独特访客 ID。如果在生成时无法访问 Adobe 服务器,则会使用 Apple 的 CFUUID 生成该 ID。该值在首次启动时生成,之后会存储并使用该值。在应用程序升级期间,会保留该 ID;在标准应用程序备份过程中,会保存并恢复该 ID;而在应用程序卸载时,则会删除该 ID。
    如果您的应用程序从 Experience Cloud 3.x SDK 升级到 4.x SDK,则会检索之前的自定义访客 ID 或自动生成的访客 ID,并将其存储为自定义用户标识符。有关更多信息,请参阅下面的 userIdentifier 行。这样可在 SDK 升级期间保留访客数据。对于 4.x SDK 上的新安装,用户标识符为 nil ,并且将使用跟踪标识符。
    • 以下是此方法的语法:
      + (NSString *) trackingIdentifier;
      
      
    • 以下是此方法的代码示例:
      NSString *tid = [ADBMobile trackingIdentifier];
      
      
  • userIdentifier
    如果已设置自定义标识符,则会返回用户标识符。如果未设置自定义标识符,则会返回 nil 。默认值为 nil
    如果您的应用程序从 Experience Cloud 3.x SDK 升级到 4.x SDK,则会检索之前的自定义访客 ID 或自动生成的访客 ID,并将其存储为自定义用户标识符。这样可在 SDK 升级期间保留访客数据。
    对于 4.x SDK 上的新安装,用户标识符在设置之前为 nil
    • 以下是此方法的语法:
      +(NSString *) userIdentifier;
      
      
    • 以下是此方法的代码示例:
      NSString *uid = [ADBMobileuserIdentifier];
      
      
  • setUserIdentifier
    将用户标识符设置为 identifier
    • 以下是此方法的语法:
      +(void)setUserIdentifier:(NSString*)identifier;
      
      
    • 以下是此方法的代码示例:
      [ADBMobile setUserIdentifier:@"billybob"]; 
      
      
  • debugLogging
    返回当前的调试日志记录首选项。默认值为 NO
    • 以下是此方法的语法:
      + (BOOL) debugLogging;
      
      
    • 以下是此方法的代码示例:
      BOOL debugging = [ADBMobile debugLogging];
      
      
  • setDebugLogging
    将调试日志记录首选项设置为 debug
    • 以下是此方法的语法:
      + (void) setDebugLogging:(BOOL)debug;
      
      
    • 以下是此方法的代码示例:
      [ADBMobile setDebugLogging:YES];
      
      
  • keepLifecycleSessionAlive
    指示 SDK 无论配置文件中的生命周期会话超时值为多少,下次从后台恢复时都不应启动新会话。
    此方法专门用于在后台注册通知的应用程序,而且只应从应用程序处于后台时运行的代码中调用。
    • 以下是此方法的语法:
      + (void) keepLifecycleSessionAlive;
      
      
    • 以下是此方法的代码示例:
      [ADBMobile keepLifecycleSessionAlive]; 
      
      
  • collectLifecycleData
    指示 SDK 应收集生命周期数据以在 SDK 的所有解决方案中使用。有关更多信息,请参阅 生命周期量度
    首选在 application:didFinishLaunchingWithOptions: 中调用此方法。
    • 以下是此方法的语法:
      + (void) collectLifecycleData;
      
      
    • 以下是此方法的代码示例:
      [ADBMobile collectLifecycleData];
      
      
  • collectLifecycleDataWithAdditionalData:
    允许您在收集生命周期量度时传入其他数据。
    必须从应用程序的入口点调用此方法。在适用的情况下,这可能包括 AppDelegate 类中的以下一种或两种方法: application:didFinishLaunchingWithOptions: 和/或 applicationWillEnterForeground:
    通过 collectLifecycleDataWithAdditionalData: 传递到 SDK 的数据将由 SDK 持久保留在 NSUserDefaults 中。SDK 将删除 NSDictionary 参数中类型不为 NSString NSNumber 的值。要使用 collectLifecycleDataWithAdditionalData: ,您必须具有 SDK 版本 4.4 或更高版本。
    • 以下是此方法的语法:
      + (void) collectLifecycleDataWithAdditionalData:(nullableNSDictionary*)data; 
      
      
    • 以下是此方法的代码示例:
      [ADBMobile collectLifecycleDataWithAdditionalData:@{@"entryType":@"appShortcutIcon"}]; 
      
      
  • overrideConfigPath
    允许您在应用程序启动时加载其他 ADBMobile JSON 配置文件。在应用程序关闭之前,将一直使用该配置。
    要使用 overrideConfigPath ,您必须具有 SDK 版本 4.2 或更高版本。
    • 以下是此方法的语法:
       + (void) overrideConfigPath: (nullableNSString *) path;
      
      
    • 以下是此方法的代码示例:
      NSString *filePath = [[NSBundle mainBundle] pathForResource:@"ExampleJSONFile" ofType:@"json"]; 
      [ADBMobile overrideConfigPath:filePath];
      
      
  • setPushIdentifier
    设置推送通知的设备令牌。
    应当只在 application:didRegisterForRemoteNotificationsWithDeviceToken: 方法中使用此方法。
    • 以下是此方法的语法:
      + (void) setPushIdentifier:(NSData *)deviceToken;
      
      
    • 以下是此方法的代码示例:
      - (void) application:(UIApplication *) application  didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken { 
      [ADBMobile setPushIdentifier:deviceToken];  
      }
      
      
  • setAdvertisingIdentifier
    在 SDK 中设置 IDFA。如果已在 SDK 中设置 IDFA,则将在生命周期中发送 IDFA。此外,也可以在信号(回发)中访问 IDFA。
    ​当使用广告服务时,才应从 Apple API 检索 IDFA。如果您检索 IDFA 但并未正确使用它,则您的应用程序可能会被拒绝。
    • 以下是此方法的语法:
      +(void) setAdvertisingIdentifier:(NSString*)identifier;
      
      
    • 以下是此方法的代码示例:
      NSString *idfa = [[[ASIdentifierManager sharedManager]advertisingIdentifier] UUIDString]; 
      [ADBMobile setAdvertisingIdentifier:idfa]; 
      
      

ADBMobileAppExtensionType enum

/** 
 * @brief An enum type. 
 * The possible types of app extension you might use 
 * @see setAppExtensionType 
 */ 
typedef NS_ENUM(NSUInteger, ADBMobileAppExtensionType) { 
    ADBMobileAppExtensionTypeRegular = 0, /*!< Enum value ADBMobileAppExtensionTypeRegular. */ 
    ADBMobileAppExtensionTypeStandAlone = 1 /*!< Enum value ADBMobileAppExtensionTypeStandAlone. */ 
};