수집 모범 사례
고객의 사용자 프로필 수명주기를 구상할 때, 알려진 사용자와 알려지지 않은 사용자의 데이터를 언제, 어떻게 수집해야 하는지 파악하기란 쉽지 않습니다. 이 문서에서는 사용 사례를 단계별로 살펴보며 신규 및 기존 사용자 데이터를 수집하는 다양한 방법과 모범 사례를 명확히 설명합니다.
다음 예시는 이메일 수집 사용 사례이지만, 같은 로직을 다양한 데이터 수집 시나리오에 적용할 수 있습니다. 이 예시에서는 가입 양식이나 사용자 정보를 수집하는 방법을 이미 통합했다고 가정합니다.
사용자가 기록할 정보를 제공하면 해당 데이터가 데이터베이스에 이미 존재하는지 확인하고, 필요한 경우 사용자 별칭 프로필을 생성하거나 기존 고객 프로필을 업데이트하는 것이 좋습니다.
알려지지 않은 사용자가 사이트를 방문한 뒤 나중에 계정을 만들거나 이메일 가입을 통해 자신을 식별하는 경우, 프로필 병합을 신중하게 처리해야 합니다. 병합 방법에 따라 별칭 전용 사용자 정보나 익명 데이터를 덮어쓸 수 있습니다.
웹 양식을 통한 사용자 데이터 수집
1단계: 사용자 존재 여부 확인
사용자가 웹 양식을 통해 콘텐츠를 입력하면 해당 이메일을 가진 사용자가 이미 데이터베이스에 존재하는지 확인합니다. 다음 방법 중 하나로 확인할 수 있습니다.
- 내부 데이터베이스 확인(권장): Braze 외부에 제공된 사용자 정보를 담고 있는 외부 레코드나 데이터베이스가 있다면, 이메일 제출 또는 계정 생성 시점에 이를 참조하여 해당 정보가 아직 수집되지 않았는지 확인합니다.
/users/track엔드포인트:email을 식별자로 사용하면, 해당 이메일 주소가 아직 존재하지 않는 경우 새 고객 프로필이 생성됩니다./subscription/status/get엔드포인트: 커스텀 양식으로 이메일을 수집한 다음 REST API를 통해 구독 그룹 멤버십을 설정하는 경우, 먼저 이 엔드포인트를 호출하세요. 일치하는 프로필이 없으면/subscription/status/set엔드포인트로 사용자를 생성하거나 구독시킵니다. 그렇지 않으면 중복 프로필을 만드는 대신 기존 프로필을 업데이트합니다.
2단계: 사용자 기록 또는 업데이트
- 사용자가 존재하는 경우:
- 새 프로필을 생성하지 마세요.
- 사용자가 뉴스레터 구독을 통해 이메일을 제출했음을 나타내기 위해 사용자 프로필에 커스텀 속성(예:
newsletter_subscribed: true)을 기록합니다. 동일한 이메일 주소를 가진 Braze 고객 프로필이 여러 개 있는 경우 모든 프로필이 내보내집니다.
- 사용자가 존재하지 않는 경우:
/users/track엔드포인트를 통해 별칭 전용 프로필을 생성합니다. 이 엔드포인트는user_alias객체를 받아들이며,update_existing_only가false로 설정되면 별칭 전용 프로필을 생성합니다. 나중에 해당 사용자를 참조할 수 있도록 사용자의 이메일을 사용자 별칭으로 설정하세요(사용자에게external_id가 없기 때문입니다).
이메일 캡처 양식을 통해 사용자 이메일 수집하기
이메일 캡처 양식을 사용하면 사용자에게 이메일 주소를 입력하도록 요청할 수 있으며, 입력된 이메일 주소는 고객 프로필에 추가됩니다. 이 양식을 설정하는 방법에 대한 자세한 내용은 이메일 캡처 양식을 참조하세요.
커스텀 양식을 사용하고 REST API를 통해 구독 그룹 멤버십을 설정하는 경우, 사용자를 생성하기 전에 프로필이 이미 존재하는지 확인하세요. 1단계: 사용자가 존재하는지 확인하기를 참조하세요.
별칭 전용 사용자 식별
계정 생성 시 사용자를 식별할 때, /users/identify 엔드포인트를 통해 별칭 전용 사용자를 알려진 프로필과 병합하여 별칭 전용 사용자를 식별하고 외부 ID를 할당할 수 있습니다.
사용자가 별칭 전용 사용자인지 확인하려면 데이터베이스 내에 사용자가 존재하는지 확인하세요.
- 외부 레코드가 존재하면
/users/identify/엔드포인트를 호출할 수 있습니다. /users/export/id엔드포인트가external_id를 반환하면/users/identify/엔드포인트를 호출할 수 있습니다.- 엔드포인트가 아무것도 반환하지 않으면
/users/identify/호출을 하지 않아야 합니다.
별칭 전용 사용자 정보가 이미 있는 경우 사용자 데이터 캡처하기
사용자가 계정을 생성하거나 이메일 가입을 통해 자신을 식별하면 프로필을 병합할 수 있습니다. 병합할 수 있는 필드 목록은 병합 업데이트 동작을 참조하세요.
중복 사용자 프로필 병합하기
사용자 데이터가 늘어나면 Braze 대시보드에서 중복 사용자 프로필을 병합할 수 있습니다. 이러한 중복 프로필은 동일한 검색 쿼리로 찾아야 합니다. 중복 사용자 프로필을 병합하는 방법에 대한 자세한 내용은 중복 사용자 병합을 확인하세요.
사용자 병합 엔드포인트를 사용하여 하나의 사용자 프로필을 다른 사용자 프로필로 병합할 수도 있습니다.
사용자 프로필을 병합한 후에는 이 작업을 되돌릴 수 없습니다.