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

Cloud Data Ingestion으로 데이터 객체 동기화

이 페이지를 참고하여 Cloud Data Ingestion(CDI)으로 소스의 데이터 객체 레코드와 그 관계를 Braze에 동기화하세요. 데이터 객체를 사용하면 계정과 같은 비즈니스 레코드를 저장하고 사용자와 연결할 수 있습니다. 기본 객체 모델과 API 엔드포인트에 대해서는 데이터 객체를 참조하세요.

동기화 유형

데이터 객체는 세 가지 동기화 유형을 사용합니다. 각 유형은 Braze에서 별도의 동기화로 구성되며, 각각 자체 소스 테이블 또는 쿼리와 자체 스케줄을 가집니다.

데이터 유형	각 행이 나타내는 내용	필수 식별자
데이터 객체	단일 계정과 같은 하나의 데이터 객체 레코드입니다.	`OBJECT_ID`
데이터 객체 사용자 관계	하나의 레코드와 한 명의 사용자 간 연결입니다.	`OBJECT_ID` 및 하나 이상의 사용자 식별자
데이터 객체 관계	같은 유형 또는 서로 다른 유형의 두 레코드 간 연결입니다.	`OBJECT_ID` 및 `RELATED_OBJECT_ID`

레코드를 참조하는 관계보다 레코드를 먼저 동기화하세요. 아직 존재하지 않는 레코드를 참조하는 관계 행은 바로 적용되지 않고 보류된 후 재시도됩니다.

동기화를 만들기 전에

CDI는 동기화 중에 데이터 객체 필드를 생성하거나 변경하지 않으므로 먼저 필드를 설정하세요.

데이터 설정 > 계정에서 전송할 각 필드와 관계 필드를 추가합니다. 모든 행에 해당 필드 값이 있는 경우에만 필드를 필수로 표시하세요.
소스에서 각 동기화에 사용할 테이블 또는 뷰를 생성하거나, CDI에서 직접 작성할 쿼리를 계획합니다.

동기화 만들기

데이터 설정 > Cloud Data Ingestion > 동기화로 이동하여 데이터 동기화 생성을 선택합니다.
이름을 입력하고 소스를 선택합니다.
데이터 유형에서 데이터 객체, 데이터 객체 사용자 관계 또는 데이터 객체 관계를 선택합니다.
레코드 동기화의 경우 데이터 객체 유형을, 관계 동기화의 경우 관계 이름을 선택합니다. 관계 이름은 관계 뒤에 그 관계가 연결하는 두 유형이 함께 표시됩니다(예: User (Account-User) 또는 Subaccount (Account-Account)).
데이터 정의 단계에서 동기화 모드를 선택합니다. 데이터 객체 동기화는 데이터 웨어하우스 소스에서 테이블 및 SQL 모드를 지원합니다. 비주얼 매퍼는 데이터 객체 동기화에서 사용할 수 없습니다.
미리 보기 및 유효성 검사를 선택한 다음 알림 및 스케줄 설정을 계속 진행합니다.

소스 열

UPDATED_AT - 이 행이 테이블에서 업데이트되거나 테이블에 추가된 시간입니다. Braze는 UPDATED_AT이 마지막으로 동기화된 값보다 이후인 행을 동기화합니다. 정확히 경계 타임스탬프에 해당하는 행은 새 행이 같은 타임스탬프를 공유하는 경우 다시 동기화될 수 있습니다.
OBJECT_ID - 데이터 오브젝트 레코드의 식별자입니다. 이 값은 Braze에서 이 데이터 오브젝트 유형에 사용하는 object_id 값과 일치해야 합니다.
PAYLOAD - 동기화할 필드와 값으로 구성된 JSON 문자열입니다. 각 키는 Braze의 데이터 오브젝트 유형에 정의된 필드와 일치해야 합니다.
DELETED - true이면 Braze는 레코드를 업데이트하는 대신 삭제합니다. 생성하거나 업데이트하려는 행에는 이 값을 null 또는 false로 두세요.

PAYLOAD 내부의 필드 이름은 대소문자를 구분합니다. NAME이라는 키는 name이라는 필드와 일치하지 않습니다. 대소문자가 일치하지 않으면 유효성 검사에서 해당 키를 정의되지 않은 필드로 보고하고, 원래 채우려던 필드는 누락된 것으로 보고합니다. 키 이름은 데이터 설정 > 데이터 오브젝트에 표시되는 필드 이름과 정확히 같게 지정하세요.

Braze는 동기화 중에 데이터 오브젝트 유형을 생성하거나 변경하지 않습니다. 동기화를 생성하기 전에 Braze에서 유형과 모든 필드를 정의하세요. 나중에 필드를 추가하려면 먼저 유형에 필드를 추가한 다음 소스 테이블이나 쿼리를 업데이트하세요.

소스의 SQL 방언으로 작성된 열 정의와 DDL 예시는 소스 페이지를 참조하세요.

사용자 관계 식별자

사용자 관계 행에는 OBJECT_ID와 함께 하나 이상의 사용자 식별자(EXTERNAL_ID, ALIAS_NAME과 ALIAS_LABEL의 조합, EMAIL 또는 PHONE)가 필요합니다.

유효성 검사

미리 보기 및 검증을 선택하면 Braze는 테이블 또는 쿼리가 반환하는 열을 데이터 객체 유형에 정의된 필드와 비교하여 확인합니다. 검증을 통과해야 데이터 정의 단계 이후로 진행할 수 있습니다.

오류	원인	해결 방법
쿼리에 필수 필드가 누락되었거나 null입니다	유형에서 필수로 지정된 필드와 일치하는 열이 없거나, 미리 보기한 행에서 해당 열이 null입니다.	각 필수 필드에 해당하는 열을 추가하고, 모든 행에 값이 있는지 확인하세요.
데이터 객체 유형에 다음 필드가 정의되어 있지 않습니다	열이 유형의 어떤 필드와도 일치하지 않습니다. 필드는 대소문자를 구분하므로 `TEAM_ID`는 `team_id`와 일치하지 않습니다.	열 이름을 필드와 정확히 일치하도록 수정하거나, 열을 제거하거나, Braze에서 해당 필드를 유형에 추가하세요.
필드에서 예상하는 데이터 유형이 쿼리의 데이터 유형과 다릅니다	열의 데이터 유형이 필드의 데이터 유형과 일치하지 않습니다. 예를 들어 필드는 숫자를 예상하는데 열에는 문자열이 있는 경우입니다.	소스 테이블 또는 쿼리에서 열을 예상 유형으로 변환(cast)하세요.

검증은 소스가 반환하는 처음 10개 행만 확인한다는 점에 유의하세요. 동기화 중에 실패한 행은 동기화 로그에 보고됩니다.

레코드 및 관계 삭제

레코드 또는 관계를 제거하려면 소스에 DELETED 열을 포함하세요. DELETED가 true이면 Braze는 해당 레코드 또는 관계를 업데이트하는 대신 삭제합니다. 레코드나 관계를 삭제해도 그와 연결된 사용자는 삭제되지 않습니다.

필수 열과 페이로드 형식은 테이블 설정을 참조하세요.
동기화 일정 설정과 데이터 포인트 효율성은 모범 사례를 참조하세요.
동기화 실행 모니터링은 동기화 로그 및 관측 가능성을 참조하세요.
모든 소스에 공통된 질문은 FAQ를 참조하세요.

New Stuff!