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

이 페이지에서는 클라우드 데이터 수집(CDI)이 데이터를 읽는 방식을 선택하고, PAYLOAD 열을 사용하는 방법을 선택한 경우 소스 테이블을 설정하는 방법을 안내합니다.

데이터 정의 옵션 선택

데이터 웨어하우스 소스에서 동기화를 생성할 때, 데이터 정의 단계에서 Braze가 데이터를 읽는 방법을 선택합니다. 표시되는 옵션은 동기화 유형에 따라 다릅니다.

테이블 설정과 페이로드 포맷팅 비교 이해하기

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

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

소스 테이블 설정하기

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

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

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

UPDATED_AT 요구 사항

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

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

참고

파일 스토리지 소스는 다른 설정 요구 사항을 사용하며 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
        }
      }
}

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": "Alex Smith"
    }
}

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 }
        ]
    }
}

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"
        }
      ]
}

관련 CDI 설정 문서

• 소스별 DDL 예시는 데이터 웨어하우스 통합을 참조하세요.
• 파일 기반 설정은 파일 스토리지 통합을 참조하세요.
• 동기화 동작 및 최적화 가이드는 클라우드 데이터 수집 모범 사례를 참조하세요.