이벤트 생성
고객의 상호작용, 구매, 로열티 프로그램 활동을 추적해 개인화된 고객 참여와 리워드 지급으로 연결합니다.
빠른 시작
기본 이벤트 추적
POST https://api.brevo.com/v3/eventsContent-Type: application/jsonapi-key: YOUR_API_KEY
{ "event": "Purchase Completed", "properties": { "order_id": "ORD-2024-001", "amount": 149.99, "currency": "USD", "products": ["Product A", "Product B"], "points_earned": 150, "loyalty_tier": "Gold" }}응답
{ "success": true, "eventId": "evt_abc123"}로열티 프로그램 이벤트
구매 이벤트
포인트를 적립하고 로열티 등급을 갱신하려면 다음과 같이 구매 이벤트를 추적합니다.
{ "event": "Purchase Completed", "properties": { "order_id": "ORD-2024-001", "order_total": 299.99, "currency": "USD", "payment_method": "Credit Card", "products": [ { "id": "PROD-001", "name": "Premium Widget", "category": "Electronics", "price": 149.99, "quantity": 2 } ], "points_earned": 300, "bonus_points": 50, "points_multiplier": 1.2, "loyalty_tier_before": "Silver", "loyalty_tier_after": "Gold", "tier_upgraded": true, "shipping_cost": 9.99, "discount_applied": 29.99, "coupon_code": "SAVE10" }, "eventdate": "2024-01-25T14:30:00Z"}포인트 사용
고객이 로열티 포인트를 사용하는 시점과 사용 내역을 추적합니다.
{ "event": "Points Redeemed", "properties": { "points_redeemed": 1000, "reward_type": "Discount", "reward_value": 50.00, "reward_description": "$50 Off Next Purchase", "coupon_generated": "LOYALTY50", "expiry_date": "2024-03-25", "remaining_points": 750, "redemption_source": "Mobile App" }}계정 활동
계정 생성과 같이 계정과 관련된 활동을 추적합니다.
{ "event": "Account Created", "properties": { "signup_source": "Website", "referral_code": "REF-12345", "welcome_bonus": 500, "initial_tier": "Bronze", "marketing_consent": true, "sms_consent": false, "preferred_categories": ["Fashion", "Electronics"] }}참여 이벤트
개인화에 활용할 수 있도록 고객의 참여 활동을 추적합니다.
{ "event": "Email Opened", "properties": { "campaign_id": "CAMP-001", "campaign_name": "Weekly Offers", "subject_line": "Exclusive Deals Just for You!", "open_time": "2024-01-25T09:15:00Z", "device": "Mobile", "email_client": "Gmail", "location": "New York, NY" }}Tajo를 위한 이커머스 이벤트
장바구니 이벤트
{ "event": "Product Added to Cart", "properties": { "product_id": "PROD-123", "product_name": "Smart Watch", "category": "Electronics", "price": 299.99, "cart_total": 459.98, "cart_items_count": 2, "potential_points": 460 }}{ "event": "Cart Abandoned", "properties": { "cart_value": 459.98, "items_count": 2, "potential_points_lost": 460, "abandonment_stage": "Checkout", "time_in_cart": "25 minutes" }}탐색 이벤트
{ "event": "Product Viewed", "properties": { "product_id": "PROD-456", "product_name": "Wireless Headphones", "category": "Electronics", "price": 199.99, "view_duration": "45 seconds", "referrer": "Search Results", "loyalty_discount_shown": true }}로열티 전용 이벤트
{ "event": "Tier Upgraded", "properties": { "previous_tier": "Silver", "new_tier": "Gold", "points_balance": 2500, "benefits_unlocked": ["Free Shipping", "Priority Support"], "next_tier": "Platinum", "points_to_next_tier": 1500 }}{ "event": "Reward Earned", "properties": { "reward_type": "Birthday Bonus", "points_awarded": 500, "trigger": "Birthday", "total_points": 3000, "tier_progress": 75 }}이벤트 속성 가이드라인
필수 속성
| 속성 | 타입 | 설명 |
|---|---|---|
email | String | 고객의 이메일 주소입니다 (필수) |
event | String | 이벤트의 이름입니다 (필수) |
properties | Object | 이벤트에 따라 달라지는 데이터입니다 |
로열티에 권장되는 속성
| 속성 | 타입 | 설명 |
|---|---|---|
customer_id | String | 내부 시스템의 고객 ID입니다 |
loyalty_id | String | 로열티 프로그램의 회원 ID입니다 |
points_balance | Number | 이벤트 반영 이후의 현재 포인트 잔액입니다 |
loyalty_tier | String | 고객의 현재 로열티 등급입니다 |
event_value | Number | 이벤트가 지니는 금전적 가치입니다 |
고급 이벤트 추적
커스텀 이벤트 속성
{ "event": "Product Review Submitted", "properties": { "product_id": "PROD-789", "rating": 5, "review_length": "detailed", "verified_purchase": true, "points_earned": 25, "review_bonus": true, "helpful_votes": 0 }}이벤트 일괄 생성
{ "events": [ { "event": "Purchase Completed", "properties": { "order_id": "ORD-001", "amount": 99.99 } }, { "event": "Points Redeemed", "properties": { "points_used": 500, "reward": "Free Shipping" } } ]}오류 처리
{ "code": "invalid_event", "message": "Event name must be a non-empty string", "details": { "field": "event", "value": "" }}Tajo 모범 사례
- 일관된 이벤트 이름: 표준 명명 규칙을 사용하세요
- 풍부한 속성: 모든 이벤트에 로열티 관련 데이터를 포함하세요
- 실시간 추적: 이벤트가 발생한 즉시 전송하세요
- 고객 여정: 구매와 참여 퍼널 전체를 추적하세요
- 세그먼테이션 데이터: 타기팅에 도움이 되는 속성을 포함하세요
다음 단계
- 이벤트 기반 자동화 설정하기
- 이메일 참여도 추적하기
- 로열티 워크플로 구성하기
- 이벤트 분석 보기