يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات
Apigee X. المعلومات
مقدمة
يمكنك ضبط الحدود المتعلقة بتحقيق الربح كما هو موضّح في المقالة فرض حدود على ميزة تحقيق الربح باستخدام سياسة التحقّق من القيود المفروضة على تحقيق الربح. يمكنك أيضًا إعداد إشعارات تلقائية لتنبيه المطوّرين و/أو المستخدمين في مؤسستك عند اقتراب الحدّ الأقصى المسموح به أو بلوغه.
يمكنك إعداد الإشعارات التلقائية بشأن الحدود المخصّصة والحدود الضمنية. على سبيل المثال، يضع النظام حدًا ضمنيًا لمطوّري البرامج المدفوعة مسبقًا، وهو رصيدهم المدفوع مسبقًا. يمكنك إعداد إشعارات تلقائية بحيث يتم إعلام المطوّرين في حال اقترابهم من بلوغ رصيدهم المدفوع مسبقًا أو الوصول إليه.
مربع الأدوات
يمكنك إعداد الإشعارات التلقائية بشأن الحدود القصوى المسموح بها باستخدام واجهة مستخدم الإدارة أو واجهة برمجة التطبيقات لتحقيق الربح. وإذا كنت تستخدم واجهة المستخدم، يمكنك إعداد الإشعارات التلقائية على صفحة "الإشعارات".
إذا كنت تستخدم واجهة برمجة التطبيقات، يمكنك إعداد الإشعارات التلقائية بشأن الحدود من خلال تعديل نموذج الإشعارات الذي تقدّمه ميزة تحقيق الربح. بعد ذلك، عليك تحديد الشرط الذي يؤدي إلى إرسال الإشعار المقدَّم من النموذج المعدَّل.
إعداد الحد الأقصى المسموح به للإشعارات باستخدام واجهة المستخدم
- انقر على إضافة في القسم "الإشعارات" من صفحة "إضافة حد". سيؤدي هذا الإجراء إلى فتح قسم
"الإشعار".
- اختَر مستوى الإشعار. يمثّل هذا الحدّ حدًّا يستند إلى عدد مطلق أو
نسبة مئوية من الحد الأساسي. اختَر أيًا مما يلي:
- أكبر من أو يساوي علامة (?) أو أقل من أو يساوي علامة (?) من القائمة المنسدلة.
- عدد صحيح (أي بدون خانات عشرية). قيمة مطلقة (للإشارة إلى قيمة رقم) أو نسبة مئوية للإشارة إلى قيمة النسبة المئوية. بالنسبة إلى حدود النسبة المئوية، تأكَّد دائمًا من ضبط الحدّ على >، ما يعني أنّه يتم إرسال الإشعار عندما يصل المطوّر إلى هذه النسبة المئوية أو يتجاوزها.
على سبيل المثال، إذا ضبطت حد الإنفاق بقيمة 100 دولار أمريكي (أو ما يعادله بالعملة المحلية) وضبطت الإشعار على قيمة أكبر من أو يساوي 90%، سيتم إرسال الإشعار عند بلوغ 90% من الحدّ الأقصى (90 دولار أمريكي) أو تجاوزه.
- في حقل "إرسال رسالة إلكترونية"، اختَر مطوّرًا واحدًا أو أكثر، أو اختَر مستخدمًا واحدًا أو أكثر في
مؤسستك. سيتم إرسال إشعار إلى المطوّرين أو المستخدمين المتأثرين.
مستلمو البريد الإلكتروني: لا يمكنك إرسال الإشعارات إلى المطوّرين إلا إذا ضبطت شرطًا للحدّ الأقصى للمطوّر على "أي" أو ضبطت شرطًا للحدّ الأقصى للمطوّر مع مطوّر محدّد. إذا اخترت "أيّ"، سترى "مطوّر البرامج المحدَّد (أيّ)" في قائمة عناوين البريد الإلكتروني. هذا يعني أنّ ميزة تحقيق الربح سترسل إشعارًا إلى أي مطوّر برامج متأثر بهذا التغيير. في حال اخترت مطوّرًا معيّنًا، سترى عبارة "مطوّر البرامج المحدّد (
{developer_id})" في قائمة عناوين البريد الإلكتروني (حيث يشير{developer_id}إلى تعريف المطوّر الذي تم اختياره). وسترسل ميزة تحقيق الربح إشعارًا إلى المطوّر المحدّد فقط.إذا لم تختَر شرط الحد الأقصى للمطوّرين "أي" أو لمطوّر محدّد، لن يظهر لك "المطوّر المحدد (أي)" في حقل "إرسال رسالة إلكترونية". ومع ذلك، يمكنك اختيار المستخدمين في مؤسستك الذين تريد إعلامهم.
يمكنك إضافة عناوين البريد الإلكتروني لمستخدمي مؤسستك من خلال اختيار "مستخدمو المؤسسة" في علامة تبويب "المشرف".
نماذج الرسائل الإلكترونية: سيظهر لك نموذج رسالة إلكترونية بعد اختيار "إرسال رسالة إلكترونية" في حقل "المطوّر المحدد (أي)" أو عناوين البريد الإلكتروني للمستخدمين في مؤسستك (أو كليهما).ويعتمد ما يظهر في النموذج على ما يلي:
- مستوى الإشعار.
- ما إذا كان الحد عبارة عن إيقاف التنفيذ أم لا.
- ما إذا كانت رسالة البريد الإلكتروني موجّهة إلى مستخدمي المؤسسة أو المطوّرين أو كليهما.
على سبيل المثال، إذا كان كل ما يلي صحيحًا:
- تم وضع علامة في مربّع الاختيار إيقاف تنفيذ الإجراء.
- مستوى الإشعار هو 100% أو نفس مقداره المحدد.
- هذا البريد الإلكتروني مخصَّص لمستخدمي المؤسسة فقط.
يبدو القالب كما يلي:
لنفترض أنّ اسم شركة المطوّر هو "شركة XYZ"، وقد تم ضبط الحدّ الأقصى لحجم المعاملات على 50 لحزمة واجهة برمجة التطبيقات باسم "X Package" ومنتج واجهة برمجة تطبيقات باسم "Y Product" وأنّ تاريخ انتهاء الصلاحية قد تم ضبطه في 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.
يظهر أدناه نموذج تم تعديله لـ "أي" أو لتطبيق محدد.
إذا لم يتم وضع علامة على توقّف التنفيذ أو إذا كان مستوى الإشعار أكبر من أو يساوي 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%، سيتم إرسال إشعار عند الوصول إلى كل مستوى من هذه المستويات.
- بعد إضافة جميع الإشعارات، انقر على "حفظ" (لحفظ الإشعارات ونشرها في تاريخ لاحق) أو "حفظ ونشر" (للنشر الآن) أو "إلغاء" (للإلغاء).
جارٍ ضبط حدود الإشعارات باستخدام واجهة برمجة التطبيقات
توفر ميزة تحقيق الربح مجموعة من النماذج التي توفِّر نصًا لأنواع مختلفة من الإشعارات، بما في ذلك إشعارات بشأن الحدّ الأقصى وإشعارات مخصّصة مثل تنبيه المطوّرين بتوفّر منتجات جديدة. ويمكنك تخصيص أيّ من هذه النماذج لتلبية احتياجاتك. لإعداد إشعار بالحدّ الأقصى تلقائيًا، عليك أولاً تعديل نموذج مناسب. بعد ذلك، حدِّد الشرط الذي يؤدي إلى إرسال الإشعار الذي يوفّره النموذج المعدَّل. ولمزيد من التفاصيل، يُرجى الاطّلاع على إعداد الإشعارات باستخدام نماذج الإشعارات.
الخطوات التالية
يمكنك التعرّف على كيفية إعداد الإشعارات التلقائية حتى تتمكّن من تنبيه المطوّرين بشأن أحداث، مثل المنتجات الجديدة أو الإصدارات الجديدة من الأحكام والشروط أو خطط الأسعار الجديدة. يمكنك الاطّلاع على إعداد الإشعارات باستخدام نماذج الإشعارات.