사용자 식별

이 엔드포인트를 사용하여 미확인(별칭 전용) 사용자를 식별할 수 있습니다.

/users/identify 호출은 별칭 전용 프로필을 식별된 프로필과 결합하고 별칭 전용 프로필을 제거합니다.

사용자를 식별하려면 aliases_to_identify 객체에 external_id가 포함되어야 합니다. 해당 external_id를 가진 사용자가 없는 경우 별칭이 지정된 사용자의 레코드에 external_id가 추가되고 사용자가 식별된 것으로 간주됩니다. 요청당 최대 50개의 사용자 별칭을 추가할 수 있습니다.

그런 다음 여러 개의 추가 사용자 별칭을 단일 external_id에 연결할 수 있습니다.

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

필수 구성 요소

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

사용량 제한

2021년 9월 16일 또는 그 이후에 Braze에 온보딩한 고객의 경우 이 엔드포인트에 대한 요청에 사용량 제한이 적용됩니다. 자세한 내용은 API 제한을 참조하세요.

요청 본문

1
2
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY

1
2
3
4
{
   "aliases_to_identify" : (required, array of alias to identify objects), 
   "merge_behavior": (optional, string) one of 'none' or 'merge' is expected
}

요청 매개변수

병합_행동 필드

merge_behavior 필드를 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” 앱 요약이 표시됩니다.

필드를 none으로 설정하면 사용자 데이터가 식별된 고객 프로필에 병합되지 않습니다.

이메일로 사용자 식별

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

배열에 허용되는 값은 identified, unidentified, most_recently_updated. most_recently_updated이며 이는 가장 최근에 업데이트된 사용자에게 우선순위를 지정하는 것을 의미합니다.

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

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

요청 예시

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": "john.smith@braze.com",
      "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"
}