Skip to content

클라우드 데이터 수집 테이블 설정

이 페이지에서는 클라우드 데이터 수집(CDI)의 관련되지만 서로 다른 두 가지 요구 사항인 소스 테이블 설정과 페이로드 형식 지정을 구분하여 설명합니다.

테이블 설정과 페이로드 형식 지정 비교

CDI 사용자 데이터 동기화의 경우 다음 두 가지를 모두 구성합니다:

Braze는 먼저 소스 테이블에서 행을 읽은 다음, 선택한 데이터 유형에 따라 PAYLOAD 필드를 검증합니다.

소스 테이블 설정

데이터 웨어하우스 사용자 데이터 동기화의 경우 소스 테이블 또는 뷰에 다음이 포함되어야 합니다:

  • UPDATED_AT
  • PAYLOAD
  • 하나 이상의 지원되는 사용자 식별자 열:
    • EXTERNAL_ID
    • ALIAS_NAME 및 ALIAS_LABEL
    • BRAZE_ID
    • EMAIL
    • PHONE

테이블에 여러 식별자 열이 포함되어 있더라도 각 행에는 한 번에 하나의 식별자 유형만 포함해야 합니다.

UPDATED_AT 요구 사항

  • 일광 절약 시간 문제를 방지하려면 UPDATED_AT 값을 UTC로 저장합니다.
  • Braze는 UPDATED_AT가 마지막으로 동기화된 값보다 이후인 행을 동기화합니다.
  • 새 행이 동일한 타임스탬프를 공유하는 경우 정확한 경계 타임스탬프의 행이 다시 동기화될 수 있습니다.

중복 타임스탬프 및 증분 업데이트에 대한 지침은 클라우드 데이터 수집 모범 사례를 참조하세요.

PAYLOAD 열 설정

PAYLOAD 값은 선택한 데이터 유형에 대해 Braze /users/track 엔드포인트에서 사용하는 것과 동일한 오브젝트 형식을 따릅니다.

중첩 속성의 경우 오브젝트 등록정보로 날짜 캡처의 형식을 사용하여 날짜를 포함합니다.

페이로드 예시

커스텀 속성 동기화를 위한 페이로드 열에 중첩 커스텀 속성을 포함할 수 있습니다.

1
2
3
4
5
6
7
8
9
10
11
12

{
      "most_played_song": {
        "song_name": "Solea",
        "artist_name": "Miles Davis",
        "album_name": "Sketches of Spain",
        "genre": "Jazz",
        "play_analytics": {
            "count": 1000,
            "top_10_listeners": true
        }
      }
}

이벤트를 동기화하려면 이벤트 이름이 필수입니다. time 필드는 ISO 8601 문자열 또는 yyyy-MM-dd'T'HH:mm:ss:SSSZ 형식으로 지정합니다. time 필드가 없는 경우 Braze는 UPDATED_AT 열 값을 이벤트 시간으로 사용합니다. app_id 및 properties를 포함한 기타 필드는 선택 사항입니다.

행당 하나의 이벤트를 동기화할 수 있습니다.

1
2
3
4
5
6
7
8
9

{
    "app_id" : "your-app-id",
    "name" : "rented_movie",
    "time" : "2013-07-16T19:20:45+01:00",
    "properties": {
        "movie": "The Sad Egg",
        "director": "Dan Alexander"
    }
}

구매 이벤트를 동기화하려면 product_id, currency, price가 필수입니다. 선택 사항인 time 필드는 ISO 8601 문자열 또는 yyyy-MM-dd'T'HH:mm:ss:SSSZ 형식으로 지정합니다. time 필드가 없는 경우 Braze는 UPDATED_AT 열 값을 이벤트 시간으로 사용합니다. app_id, quantity, properties를 포함한 기타 필드는 선택 사항입니다.

행당 하나의 구매 이벤트를 동기화할 수 있습니다.

1
2
3
4
5
6
7
8
9
10
11
12

{
    "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
    "product_id" : "Completed Order",
    "currency" : "USD",
    "price" : 219.98,
    "time" : "2013-07-16T19:20:30+01:00",
    "properties" : {
        "products" : [ { "name": "Monitor", "category": "Gaming", "product_amount": 19.99 },
        { "name": "Gaming Keyboard", "category": "Gaming ", "product_amount": 199.99 }
        ]
    }
}

구독 그룹 상태를 동기화하려면 각 행에 하나 이상의 subscription_group_id 및 subscription_state 쌍을 포함합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

{
    "subscription_groups" : [
        {
            "subscription_group_id": "subscription_group_identifier_1",
            "subscription_state": "unsubscribed"
        },
        {
            "subscription_group_id": "subscription_group_identifier_2",
            "subscription_state": "subscribed"
        },
        {
            "subscription_group_id": "subscription_group_identifier_3",
            "subscription_state": "subscribed"
        }
      ]
}
New Stuff!