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

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

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

استعن بخطوات استكشاف الأخطاء وإصلاحها التالية للمساعدة في تحديد المشكلة:

  1. الانتقال إلى مدير الأحداث
  2. فتح موقع ويب في المتصفح
  3. واجهة المستخدم لمسؤول بوابة واجهة API التحويلات

لم يتم تكوين النطاق لإرسال الأحداث

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

التشخيصات

  • سجِّل الدخول إلى مدير الأحداث
  • حدِّد الحدث المناسب
  • انقر على عرض التفاصيل وحدِّد نظرة عامة على الحدث
  • من القائمة المنسدلة الموجودة على اليمين، حدِّد النطاقات للعثور على النطاقات التي يتم تشغيل أحداث المتصفح منها
  • إذا كانت تلك النطاقات مفقودة أو مختلفة عن النطاقات التي تم تكوينها، فمن المتوقع ألا يتم تسجيل أحداث المتصفح

الدقة

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

نظام أسماء النطاقات (DNS) ليس مكوَّنًا أو مُعيّنًا بشكل خاطئ

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

التشخيصات

  • استخدم مدقق نظام أسماء نطاقات (DNS) على الإنترنت مثل https://dnschecker.org/ للتحقق مما إذا كان نطاق بوابة واجهة API التحويلات قد تم تعيينه إلى عنوان IP الصحيح وتم نشره بالكامل. إذا لم يتم تعيين نطاقك إلى أي عنوان IP، يرجى الرجوع إلى قسم التعيين للخطوات التالية.
  • احصل على عنوان IP لخادم بوابة API التحويلات من لوحة معلومات AWS EC2 أو اطلب هذه المعلومات من نقطة الاتصال الخاصة ببنيتك التحتية السحابية.
  • إذا كان عنوانا IP مختلفين، يرجى الرجوع إلى قسم التعيين للخطوات التالية.

الدقة

  • تعاون مع مسؤول بشأن مسجل النطاق.
  • قم بتحديث سجل نظام أسماء النطاقات (DNS) في مسجل نطاقك باستخدام عنوان IP لخادم بوابة واجهة API التحويلات (الذي يظهر على لوحة معلومات AWS EC2 الخاصة بك).
    • قم بتعيين سجل لنظام أسماء النطاقات (DNS) يقوم بتعيين نطاقك الفرعي لبوابة واجهة API التحويلات إلى عنوان IP للخادم الذي تم إنشاؤه أثناء الإعداد.

لم يتم إصدار الشهادة مطلقًا

إذا لم يكن لدى بوابة واجهة API التحويلات شهادة صادرة من Let's Encrypt، حتى بعد فترة طويلة من تكوين نظام أسماء نطاقات (DNS) بشكل صحيح، فهذا يعني أن نطاقك شائع للغاية لدرجة أن Let’s Encrypt رفضت إصدار شهادة له.

الدقة

  • فكر في وضع موازن تحميل AWS (ALB) أمام مثيل بوابة واجهة API التحويلات واستخدم ذلك الموازن لاستضافة الشهادة التي تملكها.

تم إصدار الشهادة ولكن انتهت صلاحيتها

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

الدقة

  • افتح المنفذ 80 وقم بترقية بوابة واجهة API التحويلات إلى أحدث إصدار.

لا يمكن الوصول إلى واجهة المستخدم للبوابة

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

الدقة

  • تأكد من أن عنوان IP لمثيل بوابة واجهة API التحويلات يطابق تكوين نظام أسماء النطاقات (DNS). إذا لم يكن الأمر كذلك، فراجع نظام أسماء النطاقات (DNS) ليس مكوَّنًا أو مُعيّنًا بشكل خاطئ.
  • إذا كان الخادم لا يستجيب، فقد يكون هذا بسبب خطأ مؤقت في الشبكة ويمكن حله عن طريق إعادة تشغيل المثيل. وقد يستغرق الأمر بضع دقائق لبدء تشغيل بوابة واجهة API التحويلات، لذا انتظر حوالي 10 دقائق لتسجيل الدخول مجددًا.

البوابة تتطلب ترقية الإصدار

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

التشخيصات

  • للتحقق من الإصدار الحالي لبوابة واجهة API التحويلات:
    • افتح واجهة المستخدم لمسؤول بوابة واجهة API التحويلات:
https://<Conversions API Gateway Endpoint>/hub
  • تحقق من الإصدار الحالي لخادم بوابة واجهة API التحويلات:
    • القائمة على اليمين > الإعدادات > التحديثات

الدقة

لترقية بوابة واجهة API التحويلات، قم بما يلي:

استكشاف الأخطاء وإصلاحها باستخدام سجلات EKS

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

يتوفر سجل تثبيت EKS ضِمن AWS Cloudwatch تحت اسم المجموعة "ConversionsAPIGateway/cloud-init-output.log". يمكنك التحقق مما إذا كانت هناك أي رسائل خطأ. تشمل الأخطاء الشائعة تجاوز حدود موارد AWS وعدم وجود أذونات AWS.



سجل DNS بالنوع CAA لا يحتوي على amazonaws.com

إذا كان سجل DNS الذي تطلب بوابة واجهة API التحويلات إعداده يحتوي على شهادة TLS مناسبة أو لا يحتوي على سجل CAA، فيمكنك تجاهل هذا القسم.

إذا كان لديك سجل CAA للنطاق، فيرجى التأكد من توفير amazonaws.com كقيمة لسجل CAA إذا قمت بتثبيت إصدار AWS EKS من بوابة واجهة API التحويلات (للحساب الفردي) أو بوابة واجهة API التحويلات للحسابات المتعددة بالإصدار 1.10.* أو الإصدارات الأحدث والتي تستخدم مدير شهادات AWS لإنشاء النطاق. مثال على سجل CAA:

0 issue "amazonaws.com"

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

0 issue "letsencrypt.org"

راجع أيضًا