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

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

علاوة على ذلك، توفر بوابة واجهة API التحويلات الكفاءات التزايدية، مثل:

السرعة: لتقليل الوقت المحتمل لدمج واجهة API التحويلات من أسابيع إلى ساعات.
التكلفة: قد تتسبب بوابة واجهة API التحويلات في أن يتكبد العملاء تكلفة أقل نتيجة تقليل المتطلبات أو الموارد الفنية. التكلفة الوحيدة لبوابة واجهة API التحويلات هي رسوم موارد السحابة.
اعتماد أقل على العامل التقني: يمكن لمسوقي الأداء الذين يتمتعون ببعض الخبرة الفنية إعداد وتكوين واجهة API التحويلات بأنفسهم بأقل قدر من الدعم من فريق تكنولوجيا المعلومات أو المطوّرين.
تكاليف صيانة أقل: على عكس عمليات الدمج اليدوية المباشرة، ستُجري بوابة واجهة API التحويلات تحديثات تلقائية (بموافقة العميل) عند توفر ميزات جديدة؛ مما يحد من تكاليف الصيانة طويلة الأمد.

البنية

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

فيما يلي مخطط عالي المستوى للمكونات الرئيسية المضمنة في بوابة واجهة API التحويلات:

في هذا المخطط:

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

دعم وحدات البيكسل المتعددة والنطاقات المتعددة في بيكسل Meta

تدعم بوابة واجهة API التحويلات عدة نطاقات. على سبيل المثال، يمكن أن يتوفر لديك عدة نطاقات مثل "domain.com" و"domain.co.uk" و"anotherdomain.com". يمكن تكوين كل هذه النطاقات في مثيل واحد من بوابة واجهة API التحويلات أثناء النشر. يُرجى مراجعة دليل الإعداد لمزيد من التفاصيل.

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

مكونات بوابة واجهة API التحويلات

تتطلب بوابة واجهة API التحويلات حساب موفر خدمة سحابية مُدار بواسطة جهة خارجية بخلاف Meta (على سبيل المثال، AWS) للسماح للأنشطة التجارية بنشر البنية الأساسية تلقائيًا من دون الحاجة إلى مطوّر بالإضافة إلى القدرة على التنبؤ بالتكلفة.

مكونات البرامج

بيكسل Meta

بيكسل Meta هو مكتبة JavaScript القياسية التي يتم تحميلها على موقع ويب المعلن الذي يسمح للنشاط التجاري بمشاركة بيانات حول إجراءات العملاء، والتي يشار إليها باسم بيانات أدوات الأعمال في شروط أدوات الأعمال. بالنسبة إلى الأنشطة التجارية التي تعمل على تمكين بوابة واجهة API التحويلات، سترسل إشارة JavaScript هذه الأحداث إلى كل من Meta وبوابة واجهة API التحويلات عبر اتصال آمن (HTTPS) في كل مرة يتم فيها تشغيل بيكسل Meta من المتصفح.

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

بوابة واجهة API التحويلات عبارة عن منتج Meta مستقل وعملية نشر قائمة على Kubernetes تتم استضافتها على مثيل مجموعة EKS لموفر الخدمة السحابية. يتم توفيرها ضمن حساب موفر الخدمة السحابية المملوك للنشاط التجاري. تتكون من وحدتين رئيسيتين:

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

واجهة مستخدم مسؤول بوابة واجهة API التحويلات

توفر بوابة واجهة API التحويلات واجهة مستخدم مع المنتج. يمكنك الوصول إلى واجهة المستخدم هذه من "https://<Conversions API Gateway Endpoint>/hub/capig" (أي نقطة نهاية بوابة واجهة API التحويلات التي قمت بتكوينها في DNS).

من واجهة المستخدم هذه، يمكنك الاطّلاع على: