أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى
مستندات Apigee X. info
مقدمة
يمكنك ضبط حدود متعلّقة بتحقيق الربح، كما هو موضّح في مقالة فرض حدود تحقيق الربح باستخدام سياسة التحقّق من حدود تحقيق الربح. يمكنك أيضًا إعداد إشعارات تلقائية لتنبيه المطوّرين و/أو المستخدمين في مؤسستك عند الاقتراب من الحدّ الأقصى أو بلوغه.
يمكنك إعداد إشعارات تلقائية للحدود المخصّصة والحدود الضمنية. على سبيل المثال، يضع النظام حدًا ضمنيًا للمطوّرين الذين يستخدمون الدفع المُسبَق، وهو رصيد الدفع المُسبَق. يمكنك إعداد إشعارات تلقائية ليتم إعلام المطوّرين إذا كانوا على وشك بلوغ رصيد الدفع المُسبق أو إذا بلغوه.
مربع الأدوات
يمكنك إعداد إشعارات تلقائية بشأن الحدود باستخدام واجهة مستخدم الإدارة أو واجهة برمجة التطبيقات لتحقيق الربح. إذا كنت تستخدم واجهة المستخدم، يمكنك إعداد الإشعارات التلقائية في صفحة "الإشعارات".
إذا كنت تستخدم واجهة برمجة التطبيقات، يمكنك إعداد إشعارات تلقائية بشأن الحدود من خلال تعديل نموذج إشعار تقدّمه ميزة تحقيق الربح. بعد ذلك، حدِّد الشرط الذي يؤدي إلى إرسال الإشعار المقدَّم من النموذج المعدَّل.
إعداد إشعارات بلوغ الحد الأقصى باستخدام واجهة المستخدم
- انقر على "إضافة" في قسم "الإشعارات" ضمن صفحة "إضافة حدّ". سيؤدي ذلك إلى فتح قسم "الإشعارات".
- اختَر مستوى للإشعار. هذا الحدّ هو قيمة استنادًا إلى عدد مطلق أو نسبة مئوية من أساس الحدّ. اختَر:
- علامة أكبر من أو يساوي (?) أو علامة أصغر من أو يساوي (?) من القائمة المنسدلة
- عدد صحيح (أي بدون منازل عشرية) قيمة مطلقة (للإشارة إلى قيمة عددية) أو نسبة مئوية للإشارة إلى قيمة نسبة مئوية بالنسبة إلى الحدود المئوية، احرص دائمًا على ضبط الحدّ على >=، ما يعني أنّه يتم إرسال الإشعار عندما يصل المطوّر إلى مستوى النسبة المئوية أو يتجاوزه.
على سبيل المثال، إذا ضبطت حدّ الإنفاق على 100 دولار أمريكي وضبطت الإشعار على أكبر من أو يساوي %90، سيتم إرسال الإشعار عند بلوغ% 90 من الحدّ (90 دولارًا أمريكيًا) أو تجاوزه.
- في حقل "إرسال رسالة إلكترونية"، اختَر مطوّرًا واحدًا أو أكثر، أو اختَر مستخدمًا واحدًا أو أكثر في مؤسستك. سيتم إرسال إشعار إلى المطوّرين أو المستخدمين المتأثرين.
مستلمو الرسائل الإلكترونية: يمكنك إرسال إشعارات إلى المطوّرين فقط إذا ضبطت شرط حد المطوّرين على "أي" أو ضبطت شرط حد المطوّرين مع مطوّر محدّد. إذا اخترت "أي"، سيظهر لك "المطوِّر المحدّد (أي)" في قائمة عناوين البريد الإلكتروني. ويعني ذلك أنّ ميزة تحقيق الربح سترسل إشعارًا إلى أي مطوّرين متأثرين. إذا اخترت مطوّرًا معيّنًا، سيظهر لك "المطوّر المحدّد (
{developer_id})" في قائمة عناوين البريد الإلكتروني (حيث{developer_id}هو تعريف المطوّر المحدّد). سيتم إرسال إشعار إلى هذا المطوّر فقط.إذا لم تحدّد شرط "أي" أو مطوّرًا معيّنًا في "حدود المطوّر"، لن يظهر لك الخيار "المطوّر المحدّد (أي)" في حقل "إرسال رسالة إلكترونية". ومع ذلك، يمكنك اختيار المستخدمين الذين تريد إرسال إشعارات إليهم من مؤسستك.
يمكنك إضافة عناوين البريد الإلكتروني لمستخدمي مؤسستك من خلال اختيار "مستخدمو المؤسسة" في علامة التبويب "المشرف".
نماذج الرسائل الإلكترونية: سيظهر لك نموذج رسالة إلكترونية بعد اختيار "المطوّر المحدّد (أي)" أو عناوين البريد الإلكتروني للمستخدمين في مؤسستك (أو كليهما) في حقل "إرسال رسالة إلكترونية". يعتمد المحتوى الذي يظهر في النموذج على ما يلي:
- مستوى الإشعار
- ما إذا كان الحدّ الأقصى هو حدّ إيقاف التنفيذ.
- ما إذا كان البريد الإلكتروني مخصّصًا لمستخدمي المؤسسة أو المطوّرين أو كليهما
على سبيل المثال، إذا كانت جميع الشروط التالية صحيحة:
- تم وضع علامة في مربّع الاختيار "إيقاف التنفيذ".
- يكون مستوى الإشعار% 100 أو المبلغ نفسه الذي يمثّل الحدّ الأقصى.
- البريد الإلكتروني مخصّص لمستخدمي المؤسسة فقط.
يبدو القالب على النحو التالي:
لنفترض أنّ اسم شركة المطوّر هو "شركة XYZ"، وأنّ الحد الأقصى لحجم المعاملات هو 50 لحزمة واجهة برمجة التطبيقات المسماة "الحزمة X" وللمنتج المسماة "المنتج Y"، وأنّ تاريخ انتهاء الصلاحية هو 30 سبتمبر 2013. ستبدو رسالة البريد الإلكتروني التي يتم إرسالها كما يلي:
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
إذا كان البريد الإلكتروني موجّهًا إلى "مطوّر محدّد (أي)"، سيظهر النموذج على النحو التالي:
سيحلّ كلا النموذجين المتغيرات ذات الصلة، مثل اسم المطوّر (إذا كان ذلك منطبقًا) واسم الحزمة (إذا كان ذلك منطبقًا) واسم المنتج (إذا كان ذلك منطبقًا). يمكنك تعديل الرسالة لتلبية متطلباتك من خلال النقر على "تعديل" على يمين النموذج.
إذا كان الحدّ الأقصى ينطبق على "أي" تطبيق أو تطبيق معيّن و "أي" مستخدم أو مستخدم معيّن، عليك أيضًا إضافة متغيرات للتطبيقات والمستخدمين إلى النموذج. يمكنك إجراء ذلك باتّباع الخطوات التالية:
- انقر على "تعديل" على يمين النموذج.
- إضافة
${user.name}user, depending on whether the limit is for application and/or user.
يظهر أدناه نموذج تم تعديله لـ "أي تطبيق" أو تطبيق معيّن.
إذا لم يتم وضع علامة في المربّع Halt execution، أو كان مستوى الإشعار أكبر من أو يساوي 100%، سيبدو النموذج الخاص بمطوّر محدّد على النحو التالي:
مرة أخرى، إذا كان الحدّ الأقصى مخصّصًا لأي تطبيق (أو تطبيق معيّن) أو لأي مستخدم (أو مستخدم معيّن)، عليك تعديل النموذج ثم إضافة
${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}.
- أضِف إشعارات حسب الحاجة للمستويات الإضافية. لكل مستوى إضافي، انقر على "إضافة". يؤدي ذلك إلى إضافة "مستوى" و"إرسال رسالة إلكترونية" و"مساحة نموذج الرسالة الإلكترونية" إلى قسم "الإشعارات" في الصفحة. يمكنك إضافة ما يصل إلى 6 مستويات للإشعارات. على سبيل المثال، إذا ضبطت الإشعار على > %70 و%80 و%90 و%100، سيتم إرسال إشعار عند الوصول إلى كل مستوى من هذه المستويات.
- بعد إضافة جميع الإشعارات، انقر على "حفظ" (لحفظ الإشعارات ونشرها في وقت لاحق) أو "حفظ ونشر" (للنشر الآن) أو "إلغاء" (للإلغاء).
إعداد إشعارات الحدّ الأقصى باستخدام واجهة برمجة التطبيقات
توفّر ميزة تحقيق الربح مجموعة من النماذج التي تقدّم نصًا لأنواع مختلفة من الإشعارات، بما في ذلك إشعارات الحدّ الأقصى والإشعارات المخصّصة، مثل تنبيه المطوّرين بشأن توفّر منتجات جديدة. يمكنك تخصيص أي من هذه النماذج لتلبية احتياجاتك. لإعداد إشعار تلقائي بالحدّ الأقصى، عليك أولاً تعديل نموذج مناسب. بعد ذلك، حدِّد الشرط الذي يؤدي إلى إرسال الإشعار المقدَّم من النموذج المعدَّل. لمزيد من التفاصيل، اطّلِع على إعداد الإشعارات باستخدام نماذج الإشعارات.
الخطوات التالية
تعرَّف على كيفية إعداد الإشعارات التلقائية لتنبيه المطوّرين بشأن أحداث مثل المنتجات الجديدة أو الإصدارات الجديدة من"بنود الخدمة" أو خطط الأسعار الجديدة. اطّلِع على مقالة إعداد الإشعارات باستخدام نماذج الإشعارات.