CDI를 사용한 제로 복사 개인화
CDI를 사용하여 제로 복사 개인화를 위한 Canvas 트리거를 동기화하는 방법을 알아보세요. 이 기능은 데이터 저장 솔루션에서 사용자별 정보에 액세스하여 대상 Canvas로 전달합니다. 캔버스 단계에는 Braze 고객 프로필에 저장되지 않는 개인화 필드를 선택적으로 포함할 수 있습니다.
Canvas 트리거 동기화
빠른 시작 단계
Braze CDI에 이미 익숙하다면, Canvas 트리거 동기화 설정은 같은 소스의 사용자 데이터 동기화 과정과 거의 같습니다. 다만 다음과 같은 차이점이 있습니다.
- 외부 ID 또는 사용자 별칭 식별자만 지원됩니다. 이메일과 전화번호는 식별자로 지원되지 않습니다.
- 기존 Braze 사용자만 동기화할 수 있습니다. 새 사용자는 생성할 수 없습니다.
PAYLOAD열 대신PROPERTIES를 사용합니다. 이 열은 개인화를 위해 Canvas 항목 속성으로 사용할 필드를 담은 JSON 문자열입니다.
시작하려면 새 동기화를 생성할 때 Canvas 트리거 데이터 유형을 선택합니다.
1단계: Canvas 트리거용 데이터 소스 설정
소스 테이블 또는 파일 형식을 확인하려면 해당 소스 페이지를 열고 Canvas 트리거 탭을 선택합니다. 같은 페이지에서 자격 증명과 네트워크 설정도 완료합니다.
| 소스 | Canvas 트리거 설정 |
|---|---|
| Snowflake | Snowflake 소스 테이블 |
| Amazon Redshift | Redshift 소스 테이블 |
| Google BigQuery | BigQuery 소스 테이블 |
| Databricks | Databricks 소스 테이블 |
| Microsoft Fabric | Microsoft Fabric 소스 테이블 |
| Amazon S3 | Amazon S3 파일 형식 |
| Google Cloud Storage | Google Cloud Storage 파일 형식 |
| Azure Blob Storage | Azure Blob Storage 파일 형식 |
기존 동기화의 자격 증명이 이미 있다면 재사용할 수 있지만, Canvas 트리거 소스 테이블에 대한 액세스 권한도 부여해야 합니다.
2단계: 대상 Canvas 구성
- Canvas 트리거용 대상 Canvas를 설정합니다. API 트리거 Canvas를 새로 생성하거나 기존 Canvas를 선택합니다. API 트리거 전달 스케줄 유형으로 Canvas를 생성하는 방법은 항목 스케줄 유형을 참조하세요.
- API 트리거 전달 스케줄 유형을 선택한 후 Canvas 설정을 계속 진행하고 Canvas를 구축합니다. Canvases는 간단한 단일 메시지 발송부터 여러 단계로 구성된 복잡한 고객 워크플로까지 다양하게 구성할 수 있습니다.
- 캔버스 단계에서 Canvas 항목 속성을 사용하여 소스 테이블에서 동기화할 속성 필드로 메시지를 개인화합니다.
- 예를 들어 1단계에서
account_balance속성 필드를 설정했다면, 다음 Liquid 템플릿을 사용하여 메시지를 개인화할 수 있습니다:\{\{canvas_entry_properties.\$\{account_balance\}\}\}.
- 예를 들어 1단계에서
- Canvas 구축을 마쳤다면 Canvas를 실행하고 3단계로 진행합니다.
3단계: 제로 카피 동기화 생성
소스 설정을 완료하고 대상 Canvas를 실행했다면 새 데이터 동기화를 생성합니다.
- Braze에서 데이터 설정 > 클라우드 데이터 수집으로 이동합니다.
- 연결 세부 정보를 입력하거나 기존 자격 증명을 재사용하고, 1단계의 소스 테이블을 지정하여 연결을 설정합니다.
- 통합 이름을 입력합니다.
- Canvas 트리거 데이터 유형을 선택합니다.
- 2단계에서 구성한 대상 Canvas를 선택합니다.
- 동기화 빈도를 선택합니다.
- 알림 환경설정을 지정합니다.
- 연결 테스트를 선택하여 모든 것이 예상대로 작동하는지 확인합니다. Snowflake에 연결하는 경우, 먼저 대시보드에 표시된 공개 키를 Braze가 Snowflake에 연결하기 위해 생성한 사용자에게 추가합니다. 이 단계를 완료하려면 Snowflake에서 SECURITYADMIN 이상의 액세스 권한이 필요합니다.
- 동기화를 저장하여 Canvas 트리거 동기화를 시작합니다.
동기화가 실행되면 소스 테이블의 사용자가 Canvas에 진입하기 시작합니다. Canvas 분석과 클라우드 데이터 수집 동기화 로그 페이지를 사용하여 성능을 모니터링하세요.

예기치 않은 발송을 방지하려면 동기화 동작부터 Canvas 설정까지 전체 구성을 검토하세요. 사용량 제한조치, 최대 게재빈도 설정, 세분화 필터 등의 Canvas 설정을 통해 메시지 전달을 더욱 세밀하게 조정할 수 있습니다.
프로덕션 사용 사례를 구현하기 전에 소규모 또는 테스트 오디언스로 시범 운영을 진행하는 것을 권장합니다.
고려 사항
CDI Canvas 트리거는 /canvas/trigger/send에 대한 REST API 사용량 제한을 사용합니다. CDI Canvas 트리거와 REST API 통합에서 이 엔드포인트를 동시에 사용하는 경우, 두 사용량을 합산하여 사용량 제한에 포함됩니다.
각 동기화 실행에서는 시간당 최대 약 375만 명의 속도로 사용자를 해당 대상 Canvas에 진입시킵니다. 다음과 같은 경우에는 소스에서 Canvas 진입까지 시간이 더 오래 걸릴 수 있습니다.
- 동기화 실행당 375만 명 이상의 사용자를 동기화하는 경우
- REST API의
/canvas/trigger/send에 대한 사용량 제한에 이미 도달한 상태에서 CDI Canvas 트리거를 사용하는 경우
메시지 아카이빙이 활성화된 상태에서 제로 카피 CDI를 사용할 때는 다음 사항을 고려하세요.
- 테이블 결과는 처리 중에 Braze에 임시로 저장됩니다. 또한 정확히 무엇이 동기화되었는지 확인할 수 있도록 30일 동안 Snowflake로 내보내집니다.
- 아카이브된 메시지는 Braze 내 어디에도 저장되지 않습니다. 사본은 구성한 스토리지에만 전송되어 저장됩니다.
- Canvas 트리거와 함께 제로 카피 CDI를 사용하는 경우, Braze는 데이터 웨어하우스의 쿼리 결과 백업을 저장하지 않으며 어떤 데이터도 고객 프로필에 복사되지 않습니다.
- Canvas 컨텍스트 속성은 내부 시스템에 최대 30일 동안 기록될 수 있습니다.