‏منتجات Gateway‏

بوابة واجهة API التحويلات وSignals Gateway: دليل استكشاف الأخطاء وإصلاحها

خطوات استكشاف الأخطاء وإصلاحها للمضيف

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

نقطة نهاية التحقق من أداء منتجات Gateway

انتقل إلى:

https://<Gateway Products Endpoint>/hub/health/

يمكن للمضيف مراقبة حالة خادم المثيل من خلال خدمة التحقق من الحالة هذه.

المشكلة الأولى: لا يمكن الوصول إلى واجهة مستخدم بوابة المضيف أو لا تعرض أي معلومات

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

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

الخطوة الثالثة. قد تكون موارد المثيل غير كافية. يمكنك إلغاء حاويات pod لتحرير المورد باتباع الخطوات التالية:

  • قم بالاتصال بمدير الجلسة وقم بتشغيل الأمر "kubectl delete deployment capig" لإلغاء حاويات pod لدى "منتج Gateway".
  • انتظر 5 دقائق ثم حاول تشغيل الأمر kubectl get pods -A. يجب أن تكون كل حالات pod "قيد التشغيل" أو "مكتملة".
  • إذا لم يكن الأمر كذلك، قم بتشغيل الأمر "kubectl delete publishing hub" لإلغاء حاوية pod في Hub. كرّر الخطوة أعلاه

الخطوة الرابعة. قم بإلغاء تثبيت المثيل وإعادة تثبيته إذا كان هذا مثيلاً جديدًا.

الخطوة الخامسة. المشاركة مع جهة اتصال Meta (إن أمكن)

  • سجلات منتجات Gateway
  • يمكن تنزيلها من صفحة /hub/settings/updates بالنقر على الزر "تنزيل السجلات".
  • لقطة شاشة لأداة واجهة مستخدم Gateway للمضيف التي يحدث فيها الخطأ.

يحدث "الخطأ 400: نطاق الهوية غير موجود (myproject-3-XXXXX.svc.id.goog)" أثناء إعداد مضيف GCP

عادةً ما يحدث هذا الخطأ لأنك لم تنشئ نظام مجموعة Google Kubernetes Engine في حساب GCP ويستغرق الأمر وقتًا لإنشاء بعض من الموارد الأساسية لأول مرة. يجب استخدام البرنامج النصي لإلغاء التثبيت الموضح في دليل إلغاء التثبيت لإزالة التثبيت وإعادة محاولة وضع تثبيت جديد.

انتهت مهلة جلسة CloudShell أثناء تأهيل مضيف GCP

إذا تم ترك جلسة CloudShell لوقت طويل، فقد يتم فصل وحدة CloudShell الطرفية. حتى في هذه الحالة، قد يكون التثبيت قد اكتمل بالفعل. للتحقق من تعليمات التثبيت، يرجى فتح صفحة مساحة تخزين GCP السحابية، والبحث عن حاوية بالاسم capig-{your_login_id}-XXX-storage-bucket. يوجد ملف يُسمى capig-onboarding-guide.txt. يُرجى فتح الملف واتباع التعليمات المتوفرة.

خطوات استكشاف الأخطاء وإصلاحها للحساب: الاتصال بالبوابة

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

المشكلة 1: تعذر إكمال التثبيت

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

المشكلة 2: واجهة مستخدم Gateway غير قابلة للوصول أو لا تعرض أي معلومات

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

الخطوة الثانية. المشاركة مع جهة اتصال Meta (إن أمكن)

  • سجلات منتجات Gateway
  • لقطة شاشة لوحدة التحكم من أداة مضيف واجهة مستخدم Gateway للمطوّر حيث يحدث الخطأ

المشكلة 3: عدم استلام أحداث Gateway بعد اكتمال التثبيت

الخطوة الأولى. يمكن حظر مواقع الويب. بشكل افتراضي، يُسمح لأي مواقع ويب تستلم أحداثًا من أحداث البيكسل المرتبطة بمنتجات Gateway باستلام الأحداث ونشرها. سيتم منع مواقع الويب المحظورة فقط من استلام الأحداث ونشرها

التشخيصات

افتح واجهة مستخدم منتج Gateway لديك، وحدد "مواقع الويب" -> "مواقع الويب المحظورة" من القائمة الموجودة على الجانب الأيمن.

الحل

إلغاء حظر أي مواقع ويب تريدها أن تتلقى الأحداث وتنشرها.

الخطوة الثانية. قد لا يتم تثبيت حدث البيكسل بطريقة قياسية. لكي تعمل منتجات Gateway بشكل سليم، نوصي بإضافة البيكسل مباشرةً إلى إشارات <head> لموقع الويب.

التشخيصات

  • تحقق مما إذا تم تثبيت البيكسل وفقًا للإرشادات المذكورة في قسم الحل.
  • تحقق مما إذا تم تكوين الأحداث باستخدام أداة إعداد الحدث. في الوقت الحالي، لا يدعم منتج Gateway تتبع الأحداث التي يتم تكوينها باستخدام أداة إعداد الأحداث.

الحل

  • تثبيت الرمز الأساسي للبيكسل
    • بالنسبة لبيكسل Meta، راجع هذه التعليمات.
    • بالنسبة لأحداث Signals Gateway Pixel، تتوفر التعليمات في نموذج تفاصيل "مصدر البيانات"
  • بالإضافة إلى ذلك، يمكنك تنفيذ رمز تتبع التحويل إذا كنت تريد تتبع التحويلات. تأكد من تثبيت الرمز الأساسي بالفعل في كل صفحة حيث تريد تتبع التحويلات.

الخطوة الثالثة. قد يكون تكوين DNS غير مكتمل أو غير صحيح. يتواصل البيكسل مع Gateway باستخدام نطاق ملائم لهذا التواصل، وبشكل مثالي يكون مماثلاً للصفحة التي يتم تشغيل البيكسل فيها. على سبيل المثال، إذا تم تشغيل البيكسل في advertiser.com، فمن الأفضل أن تكون البوابة قابلة للوصول بواسطة البيكسل في gateway.advertiser.com.

يجب ربط نطاق فرعي لنطاق الحساب (النطاق حيث يتم تشغيل البيكسل) بالنطاق الفرعي للمضيف عبر سجل CNAME باستخدام موفر خدمة DNS للمعلنين، حتى تصبح نقطة نهاية منتج Gateway قابلة للوصول بواسطة البيكسل عبر استدعاء الطلب الأساسي.

التشخيصات

استخدم أداة فحص DNS عبر الإنترنت مثل https://dnschecker.org/، للتحقق ما إذا كان سجل CNAME قد تم تعيينه بشكل صحيح كما هو موضح أعلاه، أي أن النطاق الفرعي للحساب يشير بشكل صحيح إلى النطاق الفرعي للمضيف، والذي يشير إلى نطاق موازنة التحميل الذي تم تعيينه عند الإنشاء. إذا كان النطاق الفرعي للحساب لا يشير في النهاية إلى النطاق موازن الأحمال، فيُرجى الرجوع إلى قسم "الحل" لمعرفة الخطوات التالية.

الحل

  • تعاون مع مسؤول بشأن مسجل النطاق.
  • قم بتحديث سجل DNS في مسجل النطاق لديك باستخدام عنوان IP الخاص بخادم منتج Gateway. قم بتعيين سجل DNS CNAME الذي يربط النطاق الفرعي لمنتج Gateway بعنوان IP الخادم الذي تم إنشاؤه أثناء الإعداد.

الخطوة الرابعة. يمكن حظر الأحداث عن طريق سياسة أمان المحتوى (CSP). قد تتوفر لدى بعض مواقع الويب سياسة CSP تحظر استلام الأحداث بواسطة منتجات Gateway.

التشخيصات

تحقق ما إذا تم تعيين عنوان استجابة content-security-policy على الخادم من موقع ويب المعلن.


الحل

  • أدرج النطاق الفرعي في قائمة سماح قاعدة CSP لاستثنائه من السياسة.

الخطوة الخامسة. افصل البيكسل كليًا وأعد ربطه.

الخطوة السادسة. تأكد من أنك تستخدم رمز وصول صالح للنظام.

التشخيصات

تحقق ما إذا تم تعيين عنوان استجابة content-security-policy على الخادم من موقع ويب المعلن.

الوصول إلى https://<Gateway Product Endpoint>/capig/graphiql/. قم بلصق الأمر أدناه مع tenantId للحصول على رمز الوصول المقابل

query test {
   tenantQueries (tenantId:"") {
    account {
      signalConfigs {
        connectionId
        connectionStatus {
          badToken
          accessTokenAvailable 
        }
      }
    }
  }
}

للبحث عن tenantId، انتقل إلى واجهة مستخدم منتجات Gateway وحدّد الحساب المقابل حيث يتم عرض رابط عنوان url كـ https://<Gateway Product Endpoint>/hub/capig/?tenant=<tenentId>.

إذا كانت نتيجة badToken تُرجع true، فقم بإصلاحها بالنقر على الزر "إضافة مصدر بيانات" لإضافة مصدر البيانات نفسه مرة أخرى.

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