يمكن للمطوّرين المؤهَّلين أن يقدّموا للمستخدمين في بلدان معيّنة نظام فوترة بديلاً في تطبيقاتهم وأن يبلغوا Google بالمعاملات الناتجة. استنادًا إلى مكان توزيع تطبيقك والأهلية، يتوفّر إصداران من نظام الفوترة البديل يمكن للتطبيق إنشاؤهما:
- نظام فوترة بديل مع ميزة "الفوترة حسب اختيار المستخدم": يوفّر تطبيقك نظام فوترة بديلاً إلى جانب نظام الفوترة في Google Play.
- نظام فوترة بديل فقط (بدون ميزة "الفوترة حسب اختيار المستخدم"): يوفّر تطبيقك نظام فوترة بديلاً بدون توفير نظام الفوترة في Google Play كخيار.
يتناول هذا الدليل واجهات برمجة التطبيقات التي يجب استخدامها لأي من العرضين. يجب مراجعة صفحات البرنامج والتسجيل في البرامج ذات الصلة قبل استخدام واجهات برمجة التطبيقات هذه.
مسرد المصطلحات
اتّبِع اصطلاحات المصطلحات التالية في هذا الدليل:
- واجهات برمجة التطبيقات لنظام الفوترة البديل: هي واجهات برمجة تطبيقات تُستخدَم لعرض أي شاشات سارية للمستخدمين وللسماح للمطوّرين بإعداد تقارير عن المعاملات التي تتم من خلال نظام الفوترة البديل الخاص بهم.
- نظام فوترة بديل: هو نظام فوترة بديل يوفّره المطوّر ويمكن إتاحته إلى جانب نظام الفوترة في Google Play أو بشكل مستقل (مع مراعاة متطلبات الأهلية).
- المعاملة الخارجية: هي معاملة تتم خارج نظام الفوترة في Google Play.
- رمز المعاملة الخارجية: هو رمز يتم تقديمه إلى المطوّر من خلال مكتبة Play Billing Library ليستخدمه المطوّر عندما يكمل المستخدم معاملة باستخدام نظام فوترة بديل. يُستخدَم هذا الرمز المميز لإعلام Google Play بنجاح عملية الشراء.
- معرّف المعاملة الخارجي: هو معرّف فريد ينشئه المطوّر لتحديد معاملة.
توفير نظام فوترة بديل من خلال ميزة "الفوترة حسب اختيار المستخدم"
يوضّح هذا القسم كيفية توفير نظام فوترة بديل للمستخدمين مع إتاحة خيار استخدام نظام الفوترة في Google Play. قبل استخدام واجهات برمجة التطبيقات هذه، تأكَّد مما يلي:
- راجِع متطلبات الأهلية للبرامج ذات الصلة وأكمِل خطوات الإعداد الموضّحة في مقالة معلومات عن ميزة "الفوترة حسب اختيار المستخدم" على Google Play.
- دمج الإصدار 5.2 أو إصدار أحدث من Play Billing Library
بقية الوحدات المقترَحة لعملية الدمج في خدمة الفوترة في Google Play هي نفسها التي يستخدمها المطوّرون حاليًا في عملية الدمج.
بالإضافة إلى ذلك، ننصح بإعداد عملية دمج لواجهة Google Play Developer API لأنّ عملية الدمج في الخلفية ستستفيد منها.
الإعداد في Play Console
يمكن للمطوّرين الذين أكملوا عملية التسجيل في برنامج نظام الفوترة البديل حسب اختيار المستخدم ذي الصلة والمدمج مع واجهات برمجة التطبيقات لنظام الفوترة البديل إدارة إعدادات نظام الفوترة البديل من خلال Play Console باتّباع الخطوات التالية:
- يمكنك اختيار ما إذا كنت تريد توفير نظام فوترة بديل لكل تطبيق من تطبيقاتك المؤهَّلة.
- حمِّل شعارات طرق الدفع وفقًا للإرشادات، مع الالتزام بجميع مواصفات التنسيق. لن يتم عرض الصور التي لا تتوافق مع هذه الإرشادات لنظام الفوترة البديل في شاشة اختيار المستخدم. (ملاحظة: إنّ تضمين شعارات طرق الدفع هو أمر اختياري، ولكن يُنصح به بشدة).
- إذا كنت تقدّم اشتراكات، عليك توفير رابط إدارة الاشتراك المطلوب.
تجربة المستخدم
تتيح واجهات برمجة التطبيقات من جهة العميل الوظائف التالية:
- يعرض Google Play شاشات المعلومات وخيارات المستخدمين ذات الصلة ويديرها.
- إذا اختار المستخدم استخدام نظام الفوترة في Google Play، سيستمر مسار الفوترة باستخدام واجهة نظام الفوترة العادية في Google Play.
تطبيق المطوّر |
شاشة اختيار نظام الفوترة |
مثال لأغراض توضيحية فقط.
شاشة اختيار المستخدم
تعرض شاشة اختيار نظام الفوترة للمستخدمين خيار استخدام نظام الفوترة البديل الخاص بالمطوّر أو نظام الفوترة في Google Play.
بنية خيار نظام الفوترة البديل
يتضمّن خيار طريقة الفوترة البديلة على شاشة "الفوترة حسب اختيار المستخدم" عناصر واجهة المستخدم التالية:
- رمز التطبيق
- اسم التطبيق
- مادة عرض على شكل صورة تتضمّن طُرق الدفع التي يوفّرها المطوّر
- مؤشر إضافي (عنصر واجهة المستخدم والمزيد ليس جزءًا من مادة عرض الصورة).
مادة عرض الصورة لطرق الدفع
يتكوّن عنصر صورة واحدة من بطاقات طرق دفع متعددة ويجب أن يتوافق مع المواصفات المحدّدة في هذه الإرشادات.
الأبعاد |
192dp × 20dp |
تباعُد البطاقات |
8dp |
تنسيق الملف |
ملف PNG بخلفية شفافة |
اختلافات طرق الدفع
يمكن للمطوّرين اختيار عدد رموز طرق الدفع المتاحة التي يريدون تضمينها في مادة عرض الصورة، على ألا يتجاوز الحد الأقصى 5 رموز.
يجب ألا تتضمّن الصورة أي صور أو نصوص أخرى.
مواصفات البطاقة
يجب أن تتّبع بطاقات طريقة الدفع المضمّنة في مادة عرض الصورة الإرشادات التالية بشأن الحجم والتباعد والشكل.
| أبعاد البطاقة | 32 وحدة بكسل مستقلة عن الكثافة × 20 وحدة بكسل مستقلة عن الكثافة |
| المساحة المتروكة الداخلية | 3dp |
| المخطَّط | 1dp (يتم تضمين الحد الداخلي في الأبعاد)، نصف القطر 2dp، #E0E0E0 |
| خلفية البطاقة | لون خالص (يُفضّل الأبيض) |
الخطوات التالية
لبدء دمج واجهات برمجة التطبيقات لنظام الفوترة البديل مع ميزة "الفوترة حسب اختيار المستخدم"، اتّبِع الأدلة التفصيلية لكل من عملية الدمج داخل التطبيق وعملية الدمج في الخلفية.
توفير نظام فوترة بديل فقط
يوضّح هذا القسم كيفية توفير نظام فوترة بديل للمستخدمين بدون منحهم خيار استخدام نظام الفوترة في Google Play. قبل استخدام واجهات برمجة التطبيقات هذه، تأكَّد مما يلي:
- راجِع المتطلبات واشترِك في برنامج نظام الفوترة البديل فقط باتّباع التعليمات الواردة في مقالة توفير نظام فوترة بديل للمستخدمين في المنطقة الاقتصادية الأوروبية (EEA) بشأن نظام الفوترة البديل.
- دمج الإصدار 6.2.1 أو إصدار أحدث من Play Billing Library
ننصحك بإعداد عملية تكامل مع Google Play Developer API لأنّ عملية التكامل مع الخلفية ستستفيد منها.
الإعداد في Play Console
يمكن للمطوّرين الذين أكملوا عملية التسجيل ودمجوا واجهات برمجة التطبيقات لنظام الفوترة البديل إدارة إعدادات نظام الفوترة البديل من خلال Play Console باتّباع الخطوات التالية:
- بالنسبة إلى كل تطبيق من تطبيقاتك المؤهَّلة، يمكنك الموافقة على توفير نظام فوترة بديل فقط (بدون خيار المستخدم) أو عدم الموافقة على ذلك في كل بلد يتوفّر فيه هذا النظام.
شاشة المعلومات للمستخدمين
تساعد شاشة المعلومات المستخدمين على فهم أنّه يتم توفير نظام فوترة بديل فقط داخل التطبيق المؤهّل. وستظهر شاشة المعلومات للمستخدمين في بداية عملية الشراء الأولى داخل تطبيقك بعد تفعيل نظام الفوترة البديل. لن تظهر هذه الرسالة عند إجراء عمليات شراء لاحقة من قِبل المستخدم نفسه في تطبيقك على الجهاز نفسه. يُرجى العِلم أنّه قد يتم عرض مربع الحوار مرة أخرى للمستخدم في حالات مثل محو المستخدم لذاكرات التخزين المؤقت على جهازه.
الخطوات التالية
لبدء دمج واجهات برمجة التطبيقات لنظام الفوترة البديل، اتّبِع الأدلة التفصيلية لكل من عملية الدمج داخل التطبيق وعملية الدمج في الخلفية.