문서

글로벌 속성 설정

Singular SDK를 사용하면 앱에서 전송되는 모든 세션 및 이벤트와 함께 Singular 서버로 전송할 사용자 지정 속성을 정의할 수 있습니다. 이러한 프로퍼티는 사용자, 앱 모드/상태 등 원하는 모든 정보를 나타낼 수 있습니다.

글로벌 프로퍼티는 최대 5개까지 정의할 수 있습니다. 이러한 속성은 설정 해제하거나 사용자가 앱을 제거할 때까지 앱 실행 사이에 (설정한 최신 값으로) 유지됩니다.

사용 사례

글로벌 프로퍼티의 몇 가지 사용 사례는 다음과 같습니다:

타사 SDK에서 식별자를 전달한 다음 Singular에서 해당 타사로의 포스트백에 사용하여 매칭 목적으로 사용합니다.
게임 앱에서 '레벨'이라는 프로퍼티를 정의하고 초기에 '0'으로 설정할 수 있습니다. 앱에서 전송되는 모든 세션과 이벤트는 "레벨"과 함께 전송됩니다: "0". 사용자가 레벨을 올리면 해당 속성을 "1"로 재설정하는 등의 방식으로 재설정합니다.

참고:

글로벌 프로퍼티는 현재 Singular의 사용자 레벨 이벤트 로그(어트리뷰션 로그 내보내기 참조)와 포스트백에 반영됩니다. Singular의 집계 보고(보고서 페이지 또는 보고 API)에서 글로벌 속성에 대한 지원은 향후 추가될 예정입니다. 이 기능에 대해 궁금한 점이 있거나 글로벌 속성 지원 업데이트에 관심이 있는 경우, 담당 Singular 고객 성공 매니저에게 문의하세요.
각 속성 이름과 값은 최대 200자까지 입력할 수 있습니다. 더 긴 속성 이름이나 값을 전달하면 200자로 잘립니다.

구성 개체를 통해 전역 속성 설정하기

SDK를 초기화하기 전에 전역 프로퍼티를 설정하려면 Config 객체에서 setGlobalProperty 메서드를 사용합니다.

글로벌 프로퍼티와 해당 값은 앱 실행 간에 유지되므로 설정하려는 프로퍼티가 이미 다른 값으로 설정되어 있을 수 있습니다. 기존 프로퍼티를 새 값으로 재정의할지 여부를 SDK에 알려주려면 overrideExisting 파라미터를 사용합니다.

설정 글로벌 프로퍼티 메서드

설명 글로벌 프로퍼티를 설정합니다.

시그니처 (void)setGlobalProperty:(NSString*)key withValue:(NSString*)value overrideExisting:(BOOL)overrideExisiting;

사용 예제

func getConfig() -> SingularConfig? {         
  // (Optional) Get 3rd-party identifiers to set in Global Properties:     


  // If 3rd-party SDKs are providing any identifiers to Singular, the


  // respective SDK must be initialized before Singular.     


  let thirdPartyKey = "anonymousID"     
  let thirdPartyID = "2ed20738-059d-42b5-ab80-5aa0c530e3e1"     
  
  // Singular Config Options     


  guard let config = SingularConfig(apiKey: Constants.APIKEY, 
    andSecret: Constants.SECRET) else {
      return nil
      }
  //...     
  // Using Singular Global Properties feature to capture third party identifiers


  config.setGlobalProperty(thirdPartyKey, withValue: thirdPartyID, overrideExisting: true)     
  //...
  return config 
}

- (SingularConfig *)getConfig {     
  // (Optional) Get 3rd-party identifiers to set in Global Properties:     


  // If 3rd-party SDKs are providing any identifiers to Singular, the


  // respective SDK must be initialized before Singular.     


  NSString* thirdPartyKey = @"anonymousID";
  NSString* thirdPartyID = @"2ed20738-059d-42b5-ab80-5aa0c530e3e1";     
  
  // Singular Config Options     


  SingularConfig* config = [[SingularConfig alloc] initWithApiKey:APIKEY 
    andSecret:SECRET];
  //...
  
  // Using Singular Global Properties feature to capture 3rd-party identifiers     


  [config setGlobalProperty:thirdPartyKey withValue:thirdPartyID overrideExisting:YES];
  //...
  return config;
}

초기화 후 글로벌 프로퍼티 설정

다음 메서드를 사용하여 앱 실행 중 언제든지 전역 속성을 설정, 설정 해제 및 검색할 수 있습니다.

참고:

속성이 아직 존재하지 않고 이미 5개의 다른 전역 속성이 있는 경우 속성이 추가되지 않습니다.
프로퍼티가 이미 설정되어 있는 경우 overrideExisting 매개변수에 따라 기존 값을 재정의할지 여부가 결정됩니다.
프로퍼티가 성공적으로 설정되면 참을 반환하고 그렇지 않으면 거짓을 반환합니다.

설정 글로벌 프로퍼티 메서드
설명	전역 프로퍼티를 지정된 값으로 설정합니다.
Signature	(BOOL) setGlobalProperty:(NSString)key andValue:(NSString)value overrideExisting:(BOOL)overrideExisting
사용 예제	SwiftObjective-C `var result = Singular.setGlobalProperty("propertyName", andValue: "propertyValue", overrideExisting: true)` `BOOL result = [Singular setGlobalProperty:@"propertyName" andValue:@"propertyValue" overrideExisting:YES];`
글로벌 프로퍼티 메서드
설명	모든 글로벌 프로퍼티와 그 현재 값을 맵으로 가져옵니다.
시그니처	NSDictionary*) getGlobalProperties
사용 예제	SwiftObjective-C `var globalProperties = Singular.getGlobalProperties()` `NSDictionary* globalProperties = [Singular getGlobalProperties];`
언셋글로벌프로퍼티 메서드
설명	글로벌 프로퍼티를 제거합니다.
시그니처	(void) unsetGlobalProperty:(NSString*)key
사용 예제	SwiftObjective-C `Singular.unsetGlobalProperty("propertyName")` `[Singular unsetGlobalProperty:@"propertyName"];`
clearGlobalProperties 메서드
설명	모든 글로벌 프로퍼티를 제거합니다.
Signature	(void) clearGlobalProperties
사용 예제	SwiftObjective-C `Singular.clearGlobalProperties()` `[Singular clearGlobalProperties];`

iOS SDK - 전역 속성 설정

글로벌 속성 설정

사용 사례

구성 개체를 통해 전역 속성 설정하기

초기화 후 글로벌 프로퍼티 설정