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

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

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

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

المشكلة

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

رسائل الخطأ

<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. إذا كنت مستخدمًا خاصًا في السحابة الإلكترونية، يمكنك استخدام واجهة برمجة التطبيقات التالية:

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

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

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

رمز السبب	السبب	التفاصيل
INSUFFICIENT_FUNDS	تم استنفاد رصيد حساب المطوّر	إذا لم يكن رصيد حساب المطوّر المدفوع مسبقًا يتضمّن أموالاً كافية لإجراء أي معاملات إضافية، سيتم تعليق حساب المطوّر. بالنسبة إلى المطوّرين الذين يستخدمون نظام الدفع الآجل، قد يحدث هذا الخطأ في حال تجاوزهم حدّ الائتمان أو عند نفاد حدّ الائتمان المحدَّد على العملة المستخدمة.
LIMIT_VIOLATED RATE_PLAN_RATE_BAND_EXCEEDED	يتعذّر على المطوّر إجراء أيّ معاملات أخرى.	يُسمح لكل مطوّر برامج بإجراء عدد ثابت من المعاملات استنادًا إلى خطة السعر المشتراة. وفي حال تجاوز عدد المعاملات، سيتم تعليق حساب المطوّر ولن يتمكّن من إكمال معاملات إضافية.
NO_CURRENT_PUBLISHABLE_ENTITY	لم يشترِ المطوّر أي خطة أسعار	يجب على المطوّر شراء خطة أسعار قبل إكمال أي معاملات.

درجة الدقّة

خطأ	خطوات حلّ المشكلة
INSUFFICIENT_FUNDS	يجب على المطوّر التأكّد من توفّر رصيد كافٍ في الحساب أو رصيد متاح لإكمال أي معاملات إضافية.
LIMIT_VIOLATED RATE_PLAN_RATE_BAND_EXCEEDED	يمكنك إجراء طلبات البيانات التالية من واجهة برمجة التطبيقات للحصول على خطة سعر المطوّرين وتفاصيل المعاملات، على التوالي: يمكنك إجراء طلب البيانات من واجهة برمجة التطبيقات التالي لمعرفة تاريخَي البدء والانتهاء لخطط الأسعار التي اشتراها المطوّر: http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/developers/%7Bdeveloper_id%7D/developer-accepted-rateplans نفِّذ طلب بيانات من واجهة برمجة التطبيقات التالي لمعرفة عدد المعاملات الناجحة التي أجراها المطوّر: http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/transactions/developers/%7Bdeveloper_email_or_id%7D في واجهة مستخدم Edge، يمكنك أيضًا التحقق من عدد المكالمات التي يُسمح للمطوّر بإجرائها عن طريق تحديد: الحزم > اسم الحزمة > RatePlanName > بطاقة السعر على سبيل المثال، إذا كان اسم الحزمة هو Pro Package (حزمة Pro) وكان خطة مجانية، سيكون المسار كما يلي: الحزم > حزمة Pro > خطة مجانية > بطاقة السعر
NO_CURRENT_PUBLISHABLE_ENTITY	يجب على المطوّر شراء خطة أسعار ليتمكّن من إجراء طلبات البيانات من واجهة برمجة التطبيقات.

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

المشاكل

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

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

رسائل الخطأ

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

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

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

تشخيص السبب

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

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

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

في ما يلي الأسباب النموذجية لعدم تحقيق الربح من المعاملات:

• سياسة التحقق من حدود تحقيق الربح غير مرفقة بالخادم الوكيل لواجهة برمجة التطبيقات
• لا يتم تحقيق الربح من خلال APIProduct
• تم تحديد سياسة تسجيل المعاملات بشكلٍ غير صحيح
• لم يشترِ المطوّر خطة أسعار

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

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

التشخيص

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

درجة الدقّة

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

في حال استمرار المشكلة، ضَع علامة في المربّع لا يتم تحقيق الربح من منتج واجهة برمجة التطبيقات.

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

التشخيص

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

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

   2. إذا كنت مستخدمًا خاصًا في السحابة الإلكترونية، يمكنك استخدام واجهة برمجة التطبيقات التالية:

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

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

درجة الدقّة

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

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. في ما يلي نموذج لتتبُّع واجهة المستخدم يوضِّح إعداد متغيرات تدفق Mint بشكل صحيح.

   

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

درجة الدقّة

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

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

التشخيص

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

      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.