---
title: "이벤트 생성 | Tajo"
description: "로열티 프로그램 참여와 개인화를 위해 고객 이벤트를 추적합니다"
url: https://tajo.io/kr/docs/events-engagement/create-event/
markdown: https://tajo.io/kr/docs/events-engagement/create-event.md
lang: ko-KR
author: "Set Noa"
author_url: https://tajo.io/kr/set-noa/
robots: noindex
---

Tajo 사전 이용 신청

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

# 이벤트 생성

[Set Noa](https://tajo.io/kr/set-noa/)

고객의 상호작용, 구매, 로열티 프로그램 활동을 추적해 개인화된 고객 참여와 리워드 지급으로 연결합니다.

## 빠른 시작

### 기본 이벤트 추적

```http
POST https://api.brevo.com/v3/events
Content-Type: application/json
api-key: YOUR_API_KEY

{
  "email": "customer@example.com",
  "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"
  }
}
```

### 응답

```json
{
  "success": true,
  "eventId": "evt_abc123"
}
```

## 로열티 프로그램 이벤트

### 구매 이벤트

포인트를 적립하고 로열티 등급을 갱신하려면 다음과 같이 구매 이벤트를 추적합니다.

```json
{
  "email": "customer@example.com",
  "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"
}
```

### 포인트 사용

고객이 로열티 포인트를 사용하는 시점과 사용 내역을 추적합니다.

```json
{
  "email": "customer@example.com",
  "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"
  }
}
```

### 계정 활동

계정 생성과 같이 계정과 관련된 활동을 추적합니다.

```json
{
  "email": "customer@example.com",
  "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"]
  }
}
```

### 참여 이벤트

개인화에 활용할 수 있도록 고객의 참여 활동을 추적합니다.

```json
{
  "email": "customer@example.com",
  "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를 위한 이커머스 이벤트

### 장바구니 이벤트

```json
{
  "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
  }
}
```

```json
{
  "event": "Cart Abandoned",
  "properties": {
    "cart_value": 459.98,
    "items_count": 2,
    "potential_points_lost": 460,
    "abandonment_stage": "Checkout",
    "time_in_cart": "25 minutes"
  }
}
```

### 탐색 이벤트

```json
{
  "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
  }
}
```

### 로열티 전용 이벤트

```json
{
  "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
  }
}
```

```json
{
  "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 | 이벤트가 지니는 금전적 가치입니다 |

## 고급 이벤트 추적

### 커스텀 이벤트 속성

```json
{
  "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
  }
}
```

### 이벤트 일괄 생성

```json
{
  "events": [
    {
      "email": "customer1@example.com",
      "event": "Purchase Completed",
      "properties": { "order_id": "ORD-001", "amount": 99.99 }
    },
    {
      "email": "customer2@example.com",
      "event": "Points Redeemed",
      "properties": { "points_used": 500, "reward": "Free Shipping" }
    }
  ]
}
```

## 오류 처리

```json
{
  "code": "invalid_event",
  "message": "Event name must be a non-empty string",
  "details": {
    "field": "event",
    "value": ""
  }
}
```

## Tajo 모범 사례

1. **일관된 이벤트 이름**: 표준 명명 규칙을 사용하세요
2. **풍부한 속성**: 모든 이벤트에 로열티 관련 데이터를 포함하세요
3. **실시간 추적**: 이벤트가 발생한 즉시 전송하세요
4. **고객 여정**: 구매와 참여 퍼널 전체를 추적하세요
5. **세그먼테이션 데이터**: 타기팅에 도움이 되는 속성을 포함하세요

## 다음 단계

- [이벤트 기반 자동화 설정하기](https://tajo.io/kr/docs/automation/)
- 이메일 참여도 추적하기
- 로열티 워크플로 구성하기
- 이벤트 분석 보기