واجهة API التحويلات لبرنامج إدارة علاقات العملاء: الدمج كمنصة

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

المتطلبات الأساسية

لتخطيط مشروعك، يمكنك استخدام الجدول الزمني التقديري كدليل. ملاحظة:

1. قد تستغرق مرحلة الدمج، أو التطوير الفعلي من جانب الشريك، حوالي 3 إلى 7 أسابيع. بعد تنفيذ الدمج، قد يستغرق الأمر من شهر ونصف إلى شهرين حتى يتم تأهيل المعلن لتشغيل حملات إعلانات العملاء المحتملين من التحويل المحسّنة بالكامل.
2. يعتمد الجدول الزمني أدناه على البيانات القديمة. قد يختلف الجدول الزمني الفعلي بناءً على الموارد المتوفرة وسرعة حل المشكلة وغير ذلك.

*يمكن للمعلنين تشغيل حملات إعلانات العملاء المحتملين من التحويل أثناء فترة التعلم، ولكنهم لن يستفيدوا من تحسين الأداء الكامل حتى اكتمالها.

دليل الدمج

الخطوة الأولى: المتطلبات الأساسية

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

• مدير الأعمال
• تطبيق Meta يرجى ملاحظة أن تطبيقك يحتاج إلى الخضوع لعملية مراجعة التطبيقات. أثناء هذه العملية، يجب الحصول على صلاحية الوصول المتقدم للأذونات ads_management وpages_read_engagement وads_read وpages_show_list وbusiness_management والوصول القياس لإدارة الإعلانات. يرجى الاطلاع أدناه على مزيد من الإرشادات حول كيفية القيام بذلك
• مجموعة بيانات إدارة علاقات العملاء في Meta (المشار إليها سابقًا باسم بيكسل). مجموعة بيانات إدارة علاقات العملاء مطلوبة لواجهة API التحويلات لبرنامج إدارة علاقات العملاء. ستبلغ مجموعة بيانات إدارة علاقات العملاء النظام أنه سيتم تحميل أحداث إدارة علاقات العملاء إليها وإضافة سير عمل تحسين العملاء المحتملين الواردين من التحويل إلى مجموعة البيانات التي تعمل على تحسين جودة العملاء المحتملين.

الخطوة الثانية: المصادقة

يتوفر لدى الشركاء خياري المصادقة التاليين لمجموعات البيانات التي لا تديرها:

الخيار الأول - ملحق Meta للأعمال (MBE، موصى به)

يوفر ملحق MBE نقطة نهاية لاسترداد رموز وصول مستخدم النظام التي تم إنشاؤها في مدير الأعمال الخاص بالمعلن. أكمل كل المتطلبات لتنفيذ ملحق MBE.

تأكد من أنك:

• حصلت على manage_business_extension لتطبيقك - هذا إذن خاص يتطلب من ممثل Meta إضافة تطبيقك إلى قائمة السماح
• قمت بتعيين قيمة معلمة القناة في تكوين الإعداد كـ CONVERSIONS_API
• قادر على استلام استجابة حدث webhook عند إكمال التأهيل
• تستخدم رمز الوصول الذي تم إرجاعه عبر ملحق MBE وتحويله إلى رمز وصول مستخدم النظام عن طريق تنفيذ استدعاء API إضافي
• قد حفظت نسخة من external_business_id، وpixel_id (الذي يمثل معرف مجموعة البيانات)، وbusiness_id ورمز وصول مستخدم النظام في نظامك
• حصلت على موافقة لدمج ملحق MBE

الخيار الثاني - رمز وصول مستخدم نظام العميل

باستخدام هذا الخيار، يمكن للشركاء تمكين المعلنين من:

• إنشاء رمز وصول مستخدم النظام يدويًا عبر واجهة API التحويلات داخل الإعدادات في مدير الأحداث من Meta (EM)
• مشاركة pixel_id (الذي يمثل معرف مجموعة البيانات)، وbusiness_id ورمز وصول مستخدم النظام مع الشريك وحفظ نسخة منه

الخطوة الثالثة: دمج API

يمكن للشركاء بعد ذلك استدعاء نقطة نهاية واجهة API التحويلات لإرسال حمولة بيانات الحدث. الخطوات الرئيسية التي يجب مراعاتها:

العثور على معرف بيانات العميل المحتمل

lead_id هو معرف محدد مسبقًا مرتبط بالعملاء المحتملين الذين تم تجميع بياناتهم من حملات إعلانات تجميع بيانات العملاء المحتملين التي يتم تشغيلها على فيسبوك أو Instagram. توجد العديد من الطرق للعثور على معرف بيانات العميل المحتمل من Meta. يوصى بأن يستخدم الشركاء القراءة المجمعة لحدث Webhook أو Graph API للعثور على معرف بيانات العميل المحتمل.

إضافة سلسلة partner_agent للإسناد

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

مثال

إذا كان معرف المنصة هو datapartner، فستكون هذه عينة من حمولة بيانات الحدث التي يتم إرسالها نيابةً عن العميل:

{
    "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"
    },
   "partner_agent": "datapartner"
}

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

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

تأكد من استخدام القيمة الصحيحة لـ action_source من أحداث واجهة API التحويلات لبرنامج إدارة علاقات العملاء، والتي تكون action_source = system_generated

إرسال كل مراحل تجميع بيانات العملاء المحتملين، بما في ذلك مرحلة التجميع الأولية

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

تأكد من إرسال مرحلة تجميع بيانات العميل المحتمل الأولى (أي حدث تجميع بيانات العملاء المحتملين الأولي) حيث سيُعلم ذلك النظام بأن بيانات العميل المحتمل قد تم استلامها ومعالجتها.

يجب إرسال ما لا يقل عن مرحلتين للأحداث من مسار المبيعات لديك، بما في ذلك حدث تجميع بيانات العملاء المحتملين الأولي. يوصى بإرسال ثلاث مراحل أو أكثر إذا أمكن.

التعيين لمراحل تجميع بيانات العملاء المحتملين في إدارة علاقات العملاء

إذا كان المعلنون لديك يستخدمون أنظمة مختلفة لإدارة علاقات العملاء، فتأكد من أنك قادر على تعيين المعلمات من مصادر بيانات مختلفة إلى lead_id، وevent_name، وevent_time على التوالي.

يتمثل أحد الحلول الممكنة في دمج واجهة المستخدم/تجربة المستخدم في البوابة المعروضة للمعلن للسماح للمعلنين بتعيين المعلمات من أنظمة إدارة علاقات العملاء المختلفة إلى lead_id وevent_name وevent_time بأنفسهم.

وتشمل أفضل الممارسات الأخرى ما يلي:

1. احرص على تحميل البيانات مرة واحدة على الأقل في اليوم. من الأفضل تحميل البيانات بشكل فوري، ولكن يمكنك استخدام طرق التجميع بالساعة أو اليوم إذا لم يكن الدمج الفوري ممكنًا.
2. يمكن أن تتضمن كل مجموعة ما يصل إلى 1000 حدث. إذا كان هناك خطأ في المجموعة، فسيتم تجاهل المجموعة بالكامل، لذلك نوصي بشدة باستخدام مجموعات أصغر وإضافة منطق لعمليات إعادة المحاولة.
3. يمكنك إعادة تعبئة بياناتك لمدة تصل إلى آخر 7 أيام. ويتم حساب الفرق الزمني بين event_time وupload_time. إعادة تعبئة بعض البيانات قد تسرع من عملية التدريب.
4. تأكد من أن قيم event_time تقع بعد الطابع الزمني لتجميع بيانات العملاء المحتملين، وإلا فقد يتم تجاهل الأحداث.
5. قم بتسجيل رسائل الخطأ من استدعاءات واجهة API التحويلات وإنشاء تنبيهات إذا كانت هناك مشكلات. قد تكون معالجة الاستثناءات لهذه الأخطاء فكرة جيدة أيضًا.
6. قم بتخزين lead_id في نظامك جنبًا إلى جنب مع المعلومات الأخرى مثل تفاصيل تجميع بيانات العملاء المحتملين، ومرحلة تجميع بيانات العملاء المحتملين، وغير ذلك.

ما بعد الدمج

بعد إكمال دمج API بنجاح، نوصيك باختيار بعض المعلنين المناسبين لإجراء الاختبارات أولاً قبل إتاحة الحل لجميع المعلنين.

تحديد المعلنين المناسبين

من المهم أن تحدد المعلنين المناسبين لاستخدام واجهة API التحويلات لبرنامج إدارة علاقات العملاء. وفيما يلي بعض الإرشادات حول هؤلاء المعلنين:

• استخدام إعلانات تجميع بيانات العملاء المحتملين في فيسبوك/Instagram (النماذج الفورية)
• تجميع بيانات 200 من العملاء المحتملين على الأقل شهريًا
• مرحلة تجميع بيانات العملاء المحتملين التي يريد المعلن تحسينها

  • تحدث خلال 28 يومًا من تجميع بيانات العملاء المحتملين
  • يتوفر معدل تحويل بين 1% - 40%
• الاهتمام بجودة بيانات العملاء المحتملين

إرشادات للمعلنين

لتأهيل المعلنين بنجاح إلى واجهة API التحويلات لبرنامج إدارة علاقات العملاء وخدمتهم بشكل جيد بعد التأهيل، يوصى بشدة بأن تكون على دراية جيدة برحلة المعلن من أجل توجيهه خلال:

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

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

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

إذا لم يتمكن المعلن من المضي قدمًا في هذه الخطوة:

• فتحقق من وجود أخطاء في علامة تبويب "تشخيص مدير الأحداث" لمجموعة بيانات إدارة علاقات العملاء.

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

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

• فتأكد من وجود مرحلتين للأحداث من مسار مبيعات المعلن على الأقل، بما في ذلك مرحلة العملاء المحتملين الأولى (أي حدث تجميع بيانات العملاء المحتملين الأولي). ومع ذلك، نوصي بتوفير ثلاث مراحل على الأقل إن أمكن. على سبيل المثال، لن يكون إرسال حدث "البيع" فقط كافيًا؛ لذلك تأكد من قيام المعلن بإرسال المراحل السابقة أيضًا.

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

الخطوة الرابعة. تكوين مسار المبيعات

الخطوة الخامسة. تحليل المسار ومرحلة التعلُّم: لتجاوز حالة "تحليل المسار"، يجب أن يلبي التكامل الدمج التالية:

• أن تكون مرحلة التحسين بمعدل تحويل يتراوح بين 1-40%

• أن تبلغ نافذة التحويل ليوم التحسين 28 يومًا أو أقل

بعد اكتمال الدمج، هناك مرحلة التعلُّم تستغرق من شهر إلى شهرين حيث سيحتاج النموذج إلى استخدام البيانات التي يتم إرسالها مرة أخرى لتحسين النموذج. للتأكد مما إذا كان الدمج قد أكمل مرحلة التعلُّم، تحقق لمعرفة ما إذا كانت الحالة في "مدير الأحداث" تعرض "اكتملت مرحلة التعلُّم"

الخطوة السادسة. قم بتشغيل حملات إعلانات محسّنة لتجميع بيانات العملاء المحتملين الواردة من التحويل بالكامل عبر مدير الإعلانات باستخدام مجموعة بيانات إدارة علاقات العملاء أعلاه.

ملاحظة: ذكّر المعلن بعدم تغيير مجموعات البيانات بعد إكمال عملية الدمج. حيث إن تغيير مجموعات البيانات سيبدأ دمجًا جديدًا وسيعمل على إعادة بدء عملية التعلُم من جديد.