Skip to content

사용자 식별

post

/users/identify

이 엔드포인트를 사용하여 제공된 외부 ID를 사용하여 미확인(별칭 전용, 이메일 전용 또는 전화번호 전용) 사용자를 식별할 수 있습니다.

작동 방식

/users/identify 을 호출하면 별칭(별칭 전용 프로필), 이메일 주소(이메일 전용 프로필) 또는 전화번호(전화번호 전용 프로필)로 식별되는 사용자 프로필을 external_id (식별된 프로필)이 있는 사용자 프로필과 결합한 다음 별칭 전용 프로필을 제거합니다.

사용자를 식별하려면 aliases_to_identify 또는 emails_to_identify 또는 phone_numbers_to_identify 객체에 external_id 을 포함해야 합니다. external_id 을 가진 사용자가 없는 경우 external_id 이 별칭 사용자의 레코드에 추가되며 해당 사용자는 식별된 것으로 간주됩니다.

다음 사항에 유의하세요:

  • merge_behavior 필드가 none 으로 설정된 상태에서 이러한 후속 연결이 이루어지면 사용자 별칭과 관련된 푸시 토큰 및 메시지 기록만 유지되며, 모든 속성, 이벤트 또는 구매는 ‘고아’가 되어 식별된 사용자에게는 사용할 수 없게 됩니다. 한 가지 해결 방법은 /users/export/ids엔드포인트를 사용하여 식별하기 전에 별칭이 지정된 사용자의 데이터를 내보낸 다음 속성, 이벤트 및 구매를 식별된 사용자와 다시 연결하는 것입니다.
  • merge_behavior 필드를 merge 으로 설정하여 연결하면 이 엔드포인트는 익명 사용자에서 찾은 특정 필드를 식별된 사용자와 병합합니다.
  • 사용자는 특정 레이블에 대해 하나의 별칭만 가질 수 있습니다. 사용자가 이미 external_id 계정을 가지고 있고 별칭 전용 프로필과 동일한 레이블을 가진 기존 별칭을 가지고 있는 경우에는 사용자 프로필이 결합되지 않습니다.

필수 구성 요소

이 엔드포인트를 사용하려면 users.identify 권한이 있는 API 키가 필요합니다.

사용량 제한

2021년 9월 16일 이후에 Braze에 온보딩한 고객의 경우, 이 엔드포인트에 분당 20,000건의 요청 공유 속도 제한을 적용합니다. 이 요금 제한은 API 요금 제한에 설명된 대로 /users/delete, /users/alias/new, /users/merge, /users/alias/update 엔드포인트와 공유됩니다.

요청 본문

1
2
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY
1
2
3
4
5
6
{
   "aliases_to_identify" : (required, array of alias to identify objects),
   "emails_to_identify": (optional, array of string) User emails to identify,
   "phone_numbers_to_identify": (optional, array of string) User phone numbers to identify,
   "merge_behavior": (optional, string) one of 'none' or 'merge' is expected
}

요청 매개변수

요청당 최대 50개의 사용자 별칭을 추가할 수 있습니다. 하나의 external_id 에 여러 개의 추가 사용자 별칭을 연결할 수 있습니다.

병합_행동 필드

merge_behavior 필드를 merge 으로 설정하면 익명 사용자에게만 있는 다음 필드 목록을 식별된 사용자와 병합하도록 엔드포인트가 설정됩니다. 필드를 none으로 설정하면 사용자 데이터가 식별된 고객 프로필에 병합되지 않습니다. 기본적으로 이 필드는 merge 로 설정됩니다.

병합되는 필드 목록
  • 이름
  • 이메일
  • 성별
  • 생년월일
  • 전화번호
  • 시간대
  • 출생지
  • 국가
  • 언어
  • 세션 수(두 프로필의 세션 합계)
  • 첫 세션 날짜(Braze는 두 날짜 중 빠른 날짜를 선택합니다)
  • 마지막 세션 날짜(Braze는 두 날짜 중 늦은 날짜를 선택합니다.)
  • 사용자 지정 속성
  • 사용자 지정 이벤트 및 구매 이벤트 데이터
  • “Y일 동안 X회” 세분화에 대한 사용자 지정 이벤트 및 구매 이벤트 속성(여기서 X<=50, Y<=30)
  • 세분화 가능한 사용자 지정 이벤트 요약
    • 이벤트 수(두 프로필의 합계)
    • 이벤트가 처음 발생한 날짜(Braze는 두 날짜 중 빠른 날짜를 선택합니다.)
    • 이벤트가 마지막으로 발생한 날짜(Braze는 두 날짜 중 나중에 발생한 날짜를 선택합니다.)
  • 인앱 구매 총액(센트 단위)(두 프로필의 합계)
  • 총 구매 횟수(두 프로필의 합산)
  • 최초 구매 날짜(Braze는 두 날짜 중 빠른 날짜를 선택합니다.)
  • 마지막 구매 날짜(Braze는 두 날짜 중 늦은 날짜를 선택합니다.)
  • 앱 요약
  • Last_X_at 필드(고아가 된 프로필 필드가 더 최신인 경우 Braze가 필드를 업데이트합니다.)
  • 캠페인 요약(Braze는 가장 최근 날짜 필드를 선택합니다)
  • 워크플로 요약(Braze가 가장 최근 날짜 필드를 선택합니다)
  • 메시지 및 메시지 참여 내역
  • 사용자 지정 이벤트 및 구매 이벤트 수와 첫 번째 날짜 및 마지막 날짜 타임스탬프
    • 이렇게 병합된 필드는 ‘Y일 동안의 X 이벤트에 대한’ 필터를 업데이트합니다. 구매 이벤트의 경우 이러한 필터에는 ‘Y일 내 구매 횟수’ 및 ‘지난 Y일 동안 지출한 금액’이 포함됩니다.
  • 앱이 두 사용자 프로필에 모두 존재하는 경우 세션 데이터
    • 예를 들어, 대상 사용자에게는 “ABCApp”에 대한 앱 요약이 없지만 원래 사용자에게는 있는 경우, 병합 후 대상 사용자의 프로필에 “ABCApp” 앱 요약이 표시됩니다.

이메일로 사용자 식별

email 을 식별자로 지정한 경우 식별자에 prioritization 도 포함해야 합니다. prioritization 은 여러 사용자가 있는 경우 병합할 사용자를 지정하는 배열이어야 합니다. prioritization 은 정렬된 배열이므로 우선순위에서 일치하는 사용자가 두 명 이상이면 병합이 수행되지 않습니다.

배열에 허용되는 값은 다음과 같습니다:

  • identified
  • unidentified
  • most_recently_updated (가장 최근에 업데이트한 사용자에게 우선순위를 부여하는 것을 의미함)
  • least_recently_updated (가장 최근에 업데이트한 사용자에게 우선순위를 부여하는 것을 의미함)

우선순위 배열에는 한 번에 다음 옵션 중 하나만 존재할 수 있습니다.

  • identified 를 가진 사용자에게 우선순위를 지정하는 것을 말합니다. external_id
  • unidentified 없는 사용자에게 우선순위를 지정하는 것을 말합니다. external_id

배열에 identified 을 지정하는 경우, 이는 사용자에게 external_id있어야 캔버스에 입력할 수 있다는 의미입니다. 이메일 주소가 있는 사용자가 식별 여부에 관계없이 메시지를 입력하도록 하려면 most_recently_updated 또는 least_recently_updated 매개변수만 사용하세요.

요청 예시

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
curl --location --request POST 'https://rest.iad-01.braze.com/users/identify' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--data-raw '{
  "aliases_to_identify": [
    {
      "external_id": "external_identifier",
      "user_alias": {
          "alias_name": "example_alias",
          "alias_label": "example_label"
      }
    }
  ],
  "emails_to_identify": [
    {
      "external_id": "external_identifier_2",
      "email": "[email protected]",
      "prioritization": ["unidentified", "most_recently_updated"]
    }
  ]
  "merge_behavior": "merge"
}'

응답

1
2
3
4
5
6
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY
{
    "aliases_processed": 1,
    "message": "success"
}
이 페이지가 얼마나 도움이 되었나요?
New Stuff!