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

أنت تعرض مستندات 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 (الحزمة الاحترافية) خطة مجانية، سيكون المسار كما يلي: الطرود > حزمة احترافية > الخطة المجانية > بطاقة السعر
NO_CURRENT_PUBLISHABLE_ENTITY	على المطوّر شراء خطة أسعار ليتمكن من إجراء طلبات البيانات من واجهة برمجة التطبيقات.

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

الأعراض

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

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

رسائل الخطأ

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

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

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

تشخيص السبب

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

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

2. إذا لم تظهر أي معاملات على أنّها SUCCESS خلال المدة المحددة، لا يتم استثمار المعاملات.

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

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

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

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

التشخيص

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

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

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

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

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

الدقة

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

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