সীমা বিজ্ঞপ্তি সেট আপ করুন

আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।

ভূমিকা

আপনি ‘মনিটাইজেশন লিমিটস চেক’ পলিসি ব্যবহার করে মনিটাইজেশন সীমা প্রয়োগ করা অংশে বর্ণিত পদ্ধতি অনুযায়ী মনিটাইজেশন-সম্পর্কিত সীমা নির্ধারণ করতে পারেন। এছাড়াও, আপনি স্বয়ংক্রিয় নোটিফিকেশন সেট আপ করতে পারেন, যা কোনো সীমা কাছাকাছি এলে বা পৌঁছে গেলে আপনার প্রতিষ্ঠানের ডেভেলপার এবং/অথবা ব্যবহারকারীদের সতর্ক করে দেবে।

আপনি কাস্টম লিমিটের পাশাপাশি ইমপ্লিসিট লিমিটের জন্যও স্বয়ংক্রিয় নোটিফিকেশন সেট আপ করতে পারেন। উদাহরণস্বরূপ, সিস্টেম আপনার প্রিপেইড ডেভেলপারদের জন্য একটি ইমপ্লিসিট লিমিট নির্ধারণ করে, যা হলো তাদের প্রিপেইড ব্যালেন্স। আপনি স্বয়ংক্রিয় নোটিফিকেশন সেট আপ করতে পারেন, যাতে আপনার ডেভেলপাররা তাদের প্রিপেইড ব্যালেন্সের কাছাকাছি পৌঁছালে বা সেই সীমায় পৌঁছে গেলে অবহিত হন।

টুলবক্স

আপনি ম্যানেজমেন্ট UI অথবা মনিটাইজেশন API ব্যবহার করে লিমিটের জন্য স্বয়ংক্রিয় নোটিফিকেশন সেট আপ করতে পারেন। যদি আপনি UI ব্যবহার করেন, তাহলে নোটিফিকেশন পেজে স্বয়ংক্রিয় নোটিফিকেশন সেট আপ করতে হবে।

আপনি যদি এপিআই ব্যবহার করেন, তাহলে মনিটাইজেশন থেকে দেওয়া একটি নোটিফিকেশন টেমপ্লেট সম্পাদনা করে লিমিটের জন্য স্বয়ংক্রিয় নোটিফিকেশন সেট আপ করেন। এরপর আপনি সেই শর্তটি নির্দিষ্ট করেন, যার ফলে সম্পাদিত টেমপ্লেট অনুযায়ী নোটিফিকেশনটি পাঠানো হয়।

UI ব্যবহার করে নোটিফিকেশন সীমিত করার ব্যবস্থা করা

  1. অ্যাড লিমিট পেইজের নোটিফিকেশন সেকশনে থাকা অ্যাড-এ ক্লিক করুন। এতে নোটিফিকেশন সেকশনটি খুলে যাবে।

  2. বিজ্ঞপ্তির জন্য একটি স্তর নির্বাচন করুন। এটি একটি নির্দিষ্ট সংখ্যা বা সীমার শতাংশের উপর ভিত্তি করে নির্ধারিত একটি থ্রেশহোল্ড। নির্বাচন করুন:
    • ড্রপ-ডাউন মেনু থেকে বৃহত্তর বা সমান চিহ্ন (?) অথবা ক্ষুদ্রতর বা সমান চিহ্ন (?)।
    • একটি পূর্ণ সংখ্যা (অর্থাৎ, কোনো দশমিক স্থান ছাড়া)। অ্যাবসোলিউট (সংখ্যাসূচক মান বোঝাতে) অথবা পার্সেন্টেজ (শতাংশ মান বোঝাতে)। শতাংশের সীমার জন্য, সর্বদা নিশ্চিত করুন যে আপনি সীমাটি > হিসাবে সেট করেছেন, যার অর্থ হলো যখন ডেভেলপার সেই শতাংশ স্তরে পৌঁছায় বা অতিক্রম করে, তখন নোটিফিকেশনটি পাঠানো হয়।

    উদাহরণস্বরূপ, যদি আপনি $100 খরচের সীমা নির্ধারণ করেন এবং নোটিফিকেশনটি ৯০% বা তার বেশিতে সেট করেন, তাহলে সীমার ৯০% ($90) পূরণ হলে বা অতিক্রম করলে নোটিফিকেশনটি পাঠানো হবে।

  3. 'ইমেল পাঠান' ফিল্ডে, আপনার প্রতিষ্ঠানের এক বা একাধিক ডেভেলপার অথবা এক বা একাধিক ব্যবহারকারীকে নির্বাচন করুন। সংশ্লিষ্ট ডেভেলপার বা ব্যবহারকারীদের কাছে নোটিফিকেশন পাঠানো হবে।

    ইমেল প্রাপক: আপনি শুধুমাত্র তখনই ডেভেলপারদের কাছে নোটিফিকেশন পাঠাতে পারবেন, যদি আপনি ডেভেলপার লিমিট কন্ডিশন হিসেবে "যেকোনো" (Any) সেট করেন অথবা কোনো নির্দিষ্ট ডেভেলপারের জন্য লিমিট কন্ডিশন সেট করেন। যদি আপনি "যেকোনো" (Any) নির্বাচন করেন, তাহলে ইমেল অ্যাড্রেসের তালিকায় আপনি "নির্বাচিত ডেভেলপার (যেকোনো)" (Selected developer (Any)) দেখতে পাবেন। এর মানে হলো, মনিটাইজেশন যেকোনো প্রভাবিত ডেভেলপারের কাছে একটি নোটিফিকেশন পাঠাবে। যদি আপনি কোনো নির্দিষ্ট ডেভেলপার নির্বাচন করেন, তাহলে ইমেল অ্যাড্রেসের তালিকায় আপনি "নির্বাচিত ডেভেলপার ( {developer_id} )" (Selected developer ({developer_id})) দেখতে পাবেন (যেখানে {developer_id} হলো নির্বাচিত ডেভেলপারের পরিচয়)। মনিটাইজেশন শুধুমাত্র সেই নির্দিষ্ট ডেভেলপারের কাছেই একটি নোটিফিকেশন পাঠাবে।

    যদি আপনি ডেভেলপার সীমাবদ্ধতার শর্ত হিসেবে 'যেকোনো' বা কোনো নির্দিষ্ট ডেভেলপার নির্বাচন না করে থাকেন, তাহলে আপনি 'ইমেল পাঠান' ফিল্ডে 'নির্বাচিত ডেভেলপার (যেকোনো)' দেখতে পাবেন না। তবে, আপনি আপনার প্রতিষ্ঠানের কোন ব্যবহারকারীদের অবহিত করতে চান তা বেছে নিতে পারেন।

    অ্যাডমিন ট্যাবে ‘অর্গানাইজেশন ইউজার্স’ নির্বাচন করে আপনি আপনার প্রতিষ্ঠানের ব্যবহারকারীদের জন্য ইমেল ঠিকানা যোগ করতে পারেন।

    ইমেল টেমপ্লেট: 'ইমেল পাঠান' ফিল্ডে 'নির্বাচিত ডেভেলপার (যেকোনো)' অথবা আপনার প্রতিষ্ঠানের ব্যবহারকারীদের ইমেল ঠিকানা (বা উভয়ই) নির্বাচন করার পর আপনি একটি ইমেল টেমপ্লেট দেখতে পাবেন। টেমপ্লেটে কী প্রদর্শিত হবে তা নিম্নলিখিত বিষয়গুলির উপর নির্ভর করে:

    • বিজ্ঞপ্তির স্তর।
    • সীমাটি কার্য সম্পাদন স্থগিত করার সীমা ছিল কি না।
    • ইমেলটি প্রতিষ্ঠানের ব্যবহারকারী, ডেভেলপার, নাকি উভয়ের জন্যই ছিল।

    উদাহরণস্বরূপ, যদি নিম্নলিখিত সবগুলিই সত্য হয়:

    • ‘Halt execution’ চেকবক্সটি চেক করা আছে।
    • বিজ্ঞপ্তির মাত্রা হলো ১০০% অথবা নির্ধারিত সীমার সমান পরিমাণ।
    • এই ইমেলটি শুধুমাত্র প্রতিষ্ঠানের ব্যবহারকারীদের জন্য।

    টেমপ্লেটটি দেখতে এইরকম:

    ধরে নিন যে ডেভেলপারের কোম্পানির নাম "XYZ কোম্পানি", "X প্যাকেজ" নামক একটি এপিআই প্যাকেজ এবং "Y প্রোডাক্ট" নামক একটি এপিআই প্রোডাক্টের জন্য লেনদেনের পরিমাণ সীমা ৫০-এ সেট করা আছে, এবং মেয়াদ শেষ হওয়ার তারিখ ৩০শে সেপ্টেম্বর, ২০১৩ নির্ধারণ করা আছে। যে ইমেল বার্তাটি পাঠানো হবে তা দেখতে এইরকম হবে:

    Developer XYZ company has exceeded their transaction volume limit of 50 transactions for X package, Y product. Their API calls will be blocked till 2013-09-30

    যদি ইমেলটি "নির্বাচিত ডেভেলপার (যেকোনো)"-কে পাঠানো হয়, তাহলে টেমপ্লেটটি নিম্নরূপ দেখাবে:

    উভয় টেমপ্লেটই প্রাসঙ্গিক ভেরিয়েবলগুলো, যেমন ডেভেলপারের নাম (যদি প্রযোজ্য হয়), প্যাকেজের নাম (যদি প্রযোজ্য হয়), এবং পণ্যের নাম (যদি প্রযোজ্য হয়), স্বয়ংক্রিয়ভাবে পূরণ করে নেবে। টেমপ্লেটের বাম দিকে থাকা 'সম্পাদনা' (Edit) বোতামে ক্লিক করে আপনি আপনার প্রয়োজন অনুযায়ী বার্তাটি সম্পাদনা করতে পারেন।

    যদি সীমাটি 'যেকোনো' বা একটি নির্দিষ্ট অ্যাপ্লিকেশন এবং 'যেকোনো' বা একজন নির্দিষ্ট ব্যবহারকারীর জন্য হয়, তাহলে আপনাকে টেমপ্লেটে অ্যাপ্লিকেশন(গুলি) এবং ব্যবহারকারী(গুলি)-র জন্য ভেরিয়েবলও যোগ করতে হবে। আপনি এটি নিম্নলিখিত উপায়ে করতে পারেন:

    • টেমপ্লেটের বাম দিকে থাকা সম্পাদনা বোতামে ক্লিক করুন।
    • ${user.name} user, depending on whether the limit is for application and/or user.

    'যেকোনো' বা কোনো নির্দিষ্ট অ্যাপ্লিকেশনের জন্য সম্পাদিত একটি টেমপ্লেট নিচে দেখানো হলো।

    যদি ‘Halt execution’ চেক করা না থাকে, অথবা নোটিফিকেশন লেভেল ১০০% বা তার বেশি হয়, তাহলে নির্বাচিত ডেভেলপারের টেমপ্লেটটি দেখতে এইরকম হয়:

    আবার, যদি সীমাটি 'যেকোনো' (বা একটি নির্দিষ্ট) অ্যাপ্লিকেশন, অথবা 'যেকোনো' (বা একটি নির্দিষ্ট) ব্যবহারকারীর জন্য হয়, তাহলে আপনাকে টেমপ্লেটটি সম্পাদনা করতে হবে এবং সীমাটি একটি অ্যাপ্লিকেশন, একজন ব্যবহারকারী, নাকি উভয়ের জন্য, তার উপর নির্ভর করে ${application.name} অ্যাপ্লিকেশন এবং/অথবা ${user.name} ব্যবহারকারী যোগ করতে হবে।

    টেমপ্লেট ভেরিয়েবল: ইমেল টেমপ্লেটে বার্তা সম্পাদনা করার সময়, আপনি নিম্নলিখিত ভেরিয়েবলগুলোর যেকোনোটি অন্তর্ভুক্ত করতে পারেন।

    পরিবর্তনশীল বর্ণনা
    ${developer.name}

    ডেভেলপারের নাম।

    ${developer.legalName}

    উন্নয়নকারী কোম্পানির নাম।

    ${ratePlan.monetizationPackage.displayName}

    এপিআই প্যাকেজের নাম।

    ${application.name}

    অ্যাপ্লিকেশনটির নাম।

    ${USER}

    ব্যবহারকারীর নাম।

    ${USAGE}

    বর্তমান ব্যবহার (মোট রাজস্ব বা চার্জ, বা পরিমাণ)।

    ${PERCENT}

    বর্তমান ব্যবহারের ফলে সীমার যে শতাংশে পৌঁছেছে।

    ${QUOTA_TYPE}

    সীমার ধরণ (লেনদেনের পরিমাণ, ব্যয়ের সীমা, বা ফি-এর ঝুঁকি)।

    ${QUOTA_UNIT}

    সীমার মূল একক: মুদ্রা (ব্যয় সীমার জন্য), অথবা কল (লেনদেন সীমার জন্য)।

    ${QUOTA_LIMIT}

    সীমার পরিমাণ।

    ${EXPIRY_DATE}

    যে তারিখ বা সময়ে সীমাটির মেয়াদ শেষ হয় অথবা যখন এটি পুনরায় সেট করা হয়।

    উদাহরণস্বরূপ, যদি আপনি চান যে কোনো অ্যাপ্লিকেশনের কোনো প্যাকেজের জন্য কোনো ডেভেলপার লেনদেনের পরিমাণের একটি নির্দিষ্ট শতাংশে পৌঁছালে আপনাকে জানানো হোক, তাহলে আপনি টেমপ্লেটটি সম্পাদনা করে এটিকে এইরকম করতে পারেন:

    ${developer.legalName} has reached a total volume of ${USAGE} on ${ratePlan.monetizationPackage.displayName}. This is ${PERCENT} of the daily/weekly/monthly (state period of limit as appropriate) transaction volume limit of ${QUOTA_LIMIT}.
  4. অতিরিক্ত লেভেলের জন্য প্রয়োজন অনুযায়ী নোটিফিকেশন যোগ করুন। প্রতিটি অতিরিক্ত লেভেলের জন্য, 'যোগ করুন' (Add) বোতামে ক্লিক করুন। এটি পেজের 'নোটিফিকেশন' (Notifications) বিভাগে একটি 'লেভেল' (Level), 'ইমেল পাঠান' (Send email), এবং 'ইমেল টেমপ্লেট' (Email template) অংশ যোগ করবে। আপনি আপনার নোটিফিকেশনের জন্য সর্বোচ্চ ৬টি লেভেল যোগ করতে পারেন। উদাহরণস্বরূপ, যদি আপনি নোটিফিকেশনটি > ৭০%, ৮০%, ৯০%, ১০০% হিসাবে সেট করেন, তাহলে এই লেভেলগুলোর প্রতিটিতে পৌঁছালে একটি নোটিফিকেশন পাঠানো হবে।
  5. সবগুলো নোটিফিকেশন যোগ করার পর, সেভ (পরবর্তীতে নোটিফিকেশনগুলো সংরক্ষণ ও প্রকাশ করার জন্য), সেভ অ্যান্ড পাবলিশ (এখনই প্রকাশ করার জন্য), অথবা ক্যানসেল (বাতিল করার জন্য) -এ ক্লিক করুন।

এপিআই ব্যবহার করে লিমিট নোটিফিকেশন সেট আপ করা

মনিটাইজেশন একগুচ্ছ টেমপ্লেট প্রদান করে, যা বিভিন্ন ধরণের নোটিফিকেশনের জন্য টেক্সট সরবরাহ করে। এর মধ্যে লিমিট নোটিফিকেশন এবং অ্যাড-হক নোটিফিকেশন, যেমন—নতুন পণ্যের প্রাপ্যতা সম্পর্কে ডেভেলপারদের সতর্ক করা, অন্তর্ভুক্ত। আপনি আপনার প্রয়োজন অনুযায়ী এই টেমপ্লেটগুলোর যেকোনোটি পরিবর্তন করে নিতে পারেন। একটি স্বয়ংক্রিয় লিমিট নোটিফিকেশন সেট আপ করতে, প্রথমে একটি উপযুক্ত টেমপ্লেট সম্পাদনা করুন। তারপর, সম্পাদিত টেমপ্লেট দ্বারা প্রদত্ত নোটিফিকেশনটি পাঠানোর শর্তটি নির্দিষ্ট করুন। আরও বিস্তারিত জানতে, ‘নোটিফিকেশন টেমপ্লেট ব্যবহার করে নোটিফিকেশন সেট আপ করুন’ দেখুন।

পরবর্তী পদক্ষেপ

কীভাবে স্বয়ংক্রিয় নোটিফিকেশন সেট আপ করতে হয় তা জানুন, যাতে আপনি ডেভেলপারদের নতুন পণ্য, শর্তাবলীর নতুন সংস্করণ বা নতুন রেট প্ল্যানের মতো ইভেন্ট সম্পর্কে সতর্ক করতে পারেন। নোটিফিকেশন টেমপ্লেট ব্যবহার করে নোটিফিকেশন সেট আপ দেখুন।