اطلب الوصول المبكر

أدخل اسمك الأول وبريدك الإلكتروني أو رقم هاتفك. سنتواصل معك لتزويدك بتفاصيل الوصول إلى Tajo.

إنشاء حدث

تتبّع تفاعلات العملاء ومشترياتهم وأنشطتهم داخل برنامج الولاء لدفع التفاعل المخصّص والمكافآت.

بداية سريعة

تتبّع حدث أساسي

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

الاستجابة

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

أحداث برنامج الولاء

أحداث الشراء

تتبّع المشتريات لمنح النقاط وتحديث حالة الولاء:

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

استبدال النقاط

تتبّع لحظة استبدال العملاء لنقاط الولاء:

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

أنشطة الحساب

تتبّع الأنشطة المرتبطة بالحساب:

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

أحداث التفاعل

تتبّع تفاعل العملاء من أجل تخصيص التجربة:

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

أحداث التجارة الإلكترونية في 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
}
}

إرشادات خصائص الأحداث

الخصائص المطلوبة

الخاصيةالنوعالوصف
emailStringالبريد الإلكتروني للعميل (مطلوب)
eventStringاسم الحدث (مطلوب)
propertiesObjectبيانات خاصة بالحدث

الخصائص المُوصى بها لبرنامج الولاء

الخاصيةالنوعالوصف
customer_idStringمعرّف العميل الداخلي
loyalty_idStringمعرّف برنامج الولاء
points_balanceNumberرصيد النقاط بعد الحدث
loyalty_tierStringالمستوى الحالي
event_valueNumberالقيمة المالية للحدث

تتبّع الأحداث المتقدّم

خصائص أحداث مخصّصة

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

معالجة الأخطاء

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

أفضل الممارسات في Tajo

  1. أسماء أحداث متّسقة: التزم باصطلاحات تسمية موحّدة
  2. خصائص غنية: ضمّن البيانات المتعلّقة ببرنامج الولاء في كل حدث
  3. تتبّع فوري: أرسل الأحداث فور وقوعها
  4. رحلة العميل: تتبّع مسار الشراء والتفاعل كاملًا
  5. بيانات التقسيم: ضمّن السمات التي تساعد على الاستهداف

الخطوات التالية

اطلب الوصول المبكر

أدخل اسمك الأول وبريدك الإلكتروني أو رقم هاتفك. سنتواصل معك لتزويدك بتفاصيل الوصول إلى Tajo.

اكتشاف تلقائي
مساعد AI

مرحباً! اسألني أي شيء عن الوثائق.