মনিটাইজেশন সংক্রান্ত সমস্যার সমাধান করা

আপনি 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. আপনি Private Cloud ব্যবহারকারী হলে, নিচে উল্লেখ করা API ব্যবহার করুন:
      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

  1. ডেভেলপার রেট প্ল্যান ও ট্রানজ্যাকশনের বিবরণ পেতে, নিম্নলিখিত API কল করুন:
    • ডেভেলপার যেসব রেট প্ল্যান কিনেছেন সেগুলির শুরু ও শেষ হওয়ার তারিখ পেতে নিম্নলিখিত API কল রান করান:
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/developers/%7Bdeveloper_id%7D/developer-accepted-rateplans
      
    • ডেভেলপার কতগুলি সফল ট্রানজ্যাকশন করেছেন তা জানতে নিম্নলিখিত API কল রান করান:
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/transactions/developers/%7Bdeveloper_email_or_id%7D
      
  2. এছাড়াও, Edge UI-তে, আপনি কোনও ডেভেলপারকে কতগুলি কল করার অনুমতি দেওয়া হয়েছে তা চেক করতে পারেন:

    প্যাকেজ > PackageName > RatePlanName > Rate Card

    যেমন, প্যাকেজের নাম Pro Package এবং এটি ফ্রি প্ল্যান হলে, পাথটি হবে:

    প্যাকেজ > Pro প্যাকেজ > ফ্রি প্ল্যান > রেট কার্ড

NO_CURRENT_PUBLISHABLE_ENTITY

API কল করার জন্য ডেভেলপারকে রেট প্ল্যান কিনতে হবে।

মনিটাইজেশন সেট-আপ সংক্রান্ত সমস্যা

উপসর্গ

মনিটাইজেশন সেট-আপ সংক্রান্ত সমস্যা বিভিন্ন লক্ষণ হিসেবে দেখা দিতে পারে, যেমন:

  • ওয়েবহুক ফাংশনালিটি কাজ করছে না
  • ওয়েবহুক তৈরি করা যাচ্ছে না
  • ওয়েবহুক বিজ্ঞপ্তি ট্রিগার না হওয়া
  • মনিটাইজেশন রিপোর্টে কোনও ট্রানজ্যাকশন দেখা যাচ্ছে না। যেমন, Analytics ডেটা থেকে বোঝা যাচ্ছে যে ডেভেলপার একটি নির্দিষ্ট সময়সীমার মধ্যে অনেক ট্রানজ্যাকশন সম্পূর্ণ করেছেন, কিন্তু মনিটাইজেশন রিপোর্টে সেইসব ট্রানজ্যাকশনের কোনওটিই তালিকাভুক্ত করা নেই।
  • ট্রানজ্যাকশন রেকর্ড করা হচ্ছে না

সমস্যার মেসেজ

আপনি কোনও ত্রুটি মেসেজ দেখতে না পেলেও, লক্ষণ বিভাগে ব্যাখ্যা করা সমস্যাগুলি দেখতে পাবেন।

সম্ভাব্য কারণ

আপনি যদি উপসর্গ-এ তালিকাভুক্ত কোনও উপসর্গ দেখতে পান, তাহলে এটি খুব সম্ভবত ট্রানজ্যাকশন মনিটাইজ করা হচ্ছে না।

সমস্যার কারণ নির্ণয় করা

  1. ট্রানজ্যাকশন মনিটাইজ করা হচ্ছে কিনা তা চেক করতে নিচের বিভাগে বর্ণিত ম্যানেজমেন্ট API কল ব্যবহার করুন।

    ট্রানজ্যাকশনের স্ট্যাটাস দেখা

  2. নির্দিষ্ট সময়ের মধ্যে কোনও ট্রানজ্যাকশন সম্পূর্ণ হয়েছে হিসেবে তালিকাভুক্ত না থাকলে, বুঝতে হবে যে ট্রানজ্যাকশন মনিটাইজ করা হয়নি।

ট্রানজ্যাকশন মনিটাইজ না হওয়ার সাধারণ কারণগুলি হল:

নিচের বিভাগে প্রতিটি সমস্যা কীভাবে শনাক্ত ও সমাধান করতে হয় তা বর্ণনা করা হয়েছে।

API প্রক্সিতে মনিটাইজেশন সীমা চেক করার নীতি ব্যবহার করা হয় না

ডায়াগনসিস

  1. API প্রক্সির সাথে মনিটাইজেশন সীমা চেক করার নীতি অ্যাটাচ করা আছে কিনা তা চেক করুন।
  2. নীতি অ্যাটাচ করা না থাকলে, এই কারণে ট্রানজ্যাকশনকে সম্পূর্ণ হয়নি হিসেবে তালিকাভুক্ত করা হতে পারে।

রেজোলিউশন

প্রয়োজনীয় API প্রক্সি সার্ভারে মনিটাইজেশন সীমা চেক করার নীতি অ্যাটাচ করুন, যেমনটি API প্রক্সি সার্ভারে মনিটাইজেশন সীমা প্রয়োগ করুন নিবন্ধে বর্ণনা করা হয়েছে।

সমস্যাটি হতে থাকলে, 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. আপনি Private Cloud ব্যবহারকারী হলে, নিচে উল্লেখ করা API ব্যবহার করুন:
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
  3. আপনার API প্রক্সির সাথে যুক্ত API প্রোডাক্ট মনিটাইজ করা না থাকলে, এটি হতে পারে যে এই কারণে ট্রানজ্যাকশন মনিটাইজ করা হচ্ছে না।

রেজোলিউশন

API প্রোডাক্ট মনিটাইজ করতে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

  1. ট্রানজ্যাকশন রেকর্ডিং নীতি কনফিগার করুন।

  2. API প্রোডাক্টে অ্যাক্টিভ রেট প্ল্যান আছে কিনা তা চেক করুন।

সমস্যাটি চলতে থাকলে, চেক করুন ট্রানজ্যাকশন রেকর্ডিং নীতি ভুলভাবে সংজ্ঞায়িত করা হয়েছে।

ট্রানজ্যাকশন রেকর্ডিং নীতি ভুলভাবে সংজ্ঞায়িত করা হয়েছে

ডায়াগনসিস

  1. যে API প্রক্সির সাথে মনিটাইজেশন সীমা চেক করার নীতি অ্যাটাচ করা আছে তার জন্য UI ট্রেস চালু করুন।
  2. UI ট্রেস থেকে নির্দিষ্ট API অনুরোধ বেছে নিন।
  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. এখানে একটি স্যাম্পেল UI ট্রেস দেওয়া হল যা থেকে বোঝা যায় যে মিন্ট ফ্লো ভেরিয়েবল সঠিকভাবে সেট-আপ করা হয়েছে।

  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. আপনি Private Cloud ব্যবহারকারী হলে, নিচে উল্লেখ করা API ব্যবহার করুন:
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
  2. উপরের কল থেকে পাওয়া উত্তরের ভিত্তিতে, সেই প্ল্যানটি খুঁজে বের করুন যেটি সেই সময়ে অ্যাক্টিভ ছিল যখন ডেভেলপার ট্রানজ্যাকশন সম্পূর্ণ করেছিলেন।

রেজোলিউশন

ডেভেলপারকে তার প্রয়োজন অনুযায়ী রেট প্ল্যান কিনতে হবে এবং তারপর ট্রানজ্যাকশন/API এক্সিকিউট করতে হবে।

সমস্যার সমাধান না হলে, Apigee Edge সহায়তা টিমের সাথে যোগাযোগ করুন।