글로벌 속성 설정하기

Singular SDK를 사용하면 앱에서 전송되는 모든 세션 및 이벤트와 함께 Singular 서버로 전송할 추가 사용자 지정 속성을 정의할 수 있습니다. 이러한 속성은 사용자, 앱 모드 또는 상태 등 원하는 모든 정보를 나타낼 수 있습니다. 이러한 속성을 설정하면 보고서에서 기준으로 사용할 수 있으며 이를 사용하여 데이터를 세분화할 수 있습니다.

예를 들어 게임 앱이 있는 경우 '레벨'이라는 속성을 정의하고 처음에는 '0'으로 설정할 수 있습니다. 앱에서 전송되는 모든 세션과 이벤트는 "Level": "0". 사용자가 레벨을 올리면 이 속성을 "1"로 재설정하는 등의 방식으로 재설정합니다. 그러면 세션, 이벤트 수, 구매 데이터를 포함한 보고서를 사용자 레벨별로 세분화하여 얻을 수 있습니다.

• 글로벌 속성은 최대 5개까지 정의할 수 있습니다.
• 이러한 속성은 사용자가 설정을 해제하거나 앱을 제거할 때까지 앱 실행 사이에 (사용자가 지정한 최신 값으로) 유지됩니다.
• 각 속성 이름과 값은 최대 200자까지 입력할 수 있습니다. 더 긴 속성 이름이나 값을 전달하면 200자로 잘립니다.
• 글로벌 속성은 사용자 수준 내보내기 및 포스트백에서 액세스하고 사용할 수 있습니다. 향후에는 집계 리포팅 지원도 추가될 예정입니다. 궁금한 점이 있거나 글로벌 속성 지원 업데이트에 관심이 있는 경우 Singular 고객 성공 매니저에게 알려주세요!

SingularConfig를 통해 글로벌 속성 설정하기

SDK를 초기화하기 전에 withGlobalProperty 메서드를 사용하여 SingularConfig를 통해 글로벌 프로퍼티를 설정할 수 있습니다.

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

// Set two global properties and override any existing values

SingularConfig config = new SingularConfig("SDK KEY", "SDK SECRET")
  .withGlobalProperty(“MyProperty”, “MyValue”, true)
  .withGlobalProperty(“AnotherProperty”, “AnotherValue”, true);

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

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

boolean result = Singular.setGlobalProperty(“MyProperty”, “MyValue”, true);

Map<String, String> map = Singular.getGlobalProperties();

Singular.unsetGlobalProperty(“MyProperty”);

Singular.clearGlobalProperties();