عیب‌یابی مشکلات درآمدزایی

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید. اطلاعات

این موضوع اطلاعات و راهنمایی‌هایی درباره عیب‌یابی مشکلات رایج درآمدزایی ارائه می‌دهد.

توسعه‌دهنده تعلیق شد

نشانه

توسعه‌دهنده تعلیق شده است و نمی‌تواند تراکنش‌های درآمدزایی اضافی یا فراخوانی‌های API انجام دهد.

پیام های خطا

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

تشخیص

برای تعیین دلیل تعلیق توسعه‌دهنده، مراحل زیر را انجام دهید: مراحل:

1. فراخوانی API زیر را اجرا کنید تا کد خطای مربوط به توسعه‌دهنده تعلیق‌شده را شناسایی کنید: توسعه‌دهنده:
   1. اگر «کاربر ابر عمومی» هستید، از API زیر استفاده کنید:

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

   2. اگر «کاربر ابر خصوصی» هستید، از API زیر استفاده کنید:

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

2. کد خطا را با کدهای دلیل زیر مقایسه کنید تا دلیل تعلیق توسعه‌دهنده را متوجه شوید.

همچنین ببینید: خلاصه کدهای دلیل برای توسعه‌دهندگان تعلیق‌شده

وضوح

مشکلات راه‌اندازی درآمدزایی

علائم

مشکلات تنظیم درآمدزایی می‌تواند به صورت علائم مختلفی ظاهر شود، مانند:

• عملکرد وب‌قلاب‌ها کار نمی‌کند
• وب‌قلاب ایجاد نشد
• اعلان‌های وب‌قلاب راه‌اندازی نمی‌شود
• گزارش‌های درآمدزایی هیچ تراکنشی را نشان نمی‌دهند. برای مثال، داده‌های Analytics نشان می‌دهد که توسعه‌دهنده تراکنش‌های زیادی را در یک دوره زمانی خاص تکمیل کرده است، اما گزارش‌های «درآمدزایی» هیچ‌یک از آن تراکنش‌ها را فهرست نکرده است.
• تراکنش‌ها ضبط نمی‌شوند

پیام های خطا

ممکن است هیچ پیام خطایی مشاهده نکنید، اما مشکلات را همان‌طور که در بخش علائم توضیح داده شده است خواهید دید.

علل احتمالی

اگر هریک از علائم ذکرشده در علائم را مشاهده می‌کنید، بسیار محتمل است که تراکنش‌ها درآمدزایی نمی‌شوند.

درحال عیب‌یابی علت

1. از فراخوانی API مدیریت که در بخش زیر توضیح داده شده است برای بررسی اینکه آیا تراکنش‌ها درآمدزایی می‌شوند یا نه استفاده کنید.

   مشاهده وضعیت تراکنش‌ها

2. اگر هیچ تراکنشی را به‌عنوان موفقیت‌آمیز در مدت زمان مشخص‌شده مشاهده نکردید، تراکنش‌ها درآمدزایی نمی‌شوند.

دلایل معمول برای عدم درآمدزایی از تراکنش‌ها عبارت‌اند از:

• خط‌مشی بررسی حدود درآمدزایی به پراکسی API پیوست نشده است
• APIProduct درآمدزایی نشده است
• خط‌مشی «ضبط تراکنش» به‌اشتباه تعریف شده است
• توسعه‌دهنده طرح نرخ خریداری نکرده است

بخش‌های زیر نحوه تشخیص و رفع هر مشکل را توضیح می‌دهد.

خط‌مشی «بررسی حدود درآمدزایی» در «پراکسی API» استفاده نشده است

تشخیص

1. بررسی کنید که آیا «خط‌مشی بررسی محدودیت‌های درآمدزایی» به پراکسی‌های API پیوست شده است یا خیر.
2. اگر خط‌مشی پیوست نشده باشد، این می‌تواند دلیل فهرست شدن تراکنش‌ها به‌عنوان ناموفق باشد.

وضوح

«خط‌مشی بررسی حدود درآمدزایی» را به پراکسی‌های میانای برنامه‌سازی کاربردی موردنیاز، طبق آنچه در اعمال حدود درآمدزایی بر پراکسی‌های میانای برنامه‌سازی کاربردی توضیح داده شده است، پیوست کنید.

اگر مشکل ادامه داشت، محصول API درآمدزایی نشده است را بررسی کنید.

محصول API درآمدزایی نشده است

تشخیص

1. بررسی کنید که آیا محصول API درآمدزایی شده است یا نه (فقط محصولات API درآمدزایی‌شده رده‌بندی می‌شوند و در فهرست تراکنش‌ها قرار می‌گیرند). محصول درآمدزا محصولی است که حداقل یک طرح نرخ فعال دردسترس داشته باشد.
2. از فراخوانی مدیریت API زیر برای دریافت فهرست محصولات API درآمدزا استفاده کنید:
   1. اگر «کاربر ابر عمومی» هستید، از API زیر استفاده کنید:

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

   2. اگر «کاربر ابر خصوصی» هستید، از API زیر استفاده کنید:

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

3. اگر محصول API مرتبط با «پراکسی API» شما درآمدزایی نشده باشد، این می‌تواند دلیل درآمدزایی نشدن تراکنش‌ها باشد.

وضوح

برای درآمدزایی از محصول API، مراحل زیر را انجام دهید:

1. خط‌مشی ضبط تراکنش را پیکربندی کنید.

2. بررسی کنید که «محصول میانای برنامه‌سازی کاربردی» طرح نرخ فعال داشته باشد.

اگر مشکل برطرف نشد، خط‌مشی ضبط تراکنش به‌اشتباه تعریف شده است را بررسی کنید.

خط‌مشی ضبط تراکنش به‌درستی تعریف نشده است

تشخیص

1. ردیابی واسط کاربر را برای «پراکسی API» که «خط‌مشی بررسی حدود درآمدزایی» به آن پیوست شده است فعال کنید.
2. درخواست میانای برنامه‌سازی کاربردی خاصی را از ردیابی واسط کاربر انتخاب کنید.
3. جریان Analytics AX را انتخاب کنید و بررسی کنید که آیا متغیرهای جریان درآمدزایی (ضرب سکه) زیر دارای مقادیر مناسب هستند یا خیر:

   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. از فراخوانی API مدیریت زیر برای تأیید طرح‌های نرخ خریداری‌شده توسط توسعه‌دهنده استفاده کنید:
   1. اگر کاربر «ابر عمومی» هستید، از API زیر استفاده کنید:

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

   2. اگر کاربر «ابر خصوصی» هستید، از API زیر استفاده کنید:

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

2. براساس پاسخ تماس بالا، طرحی را که در زمان تکمیل تراکنش توسط توسعه‌دهنده فعال بوده است پیدا کنید.

وضوح

توسعه‌دهنده باید طرح نرخ را براساس الزامات خود خریداری کند و سپس تراکنش‌ها/میاناهای برنامه‌سازی کاربردی را اجرا کند.

اگر مشکل برطرف نشد، با پشتیبانی Apigee Edge تماس بگیرید.