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

بدء الاستخدام

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

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

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

نظرة عامة على العملية

تتكون عملية إعداد دمج واجهة API التحويلات من الخطوات عالية المستوى التالية:

  1. اختيار أسلوب الدمج المناسب.
  2. إكمال المتطلبات الأساسية اللازمة لأسلوب التنفيذ هذا.
  3. التنفيذ باستخدام أسلوب الدمج هذا.
  4. التحقق من الإعداد والالتزام بأفضل الممارسات التي تساعد في تحسين أداء الإعلان.

أساليب الدمج

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

ينصب التركيز الأساسي لوثائق المطوّر هذه على إنشاء عمليات دمج مباشرة

المتطلبات

معرف البيكسل

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

مدير الأعمال

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

رمز الوصول

لاستخدام واجهة API التحويلات، تحتاج إلى رمز وصول. وتتوفر طريقتان للحصول على رمز الوصول:

  • باستخدام مدير الأحداث (موصى بها)
  • باستخدام تطبيقك الخاص

باستخدام مدير الأحداث (موصى بها)

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

الخطوة الأولى - اختر البيكسل الذي تريد تنفيذه.

الخطوة الثانية - حدّد علامة التبويب "الإعدادات".


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

ملاحظة: يكون رابط "إنشاء رمز الوصول" مرئيًا فقط للمستخدمين الذين يتمتعون بامتيازات المطوّرين للنشاط التجاري. ويتم حجب الرابط عن المستخدمين الآخرين.


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



باستخدام تطبيقك الخاص

إذا كنت تمتلك بالفعل تطبيقًا ومستخدم نظام خاصًا، فيمكنك إنشاء الرمز داخل مدير الأعمال. لإجراء ذلك:

الخطوة الأولى: انتقل إلى إعدادات نشاطك التجاري.

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

الخطوة الثالثة- حدّد مستخدم النظام الذي تم تعيينه، وانقر على إنشاء رمز.

لا يلزم أن يخضع تطبيقك إلى عملية مراجعة التطبيقات. ولا يلزم طلب أي أذونات.

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

الموارد