연락처 생성
로열티 프로그램 정보와 맞춤 속성을 함께 담아 Brevo 연락처 데이터베이스에 신규 고객을 추가하고, 개인화된 인게이지먼트에 활용합니다.
빠른 시작
기본 연락처 생성
POST https://api.brevo.com/v3/contactsContent-Type: application/jsonapi-key: YOUR_API_KEY
{ "attributes": { "FIRSTNAME": "John", "LASTNAME": "Doe", "LOYALTY_POINTS": 1500, "LOYALTY_TIER": "Gold", "SIGNUP_DATE": "2024-01-15", "LAST_PURCHASE": "2024-01-20", "TOTAL_SPENT": 299.99 }, "listIds": [1, 2], "updateEnabled": true}응답
{ "id": 123456}로열티 프로그램 연동
로열티 속성을 가진 신규 고객
{ "attributes": { "FIRSTNAME": "Sarah", "LASTNAME": "Johnson", "PHONE": "+1234567890", "LOYALTY_ID": "LYL-2024-001", "LOYALTY_POINTS": 0, "LOYALTY_TIER": "Bronze", "PREFERRED_REWARDS": "Discounts", "BIRTHDAY": "1990-05-15", "SIGNUP_SOURCE": "Website", "REFERRAL_CODE": "REF-12345", "COMMUNICATION_PREFERENCES": "Email,SMS", "PURCHASE_CATEGORIES": ["Electronics", "Fashion"], "AVERAGE_ORDER_VALUE": 0 }, "listIds": [1], // New customers list "emailBlacklisted": false, "smsBlacklisted": false, "updateEnabled": true}기존 고객 업데이트
{ "attributes": { "LOYALTY_POINTS": 2500, "LOYALTY_TIER": "Platinum", "LAST_PURCHASE": "2024-01-25", "TOTAL_SPENT": 1299.99, "RECENT_PURCHASES": ["Product A", "Product B"], "ENGAGEMENT_SCORE": 8.5, "LAST_EMAIL_OPENED": "2024-01-24", "PREFERRED_CONTACT_TIME": "Evening" }, "listIds": [1, 3], // Add to platinum customers list "updateEnabled": true}Tajo 전용 속성
고객 로열티 데이터
| 속성 이름 | 타입 | 설명 |
|---|---|---|
LOYALTY_ID | String | 고유한 로열티 프로그램 ID |
LOYALTY_POINTS | Number | 현재 포인트 잔액 |
LOYALTY_TIER | String | 현재 등급 (Bronze, Silver, Gold, Platinum) |
POINTS_EARNED_YTD | Number | 올해 적립한 포인트 |
POINTS_REDEEMED_YTD | Number | 올해 사용한 포인트 |
TIER_PROGRESS | Number | 다음 등급까지의 진행률 (%) |
NEXT_TIER_POINTS | Number | 다음 등급에 필요한 포인트 |
구매 행동
| 속성 이름 | 타입 | 설명 |
|---|---|---|
TOTAL_SPENT | Number | 고객 생애 가치 |
AVERAGE_ORDER_VALUE | Number | 평균 구매 금액 |
PURCHASE_FREQUENCY | String | 구매 빈도 |
LAST_PURCHASE | Date | 마지막 구매일 |
FAVORITE_CATEGORIES | Array | 선호하는 상품 카테고리 |
SEASONAL_BUYER | Boolean | 시즌별로 구매하는지 여부 |
인게이지먼트 지표
| 속성 이름 | 타입 | 설명 |
|---|---|---|
ENGAGEMENT_SCORE | Number | 1~10 단계의 인게이지먼트 점수 |
EMAIL_OPEN_RATE | Number | 개인별 오픈율 (%) |
CLICK_THROUGH_RATE | Number | 개인별 클릭률 (%) |
LAST_EMAIL_OPENED | Date | 마지막 이메일 상호작용 |
PREFERRED_CHANNEL | String | 이메일, SMS, WhatsApp |
연락처 일괄 생성
여러 연락처를 한 번에 생성합니다.
{ "contacts": [ { "attributes": { "FIRSTNAME": "Alice", "LOYALTY_POINTS": 500, "LOYALTY_TIER": "Bronze" } }, { "attributes": { "FIRSTNAME": "Bob", "LOYALTY_POINTS": 1200, "LOYALTY_TIER": "Silver" } } ], "listIds": [1], "updateEnabled": true}오류 처리
자주 발생하는 오류와 해결 방법입니다.
{ "code": "duplicate_parameter", "message": "Contact already exists", "details": { "existingId": 123456 }}{ "code": "invalid_parameter", "message": "Invalid list ID", "details": { "listIds": [999] }}Tajo 모범 사례
- 핵심 로열티 필드를 항상 포함하기: LOYALTY_POINTS, LOYALTY_TIER, LOYALTY_ID
- 업데이트 허용 설정: 기존 연락처의 업데이트를 허용합니다
- 세그먼테이션 리스트 활용: 등급, 행동, 선호도별로 정리합니다
- 인게이지먼트 추적: 이메일과 SMS 상호작용 비율을 모니터링합니다
- 정기적인 데이터 동기화: 로열티 데이터를 자사 시스템과 최신 상태로 유지합니다
다음 단계
- 연락처 속성 업데이트
- 연락처 리스트 관리
- 맞춤 속성 설정
- 연락처 일괄 가져오기