Skip to content

중복 사용자 병합

Campaign과 Canvases의 효과를 극대화할 수 있도록 중복 사용자를 찾고 병합하는 방법을 알아보세요.

REST API: 사용자 식별 및 병합

이 페이지의 도구는 대시보드에서 중복 프로필을 병합합니다. Braze의 사용자 데이터 엔드포인트를 통해 프로필을 결합하거나 다시 연결할 수도 있습니다.

  • POST: 사용자 식별 (/users/identify): 별칭 전용, 이메일 전용 또는 전화번호 전용 프로필을 external_id가 있는 프로필과 결합합니다.
  • POST: 사용자 병합 (/users/merge): 하나의 고객 프로필을 다른 프로필에 병합합니다. 두 프로필 모두 이미 external_id가 있는 경우에도 가능합니다. 이 엔드포인트를 호출하기 전에 필수 조건병합 동작을 검토하세요.

익명 프로필이 기존 식별된 프로필과 매칭되면(예: SDK changeUser() 호출 또는 /users/identify를 통해), Braze는 익명 프로필을 분리하고 특정 필드만 식별된 프로필에 복사합니다. 자세한 내용은 익명 사용자를 식별할 때 발생하는 일을 참조하세요.

사용자 병합은 되돌리기 어렵습니다. 여러 external_id 값에 걸친 복잡한 병합이나 대규모 프로필 마이그레이션을 계획하고 있다면, /users/merge에 의존하기 전에 Braze 고객 성공 매니저에게 안내를 요청하세요.

Braze는 병합 시 삭제 예정 사용자, 테스트 사용자, 전역 제어 그룹 사용자의 세 가지 사용자 유형을 다르게 처리합니다. 자세한 내용은 사용자 병합 동작을 참조하세요.

개별 병합

사용자 검색에서 중복 프로필이 반환되면 Braze 대시보드의 고객 프로필에서 각 프로필을 개별적으로 병합할 수 있습니다.

1단계: 중복 프로필 검색

Braze에서 오디언스 > 사용자 검색을 선택합니다.

내비게이션 메뉴에서 강조 표시된 "사용자 검색" 타일.

중복 프로필의 이메일 주소나 전화번호와 같은 고유 식별자를 입력한 다음 검색을 선택합니다.

Braze 대시보드의 "사용자 검색" 페이지.

2단계: 중복 항목 병합

병합 프로세스를 시작하려면 Merge duplicates를 선택합니다.

중복 사용자 프로필 중 하나.

유지할 고객 프로필과 병합할 프로필을 선택한 다음 Merge profiles를 선택합니다. 모든 중복 프로필이 병합될 때까지 이 과정을 반복합니다.

일괄 병합

중복 사용자를 일괄 병합하면 Braze가 일치하는 식별자(예: 이메일 주소)를 가진 프로필을 찾아 하나의 프로필을 유지합니다. Braze는 먼저 external_id가 있는 프로필을 우선시한 다음 동점 해결 설정인 Resolve ties usingPrioritization을 적용합니다. external_id가 있는 프로필이 없는 경우 Braze는 external_id가 없는 프로필 전체에 Resolve ties usingPrioritization을 사용합니다. Braze는 이러한 설정이 유지할 프로필 하나를 식별하는 경우에만 사용자를 병합합니다. 예를 들어, Resolve ties usingUpdated date이고 두 프로필의 마지막 업데이트 타임스탬프가 동일한 경우 Braze는 동점을 해결할 수 없으므로 해당 사용자는 병합되지 않습니다.

1단계: 오디언스 관리로 이동

Braze 대시보드에서 오디언스 > 오디언스 관리를 선택합니다.

내비게이션 메뉴에서 강조 표시된 "오디언스 관리" 타일.

2단계: 결과 미리보기(선택 사항)

중복 항목을 병합하기 전에 결과를 미리 보려면 Generate list of duplicates를 선택합니다.

**Generate list of duplicates**가 강조 표시된 "오디언스 관리" 페이지.

Braze가 미리보기를 생성하여 이메일 주소로 CSV 파일로 전송합니다.

CSV에는 각 프로필이 처음 생성된 방식(예: SDK, REST API, CSV 가져오기)을 보여주는 Created from 열이 포함되어 있습니다. 이를 통해 중복 항목을 병합하기 전에 프로필의 소스를 파악할 수 있습니다.

중복 행을 검토할 때 Created fromexternal_id, 이메일 주소, 전화번호와 같은 식별자와 비교하세요. 이 컨텍스트를 활용하여 Merge all duplicates를 선택하기 전에 어떤 프로필을 기본 프로필로 유지할지 결정하세요.

Created from 필드는 중복 프로필이 유사한 값을 포함하지만 서로 다른 수집 경로에서 생성된 경우 특히 유용합니다. 이 필드는 팀에 병합 결정에 대한 추가 컨텍스트를 제공하고, 추가 검토가 필요할 때까지 별도로 유지하고 싶은 프로필의 실수로 인한 병합을 줄이는 데 도움이 됩니다.

다음 예시에서 Braze는 사용자의 외부 ID를 사용하여 중복 프로필을 표시하고 유지할 프로필을 식별합니다. 이러한 프로필이 일괄 병합되면 Braze는 외부 ID가 있는 프로필을 사용자의 새 기본 프로필로 사용합니다.

Email Address External ID Phone Number Braze ID Identifier for rule Created from Profile to keep Profile to merge
[email protected] 123-external-id 555 123-4567 example-id-12345 email sdk TRUE FALSE
[email protected]   555 123-4567 example-id-12346 email rest FALSE TRUE
[email protected]   555 123-4567 example-id-12347 email csv FALSE TRUE

병합 동작

Braze는 유지되는 프로필의 비어 있는 필드를 병합된 프로필의 값으로 채웁니다. 채워지는 필드 목록은 병합 동작을 참조하세요.

3단계: 중복 항목 병합

미리보기 결과에 만족하면 Merge all duplicates를 선택합니다.

규칙 기반 병합

병합 실행 시 중복 프로필이 해결되는 방식을 제어하는 규칙을 사용하여 가장 관련성 높은 고객 프로필을 유지할 수 있습니다. 규칙이 설정되면 Braze는 기준에 맞는 프로필을 유지합니다.

1단계: 규칙 정의

  1. 오디언스 > 오디언스 관리 > Edit rules로 이동합니다.
  2. Edit rules 패널의 Profile to keep 섹션에서 중복 항목 병합 시 유지할 프로필의 Identifier를 선택합니다. 이메일 주소 또는 전화번호를 선택할 수 있습니다.
  3. Resolving ties 섹션에서 Profile to keep의 일치하는 기준을 가진 프로필 간의 동점을 해결하는 기준을 선택합니다. 다음을 선택할 수 있습니다:
    • Resolve ties using: Created date, Updated date, Last session
    • Prioritization: Newest, Oldest

**Profile to keep**과 **Resolving ties** 옵션을 선택하는 섹션이 있는 **Edit rules** 패널.

예를 들어, 전화번호가 있는 프로필을 유지할 수 있습니다. 여러 사용자가 동일한 전화번호를 가진 경우 Updated date 필드를 사용하여 동점을 해결하고 가장 최근에 업데이트된 사용자를 우선시할 수 있습니다.

2단계: 결과 미리보기(선택 사항)

규칙을 저장한 후 Generate a list of duplicates를 선택하여 규칙이 어떻게 작동하는지 미리 볼 수 있습니다. Braze가 미리보기를 생성하여 이메일 주소로 CSV 파일로 전송하며, 규칙이 적용될 경우 유지 및 병합될 사용자를 보여줍니다.

3단계: 중복 항목 병합

미리보기 결과에 만족하면 오디언스 관리 페이지로 돌아가서 Merge all duplicates를 선택합니다.

예약 병합

규칙 기반 병합과 유사하게, 예약 병합을 사용하면 사전 구성된 규칙을 사용하여 매일 고객 프로필 병합을 자동화할 수 있습니다.

schedule 버튼이 있는 "오디언스 관리" 페이지.

기능이 활성화되면 Braze가 자동으로 시간대를 할당하여 사용자의 회사 시간대 기준 매일 약 오전 12시에 병합 프로세스를 수행합니다. 예약 병합은 언제든지 비활성화할 수 있습니다. Braze는 예약된 병합이 실행되기 24시간 전에 워크스페이스 관리자에게 알림을 보내 구성을 검토할 시간을 제공합니다.

동일한 이메일 주소에 여러 고객 프로필이 연결되는 이유

Braze는 서로 다른 식별자, 가져오기 또는 식별 전 익명 세션을 통해 프로필이 생성된 경우 동일한 이메일 주소를 공유하는 여러 고객 프로필을 저장합니다. 이는 사용자가 단일 external_id를 공유하지 않을 때 예상되는 동작입니다.

중복 항목을 병합하기 전에 식별자별 사용자 프로필 내보내기 엔드포인트를 사용하여 이메일 주소에 어떤 프로필이 존재하는지, 각 프로필에 어떤 필드가 포함되어 있는지 확인하세요. 오디언스 > 사용자 검색에서 이메일로 검색하여 대시보드에서 중복 항목을 검토할 수도 있습니다.

New Stuff!