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

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

إنشاء جهة اتصال

أضف عملاء جدداً إلى قاعدة بيانات جهات الاتصال في Brevo مع معلومات برنامج الولاء وسمات مخصّصة لتفاعل شخصي.

البداية السريعة

إنشاء جهة اتصال أساسية

POST https://api.brevo.com/v3/contacts
Content-Type: application/json
api-key: YOUR_API_KEY
{
"email": "[email protected]",
"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
}

التكامل مع برنامج الولاء

عميل جديد مع سمات الولاء

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

تحديث عميل موجود

{
"email": "[email protected]",
"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": [
{
"email": "[email protected]",
"attributes": {
"FIRSTNAME": "Alice",
"LOYALTY_POINTS": 500,
"LOYALTY_TIER": "Bronze"
}
},
{
"email": "[email protected]",
"attributes": {
"FIRSTNAME": "Bob",
"LOYALTY_POINTS": 1200,
"LOYALTY_TIER": "Silver"
}
}
],
"listIds": [1],
"updateEnabled": true
}

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

الأخطاء الشائعة وحلولها:

{
"code": "duplicate_parameter",
"message": "Contact already exists",
"details": {
"email": "[email protected]",
"existingId": 123456
}
}
{
"code": "invalid_parameter",
"message": "Invalid list ID",
"details": {
"listIds": [999]
}
}

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

  1. ضمِّن دائماً حقول الولاء الأساسية: LOYALTY_POINTS وLOYALTY_TIER وLOYALTY_ID
  2. فعِّل التحديث: اسمح بتحديث جهات الاتصال الموجودة
  3. استخدم قوائم التقسيم: نظِّم حسب المستوى والسلوك والتفضيلات
  4. تتبّع التفاعل: راقب معدّلات التفاعل مع البريد الإلكتروني وSMS
  5. مزامنة منتظمة للبيانات: أبقِ بيانات الولاء محدَّثة مع نظامك

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

  • تحديث سمات جهة الاتصال
  • إدارة قوائم جهات الاتصال
  • إعداد سمات مخصّصة
  • استيراد جهات اتصال بالجملة

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

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

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

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