استكشاف أخطاء تحقيق الربح وإصلاحها

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

يقدّم هذا الموضوع معلومات وإرشادات حول تحديد المشاكل الشائعة المتعلّقة بتحقيق الربح وحلّها.

تم تعليق حساب المطوّر

المشكلة

تم تعليق حساب المطوِّر ولن يتمكّن من إجراء أي معاملات إضافية لتحقيق الربح أو طلبات بيانات من واجهة برمجة التطبيقات.

رسائل الخطأ

<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>

التشخيص

لتحديد سبب تعليق حساب المطوِّر، اتّبِع الخطوات التالية:

1. نفِّذ طلب البيانات التالي من واجهة برمجة التطبيقات لتحديد رمز الخطأ المرتبط بالمطوّر المعلق:
   1. إذا كنت من مستخدمي السحابة الإلكترونية العامة، استخدِم واجهة برمجة التطبيقات أدناه:

      curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password

   2. إذا كنت من مستخدمي Private Cloud، استخدِم واجهة برمجة التطبيقات أدناه:

      curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password

2. قارِن رمز الخطأ برموز الأسباب التالية لتحديد سبب تعليق حساب المطوّر.

راجِع أيضًا: ملخّص رموز الأسباب الخاصة بالمطوّرين الذين تم تعليق حساباتهم

الدقة

المشاكل المتعلّقة بإعدادات تحقيق الربح

الأعراض

يمكن أن تظهر مشاكل إعداد تحقيق الربح على شكل أعراض مختلفة، مثل:

• وظيفة Webhooks لا تعمل
• يتعذّر إنشاء خطافات ويب
• عدم تشغيل إشعارات Webhook
• لا تعرض "تقارير تحقيق الربح" أي معاملات. على سبيل المثال، تشير بيانات "إحصاءات Google" إلى أنّ المطوّر قد أكمل العديد من المعاملات خلال فترة زمنية محدّدة، ولكن لا تُدرج تقارير تحقيق الربح أيًا من هذه المعاملات.
• عدم تسجيل المعاملات

رسائل الخطأ

قد لا تظهر لك أي رسائل خطأ، ولكن ستلاحظ مشاكل كما هو موضّح في قسم الأعراض.

الأسباب المحتملة

إذا ظهرت أي من الأعراض المدرَجة في الأعراض، فمن المحتمل جدًا ألا يتم تحقيق الربح من المعاملات.

تحديد سبب المشكلة

1. استخدِم طلب البيانات من واجهة برمجة التطبيقات الخاصة بالإدارة الموضّح في القسم التالي للتحقّق مما إذا كان يتم تحقيق الربح من المعاملات.

   عرض حالة المعاملات

2. إذا لم تظهر أي معاملات مُدرَجة على أنّها ناجحة خلال المدة المحدّدة، يعني ذلك أنّ المعاملات غير محقّقة الربح.

في ما يلي الأسباب الشائعة لعدم تحقيق الربح من المعاملات:

• Monetization Limits Check Policy Not Attached To API Proxy
• APIProduct غير مفعَّلة
• Transaction Recording Policy incorrectly defined
• لم يشترِ المطوِّر خطة أسعار

توضّح الأقسام التالية كيفية تشخيص كل مشكلة وحلّها.

سياسة التحقّق من حدود تحقيق الربح غير مستخدَمة في خادم وكيل لواجهة برمجة التطبيقات

التشخيص

1. تحقَّق ممّا إذا كانت "سياسة التحقّق من حدود تحقيق الربح" مرفقة بخوادم وكيلة لواجهة برمجة التطبيقات.
2. إذا لم يتم إرفاق السياسة، قد يكون هذا هو السبب في إدراج المعاملات على أنّها تعذّر إجراؤها.

الدقة

أرفِق سياسة التحقّق من حدود تحقيق الربح بخوادم وكيل واجهة برمجة التطبيقات المطلوبة، كما هو موضّح في فرض حدود تحقيق الربح على خوادم وكيل واجهة برمجة التطبيقات.

إذا استمرت المشكلة، راجِع لم يتم تحقيق الربح من منتج واجهة برمجة التطبيقات.

لم يتم تحقيق الربح من منتج واجهة برمجة التطبيقات

التشخيص

1. تحقَّق مما إذا كان منتج واجهة برمجة التطبيقات يحقّق الربح (يتم تقييم منتجات واجهة برمجة التطبيقات التي تحقّق الربح فقط وسيتم إدراجها ضمن المعاملات). المنتج الذي يحقّق الربح هو المنتج الذي يتضمّن خطة أسعار نشطة واحدة على الأقل.
2. استخدِم طلب البيانات التالي من واجهة Management API للحصول على قائمة بمنتجات واجهة برمجة التطبيقات التي تحقّق الربح:
   1. إذا كنت من مستخدمي السحابة الإلكترونية العامة، استخدِم واجهة برمجة التطبيقات أدناه:

      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password

   2. إذا كنت من مستخدمي Private Cloud، استخدِم واجهة برمجة التطبيقات أدناه:

      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password

3. إذا لم يكن منتج واجهة برمجة التطبيقات المرتبط بخادم وكيل واجهة برمجة التطبيقات يحقّق الربح، قد يكون هذا هو السبب في عدم تحقيق الربح من المعاملات.

الدقة

لتحقيق الربح من منتج API، اتّبِع الخطوات التالية:

1. ضبط سياسة تسجيل المعاملات

2. تأكَّد من أنّ منتج واجهة برمجة التطبيقات يتضمّن خطة أسعار نشطة.

إذا استمرت المشكلة، يُرجى مراجعة سياسة تسجيل المعاملات المحدّدة بشكل غير صحيح.

سياسة تسجيل المعاملات غير محدّدة بشكل صحيح

التشخيص

1. فعِّل تتبُّع واجهة المستخدم لخادم وكيل واجهة برمجة التطبيقات الذي تم إرفاق سياسة التحقّق من حدود تحقيق الربح به.
2. اختَر طلب بيانات من واجهة برمجة التطبيقات معيّنًا من تتبُّع واجهة المستخدم.
3. اختَر مسار AX في "إحصاءات Google" وتحقّق مما إذا كانت متغيّرات مسار تحقيق الربح (mint) التالية تتضمّن القيم المناسبة:

   mint.tx.status - Should match the value set up for "success criteria" in the transaction recording policy for the API product being used. When tracing, the txProviderStatus in the transaction recording policy is stored in the variable 'mint.tx.status'.
   mint.tx.app_id - Application id of API product.
   mint.tx.prod_id - API product id.

4. في ما يلي نموذج لتتبُّع واجهة المستخدم يوضّح أنّه تم إعداد متغيرات عملية إنشاء الرمز المميز بشكل صحيح.

   

5. إذا لاحظت خطأ في المتغيّر mint.tx.status، فهذا يشير إلى أنّ سياسة تسجيل المعاملات تم تحديدها بشكل غير صحيح.

الدقة

1. تأكَّد من اتّباع جميع الخطوات الموضّحة في مقالة إنشاء سياسة تسجيل المعاملات بشكل صحيح أثناء إنشاء سياسة تسجيل المعاملات.
2. قيمة المفتاح هي "معايير نجاح المعاملة" المحدّدة في سياسة تسجيل المعاملات. الاطّلاع على أمثلة على ضبط معايير نجاح المعاملات في سياسة تسجيل المعاملات

لم يشترِ المطوّر خطة أسعار

التشخيص

1. استخدِم طلب البيانات التالي من Management API للتحقّق من خطط الأسعار التي اشتراها المطوّر:
   1. إذا كنت من مستخدمي "السحابة العامة"، استخدِم واجهة برمجة التطبيقات أدناه:

      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password

   2. إذا كنت من مستخدمي Private Cloud، استخدِم واجهة برمجة التطبيقات أدناه:

      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password

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

الدقة

يجب أن يشتري المطوّر خطة الأسعار استنادًا إلى متطلباته ثم ينفّذ المعاملات/واجهات برمجة التطبيقات.

في حال استمرار المشكلة، يُرجى التواصل مع فريق الدعم في Apigee Edge.