--- title: "Twilio Segment 커넥터" description: "Tajo를 통해 Twilio Segment의 고객 데이터, 이벤트, 오디언스 세그먼트를 Brevo와 동기화하는 완전한 통합 가이드입니다." url: https://tajo.io/kr/docs/connectors/custom/segment/ markdown: https://tajo.io/kr/docs/connectors/custom/segment.md lang: ko-KR robots: noindex --- Tajo 사전 이용 신청 이름과 회사 이메일 주소를 입력하세요. Tajo 이용 신청을 확인할 수 있는 링크를 이메일로 보내드립니다. # Twilio Segment 커넥터 커넥터 상태: 예정 아직 구축되지 않았습니다. Tajo는 현재 이 커넥터를 실행하지 않습니다. | 원본 필드 | 대상 필드 | 예시 값 | | --- | --- | --- | | `record.id` | `source_id` | `record_1042` | | `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` | | `record.value` | `value` | `sample_value` | Tajo를 통해 Twilio Segment를 Brevo에 연결하여 고객 데이터 파이프라인을 통합하고, 모든 소스의 이벤트를 Brevo로 라우팅하며, Segment의 아이덴티티 해결로 더 풍부한 마케팅 자동화를 활용하십시오. ## 개요 | 속성 | 값 | | --- | --- | | **플랫폼** | Twilio Segment | | **카테고리** | 데이터 플랫폼 (Custom) | | **설정 복잡도** | 중간 | | **공식 통합** | 아니오 | | **동기화 데이터** | 이벤트, 고객, 특성, 오디언스 | | **사용 가능한 스킬** | 8 | ## 기능 - **범용 데이터 수집** - Segment SDK를 통해 웹사이트, 모바일 앱, 서버에서 이벤트 수집 - **소스 라우팅** - 400개 이상의 소스에서 Tajo를 거쳐 Brevo로 데이터 라우팅 - **아이덴티티 해결** - 익명 및 알려진 사용자 프로필을 자동으로 병합 - **오디언스 동기화** - Segment가 계산한 특성과 오디언스를 Brevo 목록으로 전송 - **이벤트 스트리밍** - Segment의 Connections 프레임워크를 통한 실시간 이벤트 전달 - **Reverse ETL** - Segment Reverse ETL을 사용해 웨어하우스 데이터를 Brevo로 동기화 - **스키마 적용** - 동기화 전에 Segment Protocols로 이벤트 스키마 검증 ## 사전 요구 사항 시작하기 전에 다음이 준비되어 있는지 확인하십시오. 1. 소스가 구성된 Twilio Segment 워크스페이스 2. 소스의 Segment Write Key 3. API 접근이 가능한 Brevo 계정 4. API 자격 증명이 있는 Tajo 계정 ## 인증 ### Segment Write Key Segment는 각 소스에 연결된 고유 식별자인 Write Key를 사용하여 소스를 인증합니다. ```javascript // Write Key로 Analytics.js 초기화 analytics.load("YOUR_SEGMENT_WRITE_KEY"); ``` ### Tajo API 토큰 자격 증명으로 Tajo 커넥터를 구성합니다. ```bash tajo connectors install segment \ --write-key $SEGMENT_WRITE_KEY \ --workspace-slug your-workspace \ --brevo-api-key $BREVO_API_KEY ``` ## 구성 ### 기본 설정 ```yaml connectors: segment: enabled: true write_key: "your-segment-write-key" data_region: "us" # 또는 EU 워크스페이스의 경우 "eu" # 데이터 동기화 옵션 sync: identify: true track: true page: true group: false # Brevo 목록 할당 lists: all_contacts: 5 active_users: 6 high_value: 7 ``` ### 이벤트 매핑 Segment track 이벤트를 Brevo 이벤트 유형에 매핑합니다. ```yaml event_mapping: # Segment 이벤트 -> Brevo 이벤트 "Order Completed": "order_completed" "Product Viewed": "product_viewed" "Cart Updated": "cart_updated" "Signed Up": "customer_created" "Checkout Started": "checkout_started" # 맞춤 이벤트 "Feature Used": "feature_used" "Plan Upgraded": "plan_upgraded" ``` ### 특성 매핑 Segment identify 특성을 Brevo 연락처 속성에 매핑합니다. ```yaml trait_mapping: email: email firstName: FIRSTNAME lastName: LASTNAME phone: SMS plan: PLAN_TYPE company: COMPANY createdAt: SIGNUP_DATE lifetimeValue: LTV ``` ## API 엔드포인트 | 메서드 | 엔드포인트 | 설명 | | --- | --- | --- | | `POST` | `/v1/identify` | 특성으로 사용자 식별 | | `POST` | `/v1/track` | 이벤트 추적 | | `POST` | `/v1/page` | 페이지 뷰 기록 | | `POST` | `/v1/screen` | 화면 뷰 기록 | | `POST` | `/v1/group` | 사용자를 그룹과 연결 | | `POST` | `/v1/alias` | 두 사용자 아이덴티티 병합 | | `POST` | `/v1/batch` | 여러 메시지를 배치로 전송 | | `POST` | `/v1/import` | 과거 데이터 대량 가져오기 | ## 코드 예제 ### Tajo 대상으로 Segment 초기화 ```javascript import { TajoClient } from '@tajo/sdk'; const tajo = new TajoClient({ apiKey: process.env.TAJO_API_KEY, brevoApiKey: process.env.BREVO_API_KEY }); // Segment 소스 연결 await tajo.connectors.connect('segment', { writeKey: process.env.SEGMENT_WRITE_KEY, workspaceSlug: 'your-workspace' }); ``` ### Segment를 통한 이벤트 추적 ```javascript // 사용자 식별 - Brevo 연락처로 동기화됨 analytics.identify("user_123", { email: "jane@example.com", firstName: "Jane", lastName: "Kim", plan: "premium", lifetimeValue: 450.00 }); // 이벤트 추적 - Brevo로 전달됨 analytics.track("Order Completed", { orderId: "ORD-1234", revenue: 89.99, currency: "USD", products: [ { id: "SKU-001", name: "Widget", price: 89.99 } ] }); // 페이지 뷰 추적 analytics.page("Pricing", { title: "Pricing - Tajo", url: "https://tajo.io/pricing" }); ``` ### 서버 측 이벤트 전달 (Node.js) ```javascript const Analytics = require('analytics-node'); const analytics = new Analytics(process.env.SEGMENT_WRITE_KEY); // 데이터베이스에서 사용자 배치 식별 const users = await db.query('SELECT * FROM users WHERE updated_at > $1', [lastSync]); for (const user of users) { analytics.identify({ userId: user.id, traits: { email: user.email, firstName: user.first_name, lastName: user.last_name, totalOrders: user.order_count, lifetimeValue: user.ltv } }); } // 큐 플러시 await analytics.flush(); ``` ## 속도 제한 | 티어 | 제한 | 기간 | | --- | --- | --- | | **Free** | 1,000 이벤트/초 | 소스당 | | **Team** | 10,000 이벤트/초 | 소스당 | | **Business** | 맞춤 | 워크스페이스당 | | **Batch API** | 최대 500 KB | 요청당 | | **최대 배치 크기** | 100 이벤트 | 배치 호출당 | 배치 크기 제한 각 배치 요청에는 최대 100개의 이벤트를 포함할 수 있으며 500 KB를 초과해서는 안 됩니다. 대규모 과거 데이터 가져오기의 경우 Segment Bulk Import API를 사용하십시오. ## 문제 해결 | 문제 | 원인 | 해결 방법 | | --- | --- | --- | | Brevo에 이벤트가 나타나지 않음 | 대상이 활성화되지 않음 | Segment에서 Tajo 대상 활성화 | | 사용자 특성이 동기화되지 않음 | 이메일 식별자 누락 | identify 호출에 `email` 특성 포함 확인 | | 중복 연락처 | 여러 익명 ID | 아이덴티티 병합을 위한 적절한 `alias` 호출 구현 | | 이벤트 지연 | 높은 볼륨 큐 | Segment의 이벤트 배달 대시보드 확인 | | 스키마 위반 | 계획되지 않은 이벤트 | Segment Protocols 추적 계획 검토 | | 429 속도 제한 오류 | 너무 많은 요청 | 배치 처리 구현 또는 이벤트 빈도 감소 | ## 모범 사례 1. **track 전에 identify 사용** - 이벤트가 올바른 사용자에 귀속되도록 항상 `track` 전에 `identify` 호출 2. **추적 계획 구현** - 이벤트 스키마를 적용하기 위해 Segment Protocols 사용 3. **서버 측 호출 배치 처리** - HTTP 오버헤드를 줄이기 위해 서버 측 통합에 배치 API 사용 4. **특성을 명시적으로 매핑** - 기본값에 의존하지 말고 특성-속성 매핑 정의 5. **Segment Functions 사용** - Brevo에 도달하기 전에 이벤트를 전송 중에 변환 6. **이벤트 배달 모니터링** - 실패한 이벤트는 Segment의 Event Delivery 대시보드에서 확인 7. **Replay 설정** - 과거 이벤트 재처리를 위해 Segment Replay 활성화 ## 보안 - **TLS 암호화** - 모든 데이터는 HTTPS/TLS 1.2+를 통해 전송 - **Write Key 격리** - 각 소스는 자체 Write Key 보유 - **GDPR 준수** - Segment는 데이터 삭제 및 억제 요청 지원 - **SOC 2 Type II** - Segment는 SOC 2 Type II 인증을 받음 - **지역별 데이터 호스팅** - 데이터 레지던시 준수를 위한 EU 워크스페이스 옵션 ## 관련 리소스 - [Amplitude 커넥터](https://tajo.io/kr/docs/connectors/custom/amplitude) - [Mixpanel 커넥터](https://tajo.io/kr/docs/connectors/custom/mixpanel) - [고객 동기화 스킬](https://tajo.io/kr/docs/skills/data-sync/customer-sync) - [Brevo Events API](https://tajo.io/kr/docs/events-engagement/create-event)