Flutter SDK - 글로벌 속성 설정

팔로우
Avatar
Jared Ornstead
Updated
문서

글로벌 속성 설정

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

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

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

구현

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

앱이 열릴 때 글로벌 프로퍼티를 이미 알고 있는 경우, 앱이 열리기 전에 withGlobalProperty 메서드를 사용하여 SDK를 초기화하기 전에 SingularConfig 를 통해 글로벌 프로퍼티를 설정하세요.

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

초기화 후 전역 속성 설정

다음 방법을 사용하여 앱 실행 중 언제든지 글로벌 프로퍼티를 설정, 설정 해제 및 검색할 수 있습니다.