واجهات برمجة التطبيقات للفوترة البديلة

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

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

مسرد المصطلحات

اصطلاحات المصطلحات المتبعة في هذا الدليل:

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

توفير نظام فوترة بديل يوفر ميزة "اختيار المستخدم"

يوضّح هذا القسم كيفية إتاحة خيار استخدام نظام الفوترة البديل في Google Play للمستخدمين. قبل استخدام واجهات برمجة التطبيقات هذه، تأكَّد مما يلي:

باقي الوحدات التي يُنصح بها لدمج "الفوترة في Google Play" هي نفسها تلك التي سبق أن استخدمها المطوّرون في الدمج الحالي.

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

ضبط الإعدادات في Play Console

إذا أكملوا التسجيل في برنامج الفوترة البديل من خلال خيار المستخدم ذي الصلة وتم دمجهم مع واجهات برمجة التطبيقات لنظام الفوترة البديل، يمكنهم إدارة إعدادات نظام الفوترة البديل من خلال Play Console:

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

تجربة المستخدم

تتيح واجهات برمجة التطبيقات من جهة العميل الوظيفة التالية:

  • يعرض Google Play المعلومات السارية وشاشات اختيار المستخدم ويديرها
  • إذا اختار المستخدم استخدام نظام الفوترة في Google Play، سيستمر مسار الفوترة في استخدام واجهة الفوترة العادية في Google Play.

تطبيق المطوِّر.

شاشة اختيار الفوترة

مثال لأغراض التوضيح فقط.

شاشة اختيار المستخدم

توفّر شاشة "اختيار المستخدم" للمستخدمين خيار استخدام نظام الفوترة البديل لدى المطوّر أو نظام الفوترة في Google Play.

بنية خيار نظام فوترة بديل

يتضمن خيار نظام الفوترة البديل على شاشة اختيار المستخدم عناصر واجهة المستخدم التالية:

  1. رمز التطبيق
  2. اسم التطبيق.
  3. مادة عرض صورة تتضمّن طرق دفع يوفّرها المطوِّر
  4. المؤشر الإضافي (والمزيد من عناصر واجهة المستخدم ليس جزءًا من مادة عرض الصورة).

مادة عرض الصورة لطرق الدفع

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

الأبعاد

192 بكسل مستقل الكثافة × 20 بكسل مستقل الكثافة

تباعد البطاقات

8 بكسل مستقل الكثافة

تنسيق الملف

PNG، خلفية شفافة

صيغ طرق الدفع

يمكن للمطوّرين اختيار عدد رموز طرق الدفع المتاحة التي يريدون تضمينها في مادة عرض الصورة، على أن يصل إلى 5 رموز كحد أقصى.

ويجب عدم تضمين أيّ صور أو نص آخر في الصورة.

مواصفات البطاقة

يجب أن تتّبع بطاقات طريقة الدفع المضمّنة في مادة عرض الصورة الإرشادات التالية بشأن الحجم والمسافات والنمط.

أبعاد البطاقة 32 بكسل مستقل الكثافة × 20 بكسل مستقل الكثافة
المساحة المتروكة الداخلية تنسيق 3dp
مخطط 1dp (الحد الخارجي مشمول في الأبعاد)، نصف القطر 2dp، #E0E0E0
خلفية البطاقة لون ثابت (يُفضَّل الأبيض)

الخطوات التالية

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

عرض نظام الفوترة البديل فقط

يوضّح هذا القسم كيفية توفير نظام فوترة بديل للمستخدمين بدون اختيار استخدام نظام الفوترة في Google Play. قبل استخدام واجهات برمجة التطبيقات هذه، تأكَّد مما يلي:

ننصح بتجهيز إعداد دمج واجهة برمجة التطبيقات Google Play Developer API لأنّ عملية الدمج في الخلفية ستستفيد منه.

ضبط الإعدادات في Play Console

يمكن للمطوّرين الذين أكملوا عملية التسجيل وتم دمجهم في واجهات برمجة التطبيقات لنظام الفوترة البديل من خلال إدارة إعدادات نظام الفوترة البديل من خلال Play Console:

  • لكل تطبيق من تطبيقاتك المؤهَّلة، يمكنك تفعيل أو إيقاف عرض نظام فوترة بديل فقط (بدون خيار المستخدم) في كل بلد متاح.
واجهة مستخدم مصطنعة تهدف إلى التوضيح، وهي عرضة للتغيير.

شاشة معلومات للمستخدمين

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

الخطوات التالية

لبدء دمج واجهات برمجة التطبيقات لنظام الفوترة البديل، يُرجى اتّباع الأدلّة المفصّلة حول كلّ من الدمج داخل التطبيق والدمج في الخلفية.