تخطٍ إلى المحتوى

واجهة برمجة تطبيقات التحويلات الميتا

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

نظرة عامة

● ستقوم بإنشاء مصدر بيانات رسائل في Meta Events Manager.

● ثم استرجاع بيانات الاعتماد (رمز الوصول ومعرف مجموعة البيانات).

● تضاف هذه البيانات في NewAge Ai.

● أخيرا، ستقوم بتفعيل الأحداث باستخدام واجهة برمجة تطبيقات التحويلات الميتا داخل منشئ التدفق الخاص ب NewAge Ai.

الخطوة 1: إنشاء مصدر بيانات للرسائل

1. اذهب إلى مدير الأحداث الميتا: business.facebook.com

2. انقر + أضف مصدر بيانات.

3. اختر نوع المصدر للمراسلة، ثم اضغط التالي.

أ) دمج فيسبوك

الخطوة 1: اختر صفحة فيسبوك

1. اختر فيسبوك كمنصة.

2. اختر صفحتك على فيسبوك.

3. منح جميع التصاريح المطلوبة.

إذا لم تظهر صفحتك:

● تأكد من أن حسابك على فيسبوك هو مسؤول في الصفحة.

● يجب أن تكون الصفحة نشطة ومرتبطة بمدير الأعمال.

الخطوة 2: سم مصدر البيانات

1. أدخل اسما فريدا (تجنب استخدام اسم الصفحة بالضبط).

2. اضغط على بدء التكامل.

  1. انتظر التأكيد، ثم أغلق نافذة الإعداد.

الخطوة 3: نسخ بيانات الوصول

1. انتقل إلى تبويب الإعدادات في مصدر البيانات الجديد.

2. انسخ معرف مجموعة البيانات.

  1. انقر على إنشاء رمز الوصول، ثم انسخه.

الخطوة 4: إضافة بيانات اعتماد إلى NewAge Ai

1. في NewAge Ai، افتح إعدادات مساحة العمل الخاصة بك.

2. انتقل إلى تكاملات > واجهة برمجة تطبيقات التحويلات الميتا.

3. قم بلصق معرف مجموعة البيانات ورمز الوصول في الحقول المناسبة.

4. انقر على حفظ.

الخطوة 5: إرسال الأحداث في إعداد تدفق NewAge Ai

1. افتح Flow Builder في NewAge Ai.

2. أضف عقدة إجراء.

3. اختيار: الأحداث إجراءات > واجهات برمجة التطبيقات على فيسبوك/إنستغرام/واتساب > واجهة برمجة تطبيقات التحويلات الميتا

الخطوة 6: اختبار الأحداث

1. في Meta Events Manager، افتح مصدر بياناتك.

2. اذهب إلى تبويب أحداث الاختبار واختر القناة الخاصة بالاختبار.

3. نسخ رمز حدث الاختبار.

  1. الصق هذا الكود في إجراء NewAge Ai أثناء الاختبار.
  1. شغل التدفق وتحقق من ظهور الحدث في لوحة أحداث الاختبار

ملاحظة، يمكنك الحصول على PSID لاختبارك بالنقر في واجهة برمجة تطبيقات Explorer Graph ونسخ PSID من البيانات:

الخطوة 7: إعداد خاص لإعلانات النقر على واتساب (CTWA)

إذا كنت تستخدم إعلانات CTWA:

● عندما يرسل المستخدم رسالة، يتضمن الحمولة معرف إحالة.

● عليك تسجيل معرف الإحالة هذا ضمن تدفق الإحالة الخاص بك.

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

للحصول على CTWA_clid يمكنك مشاهدة الدليل في الرابط أدناه، حيث نشرح كيفية حفظ حمولة CTWA_clid عبر محفز إحالة إعلانات واتساب:

إحالة إعلانات واتساب

ملاحظات مهمة

تكامل واتساب

● يجب استخدام رقم منصة واتساب للأعمال (وليس واتساب الشخصي).

● يجب أن يكون الرقم مرتبطا بمعرف صفحة فيسبوك.

● بالنسبة لإعلانات النقر على واتساب (CTWA)، يجب عليك التعامل مع معرفات الإحالة. إذا لم تكن مدرجة:

● تأكد من أن رقمك متصل عبر إعدادات مدير الأعمال في واتساب.

دمج إنستغرام

إذا لم يكن إنستغرام مدرجا:

● افتح تطبيق إنستغرام > الإعدادات > مركز الحسابات > الاتصال بفيسبوك.

استكشاف الأخطاء الشائعة

● صفحة أو ملف إنستغرام غير مرتبط بمدير الأعمال.

● محاولة استخدام حساب واتساب شخصي بدلا من حساب الأعمال.

● الرمز منتهية صلاحيته أو لم يتم توليده بشكل صحيح.

● صفحة فيسبوك غير نشطة أو تفتقر إلى الأذونات المطلوبة.

● مفقود معرف الإحالة أو معرف الصفحة لحملات CTWA.

● الحساب الإعلاني يعاني من قيود أو مشاكل في الفوترة.

ملاحظات ختامية

بمجرد أن يتم ضبط كل شيء بشكل صحيح:

● يمكنك إعادة استخدام نفس مصدر البيانات لعدة تدفقات.

● لا حاجة لإعادة الدمج إلا إذا أردت فصل الفعاليات حسب العلامة التجارية أو المنصة.

● دائما قم بالاختبار قبل البث للتحقق من أن Meta تستقبل الأحداث. تم اكتمال تكامل واجهة برمجة التطبيقات الخاصة بتحويلات الميتا.

إذا واجهت أي مشاكل أو لديك أي ملاحظات، لا تتردد في فتح تذكرة دعم عبر مراسلتنا عبر البريد الإلكتروني على ticket@NewAge Ai.com.au