Braze 커넥터
Braze 참여 플랫폼을 Brevo에 연결하여 통합된 고객 프로필, 크로스 채널 캠페인 오케스트레이션, 통합된 마케팅 분석을 구현하십시오.
개요
| 속성 | 값 |
|---|---|
| 플랫폼 | Braze |
| 카테고리 | Marketing |
| 설정 복잡도 | 보통 |
| 공식 통합 | 아니오 |
| 동기화 데이터 | 고객, 이벤트, 캠페인, 메시지 |
| API 유형 | REST API |
| 인증 | API Key |
| Base URL | https://rest.iad-XX.braze.com (인스턴스별) |
기능
- 사용자 프로필 동기화 - Braze와 Brevo 간의 양방향 고객 속성 동기화
- 캠페인 이벤트 추적 - 이메일 오픈, 클릭, 전환, 구독 취소 추적
- Canvas 플로 데이터 - 통합 보고를 위한 다단계 캠페인 여정 데이터 동기화
- 세그먼트 미러링 - 크로스 플랫폼 타겟팅을 위해 Braze 세그먼트를 Brevo 목록으로 복제
- 푸시 알림 이벤트 - Brevo 연락처 타임라인으로 푸시 참여 데이터 전달
- 카탈로그 동기화 - 맞춤 추천을 위한 제품 카탈로그 동기화
사전 요구 사항
시작하기 전에 다음이 준비되어 있는지 확인하십시오.
- API 접근이 활성화된 Braze 계정
- 적절한 권한을 가진 Braze REST API 키
- Braze 인스턴스 URL (예:
rest.iad-01.braze.com) - API 접근이 가능한 Brevo 계정
- 활성 구독이 있는 Tajo 계정
인증
Braze는 API 키 인증을 사용합니다. 각 API 키는 특정 엔드포인트로 범위를 지정할 수 있습니다.
API 키 생성
- Braze 대시보드에 로그인
- Settings > API Keys로 이동
- Create New API Key 클릭
- 이름을 “Tajo Integration”으로 지정
- 다음 권한 활성화:
users.trackusers.export.idsusers.export.segmentcampaigns.listcampaigns.data_seriescanvas.listcanvas.data_seriessegments.listsegments.data_seriesemail.statussubscription.status.setcatalogs.list_itemsAPI 키 보안
Braze API 키를 안전하게 저장하십시오. 클라이언트 측 코드나 공개 저장소에 절대 노출하지 마십시오. Tajo는 AES-256을 사용하여 모든 API 자격 증명을 저장 시 암호화합니다.
Tajo에 연결
tajo connectors install braze \ --api-key $BRAZE_API_KEY \ --instance-url rest.iad-01.braze.com구성
기본 설정
connectors: braze: enabled: true instance_url: "rest.iad-01.braze.com" api_version: "v1"
sync: users: true campaigns: true canvases: true segments: true events: true
lists: engaged_users: 10 dormant_users: 11필드 매핑
Braze 사용자 속성을 Brevo 연락처 속성에 매핑합니다.
field_mapping: # 표준 필드 external_id: BRAZE_ID email: email first_name: FIRSTNAME last_name: LASTNAME phone: SMS
# 참여 지표 total_revenue: TOTAL_REVENUE push_opted_in: PUSH_OPTIN email_subscribe: EMAIL_STATUS
# 맞춤 속성 loyalty_points: LOYALTY_POINTS last_app_version: APP_VERSION preferred_language: LANGUAGEAPI 엔드포인트
Tajo는 다음 Braze REST API 엔드포인트와 통합됩니다.
| 엔드포인트 | 메서드 | 목적 |
|---|---|---|
/users/track | POST | 사용자 속성, 이벤트, 구매 전송 |
/users/export/ids | POST | 외부 ID로 사용자 프로필 내보내기 |
/users/export/segment | POST | 세그먼트에서 사용자 내보내기 |
/campaigns/list | GET | 캠페인 목록 가져오기 |
/campaigns/data_series | GET | 시간별 캠페인 분석 |
/canvas/list | GET | Canvas 플로 목록 가져오기 |
/canvas/data_series | GET | 시간별 Canvas 분석 |
/segments/list | GET | 세그먼트 목록 가져오기 |
/email/status | POST | 이메일 구독 상태 변경 |
/subscription/status/set | POST | 구독 그룹 상태 설정 |
/catalogs/{catalog_name}/items | GET | 카탈로그 항목 가져오기 |
코드 예제
커넥터 초기화
import { TajoClient } from '@tajo/sdk';
const tajo = new TajoClient({ apiKey: process.env.TAJO_API_KEY, brevoApiKey: process.env.BREVO_API_KEY});
await tajo.connectors.connect('braze', { apiKey: process.env.BRAZE_API_KEY, instanceUrl: 'rest.iad-01.braze.com'});사용자 프로필 동기화
// Braze 사용자를 Brevo 연락처로 동기화await tajo.connectors.sync('braze', { type: 'incremental', resources: ['users'], since: '2024-01-01', batchSize: 50});
// 동기화 상태 확인const status = await tajo.connectors.status('braze');console.log(status);// {// connected: true,// lastSync: '2024-03-15T10:30:00Z',// usersCount: 45200,// campaignsTracked: 28,// eventsProcessed: 125000// }맞춤 이벤트 추적
// Braze 이벤트를 Brevo로 전달await tajo.connectors.handleEvent('braze', { type: 'user.event', payload: { external_id: 'user_12345', name: 'product_viewed', properties: { product_id: 'SKU-789', category: 'electronics', price: 299.99 } }});세그먼트 데이터 내보내기
// Braze 세그먼트를 내보내고 Brevo 목록 생성const result = await tajo.connectors.exportSegment('braze', { segmentId: 'segment_abc123', targetList: 15, includeAttributes: ['email', 'first_name', 'last_name', 'total_revenue']});
console.log(`Exported ${result.count} users to Brevo list 15`);속도 제한
Braze는 요금제 및 인스턴스에 따른 속도 제한을 적용합니다.
| 요금제 | 속도 제한 | 버스트 제한 |
|---|---|---|
| Starter | 시간당 250,000 요청 | N/A |
| Pro | 시간당 250,000 요청 | N/A |
| Enterprise | 맞춤 | 맞춤 |
/users/track 엔드포인트는 분당 50,000 요청의 기본 제한을 갖습니다. Tajo는 지수 백오프로 속도 제한을 자동으로 처리합니다.
배치 요청
Tajo는 속도 제한 내에서 처리량을 최대화하기 위해 /users/track 요청당 최대 75개의 사용자 속성, 75개의 이벤트, 75개의 구매를 배치 처리합니다.
문제 해결
일반적인 문제
| 문제 | 원인 | 해결 방법 |
|---|---|---|
| 401 Unauthorized | 잘못되거나 만료된 API 키 | Braze 대시보드에서 API 키 재생성 |
| 사용자가 동기화되지 않음 | 잘못된 인스턴스 URL | Braze 인스턴스 URL 확인 (예: iad-01, iad-02) |
| 속성 누락 | API 키 범위가 너무 좁음 | API 키에 필수 권한 추가 |
| 속도 제한 초과 | 동시 요청이 너무 많음 | 배치 크기 또는 동기화 빈도 줄이기 |
| 이벤트 지연 | 대규모 내보내기 대기열 | 전체 내보내기 대신 증분 동기화 사용 |
디버그 모드
connectors: braze: debug: true log_level: verbose log_api_calls: true연결 테스트
tajo connectors test braze# ✓ API 연결 성공# ✓ 사용자 내보내기 접근 가능# ✓ 캠페인 데이터 읽기 가능# ✓ 세그먼트 목록 접근 가능# ✓ 이벤트 추적 작동 중모범 사례
- 증분 동기화 사용 - 전체 내보내기 대신, 마지막 동기화 이후 변경된 레코드만 동기화
- 사용자 업데이트 배치 처리 - API 호출을 최소화하기 위해 속성 변경 그룹화
- API 키 범위 좁게 지정 - 통합에 필요한 권한만 활성화
- 속도 제한 모니터링 - Braze 속도 제한에 도달하기 전에 알림 설정
- 외부 ID를 일관되게 매핑 - Braze와 Brevo에서 동일한 식별자 사용
- 먼저 샌드박스에서 테스트 - 프로덕션 배포 전에 Braze 테스트 워크스페이스 사용
보안
- API 키 인증 - 세분화된 권한을 가진 범위 지정 API 키
- HTTPS 전용 - TLS 1.2+를 통해 암호화된 모든 API 통신
- IP 허용 목록 - Braze에서 API 접근에 대한 선택적 IP 제한
- 암호화된 저장 - Tajo에서 API 자격 증명이 저장 시 암호화됨
- 감사 로깅 - 규정 준수 검토를 위한 모든 API 호출 로깅