‏واجهة API التحويلات‏

مواصفات حمولة البيانات

يؤدي دمج نظام إدارة علاقات العملاء (CRM) مع واجهة API التحويلات في Meta واستخدام هدف تحسين بيانات العملاء المحتملين للتحويل بالنسبة لإعلانات تجميع بيانات العملاء المحتملين إلى تحقيق نتائج أفضل. في الوقت الحالي، لا يدعم هذا التحسين إلا إعلانات تجميع بيانات العملاء المحتملين الأصلية (النماذج الفورية) التي تم إنشاؤها على فيسبوك أو Instagram.

يقدم هذا الدليل مواصفات حمولة البيانات لأحداث إدارة علاقات العملاء (CRM) التي تم تحميلها لتحسين بيانات العملاء المحتملين نتيجة التحويل فقط. لا تستخدم هذه المواصفات للأحداث التي لا تتعلق بهذا التحسين.

لمزيد من المعلومات حول بدء استخدام API وغيرها من الموارد المفيدة، يمكنك الرجوع إلى وثائق واجهة API التحويلات.

حمولة بيانات الحدث

المعلمات

الاسمالوصف

lead_id

integer (عدد صحيح)

مطلوب.
معرف فيسبوك الذي تم إنشاؤه لكل عميل محتمل. عبارة عن تعداد مكون من 15 أو 16 رقمًا تم الحصول عليه من الحقل leadgen_id في حدث Webhook لتجميع بيانات العملاء المحتملين ومضمن في المعلمة user_data. يرجى الرجوع إلى العثور على معرف بيانات العميل المحتمل لمزيد من المعلومات.
يتعين استخدام معرفات بيانات العملاء المحتملين بدلاً من معلومات العملاء للمطابقة. استخدم متغيرًا لإدخاله في قيم المعرف من نظام إدارة علاقات العملاء.
ملاحظة: التجزئة غير مطلوبة.

event_name

string (سلسلة)

مطلوب.
حقل نموذجي حر لتسجيل المراحل التي تستخدمها ضمن إدارة علاقات العملاء.
تأكد من إرسال كل المراحل بينما يتم تحديثها، بما في ذلك مرحلة تجميع بيانات العملاء المحتملين الأولية.
على سبيل المثال، قد تتضمن المراحل الأنواع التالية. إذا وصلت بيانات عميل محتمل إلى مرحلة "تم التحويل" النهائية، فمن المفترض أن يتم إرسال كل المراحل السابقة قبل ذلك.

  1. بيانات العميل المحتمل الأولية من فيسبوك
  2. بيانات العملاء المحتملين المؤهلة للتسويق
  3. فرصة المبيعات
  4. تم التحويل

استخدم متغيرًا لإدخاله في المراحل من نظام إدارة علاقات العملاء. بدلاً من ذلك، يمكنك إنشاء استدعاء API منفصل لكل مرحلة.

event_time

integer (عدد صحيح)

مطلوب.
بتنسيق Unix بالثوان يشير إلى وقت تحديث حدث تحديث مرحلة بيانات العميل المحتمل بواسطة إدارة علاقات العملاء.
استخدم متغيرًا لإدخال قيم الطابع الزمني بتنسيق Unix من قاعدة البيانات.
ملاحظة: يمكن أن تصل قيمة المعلمة event_time إلى 7 أيام كحد أقصى قبل أن تتمكن من إرسال حدث إلى Meta. كما يجب أن يحدث الطابع الزمني بعد وقت تجميع بيانات العملاء المحتملين وإلا فقد يتم تجاهل الحدث.

action_source

string (سلسلة)

مطلوب.
قم بتعيين هذه المعلمة على القيمة system_generated لجميع أحداث العملاء المحتملين للتحويل.
بالنسبة لعمليات دمج بيانات العملاء المحتملين للتحويل، يحدد هذا المكان الذي يتم إنشاء تحويلاتك فيه.

lead_event_source

string (سلسلة)

مطلوب.
قم بتعيين هذه المعلمة على اسم الأداة التي توفر بيانات العملاء المحتملين (مثل، Hubspot وSAP وOracle وDynamics ونظام إدارة علاقات العملاء الداخلي، وغير ذلك)، ويتم تضمينه في المعلمة custom_data.

event_source

string (سلسلة)

مطلوب.
قم بتعيين هذه المعلمة على القيمة crm لجميع أحداث العملاء المحتملين للتحويل.
بالنسبة لدمج العملاء المحتملين للتحويل، يحدد هذا مصدر الحدث ليكون نظام إدارة علاقات العملاء ضمن المعلمة custom_data.

مثال

يوضح هذا المثال تنسيق حمولة بيانات الحدث المُرسلة في استدعاء واجهة API.

{
    "event_name": "my lead stage",
    "event_time": 1617693833,
    "user_data": {
        "lead_id": 1234567890123456
    },
    "action_source": "system_generated",
    "custom_data": {
        "lead_event_source": "Salesforce",
        "event_source": "crm"
    }
}

معرفة المزيد