사용자 병합

이 엔드포인트를 사용하여 한 사용자를 다른 사용자와 병합할 수 있습니다.

요청당 최대 50개의 병합을 지정할 수 있습니다. 이 엔드포인트는 비동기식입니다.

Prerequisites

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

사용량 제한

이 엔드포인트에는 분당 20,000개의 요청에 대한 공유 속도 제한이 적용됩니다. 이 속도 제한은 API 속도 제한 설명서에 설명된 대로 ,/users/delete /users/alias/new, /users/identify, 및/users/alias/update엔드포인트와 공유됩니다.

요청 본문

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

1
2
3
{
  "merge_updates" : (required, array of objects)
}

요청 매개변수

병합 동작

아래에 설명된 동작은 스노우플레이크가 지원하지 않는 모든 Braze 기능에 적용됩니다. 사용자 병합은 메시징 기록 탭, 세그먼트 확장, 쿼리 작성기 및 커런츠에 반영되지 않습니다.

이 엔드포인트는 대상 사용자에게 없는 경우 다음 필드를 병합합니다.

• First name
• Last name
• 이메일 주소(암호화되지 않은 경우 encrypted)
• Gender
• Date of birth
• Phone number
• Time zone
• Home city
• Country
• 언어
• 장치 정보
• 세션 수(두 프로필의 세션 합계)
• 첫 세션 날짜(브레이즈는 두 날짜 중 더 이른 날짜를 선택합니다)
• 마지막 세션 날짜(브레이즈는 두 날짜 중 더 늦은 날짜를 선택합니다)
• 커스텀 속성(브레이즈는 대상 프로필에 기존 커스텀 속성을 유지하고 대상 프로필에 존재하지 않는 커스텀 속성을 포함합니다)
• 사용자 지정 이벤트 및 구매 이벤트 데이터
• “Y일 동안 X회” 세분화를 위한 커스텀 이벤트 및 구매 이벤트 속성(여기서 X<=50 및 Y<=30)
• 세분화 가능한 사용자 지정 이벤트 요약
  • 이벤트 수(두 프로필의 합계)
  • 이벤트가 처음 발생한 날짜(브레이즈는 두 날짜 중 더 이른 날짜를 선택합니다)
  • 이벤트가 마지막으로 발생한 날짜(브레이즈는 두 날짜 중 더 늦은 날짜를 선택합니다)
• 인앱 구매 총액(센트 단위)(두 프로필의 합계)
• 총 구매 횟수(두 프로필의 합산)
• 첫 구매 날짜(브레이즈는 두 날짜 중 더 이른 날짜를 선택합니다)
• 마지막 구매 날짜(브레이즈는 두 날짜 중 더 늦은 날짜를 선택합니다)
• 앱 요약
• Last_X_at 필드(브레이즈는 고아 프로필 필드가 더 최근인 경우 필드를 업데이트합니다)
• 캠페인 상호작용 데이터(브레이즈는 가장 최근 날짜 필드를 선택합니다)
• 워크플로우 요약(브레이즈는 가장 최근 날짜 필드를 선택합니다)
• 메시지 및 메시지 참여 내역
• 브레이즈는 앱이 두 사용자 프로필 모두에 존재하는 경우에만 세션 데이터를 병합합니다.

사용자 지정 이벤트 날짜 및 구매 이벤트 날짜 동작

이 병합된 필드는 “Y일 동안 X회 이벤트” 필터를 업데이트합니다. 구매 이벤트의 경우 이러한 필터에는 ‘Y일 내 구매 횟수’ 및 ‘지난 Y일 동안 지출한 금액’이 포함됩니다.

이메일 또는 전화번호로 사용자 병합하기

식별자로 email 또는 phone가 지정된 경우, 식별자에 추가 prioritization 값을 포함해야 합니다. prioritization는 여러 사용자가 발견된 경우 병합할 사용자를 지정하는 정렬된 배열이어야 합니다. 이는 우선 순위에서 하나 이상의 사용자가 일치하는 경우 병합이 발생하지 않음을 의미합니다.

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

• identified
• unidentified
• most_recently_updated (가장 최근에 업데이트한 사용자에게 우선순위를 부여하는 것을 의미함)
• least_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
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
curl --location --request POST 'https://rest.iad-01.braze.com/users/merge' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--data-raw '{
{
  "merge_updates": [
    {
      "identifier_to_merge": {
        "external_id": "old-user1"
      },
      "identifier_to_keep": {
        "external_id": "current-user1"
      }
    },
    {
      "identifier_to_merge": {
        "email": "[email protected]",
        "prioritization": ["unidentified", "most_recently_updated"]
      },
      "identifier_to_keep":  {
        "email": "[email protected]",
        "prioritization": ["identified", "most_recently_updated"]
      }
    },
    {
      "identifier_to_merge": {
        "user_alias": {
          "alias_name": "[email protected]",
          "alias_label": "email"
        }
      },
      "identifier_to_keep": {
        "user_alias": {
          "alias_name": "[email protected]",
          "alias_label": "email"
        }
      }
    }
  ]
}'

미확인 사용자 병합하기

다음 요청은 이메일 주소 [email protected]를 가진 가장 최근에 업데이트된 식별되지 않은 사용자를 외부 ID john를 가진 사용자와 병합합니다. 이 예에서는 most_recently_updated을 사용하여 쿼리를 하나의 식별되지 않은 사용자로 필터링합니다. 따라서, 이 이메일 주소를 가진 두 명의 식별되지 않은 사용자가 있다면, 외부 ID john를 가진 사용자와 병합되는 것은 단 한 명뿐입니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
curl --location --request POST 'https://rest.iad-01.braze.com/users/merge' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--data-raw '{
{
  "merge_updates": [
    {
      "identifier_to_merge": {
        "email": "[email protected]",
        "prioritization": ["unidentified", "most_recently_updated"]
      },
      "identifier_to_keep": {
        "external_id": "john"
      }
    }
  ]
}'

미확인 사용자를 식별된 사용자로 병합하기

다음 예시는 이메일 주소 [email protected]를 가진 가장 최근에 업데이트된 식별되지 않은 사용자를 이메일 주소 [email protected]를 가진 가장 최근에 업데이트된 식별된 사용자와 병합합니다.

most_recently_updated을 사용하면 쿼리가 한 사용자(식별되지 않은 사용자 identifier_to_merge와 식별된 사용자 identifier_to_keep 각각 하나)로 필터링됩니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
curl --location --request POST 'https://rest.iad-01.braze.com/users/merge' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--data-raw '{
{
  "merge_updates": [
    {
      "identifier_to_merge": {
        "email": "[email protected]",
        "prioritization": ["unidentified", "most_recently_updated"]
      },
      "identifier_to_keep": {
        "email": "[email protected]",
        "prioritization": ["identified", "most_recently_updated"]
      }
    }
  ]
}'

우선순위 most_recently_updated을 포함하지 않고 식별되지 않은 사용자를 병합하기

이메일 주소 [email protected]을 가진 두 명의 식별되지 않은 사용자가 있다면, 이 예제 요청은 사용자를 병합하지 않습니다. 왜냐하면 그 이메일 주소를 가진 식별되지 않은 사용자가 두 명이기 때문입니다. 이 요청은 이메일 주소 [email protected]를 가진 식별되지 않은 사용자가 단 한 명일 때만 작동합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
curl --location --request POST 'https://rest.iad-01.braze.com/users/merge' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--data-raw '{
{
  "merge_updates": [
    {
      "identifier_to_merge": {
        "email": "[email protected]",
        "prioritization": ["unidentified"]
      },
      "identifier_to_keep": {
        "external_id": "john"
      }
    }
  ]
}'

Response

이 엔드포인트에 대한 상태 코드 응답은 202 와 400 두 가지입니다.

성공 응답의 예

202 상태 코드는 다음과 같은 응답 본문을 반환할 수 있습니다.

1
2
3
{
  "message": "success"
}

오류 응답의 예

400 상태 코드는 다음과 같은 응답 본문을 반환할 수 있습니다. 발생할 수 있는 오류에 대한 자세한 내용은 문제 해결을 참조하세요.

1
2
3
{
  "message": "'merge_updates' must be an array of objects"
}

문제 해결

다음 표에는 발생할 수 있는 오류 메시지가 나열되어 있습니다.