يوضّح هذا المستند كيفية رصد المنتجات التي يتم تحصيل سعرها مرة واحدة وتسليمها في لعبتك بعد أن يشتريها اللاعبون باستخدام نقاط Play Points في تطبيق Google Play.
بعد أن يستبدل المستخدمون نقاط Play Points بمنتج يتم تحصيل سعره مرة واحدة في تطبيق Google Play، يجب تسليم المنتجات على الفور في لعبتك. في ما يلي كيفية شراء المستخدمين للمنتجات باستخدام نقاط Play Points.
| 1. انقر على Play Points. | 2. انقر على علامة التبويب استخدام لعرض المنتجات. | 3. اختَر منتجًا وانقر على استخدام النقاط لإكمال عملية الشراء. | 4. تلقّي المنتج |
|
|
|
|
في المثال، لا تكون اللعبة قيد التشغيل أثناء شراء المنتج. يمكن للمستخدمين أيضًا استبدال نقاط Play Points بمنتجات عندما لا تكون اللعبة مثبّتة على أجهزتهم. لهذا السبب، عليك تصميم لعبتك للتعامل مع تسليم المنتجات داخل التطبيق من خارج المتجر داخل اللعبة.
قبل البدء
قبل رصد منتج يتم تحصيل سعره مرة واحدة وتسليمه، عليك إنشاء المنتج والعروض الترويجية في Play Points.
متطلبات التسليم
عند تسليم منتجات يتم تحصيل سعرها مرة واحدة في لعبتك باستخدام عرض ترويجي في Play Points، عليك اتّباع المتطلبات الواردة في هذا القسم.
توقيت التسليم
عندما يستبدل أحد اللاعبين نقاط Play Points بمنتج يتم تحصيل سعره مرة واحدة، استخدِم Google Play Billing Library لتسليم المنتج في الوقت المناسب.
رسالة التسليم
بعد أن يعود المستخدم إلى لعبتك بعد شراء منتج يتم تحصيل سعره مرة واحدة من خارج اللعبة، عليك عرض تأكيد بأنّه تم منح المنتج بنجاح داخل اللعبة. يجب أن تأتي الرسالة في شكل مربّع حوار أو رسالة داخل اللعبة. لا يجب أن يتّخذ المستخدمون أي خطوات إضافية لتلقّي المنتج.
في ما يلي تنسيق الرسائل المطلوبة:
رسالة واضحة تفيد بتلقّي المنتج
الإشارة إلى اسم المنتج بوضوح والإشارة إلى "نقاط Play Points" لضمان تمكّن المستخدمين من تمييزه عن المحتوى الآخر الذي يتلقّونه
يجب أن يتضمّن اسم المنتج أيضًا القيمة الصحيحة له إذا كانت هناك منتجات مماثلة بقيم متعدّدة.
يجب أن يظهر مربّع الحوار أو الرسالة أو الإشعار داخل اللعبة للمستخدم إلى أن ينقر على تأكيد، مثل متابعة أو حسنًا. يجب ألا يكون هناك زر إلغاء، لأنّ هذه الرسالة تهدف فقط إلى إشعار المستخدمين بالمنتج الذي تلقّوه داخل اللعبة. إذا لم يكن هناك زر تأكيد، يجب أن تظهر الرسالة للمستخدمين لمدة 3 ثوانٍ على الأقل قبل أن تختفي لضمان معرفة المستخدمين بأنّهم تلقّوا المنتج.
في ما يلي مثال على رسالة:
"تم تلقّي المنتج! لقد حصلت للتو على 100 جوهرة باستخدام نقاط Play Points. متابعة"
يجب أن يرى المستخدمون رسمًا متحركًا أو تأكيدًا مرئيًا يعرض الزيادة في رصيد العملة داخل اللعبة. إذا كان المنتج منتجًا دائمًا أو قابلاً للاستهلاك داخل التطبيق، يجب توجيه المستخدمين إلى المكان الذي تم فيه فتح المنتج أو المكان الذي يتوفّر فيه داخل اللعبة.
رصد المنتجات التي تم تلقّيها من خارج اللعبة
إذا كانت لعبتك تستخدم نظام الفوترة في Google Play، يمكنك الاطّلاع على مقالة رصد عمليات الشراء ومعالجتها لرصد المنتجات التي يتم تحصيل سعرها مرة واحدة والتي يتم تلقّيها من خارج اللعبة.
عرض تأكيد التسليم
عندما يستبدل المستخدمون نقاط Play Points ويتلقّون منتجًا مقابلها، يتوقّعون أن تعرض اللعبة رسالة داخل اللعبة أو تستخدم نوعًا ما من الإشعارات لإعلامهم بأنّ اللعبة قد تلقّت المنتج وعالجته بشكلٍ صحيح. يمكنك الاطّلاع على مقالة إشعار المستخدم لتأكيد عملية الشراء الناجحة.
تعديلات لمحركات ألعاب معيّنة
في ما يلي بعض الاعتبارات التي يجب مراعاتها لمحركات ألعاب معيّنة:
إذا كانت لعبتك مبنية باستخدام Unity، ننصحك بالتحقّق مما إذا كان تنفيذ عمليات الشراء داخل التطبيق الذي تستخدمه يتيح حاليًا العروض الترويجية في Play Points.
إذا كانت لعبتك مبنية باستخدام Cocos2d-x أو Unreal Engine (C/C++)، ستحتاج على الأرجح إلى كتابة رمز JNI الذي يستدعي واجهات برمجة تطبيقات Java من رمز C/C++.
أفضل الممارسات من جهة الخادم
يحتوي هذا القسم على أفضل الممارسات من جهة الخادم التي يجب استخدامها للعروض الترويجية في Play Points:
إذا كنت تستدعي
Purchases.products: getعلى الخادم، تحقَّق مما إذا كنت بحاجة إلى معالجة المنتجات التي يتم تحصيل سعرها مرة واحدة والمنتجات التي يتم الحصول عليها مقابل نقاط Play بشكلٍ منفصل استنادًا إلى قيمproductId.إذا كنت تستخدم
Onetimeproducts: listعلى الخادم، تحقَّق مما إذا كنت بحاجة إلى فصل المنتجات التي يتم الحصول عليها مقابل نقاط Play عن المنتجات الأخرى التي يتم تحصيل سعرها مرة واحدة حسب قيمproductId.راجِع أفضل الممارسات التالية للتحقّق مما إذا كنت بحاجة إلى إجراء تغييرات إضافية:
- مرجع:
- تنفيذ عملية التحقّق من التوقيع من جهة الخادم
- التأكّد من أنّ قيمتَي
purchaseTokenوorderIdفريدتان ولم يتم استخدامهما من قبل
تحديد المشاكل وحلّها
يحتوي هذا القسم على اقتراحات للسيناريوهات التي يمكن أن تؤدي إلى استفسارات العملاء.
تعدُّد المستخدمين
إذا كان لدى المستخدم حسابات Google متعدّدة على جهازه واستبدل نقاط Play Points في الحساب الخطأ، لا يمكن لشركة Google نقل المنتجات إلى الحسابات الأخرى. وبالمثل، لا يمكن لتطبيقك نقل المنتج من خلال استدعاء طريقة getPurchases(). في هذا السيناريو، ننصحك بمنح المنتجات داخل التطبيق للمستخدم يدويًا باستخدام عمليات دعم العملاء.
المنتجات المتأخرة أو المفقودة
إذا واجه اللاعبون مشكلة تأخّر المنتجات التي يتم الحصول عليها مقابل نقاط Play أو فقدانها، يمكنك الاطّلاع على دليل تحديد المشاكل وحلّها في عمليات الشراء داخل التطبيق في مستندات مساعدة Google Play.