بوابة واجهة API التحويلات: دليل الإعداد

استخدم الخطوات التالية لإعداد بوابة واجهة API التحويلات.

الخطوة الأولى: بدء الاستخدام والنشر

لبدء عملية الإعداد، انتقل إلى علامة تبويب "الإعدادات" ضمن مدير الأحداث من Meta. ضمن "الإعداد من خلال بوابة واجهة API التحويلات"، انقر على بدء الاستخدام.

• راجع المتطلبات الأساسية لبوابة واجهة API التحويلات ثم حدّد التالي.

تحديد التفضيلات

• اختر الإعدادات التي تريد تمكينها ثم انقر على متابعة.

  • يمكن أن يساعد تحسين الأحداث في تحسين إسناد التحويل وتعظيم فوائد أداء الأحداث التي تشاركها حاليًا مع Meta.
  • يعمل التحقق من أداء بوابة واجهة API التحويلات على تمكين Meta من استكشاف المشاكل المحتملة وإصلاحها بشكل أكثر فعالية.

• بعد ذلك، ضمن تحديد منطقة الاستضافة، اختر المنطقة المرغوبة. يمكنك إعداد بوابة واجهة API التحويلات في منطقة واحدة فقط.
• انقر على التالي لفتح Amazon Web Services (AWS) أو انقر على نسخ عنوان URL للإرسال إلى مسؤول حساب AWS للمؤسسة.

الخطوة الثانية: تكوين خدمات AWS والتثبيت

يمكنك تسجيل الدخول إلى خدمات AWS إذا لم تكن قد أجريت ذلك بالفعل.

• سيتم فتح دفق الإنشاء السريع لمكدس بوابة واجهة API التحويلات.

• سيتم ملء جميع الحقول مسبقًا. يرجى عدم تغيير الحقل ProvisioningData.
• انقر على إنشاء مكدس لبدء التثبيت.
• تستغرق عملية الإنشاء حوالي 30 إلى 40 دقيقة، وبعدها ستتم كتابة ثلاثة من المخرجات في علامة تبويب "المخرجات" لمثيل AWS الجديد. ستعرف أن العملية قد اكتملت عندما تظهر الحالة: CREATE_COMPLETE في علامة التبويب "معلومات التجميع".
• بمجرد الاكتمال، انتقل إلى علامة التبويب المخرجات.
• (موصى به) أنشئ نطاقًا مخصصًا للمساعدة في توجيه البيانات، راجع الخطوة الرابعة أدناه.
• يُرجى تدوين CapigSetupURL، حيث ستحتاج إليه لتوفير واجهة مستخدم بوابة واجهة API التحويلات.

الخطوة الثالثة: التحقق من جمع البيانات

للوصول إلى واجهة مستخدم بوابة واجهة API التحويلات، استخدم CapigSetupURL ضمن علامة التبويب "المخرجات" (المرجع الخطوة الثانية). كما يمكن العثور على CapigSetupURL ضمن مدير الأحداث في Meta.

• سيتعين عليك إنشاء حساب مسؤول عند تسجيل الدخول لأول مرة في واجهة مستخدم المسؤول
• حدّد تسجيل الدخول بعد إنشاء حساب مسؤول
• سترى موقع واجهة مستخدم مسؤول بوابة واجهة API التحويلات.
• عند عرض الموقع لأول مرة، قد تكون بيانات الخادم والمتصفح عند 0. من المفترض أن تستغرق هذه المعلومات من 5 دقائق حتى ساعتين حتى يتم ملؤها.
• للتحقق مما إذا كان يتم تجميع البيانات أم لا، يمكنك الانتقال إلى موقع الويب لديك وتحديث الصفحة.
• إذا لم يتم ملء الأحداث بعد ساعتين، فيُرجى الاتصال بـ Meta.
• يجب أن تظهر الآن بوابة واجهة API التحويلات ضمن إعدادات البيكسل.

(موصى به) الخطوة الرابعة: إضافة نطاق مخصص

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

ملحوظة: ستحتاج إلى الوصول إلى موفر DNS لإضافة نطاق مخصص

• سجل الدخول في واجهة مستخدم مسؤول بوابة واجهة API التحويلات
• انتقل إلى إدارة النطاق على الشريط الجانبي الأيمن ضمن الإعدادات.
• اختر بين موفر خدمة DNS سواء مدير شهادات AWS (ACM) أو Cloudflare.

1. مدير شهادات AWS

يُرجى اتباع تعليمات إعداد ACM لإنهاء الإعداد.

2. Cloudflare

يرجى اتباع تعليمات إعداد Cloudflare لإنهاء الإعداد.

استكشاف مشكلات الإعداد وإصلاحها

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

تتداخل عملية الإكمال التلقائي في المتصفح مع الإعداد

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

التشخيصات

1. يمكنك تشغيل عملية التثبيت من مدير الأحداث وحفظ بيانات التوفير لفحصها لاحقًا.
2. انقر على نسخ عنوان URL، واحفظ عنوان URL الذي تم نسخه في أي محرر نصوص مثل Notepad.
3. انقر على بدء النشر لتشغيل صفحة إنشاء خدمات AWS.
4. في صفحة إنشاء خدمات AWS، ابحث عن ProvisioningData وتحقق من أن الإدخال يطابق عنوان URL الذي نسخته مسبقًا. وإذا لم يحدث تطابق، فهذا يعني أن الإكمال التلقائي قيد التشغيل وعليك إيقاف تشغيله.

الحل

بالنسبة إلى متصفحات FireFox، استخدم الخطوات التالية:

1. انقر على أيقونة قائمة Firefox (ثلاثة أشرطة أعلى الجانب الأيسر للشاشة).
2. انقر على الإعدادات.
3. وحدّد إعدادات الخصوصية والأمان.
4. مرّر إلى السجل وبالنسبة إلى Firefox سنختاراستخدام الإعدادات المخصصة للسجل.
5. يمكنك إلغاء تحديد تذكر البحث وسجل النماذج.
6. يتم حفظ تغييراتك تلقائيًا.

بالنسبة إلى متصفحات Chrome، استخدم الخطوات التالية:

1. انقر على أيقونة قائمة Chrome (ثلاث نقاط أعلى الجانب الأيسر للشاشة).
2. انقر على الإعدادات.
3. حدّد إعدادات الملء التلقائي.
4. قم بتوسيع المنطقة المناسبة.
5. قم بتبديل إعداد الملء التلقائي لإيقاف التشغيل.
6. يتم حفظ تغييراتك تلقائيًا.

التكوينات الإضافية

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

انقر على عمليات دمج الشركاء، التي تظهر على يمين الصفحة:

حدّد بوابة واجهة API التحويلات لفتح بوابة واجهة API التحويلات.

في هذه الشاشة، يمكنك عرض:

• أحداث موقع الويب

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

• نطاقات موقع الويب

  1. مواقع الويب التي تم تكوين بوابة واجهة API التحويلات للاتصال بها عبر البيكسل.

انقر على الإعدادات وحدّد الإجراء الذي ترغب في اتخاذه.

إضافة اتصال آخر لبوابة واجهة API التحويلات

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

إضافة بيكسل Meta آخر إلى اتصال بوابة واجهة API التحويلات الحالي

يسمح لك هذا الخيار بإعداد بيكسل Meta آخر في عملية تثبيت بوابة واجهة API التحويلات الحالية.

لبدء عملية الإعداد، انتقل إلى علامة تبويب الإعدادات ضمن مدير الأحداث من Meta. ضمن القسم "بوابات واجهة API التحويلات"، انقر على الزر اتصال:

راجع أيضًا

• بوابة واجهة API التحويلات - إدارة ما بعد الإعداد
• بوابة واجهة API التحويلات - التحذيرات واستكشاف الأخطاء وإصلاحها