---
title: "Braze 커넥터"
description: "Tajo를 통해 Braze의 고객 참여 데이터, 캠페인, 메시징 이벤트를 Brevo와 동기화하는 완전한 통합 가이드입니다."
url: https://tajo.io/kr/docs/connectors/marketing/braze/
markdown: https://tajo.io/kr/docs/connectors/marketing/braze.md
lang: ko-KR
robots: noindex
---

Tajo 사전 이용 신청

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

# Braze 커넥터

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

| 원본 필드 | 대상 필드 | 예시 값 |
| --- | --- | --- |
| `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 연락처 타임라인으로 푸시 참여 데이터 전달
- **카탈로그 동기화** - 맞춤 추천을 위한 제품 카탈로그 동기화

## 사전 요구 사항

시작하기 전에 다음이 준비되어 있는지 확인하십시오.

1. API 접근이 활성화된 Braze 계정
2. 적절한 권한을 가진 Braze REST API 키
3. Braze 인스턴스 URL (예: `rest.iad-01.braze.com`)
4. API 접근이 가능한 Brevo 계정
5. 활성 구독이 있는 Tajo 계정

## 인증

Braze는 API 키 인증을 사용합니다. 각 API 키는 특정 엔드포인트로 범위를 지정할 수 있습니다.

### API 키 생성

1. Braze 대시보드에 로그인
2. **Settings** > **API Keys**로 이동
3. **Create New API Key** 클릭
4. 이름을 “Tajo Integration”으로 지정
5. 다음 권한 활성화:

```
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에 연결

```bash
tajo connectors install braze \
  --api-key $BRAZE_API_KEY \
  --instance-url rest.iad-01.braze.com
```

## 구성

### 기본 설정

```yaml
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 연락처 속성에 매핑합니다.

```yaml
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 | 카탈로그 항목 가져오기 |

## 코드 예제

### 커넥터 초기화

```javascript
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'
});
```

### 사용자 프로필 동기화

```javascript
// 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
// }
```

### 맞춤 이벤트 추적

```javascript
// 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
    }
  }
});
```

### 세그먼트 데이터 내보내기

```javascript
// 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 키에 필수 권한 추가 |
| 속도 제한 초과 | 동시 요청이 너무 많음 | 배치 크기 또는 동기화 빈도 줄이기 |
| 이벤트 지연 | 대규모 내보내기 대기열 | 전체 내보내기 대신 증분 동기화 사용 |

### 디버그 모드

```yaml
connectors:
  braze:
    debug: true
    log_level: verbose
    log_api_calls: true
```

### 연결 테스트

```bash
tajo connectors test braze
# ✓ API 연결 성공
# ✓ 사용자 내보내기 접근 가능
# ✓ 캠페인 데이터 읽기 가능
# ✓ 세그먼트 목록 접근 가능
# ✓ 이벤트 추적 작동 중
```

## 모범 사례

1. **증분 동기화 사용** - 전체 내보내기 대신, 마지막 동기화 이후 변경된 레코드만 동기화
2. **사용자 업데이트 배치 처리** - API 호출을 최소화하기 위해 속성 변경 그룹화
3. **API 키 범위 좁게 지정** - 통합에 필요한 권한만 활성화
4. **속도 제한 모니터링** - Braze 속도 제한에 도달하기 전에 알림 설정
5. **외부 ID를 일관되게 매핑** - Braze와 Brevo에서 동일한 식별자 사용
6. **먼저 샌드박스에서 테스트** - 프로덕션 배포 전에 Braze 테스트 워크스페이스 사용

## 보안

- **API 키 인증** - 세분화된 권한을 가진 범위 지정 API 키
- **HTTPS 전용** - TLS 1.2+를 통해 암호화된 모든 API 통신
- **IP 허용 목록** - Braze에서 API 접근에 대한 선택적 IP 제한
- **암호화된 저장** - Tajo에서 API 자격 증명이 저장 시 암호화됨
- **감사 로깅** - 규정 준수 검토를 위한 모든 API 호출 로깅

## 관련 리소스

- [Customer.io 커넥터](https://tajo.io/kr/docs/connectors/marketing/customerio)
- [Iterable 커넥터](https://tajo.io/kr/docs/connectors/marketing/iterable)
- [고객 동기화 스킬](https://tajo.io/kr/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/kr/docs/contact-management)