영구 및 제로 카피 데이터 수집 옵션 비교
수집 파이프라인을 설계하기 전에, 웨어하우스 또는 애플리케이션의 데이터가 Braze에 도달하는 방식을 선택하세요. 사용자 프로필에 복사할지, 세분화를 위해 그 자리에서 쿼리할지, 또는 일시적으로 Canvas에 전달할지 결정합니다.
이 예시 소개
MovieCanon은 가상의 영화 스트리밍 서비스입니다. 고객, 티켓, 시청 데이터를 데이터 웨어하우스에 중앙 집중화합니다. 데이터 팀은 세 가지 일반적인 필요에 따라 Braze에 데이터를 공급하는 방법을 결정해야 합니다.
- 프로필 데이터: Braze 사용자 프로필에 지속적으로 저장되는 로열티 등급, 생애주기 가치, 장르 또는 포맷 선호도 속성.
- 오디언스 구축: 모든 컬럼을 Braze에 복사하지 않고 웨어하우스 테이블에서 SQL 기반 Segments를 생성.
- 트리거 메시징: 프로필에 저장할 필요 없는 행별 개인화와 함께 Canvas에 진입해야 하는 웨어하우스 행.
Braze는 네 가지 기본 수집 경로를 제공합니다. 표준 클라우드 데이터 수집(CDI) 동기화와 /users/track API는 모두 프로필에 데이터를 저장합니다. CDI Segments(Connected Sources)와 CDI Canvas 트리거는 제로 카피 옵션으로, 웨어하우스 데이터가 웨어하우스에 그대로 유지되며 Braze 사용자 프로필에 기록되지 않습니다.
아키텍처를 계획하거나 처리량을 산정하거나 엔지니어링 및 마케팅 이해관계자에게 트레이드오프를 설명할 때 이 비교를 활용하세요. 이 문서는 각 옵션의 통합 설정 가이드를 대체하지 않습니다.
고려 사항
- 클라우드 데이터 수집은 포괄적인 기능입니다. 표준 CDI 동기화는 데이터를 Braze 프로필에 복사합니다(
/users/track과 유사). CDI Segments 및 CDI Canvas 트리거는 웨어하우스 데이터를 Braze 사용자 프로필에 기록하지 않고 해당 위치에 유지합니다. - CDI 반복 동기화는 최소 5분마다 또는 최대 한 달에 한 번까지 실행할 수 있습니다. 기본적으로 대시보드에서 설정할 수 있는 최소 간격은 15분이며, 이는 웨어하우스 컴퓨팅 비용과 요청 볼륨을 관리하는 데 도움이 됩니다. 5분마다 동기화하려면 Braze 지원팀 또는 고객 성공 매니저에게 문의하세요. 데이터가 변경되는 즉시 동기화하려면 웨어하우스 로드가 완료될 때 동기화 트리거 엔드포인트를 호출하세요. Braze 클라우드 데이터 수집을 참조하세요.
- CDI Canvas 트리거는
/canvas/trigger/sendREST API 사용량 제한을 해당 엔드포인트로의 다른 트래픽과 공유합니다./users/track에는 자체 제한 및 배치 규칙이 있습니다. 기본 제한은 상향 조정할 수 있습니다. 설정 > API 및 식별자 > API 제한으로 이동하고, API 사용량 제한을 참조하세요. - 연결된 소스 및 CDI 세그먼트 확장은 웨어하우스에서 쿼리를 실행합니다. 웨어하우스 컴퓨팅 비용은 사용자 부담이며, Braze는 해당 쿼리에 대해 데이터 포인트를 기록하지 않습니다. 연결된 소스를 참조하세요.
설정
1단계: 사용 사례를 수집 경로에 매핑하기
목표를 권장 수집 경로와 해당 경로가 Braze 프로필에 데이터를 기록하는지 여부에 매핑하세요.
| 목표 | 권장 경로 | 프로필 기록 여부 |
|---|---|---|
| 웨어하우스에서 속성, 이벤트, 구매 또는 카탈로그 항목을 유지 | 표준 CDI 동기화 | 예 (데이터가 Braze 프로필 또는 카탈로그에 복사됨) |
| 소스 테이블을 Braze에 복사하지 않고 웨어하우스 SQL로 오디언스 구축 | CDI Segments (Connected Sources) | 아니요 (멤버십만 해당) |
| 프로필에 유지되지 않아야 하는 웨어하우스 행 컨텍스트로 사용자를 Canvas에 진입시키기 | CDI Canvas 트리거 | 아니요 (일시적 Canvas 컨텍스트 속성) |
| 앱, 서버 또는 스트리밍 파이프라인에서 거의 실시간으로 데이터 푸시 | /users/track (또는 SDK) |
예 (데이터가 프로필에 유지됨) |
2단계: 지속성, 지연 시간 및 처리량 비교하기
각 경로가 데이터 상주, 지연 시간, 처리량 및 사용자 생성을 어떻게 처리하는지 비교하세요.
| 차원 | 표준 CDI 동기화 | CDI Segments | CDI Canvas 트리거 | /users/track |
|---|---|---|---|---|
| 기능 | 웨어하우스 테이블의 스케줄 읽기; 속성, 이벤트, 구매, 사용자 삭제 또는 카탈로그를 기록 | Braze가 SQL 세그먼트 확장을 위해 웨어하우스를 쿼리 | 웨어하우스 행이 행 컨텍스트를 Canvas 컨텍스트 속성으로 사용하여 Canvas 진입을 트리거 | 앱, 서버 또는 스트리밍 파이프라인이 속성, 이벤트, 구매를 프로필에 기록 |
| 데이터 상주 | Braze 프로필에 복사 및 유지 | 웨어하우스에 유지; 프로필에 기록되지 않음 | Canvas 컨텍스트 속성은 일시적; 프로필에 유지되지 않음 | Braze 프로필에 복사 및 유지 |
| 일반적인 지연 시간 | 스케줄에 따라 실행 (최소 5분 간격; 기본값 15분) 또는 동기화 트리거 엔드포인트를 통한 온디맨드. 웨어하우스 최신성도 적용됩니다. | 세그먼트 확장 스케줄에 따라 새로고침. 멤버십은 마지막 새로고침 시점의 웨어하우스 데이터를 반영합니다. | 동기화 스케줄에 따라 실행 (최소 5분 간격; 기본값 15분). | 거의 실시간 (비동기 처리) |
| 처리량 참고사항 | 동기화당 전체 쿼리 결과; Braze가 내부적으로 /users/track, /users/delete 또는 카탈로그 엔드포인트로 배치 처리 |
연결된 소스당 60분 쿼리 실행 시간 제한; 요청당 객체 제한 없음 | /canvas/trigger/send 사용량 제한 공유; 동기화 실행당 시간당 약 375만 Canvas 진입 |
요청당 최대 75개 결합 객체; API 사용량 제한 참조 |
| 배치 크기 | 웨어하우스 읽기에 대한 CDI 측 객체당 제한 없음 | N/A (쿼리 출력이 멤버십을 정의) | 동기화 실행당 웨어하우스 행당 하나의 Canvas 진입 | 요청당 75개 속성, 이벤트, 구매 결합 (기본값) |
| 사용자 생성 | 예, 기존 사용자만 업데이트가 설정되지 않은 경우 | 아니요 (쿼리 결과의 알 수 없는 사용자는 무시됨) | 아니요 (기존 Braze 사용자만 해당) | 예, _update_existing_only가 true가 아닌 경우 |
3단계: 스키마 및 식별자 요구 사항 비교하기
각 경로에 필요한 열과 지원되는 식별자를 비교하세요. 표준 CDI 동기화당 하나의 데이터 유형을 구성합니다 (예: 하나의 통합에 속성, 다른 통합에 이벤트).
| 차원 | 표준 CDI 동기화 | CDI Segments | CDI Canvas 트리거 | /users/track |
|---|---|---|---|---|
| 필수 열 / 형태 | 사용자 식별자 + UPDATED_AT + 행당 PAYLOAD (JSON) |
SQL이 external_user_id만 출력해야 함 |
식별자 + UPDATED_AT + PROPERTIES (JSON; 비어 있을 때 {} 사용) |
표준 /users/track 요청 본문 |
| 지원되는 식별자 | external_id, 사용자 별칭, braze_id, 이메일 또는 전화번호 |
external_user_id만 해당 (문자열) |
external_id 또는 사용자 별칭만 해당 |
external_id, 사용자 별칭, braze_id, 이메일 또는 전화번호 |
4단계: 선택한 경로 구현하기
- 표준 CDI 동기화: 웨어하우스 테이블 또는 뷰를 생성한 다음 클라우드 데이터 수집 통합 및 테이블 설정을 따르세요.
- CDI Segments: 연결된 소스를 추가한 다음 CDI 세그먼트 확장을 생성하세요.
- CDI Canvas 트리거:
PROPERTIES가 포함된 소스 테이블을 설정하고, 대상 Canvas를 빌드 및 실행한 다음 CDI를 사용한 제로 카피 개인화에 따라 동기화를 생성하세요. /users/track: 애플리케이션 또는 미들웨어에서 요청을 전송하세요. POST: 사용자 생성 및 업데이트에 따라 페이로드를 구성하세요.
MovieCanon의 일반적인 패턴은 다음과 같습니다: 야간 프로필 보강을 위한 표준 CDI 동기화, 웨어하우스 전용 오디언스 규칙을 위한 CDI Segments, 행 수준 컨텍스트가 포함된 티켓 상태 또는 시청 여정을 위한 Canvas 트리거, 실시간 앱 이벤트를 위한 /users/track.