클라우드 데이터 수집: 비주얼 매퍼

이 페이지에서는 SQL을 작성하거나 데이터를 재구성하지 않고 비주얼 매퍼를 사용하여 데이터 웨어하우스의 테이블 또는 뷰를 Braze에 동기화하는 방법을 다룹니다.

비주얼 매퍼는 모든 클라우드 데이터 수집 데이터 웨어하우스 소스에서 속성, 커스텀 이벤트 및 Canvas 트리거 동기화에 사용할 수 있습니다. 다른 동기화 유형은 데이터 정의 옵션 선택을 참조하세요.

비주얼 매퍼를 사용하면 SQL을 작성하거나 업스트림에서 데이터를 재구성하지 않고도 데이터 웨어하우스의 기존 테이블 또는 뷰를 동기화할 수 있습니다. EXTERNAL_ID, UPDATED_AT, PAYLOAD 열이 포함된 Braze 전용 테이블을 만드는 대신, 대시보드에서 기존 테이블의 열을 Braze 필드에 직접 매핑합니다.

사전 요구 사항

시각적 매퍼로 동기화를 만들기 전에 다음이 필요합니다.

• 활성화된 클라우드 데이터 수집 데이터 웨어하우스 소스. 아직 설정하지 않았다면 클라우드 데이터 수집 소스를 참조하세요.
• 동기화하려는 테이블 또는 뷰의 이름(데이터 웨어하우스에 표시된 그대로).
• 테이블에 지원되는 사용자 식별자가 포함된 열과 Braze가 변경 사항 추적에 사용할 수 있는 타임스탬프 열.

참고

Braze는 데이터에 대해 읽기 전용 쿼리만 실행하며 기본 테이블을 수정하지 않습니다. 쿼리 실행 중에 임시 객체가 생성될 수 있지만 유지되지는 않습니다.

비주얼 매퍼로 동기화 생성하기

1단계: 동기화 구성

1. 데이터 설정 > 클라우드 데이터 수집 > 동기화로 이동한 다음 데이터 동기화 생성을 선택합니다.
2. 동기화 이름을 정하고 활성 데이터 소스를 선택합니다. 활성 소스만 사용할 수 있습니다.
3. 데이터 대상에서 Braze Data Platform을 선택합니다.
4. 데이터 유형을 선택합니다.
5. 다음: 데이터 정의를 선택합니다.

2단계: 소스 스키마 매핑

1. 데이터 정의 단계에서 비주얼을 선택합니다.
2. 데이터 웨어하우스에 표시된 그대로 테이블 또는 뷰 이름을 입력합니다.
3. 소스 스키마 매핑을 선택합니다. Braze가 테이블 또는 뷰의 스키마를 읽고 감지된 데이터 유형과 함께 모든 열을 나열하므로, 각 열을 Braze 필드에 매핑할 수 있습니다.

3단계: 매핑 검토

매핑 검토 섹션에서는 두 가지 필수 매핑을 추적합니다. 두 매핑이 모두 완료되어야 동기화를 생성할 수 있습니다.

• 하나의 열을 Braze에서 허용하는 사용자 식별자(external_id, braze_id, email, phone 또는 사용자 별칭)에 매핑합니다. 식별자 옵션은 대상 필드 드롭다운의 식별자 아래에 표시됩니다.
• 하나의 열을 updated_at에 매핑합니다. Braze는 이 타임스탬프를 변경 사항 추적에 사용하며, 각 동기화 실행 시 updated_at이 마지막으로 동기화된 값보다 이후인 행을 가져옵니다.

나머지 각 열에 대해 다음 작업을 할 수 있습니다.

• 기본값 매핑 유지. 각 열은 같은 이름의 Braze 필드에 매핑됩니다. 해당 필드가 아직 워크스페이스에 없으면 새 속성으로 표시되며, 동기화가 처음 실행될 때 생성됩니다.
• 기존 필드에 매핑. 대상 필드 드롭다운에서 검색하여 열을 워크스페이스의 기존 기본값 속성 또는 커스텀 속성에 매핑합니다.
• 새 필드에 매핑. 대상 필드 드롭다운에 직접 입력하여 열을 새 커스텀 속성에 매핑합니다.
• 열 제외. 가져오기 체크박스를 해제하면 해당 열을 동기화에서 제외할 수 있습니다.

팁

새 속성을 생성하기 전에 대상 드롭다운에서 기존 속성이 있는지 먼저 검색하세요. 예를 들어 테이블에 fav_color 열이 있는데 워크스페이스에서 이미 favorite_color를 추적하고 있다면, 속성을 하나 더 만드는 대신 fav_color를 favorite_color에 매핑하는 것을 고려해 보세요.

참고

데이터 유형이 열의 감지된 유형과 일치하지 않는 필드에는 유형 불일치 경고가 표시됩니다. 그대로 진행할 수는 있지만, 일치하지 않는 값은 행 오류로 동기화에 실패할 수 있습니다. 행 오류는 동기화의 실행 세부 정보에서 확인할 수 있습니다.

4단계: 미리 보기 및 유효성 검사

미리 보기 및 유효성 검사를 선택하면 테이블 또는 뷰에 대해 읽기 전용 검사를 실행합니다. 미리 보기에는 매핑된 필드 이름을 사용한 처음 10개 행이 표시되며, 가져오는 열만 포함됩니다.

5단계: 동기화 생성 완료

1. 알림 단계에서 동기화 오류 알림을 받을 연락처 이메일을 하나 이상 입력합니다. 선택적으로 행 오류 알림(일정 비율의 행이 업데이트에 실패할 때 전송)과 동기화 성공 알림을 켤 수 있습니다.
2. 스케줄 단계에서 반복 동기화를 켜면 스케줄에 따라 동기화를 실행하고, 끄면 일회성 동기화로 실행됩니다.
3. 요약 단계를 검토합니다. 이 단계에는 구성 내용, 새 속성과 기존 속성의 구분, 그리고 데이터 유형 문제나 사용자의 선택으로 가져오기에서 제외된 열이 나열됩니다.
4. 동기화 생성을 선택합니다. 어느 단계에서든 초안으로 저장을 선택해 나중에 마무리할 수도 있습니다.

스키마 변경 처리

시각적 매퍼는 동기화를 실행할 때마다 테이블 또는 뷰의 스키마를 확인하고, 변경 유형에 따라 다음과 같이 대응합니다.

열이 제거되어 일시 중지된 동기화를 재개하려면 동기화 편집을 선택하고 매핑을 검토하세요. 제거된 열은 표시되며 더 이상 매퍼에 나타나지 않습니다. 매핑을 저장하면 해당 열 없이 동기화를 계속하는 것으로 확정됩니다. 또는 데이터가 다른 열로 이동한 경우, 저장하기 전에 새 열을 매핑하세요.

자주 묻는 질문

동기화를 생성한 후에 매핑을 편집할 수 있나요?

예. 동기화를 편집하고 매핑 보기 및 편집을 선택합니다. 소스 테이블의 현재 스키마가 로드되며, 동기화를 생성할 때 설정한 이전 매핑도 저장되어 있습니다. 여기에서 매핑을 편집할 수 있습니다.

비주얼 매퍼에서 데이터를 변환할 수 있나요?

아니요. 비주얼 매퍼는 소스에 있는 열 값을 그대로 동기화합니다. 변환, 조건 로직, 테이블 간 조인은 지원하지 않습니다. 이러한 사용 사례에는 데이터 정의 단계에서 SQL 옵션을 사용해 쿼리로 데이터를 구성하세요. 자세한 내용은 클라우드 데이터 수집: SQL 편집기를 참조하세요.

기존 CDI 동기화가 변경되나요?

아니요. EXTERNAL_ID, UPDATED_AT, PAYLOAD 열이 있는 기존 테이블 형식을 사용하는 동기화는 계속 작동하며, 이 형식으로 새 동기화를 생성할 수도 있습니다.

Braze 사용량에는 어떤 영향이 있나요?

가져와서 매핑하는 각 열은 Braze 필드 업데이트로 기록되며, 데이터 포인트 청구 방식은 다른 CDI 사용자 데이터 동기화와 동일합니다. 필요하지 않은 열을 제외하면 동기화를 효율적으로 유지할 수 있습니다. 자세한 내용은 클라우드 데이터 수집 모범 사례를 참조하세요.