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

أنت تطّلع على مستندات 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 بخدمات الوكيل لواجهات برمجة التطبيقات لفرض حدود تحقيق الربح.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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