Đăng ký quyền truy cập sớm

Nhập tên của bạn cùng email hoặc số điện thoại. Chúng tôi sẽ liên hệ và gửi thông tin truy cập Tajo.

Create Event

Track customer interactions, purchases, and loyalty program activities to drive personalized engagement and rewards.

Quick Start

Basic Event Tracking

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

{
  "email": "[email protected]",
  "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"
  }
}

Response

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

Loyalty Program Events

Purchase Events

Track purchases to award points and update loyalty status:

{
  "email": "[email protected]",
  "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"
}

Points Redemption

Track when customers redeem loyalty points:

{
  "email": "[email protected]",
  "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"
  }
}

Account Activities

Track account-related activities:

{
  "email": "[email protected]",
  "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"]
  }
}

Engagement Events

Track customer engagement for personalization:

{
  "email": "[email protected]",
  "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"
  }
}

Ecommerce Events for Tajo

Cart Events

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

Browse Events

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

Loyalty-Specific Events

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

Event Properties Guidelines

Required Properties

Property	Type	Description
`email`	String	Customer email (required)
`event`	String	Event name (required)
`properties`	Object	Event-specific data

Recommended Properties for Loyalty

Property	Type	Description
`customer_id`	String	Internal customer ID
`loyalty_id`	String	Loyalty program ID
`points_balance`	Number	Current points after event
`loyalty_tier`	String	Current tier
`event_value`	Number	Monetary value of event

Advanced Event Tracking

Custom Event Properties

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

Batch Event Creation

{
  "events": [
    {
      "email": "[email protected]",
      "event": "Purchase Completed",
      "properties": { "order_id": "ORD-001", "amount": 99.99 }
    },
    {
      "email": "[email protected]",
      "event": "Points Redeemed",
      "properties": { "points_used": 500, "reward": "Free Shipping" }
    }
  ]
}

Error Handling

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

Best Practices for Tajo

Consistent Event Names: Use standard naming conventions
Rich Properties: Include loyalty-relevant data in every event
Real-time Tracking: Send events immediately after they occur
Customer Journey: Track complete purchase and engagement funnel
Segmentation Data: Include attributes that help with targeting

Next Steps

Set up Event-based Automation
Track Email Engagement
Configure Loyalty Workflows
View Event Analytics