Show Menu
화제×

구성 메서드

다음은 iOS 라이브러리에서 제공하는 메서드 목록입니다.
현재 SDK는 Analytics, Target, Audience Manager 및 Adobe Experience Platform ID 서비스 등 여러 Adobe Experience Cloud 솔루션을 지원합니다.
  • setAppExtensionType
    Adobe Mobile SDK 설정을 구성하여 현재 어떤 종류의 확장이 실행되고 있는지 확인합니다.
    다음 값 중 하나를 설정합니다.
    • ADBMobileAppExtensionTypeRegular - 확장 프로그램이 포함된 앱과 번들로 제공됩니다.
    • ADBMobileAppExtensionTypeStandAlone - 확장 프로그램이 포함된 앱과 번들로 제공되지 않습니다.
    이 메서드는 앱에 확장 프로그램이 있거나 독립형 확장 프로그램인 경우에​ 사용해야 합니다. 자세한 내용은 아래 ADBMobileAppExtensionType ​을 참조하십시오.
    • 다음은 이 메서드에 대한 구문입니다.
      + (void) setAppExtensionType:(ADBMobileAppExtensionType)type;
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      [ADBMobile setAppExtensionType:ADBMobileAppExtensionTypeStandAlone]; 
      
      
  • 버전
    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 서버에 도달할 수 없다면 이 ID가 Apple CFUUID를 사용하여 생성됩니다. 이 값은 처음 실행 시 생성된 다음 저장되며 그 이후부터 사용됩니다. 이 ID는 앱 업그레이드 시에도 보존되고, 표준 애플리케이션 백업 프로세스 중 저장 및 복원되며, 앱을 제거하면 삭제됩니다.
    앱을 Experience Cloud 3.x에서 4.x SDK로 업그레이드할 경우 이전 사용자 지정 또는 자동 생성된 방문자 ID가 검색되어 사용자 지정 사용자 식별자로 저장됩니다. 자세한 내용은 아래의 userIdentifier 행을 참조하십시오. 이렇게 하면 SDK 업그레이드 시에도 방문자 데이터가 보존됩니다. 4.x SDK에 새로 설치하는 경우 사용자 식별자는 nil 이며 추적 식별자가 사용됩니다.
    • 다음은 이 메서드에 대한 구문입니다.
      + (NSString *) trackingIdentifier;
      
      
    • 다음은 이 메서드의 코드 샘플입니다.
      NSString *tid = [ADBMobile trackingIdentifier];
      
      
  • userIdentifier
    사용자 지정 ID가 설정된 경우 사용자 ID가 반환됩니다. 사용자 지정 ID가 설정되지 않은 경우에는 nil 이 반환됩니다. 기본값은 nil 입니다.
    앱을 Experience Cloud 3.x에서 4.x SDK로 업그레이드할 경우 이전 사용자 지정 또는 자동 생성된 방문자 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에 전달되는 데이터는 NSUserDefaults 에서 SDK에 의해 유지됩니다. 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. */ 
};