خطوات إعداد ميزة تحقيق الربح

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

قبل البدء

قبل البدء في استخدام ميزة تحقيق الربح مع مؤسسة Apigee، عليك تنفيذ المهام الأساسية التالية:

  • أنشِئ حسابًا على Apigee Edge، كما هو موضّح في إنشاء حساب على Apigee Edge.
  • تحقيق الربح من عمليات الشراء لا يتضمّن Edge في البداية واجهة برمجة التطبيقات لتحقيق الربح أو يدمج ميزة تحقيق الربح في واجهة مستخدم الإدارة. عليك شراء ميزة تحقيق الربح لدمج واجهة برمجة التطبيقات لتحقيق الربح ومكوّنات واجهة المستخدم لتحقيق الربح في Edge لمؤسستك على Apigee.

بعد شراء ميزة تحقيق الربح، عليك تنفيذ المهام التالية:

عملية الإعداد الأوّلية باستخدام Apigee

تعاوَن مع فريق إعداد Apigee Edge لإكمال عملية الإعداد الأوّلي لتحقيق الربح. استنادًا إلى المعلومات التي تقدّمها، سيُعدّ فريق الإعداد ما يلي:

  • تُستخدَم لتحديد ما إذا كانت مؤسستك شركة اتصالات.
  • نوع الفوترة الذي تريد إتاحته للمطوّرين الذين يشترون خطط الأسعار: الدفع المُسبَق أو الدفع الآجل أو كلاهما اطّلِع على الحسابات المدفوعة مسبقًا مقابل الحسابات المدفوعة لاحقًا.
  • تحديد ما إذا كنت تريد استخراج بيانات مفصّلة أو موجزة من تحقيق الربح إلى نظام المحاسبة الخاص بك وتحديد تنسيق البيانات المطلوب
  • عنوان الرد على الرسائل الإلكترونية المخصّص بالنسبة إلى إشعارات البريد الإلكتروني المتعلقة بتحقيق الربح والتي يتم إرسالها إلى الشركات والمطوّرين، يتم ضبط عنوان noreply@apigee.com تلقائيًا. يجب طلب اسم وعنوان ردّ مخصّصَين لمؤسستك.

يُشغّل فريق إعداد Apigee نصًا برمجيًا لمزامنة تحقيق الربح مع مؤسستك وأي مطوّرين وتطبيقات ومنتجات واجهة برمجة تطبيقات أنشأتها باستخدام Apigee Edge. قد يطلب فريق دعم Apigee منك مزامنة مؤسستك في المستقبل، كما هو موضّح في مقالة مزامنة بيانات Apigee Edge مع ميزة تحقيق الربح للحصول على التفاصيل. لا تتم مزامنة بيانات تحقيق الربح إلا إذا طلبت منك Apigee ذلك.

ضبط إعدادات تحقيق الربح

يلخّص الجدول التالي الخطوات المطلوبة لإعداد تحقيق الربح لمؤسستك على Apigee.
الخطوة الوصف
تعديل ملف مؤسستك كجزء من عملية الإعداد الأوّلية لتحقيق الربح، يضبط فريق إعداد Apigee Edge ملف مؤسستك.

عليك تعديل ملف المؤسسة لإضافة معلومات عن مؤسستك أو تعديلها، حسب الاقتضاء. على سبيل المثال، قد تحتاج إلى تعديل نوع الفوترة أو إعدادات العملة أو النموذج الضريبي.

إدارة العملات المتاحة كجزء من الإعداد الأوّلي لتحقيق الربح، يحدّد فريق إعداد Apigee Edge العملات التي تقبلها مؤسستك، ويضبط العملة التلقائية.

يمكنك استرداد العملات التي تتيحها مؤسستك وإضافة العملات المتاحة أو حذفها (لتعكس العملات التي يستخدمها المطوّر أو خطة الأسعار).

ملاحظة: تنفّذ ميزة تحقيق الربح تلقائيًا مهمة يومية للحصول على سعر الصرف بالدولار الأمريكي لكل عملة متوافقة. يتم تنفيذ المهمة تلقائيًا كل يوم في الثانية الأولى بعد منتصف الليل. لمزيد من التفاصيل، يُرجى الاطّلاع على جدولة مهام تحقيق الربح.
تحديد الأحكام والشروط يمكنك اختياريًا إضافة بنود وشروط إلى ملف مؤسستك قبل نشر خطط الأسعار. وبعد نشر خطة أسعار، يتم عرض الإصدار الحالي من البنود والشروط في بوابة مخصّصة للمطوّرين.

ملاحظة: تقع الأحكام والشروط خارج ملف مؤسستك. في ملف مؤسستك، حدِّد الموقع الجغرافي (عنوان URL متاح للجميع) للأحكام والشروط. يمكنك إضافة نُسخ متعددة من البنود والشروط لعرض التغييرات بمرور الوقت.
فرض حدود تحقيق الربح أرفِق سياسة MonetizationLimitsCheck بخوادم وكيلة لواجهة برمجة التطبيقات لفرض حدود تحقيق الربح.

على وجه التحديد، يتم تطبيق السياسة في الحالات التالية:

  • لم يتم تسجيل المطوّر الذي يصل إلى واجهة برمجة التطبيقات المدفوعة أو لم يشترك في خطة الأسعار.
  • تجاوز المطوّر حجم المعاملات لخطة الأسعار المستندة إلى الاشتراك.
  • تم بلوغ رصيد حساب المطوِّر المدفوع مسبقًا أو حد الائتمان المدفوع لاحقًا.
إعداد الإشعارات يمكنك ضبط الإشعارات لإبلاغ المطوّرين أو مقدّمي واجهات برمجة التطبيقات بحدث معيّن، مثل خطة أسعار تم نشرها حديثًا.

تحقيق الربح من واجهات برمجة التطبيقات

عند تحقيق الربح من واجهات برمجة التطبيقات، يمكنك تجميع منتج واحد أو أكثر من منتجات واجهة برمجة التطبيقات في حزمة منتجات واجهة برمجة التطبيقات وتحديد خطة الأسعار المرتبطة بها.

لا تصبح حِزمة منتجات واجهة برمجة التطبيقات مرئية للمطوّرين إلا بعد نشر خطة أسعار للحزمة (بتاريخ بدء هو التاريخ الحالي أو تاريخ مستقبلي). يمكن للمطوّرين تسجيل تطبيقاتهم لاستخدام حِزمة منتجات API فقط من خلال شراء إحدى خطط الأسعار السارية حاليًا. إذا لم تتضمّن حزمة منتجات واجهة برمجة التطبيقات خطة أسعار منشورة وسارية حاليًا، لن يتم تحقيق الربح من الحزمة.

يلخّص الجدول التالي الخطوات المطلوبة لتحقيق الربح من واجهات برمجة التطبيقات.

الخطوة الوصف
إدارة حِزم منتجات واجهة برمجة التطبيقات

أنشئ حِزم منتجات واجهة برمجة التطبيقات لتجميع منتجات واجهة برمجة التطبيقات.

ملاحظة: في واجهة المستخدم Classic Edge API وواجهة برمجة التطبيقات لتحقيق الربح، يُشار إلى حِزم المنتجات باسم حِزم واجهة برمجة التطبيقات.

لاستخدام واجهة برمجة التطبيقات لإدارة حِزم منتجات واجهة برمجة التطبيقات، يُرجى الاطّلاع على ما يلي:
ضبط سياسة تسجيل المعاملات

اضبط سياسة تسجيل المعاملات لكل منتج من منتجات واجهة برمجة التطبيقات. تحدّد سياسة تسجيل المعاملات ما تريد تسجيله في سجلّات المعاملات لأحد منتجات واجهة برمجة التطبيقات، بما في ذلك أي سمات مخصّصة.

لاستخدام واجهة برمجة التطبيقات لضبط سياسة تسجيل المعاملات، يُرجى الاطّلاع على ما يلي:
إدارة خطط الأسعار ونشرها

أنشئ خطة أسعار لتحديد طريقة تحقيق الربح من واجهات برمجة التطبيقات. على سبيل المثال، ما إذا كنت تفرض سعرًا ثابتًا أو متغيرًا مقابل استخدام واجهة برمجة التطبيقات.

لإدارة خطط الأسعار باستخدام واجهة برمجة التطبيقات، يُرجى الاطّلاع على ما يلي:

شراء خطة أسعار منشورة شراء خطة أسعار منشورة وإيقاف خطة أسعار تم شراؤها أو إلغاؤها، إذا أردت، باستخدام واجهة برمجة التطبيقات
ضبط إعدادات تحقيق الربح في بوابة مخصّصة للمطوّرين يمكنك ضبط إعدادات تحقيق الربح في بوابة مخصّصة للمطوّرين لمنح المطوّرين إمكانية الوصول إلى خدمة ذاتية للاشتراك في خطة الأسعار ومعالجة الدفعات والفواتير تلقائيًا والتقارير وقوائم المنتجات وغيرها من الإعدادات الخاصة بتحقيق الربح.

إدارة تحقيق الربح

بعد إعداد ميزة تحقيق الربح وتحقيق الربح من واجهة برمجة التطبيقات، يمكنك تنفيذ خطوة واحدة أو أكثر من الخطوات الموجزة في الجدول التالي:

الخطوة الوصف
إدارة الشركات والمطوّرين إدارة الشركات والمطوّرين الذين يستخدمون واجهات برمجة التطبيقات المطوِّر هو كيان واحد يتم تعريفه بشكل فريد من خلال عنوان البريد الإلكتروني. الشركة هي مجموعة من المطوّرين تتم إدارتها ككيان واحد.
إنشاء التقارير إنشاء تقارير عن الرصيد المدفوع مسبقًا والإيرادات والفرق بالنسبة إلى المطوّرين الذين يستخدمون خطة الدفع المُسبق، يمكنك مطابقة تقارير الرصيد المدفوع مسبقًا مع الإيداعات المصرفية.
إجراء تعديلات على الفوترة إجراء تعديلات على الفوترة لتصحيح التناقضات في سجلّاتك، على سبيل المثال
إصدار أرصدة إصدار أرصدة للمطوّرين، إذا لزم الأمر بالنسبة إلى المطوّر الذي يستخدم نظام الدفع المسبق، يظهر الرصيد على شكل انخفاض في الاستخدام يؤدي إلى زيادة رصيد الدفع المسبق للمطوّر في المستقبل. بالنسبة إلى المطوّرين الذين يستخدمون الدفع الآجل، يظهر الرصيد كسطر منفصل في الفاتورة، ما يؤدي إلى خفض الرسوم في الفاتورة.
إدارة أرصدة الحسابات المدفوعة مسبقًا الاطّلاع على رصيد حساب الدفع المُسبَق الحالي وإعادة شحن حسابات الدفع المُسبَق أو إعداد عملية إعادة شحن تلقائية باستخدام مقدّم خدمة دفع تابع لجهة خارجية
إدارة أرصدة الدفع الآجل باستخدام حدود الائتمان عند إضافة عملة معتمَدة لمؤسسة، يمكنك ضبط حدّ ائتمان لمطوّر يستخدم نظام الدفع الآجل. ينطبق حدّ الائتمان على جميع المطوّرين الذين يستخدمون الدفع الآجل في المؤسسة. بالإضافة إلى ذلك، يمكنك ضبط حدّ الائتمان لمطوّر فردي يستخدم الدفع الآجل. في هذه الحالة، يتجاوز حدّ الرصيد أي حدّ تم ضبطه للعملة للمطوّر المحدّد فقط.
ردّ الأموال بعد إتمام عملية الشراء نشر المبالغ المستردة للمطوّرين مقابل معاملات الشراء
جدولة مهام تحقيق الربح توفّر ميزة تحقيق الربح نظام جدولة مهام ومجموعة من المهام التي تمّت جدولتها مسبقًا لتنفيذها في أوقات محدّدة. إدارة جدول مهام تحقيق الربح باستخدام واجهة برمجة التطبيقات
عرض حالة المعاملات عرض حالة المعاملات التي حدثت خلال نطاق زمني محدّد باستخدام واجهة برمجة التطبيقات
مزامنة بيانات Apigee Edge مع ميزة تحقيق الربح إذا طلبت منك Apigee ذلك، أعِد مزامنة البيانات مع تحقيق الربح للتأكّد من أنّ البيانات متزامنة. يمكنك مزامنة ما يلي: المؤسسة ومنتجات واجهة برمجة التطبيقات والمطوّرون والتطبيقات.
حذف بيانات تحقيق الربح من مؤسستك قد تحتاج إلى حذف بيانات تحقيق الربح من مؤسستك لمحو مؤسسة تجريبية أو حذف مؤسسة.