إنشاء جهة اتصال
أضف عملاء جدداً إلى قاعدة بيانات جهات الاتصال في Brevo مع معلومات برنامج الولاء وسمات مخصّصة لتفاعل شخصي.
البداية السريعة
إنشاء جهة اتصال أساسية
POST https://api.brevo.com/v3/contactsContent-Type: application/jsonapi-key: YOUR_API_KEY
{ "attributes": { "FIRSTNAME": "John", "LASTNAME": "Doe", "LOYALTY_POINTS": 1500, "LOYALTY_TIER": "Gold", "SIGNUP_DATE": "2024-01-15", "LAST_PURCHASE": "2024-01-20", "TOTAL_SPENT": 299.99 }, "listIds": [1, 2], "updateEnabled": true}الاستجابة
{ "id": 123456}التكامل مع برنامج الولاء
عميل جديد مع سمات الولاء
{ "attributes": { "FIRSTNAME": "Sarah", "LASTNAME": "Johnson", "PHONE": "+1234567890", "LOYALTY_ID": "LYL-2024-001", "LOYALTY_POINTS": 0, "LOYALTY_TIER": "Bronze", "PREFERRED_REWARDS": "Discounts", "BIRTHDAY": "1990-05-15", "SIGNUP_SOURCE": "Website", "REFERRAL_CODE": "REF-12345", "COMMUNICATION_PREFERENCES": "Email,SMS", "PURCHASE_CATEGORIES": ["Electronics", "Fashion"], "AVERAGE_ORDER_VALUE": 0 }, "listIds": [1], // New customers list "emailBlacklisted": false, "smsBlacklisted": false, "updateEnabled": true}تحديث عميل موجود
{ "attributes": { "LOYALTY_POINTS": 2500, "LOYALTY_TIER": "Platinum", "LAST_PURCHASE": "2024-01-25", "TOTAL_SPENT": 1299.99, "RECENT_PURCHASES": ["Product A", "Product B"], "ENGAGEMENT_SCORE": 8.5, "LAST_EMAIL_OPENED": "2024-01-24", "PREFERRED_CONTACT_TIME": "Evening" }, "listIds": [1, 3], // Add to platinum customers list "updateEnabled": true}السمات الخاصّة بـ Tajo
بيانات ولاء العميل
| اسم السمة | النوع | الوصف |
|---|---|---|
LOYALTY_ID | نص | معرّف فريد لبرنامج الولاء |
LOYALTY_POINTS | رقم | رصيد النقاط الحالي |
LOYALTY_TIER | نص | المستوى الحالي (Bronze، Silver، Gold، Platinum) |
POINTS_EARNED_YTD | رقم | النقاط المكتسبة هذا العام |
POINTS_REDEEMED_YTD | رقم | النقاط المستبدلة هذا العام |
TIER_PROGRESS | رقم | التقدّم نحو المستوى التالي (%) |
NEXT_TIER_POINTS | رقم | النقاط اللازمة للمستوى التالي |
سلوك الشراء
| اسم السمة | النوع | الوصف |
|---|---|---|
TOTAL_SPENT | رقم | القيمة مدى الحياة |
AVERAGE_ORDER_VALUE | رقم | متوسّط قيمة الشراء |
PURCHASE_FREQUENCY | نص | مدى تكرار الشراء |
LAST_PURCHASE | تاريخ | تاريخ آخر عملية شراء |
FAVORITE_CATEGORIES | مصفوفة | فئات المنتجات المفضّلة |
SEASONAL_BUYER | قيمة منطقية | يتسوّق موسمياً |
مقاييس التفاعل
| اسم السمة | النوع | الوصف |
|---|---|---|
ENGAGEMENT_SCORE | رقم | تقييم التفاعل من 1 إلى 10 |
EMAIL_OPEN_RATE | رقم | نسبة الفتح الشخصية % |
CLICK_THROUGH_RATE | رقم | نسبة CTR الشخصية % |
LAST_EMAIL_OPENED | تاريخ | آخر تفاعل مع البريد الإلكتروني |
PREFERRED_CHANNEL | نص | البريد الإلكتروني، SMS، واتساب |
إنشاء جهات اتصال دفعةً واحدة
أنشئ عدّة جهات اتصال في وقت واحد:
{ "contacts": [ { "attributes": { "FIRSTNAME": "Alice", "LOYALTY_POINTS": 500, "LOYALTY_TIER": "Bronze" } }, { "attributes": { "FIRSTNAME": "Bob", "LOYALTY_POINTS": 1200, "LOYALTY_TIER": "Silver" } } ], "listIds": [1], "updateEnabled": true}معالجة الأخطاء
الأخطاء الشائعة وحلولها:
{ "code": "duplicate_parameter", "message": "Contact already exists", "details": { "existingId": 123456 }}{ "code": "invalid_parameter", "message": "Invalid list ID", "details": { "listIds": [999] }}أفضل الممارسات في Tajo
- ضمِّن دائماً حقول الولاء الأساسية: LOYALTY_POINTS وLOYALTY_TIER وLOYALTY_ID
- فعِّل التحديث: اسمح بتحديث جهات الاتصال الموجودة
- استخدم قوائم التقسيم: نظِّم حسب المستوى والسلوك والتفضيلات
- تتبّع التفاعل: راقب معدّلات التفاعل مع البريد الإلكتروني وSMS
- مزامنة منتظمة للبيانات: أبقِ بيانات الولاء محدَّثة مع نظامك
الخطوات التالية
- تحديث سمات جهة الاتصال
- إدارة قوائم جهات الاتصال
- إعداد سمات مخصّصة
- استيراد جهات اتصال بالجملة