📘

사용자 식별자 관리

사용자 식별자는 사용자를 고유하게 식별하는 목적으로 사용합니다.
사용자 식별자의 의미와 중요성, 선택하는 기준 등에 대해서는 사용자 식별자 관리하기 문서를 참고하시기 바랍니다.

사용자 식별자

SDK에서 관리하는 식별자 사용

Flutter SDK는 디바이스의 식별자를 관리하는 기능을 포함하고 있습니다. 따라서 사용자 식별자를 별도로 전달하지 않아도 사용자를 자동으로 식별할 수 있습니다.

SDK에서 관리하는 식별자를 얻는 방법은 다음과 같습니다.

import "package:hackle/hackle.dart";

// 내부적으로 관리되는 디바이스 식별자 가져오기
String deviceId = await HackleApp.getDeviceId();

// 기존에 설정한 사용자 정보 모두 가지고 오기
HackleUser user = await HackleApp.getUser();

사용자 식별자 추가

로그인 한 사용자의 식별자를 설정하실 수 있습니다. 디바이스 식별자를 직접 관리하는 경우 따로 설정할 수 있습니다.

예시

import "package:hackle/hackle.dart";

// 1. 로그인 한 사용자 식별자 추가
await HackleApp.setUserId("LOGIN_ID");

// 2. 디바이스 식별자 변경
await HackleApp.setDeviceId("CUSTOM_DEVICE_ID");

추가 식별자

기본 식별자 외의 추가 식별자는 아래 예시 코드를 통해 전송할 수 있습니다.

import "package:hackle/hackle.dart";

HackleUser user = HackleUser.builder()
	.userId("LOGIN_ID") // 사용자 ID (핵클 통합 식별자 사용가능)
	.deviceId("CUSTOM_DEVICE_ID") // 디바이스 ID (핵클 통합 식별자 사용가능)
	.identifier("myCustomId", "CUSTOM_IDENTIFIER") // Custom ID
	.build();

await HackleApp.setUser(user);

속성(Property)

핵클 SDK는 사용자(User) 객체에 속성을 추가할 수 있도록 지원합니다.

• 속성은 속성명(key)과 속성값(value)을 한 쌍으로 보내야 합니다.
• 사용자 객체에 추가 가능한 속성 개수는 최대 64개입니다.

속성명(key)

• 일반적인 변수명처럼 만들되 식별하기 쉽게 만드는 것을 권장합니다.
• 글자수 제한은 64자입니다. (64 characters)
• 대소문자를 구분하지 않습니다. 예를 들어 AGE와 age는 동일한 속성명으로 인식합니다.

속성값(value)

• value는 boolean, string, number 타입을 지원합니다.
• string 타입인 경우 글자수 제한은 64자입니다. (64 characters)
• string 타입은 대소문자를 구분합니다. 예를 들어 APPLE과 apple은 서로 다른 속성값으로 인식합니다.
• number 타입인 경우 정수 최대 15자리, 소수점 최대 6자리를 지원합니다.

예시

한번 설정한 속성은 테스트 그룹 분배, 기능 플래그 결정, 사용자 이벤트 전송에서 파라미터로 사용됩니다.
아래 예시에서는 세 가지 속성(age, grade, is_paying_user)을 추가한 것을 확인할 수 있습니다.

import "package:hackle/hackle.dart";

await HackleApp.setUserProperty("age", 30);
await HackleApp.setUserProperty("grade", "GOLD");
await HackleApp.setUserProperty("is_paying_user", false);

사용자 속성(Property)

핵클 SDK는 사용자 속성을 추가할 수 있도록 지원합니다.

• 속성은 속성명(key)과 속성값(value)으로 구성되어 있습니다.
• 추가 가능한 속성 개수는 최대 64개입니다.

속성명(key)

• 일반적인 변수명처럼 만들되 식별하기 쉽게 만드는 것을 권장합니다.
• 글자수 제한은 64자입니다. (64 characters)
• 대소문자를 구분하지 않습니다. 예를 들어 AGE와 age는 동일한 속성명으로 인식합니다.

속성값(value)

• value는 boolean, string, number 타입을 지원합니다.
• string 타입인 경우 글자수 제한은 64자입니다. (64 characters)
• string 타입은 대소문자를 구분합니다. 예를 들어 APPLE과 apple은 서로 다른 속성값으로 인식합니다.
• number 타입인 경우 정수 최대 15자리, 소수점 최대 6자리를 지원합니다.

사용자 속성 설정

사용자 속성을 추가, 제거 할 수 있습니다.

설정하고 싶은 사용자 속성으로 PropertyOperations 객체를 인스턴스화 합니다. 다음 updateUserProperties 를 호출하여 사용자 속성을 업데이트 합니다. 한번에 여러개의 속성을 설정할 수도 있습니다.

PropertyOperations operations = PropertyOperations.builder()
  .set("age", 42)
  .set("grade", "GOLD")
  .setOnce("sign_up_date", "2020-07-03")
  .build();

await HackleApp.updateUserProperties(operations);

set

사용자 속성을 설정합니다. 설정한 속성값으로 덮어씁니다.

PropertyOperations operations = PropertyOperations.builder()
    .set("age", 42)
    .set("grade", "GOLD")
    .build();

await HackleApp.updateUserProperties(operations);

setOnce

사용자 속성 값을 한번만 설정합니다. 속성키에 대한 속성이 이미 있는 경우 setOnce 는 무시됩니다. 예를들어 사용자에 대한 가입일, 초기 가입 위치 등을 설정할 수 있습니다.

PropertyOperations operations = PropertyOperations.builder()
    .setOnce("sign_up_date", "2020-07-03")
    .setOnce("initial_location", "Seoul")
    .build();

await HackleApp.updateUserProperties(operations);

unset

설정된 사용자 속성을 제거합니다.

PropertyOperations operations = PropertyOperations.builder()
    .unset("membership_type")
    .build();

await HackleApp.updateUserProperties(operations);

clearAll

사용자의 모든 속성을 제거합니다.

PropertyOperations operations = PropertyOperations.clearAll();

await HackleApp.updateUserProperties(operations);

사용자 속성 초기화

사용자가 로그아웃 한 경우, 기존에 설정한 정보를 초기화해야 합니다.
초기화하는 방법은 다음과 같습니다.

import "package:hackle/hackle.dart";

await HackleApp.resetUser();

resetUser() 를 호출하는 경우 기존에 설정했던 식별자, 속성이 모두 초기화됩니다.