Skip to content

수집 모범 사례

고객의 사용자 프로필 수명주기를 구상할 때 알려진 사용자와 알려지지 않은 사용자의 사용자 데이터를 언제, 어떻게 수집해야 하는지 파악하는 것은 어려울 수 있습니다. 이 문서에서는 사용 사례를 안내하여 신규 및 기존 사용자 데이터를 수집하는 다양한 방법과 모범 사례를 명확히 설명합니다.

다음 예는 이메일 수집 사용 사례이지만, 이 로직은 다양한 데이터 수집 시나리오에 적용될 수 있습니다. 이 예에서는 이미 가입 양식이나 사용자 정보를 수집하는 방법을 통합했다고 가정합니다.

사용자가 기록할 정보를 제공한 후에는 해당 데이터가 데이터베이스에 이미 존재하는지 확인하고, 필요한 경우 사용자 별칭 프로필을 만들거나 기존 사용자 프로필을 업데이트하는 것이 좋습니다.

알 수 없는 사용자가 사이트를 방문한 후 나중에 계정을 만들거나 이메일 가입을 통해 신원을 확인하는 경우, 프로필 병합을 신중하게 처리해야 합니다. 병합하는 방법에 따라 별칭 전용 사용자 정보 또는 익명 데이터가 덮어쓰여질 수 있습니다.

웹 양식을 통한 사용자 데이터 캡처

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가 없으므로).

별칭 전용 고객 프로필 업데이트 프로세스를 보여주는 다이어그램. 사용자가 마케팅 랜딩 페이지에서 이메일 주소와 커스텀 속성인 우편번호를 제출합니다. 랜딩 페이지 수집에서 별칭 전용 고객 프로필을 가리키는 화살표는 사용자 추적 엔드포인트에 대한 Braze API 요청을 나타내며, 요청 본문에는 사용자의 별칭 이름, 별칭 라벨, 이메일 및 우편번호가 포함되어 있습니다. 프로필에는 요청 본문의 속성과 함께 "Braze에서 생성된 별칭 전용 사용자"라는 라벨이 표시되어 새로 생성된 프로필에 데이터가 반영되었음을 보여줍니다.

이메일 캡처 양식을 통한 사용자 이메일 수집

이메일 캡처 양식을 사용하여 사용자에게 이메일 주소를 제출하도록 안내하면, 해당 주소가 고객 프로필에 추가됩니다. 이 양식을 설정하는 방법에 대한 자세한 내용은 이메일 캡처 양식을 참조하세요.

커스텀 양식을 사용하고 REST API를 통해 구독 그룹 멤버십을 설정하는 경우, 사용자를 생성하기 전에 프로필이 이미 존재하는지 확인하세요. 1단계: 사용자가 존재하는지 확인하기를 참조하세요.

별칭 전용 사용자 식별하기

계정 생성 시 사용자를 식별할 때, 별칭 전용 사용자는 /users/identify 엔드포인트를 통해 별칭 전용 사용자를 알려진 프로필과 병합하여 식별하고 외부 ID를 할당할 수 있습니다.

사용자가 별칭 전용인지 확인하려면 데이터베이스에서 사용자가 존재하는지 확인하세요.

  • 외부 레코드가 존재하는 경우 /users/identify/ 엔드포인트를 호출할 수 있습니다.
  • /users/export/id 엔드포인트가 external_id를 반환하면 /users/identify/ 엔드포인트를 호출할 수 있습니다.
  • 엔드포인트가 아무것도 반환하지 않으면 /users/identify/ 호출을 하지 않아야 합니다.

별칭 전용 사용자 정보가 이미 존재할 때 사용자 데이터 캡처하기

사용자가 계정을 만들거나 이메일 가입을 통해 본인을 식별하면, 프로필을 병합할 수 있습니다. 병합할 수 있는 필드 목록은 병합 업데이트 동작을 참조하세요.

중복 고객 프로필 병합하기

사용자 데이터가 증가하면 Braze 대시보드에서 중복된 고객 프로필을 병합할 수 있습니다. 이러한 중복 프로필은 동일한 검색 쿼리를 사용하여 찾아야 합니다. 고객 프로필을 중복 병합하는 방법에 대한 자세한 내용은 중복 사용자 병합을 확인하세요.

또한 사용자 병합 엔드포인트를 사용하여 하나의 고객 프로필을 다른 프로필에 병합할 수도 있습니다.

추가 리소스
New Stuff!