Tajo 사전 이용 신청

이름과 회사 이메일 주소를 입력하세요. Tajo 이용 신청을 확인할 수 있는 링크를 이메일로 보내드립니다.

Braze 커넥터

커넥터 상태: 예정 아직 구축되지 않았습니다. Tajo는 현재 이 커넥터를 실행하지 않습니다.

예시 그림 · 샘플 데이터

동기화 예시

레코드 한 건 검토

원본

Braze

커넥터 상태: 예정

대상

다른 도구

커넥터 상태: 사용자 지정 도구

필드 매핑

원본 필드	대상 필드	예시 값
`record.id`	`source_id`	`record_1042`
`record.updated_at`	`updated_at`	`2026-10-18T08:00:00Z`
`record.value`	`value`	`sample_value`

초안
레코드 한 건 검토
이 버전 승인

상태는 개별 커넥터에 대한 것으로, 이 동기화가 준비됐다는 보장은 아닙니다. 표시된 필드는 예시입니다. 동기화 실행 전에 실제 스키마와 권한을 확인하세요.

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.track
users.export.ids
users.export.segment
campaigns.list
campaigns.data_series
canvas.list
canvas.data_series
segments.list
segments.data_series
email.status
subscription.status.set
catalogs.list_items

API 키 보안

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: LANGUAGE

API 엔드포인트

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 호출 로깅

Braze 커넥터

동기화 예시

필드 매핑

개요

기능

사전 요구 사항

인증

API 키 생성

Tajo에 연결

구성

기본 설정

필드 매핑

API 엔드포인트

코드 예제

커넥터 초기화

사용자 프로필 동기화

맞춤 이벤트 추적

세그먼트 데이터 내보내기

속도 제한

문제 해결

일반적인 문제

디버그 모드

연결 테스트

모범 사례

보안

관련 리소스

이메일에서 신청을 확인하세요

이 페이지의 Markdown: braze.md