이 페이지는 AI로 자동 번역되었으며 부정확한 내용이 포함될 수 있습니다. 번역 오류를 신고하려면 페이지 오른쪽 목차 아래에 있는 피드백 기능을 사용하세요.

BrazeAI Decisioning Studio 데이터 동기화

이 페이지에서는 클라우드 데이터 수집(CDI)을 사용하여 데이터 웨어하우스의 데이터를 BrazeAI Decisioning Studio™에 직접 동기화하는 방법을 다룹니다.

CDI의 Decisioning Studio 대상을 사용하면 CDI가 웨어하우스 데이터를 BrazeAI Decisioning Studio에 직접 동기화할 수도 있습니다. 이러한 동기화를 통해 전달된 데이터는 Decisioning Studio에서 활성화에 사용할 수 있지만, 고객 프로필과 Braze 워크스페이스는 변경되지 않습니다.

중요

이 기능은 얼리 액세스 단계입니다. 액세스하려면 고객 성공 매니저 또는 계정 매니저에게 문의하세요.

작동 방식

동기화를 생성할 때 대상으로 Decisioning Studio를 선택하고, 동기화하려는 데이터를 반환하는 SQL 쿼리를 작성합니다. CDI는 설정한 스케줄에 따라 해당 쿼리를 실행하고 결과를 Decisioning Studio 자산으로 전달합니다. 각 동기화는 하나의 자산에 매핑되므로, 여러 동기화가 같은 자산을 가리키도록 설정할 수 없습니다.

Braze 데이터 플랫폼으로의 동기화와 달리, Decisioning Studio 동기화는 데이터를 고객 프로필, 이벤트 또는 카탈로그에 매핑하지 않습니다.

Decisioning Studio에서 데이터를 사용할 수 있도록 하는 다른 방법은 데이터 연결을 참조하세요.

사전 요구 사항

Braze 및 BrazeAI Decisioning Studio에 대한 액세스 권한
활성 상태인 클라우드 데이터 수집 데이터 웨어하우스 소스. 아직 설정하지 않았다면 클라우드 데이터 수집 소스를 참조하세요.
동기화하려는 테이블 또는 뷰
해당 테이블에서 기본 키로 사용할 열(하나 또는 여러 개)과 CDI가 증분 동기화에 사용할 수 있는 타임스탬프 열

Decisioning Studio 동기화 생성

1단계: 동기화 생성 및 대상 선택

데이터 설정 > 클라우드 데이터 수집 > 동기화로 이동합니다.
데이터 동기화 생성을 선택합니다.
통합 이름을 입력한 다음 데이터 소스에서 소스를 선택합니다.
대상에서 데이터 대상을 BrazeAI Decisioning Studio™로 설정합니다.
데이터 카테고리에서 테이블에 가장 잘 맞는 Decisioning Studio 데이터 유형을 선택합니다. 고객 프로필, 메시지 인게이지먼트 이벤트, 전환 이벤트, 기타 중에서 선택할 수 있습니다. 이 설정은 Decisioning Studio용 데이터에 태그를 지정할 뿐이며, CDI가 행을 처리하는 방식은 바뀌지 않습니다.

2단계: SQL 쿼리 작성

데이터 정의 단계에서 동기화하려는 테이블 또는 뷰의 데이터를 반환하는 SQL 쿼리를 작성합니다. 쿼리 결과가 동기화의 스키마가 됩니다.

소스 탐색기를 사용해 사용 가능한 테이블과 뷰를 둘러보거나, AI SQL 생성기를 사용해 쿼리 작성에 도움을 받을 수 있습니다.

CDI는 증분 동기화와 변경 사항 추적에 UPDATED_AT을 사용하므로, 쿼리는 반드시 UPDATED_AT 열을 반환해야 합니다. 각 동기화 실행 시 CDI는 UPDATED_AT이 마지막으로 동기화된 값보다 이후인 행만 동기화합니다. 확인한 타임스탬프 열의 이름이 UPDATED_AT이 아니라면 쿼리에서 별칭을 지정할 수 있습니다.

SELECT *, LAST_MODIFIED AS UPDATED_AT FROM my_table

UPDATED_AT이 증분 동기화를 제어하는 방식과 이 값을 이전 시점으로 되돌릴 때 발생하는 일에 대한 자세한 내용은 UPDATED_AT 열 이해하기를 참조하세요.

참고

JOIN 절을 포함하여 단일 문으로 된 읽기 전용 쿼리만 지원됩니다. CDI는 읽기 전용 쿼리를 실행하며 기본 테이블을 수정하지 않습니다.

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

미리보기 및 유효성 검사를 선택해 쿼리를 실행합니다. 쿼리 미리보기(처음 10개 행) 섹션에는 소스에서 반환된 처음 10개 행과 각 열에서 감지된 데이터 유형이 표시되므로, 계속 진행하기 전에 데이터가 올바른지 확인할 수 있습니다.

4단계: 기본 키 선택

모든 Decisioning Studio 동기화에는 각 행을 고유하게 식별하는 하나 이상의 열로 구성된 기본 키 또는 복합 키가 필요합니다. 유효성 검사가 완료되면 기본 키 드롭다운을 열고 기본 키로 사용할 열을 선택합니다. 여러 열을 선택하면 복합 키가 됩니다.

팁

좋은 기본 키는 모든 행에서 고유하고, 비어 있지 않으며, 동기화 실행 간에 안정적으로 유지됩니다. UUID() 또는 CURRENT_TIMESTAMP처럼 쿼리 시점에 생성되는 값은 행이 중복되거나 누락될 수 있으므로 피하세요.

5단계: 알림 및 스케줄 설정 후 동기화 생성

알림 단계에서 동기화 오류 알림을 받을 연락처 이메일을 하나 이상 입력합니다. 행 오류 및 동기화 성공 알림도 켤 수 있습니다.
스케줄 단계에서 반복 동기화를 켜면 스케줄에 따라 동기화가 자동으로 실행됩니다. 반복 동기화를 끄면 대시보드에서 수동으로 실행하거나 동기화 트리거 엔드포인트를 통해 트리거할 때만 동기화가 실행됩니다.
요약을 검토한 다음 동기화를 생성합니다.

동기화 편집

기존 동기화를 편집할 때 SQL 쿼리를 변경하면 저장하기 전에 다시 유효성 검사를 거쳐야 합니다. 기본 키와 복합 키는 변경할 수 없으며, 쿼리 결과에 계속 반환되어야 합니다.

유효한 변경 사항은 다음 동기화 실행 시 적용됩니다.

스키마 변경 처리

CDI는 소스 스키마 변경을 추가 방식으로 처리합니다. 동기화가 실행될 때마다 CDI는 소스 스키마를 기존 Decisioning Studio 에셋과 비교하여 이미 있는 열은 그대로 유지하면서 새 열을 추가합니다.

소스 테이블의 변경 사항	동기화 동작
새 열이 추가됨	CDI가 해당 열을 Decisioning Studio 에셋에 추가합니다. 열이 생기기 전에 전달된 행에는 해당 열 값이 `null`로 표시됩니다.
열이 제거됨	CDI가 해당 열의 업데이트를 중단하지만, 열과 기존 데이터는 에셋에 그대로 남아 있습니다. 다른 열은 계속 동기화됩니다.
열 이름이 변경됨	열이 제거되고 새 열이 추가된 것으로 처리됩니다. 원래 열은 에셋에 그대로 남고, 새 열이 추가됩니다.
열의 데이터 유형이 변경됨	CDI가 가능한 경우 값을 변환합니다. 변환할 수 없는 행은 동기화 실행 세부 정보에 행 오류로 보고됩니다.

CDI가 스키마 변경을 감지하면 동기화 실행 세부 정보와 동기화 편집 페이지에 해당 내용이 표시되고, 알림 연락처로 이메일 알림이 전송됩니다. 전달되는 열을 변경하려면 SQL 쿼리를 업데이트한 후 다시 검증하세요.

New Stuff!