إنشاء حدث
تتبّع تفاعلات العملاء ومشترياتهم وأنشطتهم داخل برنامج الولاء لدفع التفاعل المخصّص والمكافآت.
بداية سريعة
تتبّع حدث أساسي
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 | معرّف العميل الداخلي |
loyalty_id | String | معرّف برنامج الولاء |
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
- أسماء أحداث متّسقة: التزم باصطلاحات تسمية موحّدة
- خصائص غنية: ضمّن البيانات المتعلّقة ببرنامج الولاء في كل حدث
- تتبّع فوري: أرسل الأحداث فور وقوعها
- رحلة العميل: تتبّع مسار الشراء والتفاعل كاملًا
- بيانات التقسيم: ضمّن السمات التي تساعد على الاستهداف
الخطوات التالية
- إعداد الأتمتة المبنية على الأحداث
- تتبّع التفاعل مع البريد الإلكتروني
- ضبط عمليات سير عمل الولاء
- عرض تحليلات الأحداث