사용자 ID 설정

Braze SDK를 통해 사용자 ID를 설정하는 방법을 알아보세요. 이는 여러 기기와 플랫폼에서 사용자를 추적하고, 사용자 데이터 API를 통해 데이터를 가져오고, 메시징 API를 통해 타겟팅된 메시지를 보낼 수 있는 고유 식별자입니다. 사용자에게 고유 ID를 할당하지 않으면 Braze에서 익명 ID를 대신 할당하지만, 할당할 때까지는 이러한 기능을 사용할 수 없습니다.

익명 사용자 정보

Braze SDK를 통합한 후 앱을 처음 실행하는 사용자는 changeUser 메서드를 호출하여 external_id 을 할당할 때까지 “익명” 사용자로 간주됩니다. 일단 할당되면 다시 익명으로 설정할 수 없습니다. 그러나 앱을 삭제했다가 다시 설치하면 changeUser 을 호출할 때까지 다시 익명으로 전환됩니다.

이전에 식별된 사용자가 새 기기에서 세션을 시작하는 경우, 해당 기기에서 external_id 을 사용하여 changeUser 으로 호출하면 모든 익명 활동이 기존 프로필에 자동으로 동기화됩니다. 여기에는 새 기기에서 세션 중에 수집된 모든 속성, 이벤트 또는 기록이 포함됩니다.

익명 사용자 추적 방지

사용자가 식별되기 전에 데이터를 수집하지 않아야 하는 사용 사례의 경우, 사용자가 로그인하고 external_id를 사용할 수 있을 때까지 Braze SDK 초기화를 지연할 수 있습니다. 코드에서 사용자가 로그인하면 true로 전환되는 플래그를 설정하고, 해당 플래그가 설정된 경우에만 SDK를 초기화하세요.

사용자 ID 설정

사용자 ID를 설정하려면 사용자가 처음 로그인한 후 changeUser() 방법을 호출합니다. ID는 고유해야 하며 명명 모범 사례를 따라야 합니다.

고유 식별자를 해싱하는 경우 해싱 함수의 입력을 정규화해야 합니다. 예를 들어 이메일 주소를 해시할 때는 앞뒤 공백을 모두 제거하고 현지화를 고려하세요.

• web
• android
• swift
• cordova
• roku
• unity
• react native

1
braze.changeUser(YOUR_USER_ID_STRING);

1
Braze.getInstance(context).changeUser(YOUR_USER_ID_STRING);

1
Braze.getInstance(context).changeUser(YOUR_USER_ID_STRING)

1
AppDelegate.braze?.changeUser(userId: "YOUR_USER_ID")

1
[AppDelegate.braze changeUser:@"YOUR_USER_ID_STRING"];

1
BrazePlugin.changeUser("YOUR_USER_ID");

1
m.Braze.setUserId(YOUR_USER_ID_STRING)

1
AppboyBinding.ChangeUser("YOUR_USER_ID_STRING");

1
Braze.changeUser("YOUR_USER_ID_STRING");

changeUser() 작동 방식

changeUser()를 호출하면 다음과 같은 동작이 적용됩니다:

• 이미 설정된 것과 동일한 사용자 ID로 changeUser()를 호출하면 세션 수에 영향을 미치지 않습니다.
• 다른 사용자 ID로 changeUser()를 호출하면 현재 세션이 자동으로 종료되고 새 세션이 시작됩니다.
• 익명 사용자가 새로운 사용자 ID(Braze에 아직 존재하지 않는 ID)로 changeUser()를 호출하면 익명 프로필의 데이터가 새로 식별된 프로필에 병합됩니다.
• 익명 사용자가 기존 사용자 ID로 changeUser()를 호출하면 익명 프로필의 데이터가 식별된 프로필에 병합되지 않습니다.

사용자 별칭

작동 방식

익명 사용자에게는 external_ids 이 없지만 대신 사용자 별칭을 지정할 수 있습니다. 사용자에게 다른 식별자를 추가하고 싶지만 external_id 주소가 무엇인지 모르는 경우(예: 로그인하지 않은 경우) 사용자 별칭을 지정해야 합니다. 사용자 별칭 지정도 가능합니다:

• Braze API를 사용하여 익명 사용자와 관련된 이벤트 및 속성을 로그에 기록하세요.
• 외부 사용자 ID가 비어 있음 세분화 필터를 사용하여 메시징에서 익명 사용자를 타겟팅하세요.

사용자 별칭 설정

사용자 별칭은 이름과 레이블의 두 부분으로 구성됩니다. 이름은 식별자 자체를 가리키고, 레이블은 식별자가 속한 유형을 가리킵니다. 예를 들어 타사 고객지원 플랫폼에 외부 ID 987654를 가진 사용자가 있는 경우, Braze에서 이름 987654와 레이블 support_id로 별칭을 할당하면 여러 플랫폼에서 해당 사용자를 추적할 수 있습니다.

• web
• android
• swift
• rest api
• react native

1
braze.getUser().addAlias(ALIAS_NAME, ALIAS_LABEL);

1
Braze.getInstance(context).getCurrentUser().addAlias(ALIAS_NAME, ALIAS_LABEL);

1
Braze.getInstance(context).currentUser?.addAlias(ALIAS_NAME, ALIAS_LABEL)

1
Appboy.sharedInstance()?.user.addAlias(ALIAS_NAME, ALIAS_LABEL)

1
 [[Appboy sharedInstance].user addAlias:ALIAS_NAME withLabel:ALIAS_LABEL];

1
2
3
4
{
  "alias_name" : (required, string),
  "alias_label" : (required, string)
}

1
Braze.addAlias("ALIAS_NAME", "ALIAS_LABEL");

ID 명명 모범 사례

무작위로 잘 분산된 128비트 문자열인 UUID(범용 고유 식별자) 표준을 사용하여 사용자 ID를 생성하는 것이 좋습니다.

또는 기존 고유 식별자(예: 이름 또는 이메일 주소)를 해시하여 사용자 ID를 대신 생성할 수도 있습니다. 이 경우 사용자 가장을 방지할 수 있도록 SDK 인증을 구현해야 합니다.

처음부터 사용자 ID의 이름을 올바르게 지정하는 것이 중요하지만, 나중에 언제든지 /users/external_ids/rename 엔드포인트를 사용하여 이름을 변경할 수 있습니다.