رصد العناصر داخل التطبيق وتسليمها

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

بعد أن يستبدل المستخدمون نقاط Play Points بمنتج داخل التطبيق في تطبيق Google Play، يجب تسليم العناصر فورًا في لعبتك. يوضّح ما يلي كيف يشتري المستخدم منتجات باستخدام نقاط Play Points.

‫1. انقر على Play Points.	‫1. انقر على علامة التبويب استخدام لعرض العناصر.	‫2- اختَر منتجًا وانقر على استخدام النقاط لإكمال عملية الشراء.	3- استلام السلعة

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

قبل البدء

قبل رصد منتج داخل التطبيق وتقديمه، عليك إنشاء المنتج والعروض الترويجية في Play Points.

متطلبات التسليم

عند تقديم منتجات داخل اللعبة باستخدام عرض ترويجي في Play Points، يجب استيفاء المتطلبات الواردة في هذا القسم.

توقيت التسليم

عندما يستبدل أحد اللاعبين نقاط Play Points بمنتج داخل التطبيق، استخدِم Google Play Billing Library لتسليم المنتج في الوقت المناسب.

رسالة التسليم

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

في ما يلي تنسيق الرسائل المطلوب:

• رسالة واضحة تفيد باستلام السلعة

• يجب الإشارة إلى اسم المنتج بوضوح والإشارة إلى "نقاط Play" لضمان تمكّن المستخدمين من التمييز بينه وبين المحتوى الآخر الذي يتلقّونه.

• يجب أن يتضمّن اسم السلعة أيضًا القيمة الصحيحة للسلعة إذا كانت هناك سلع مشابهة بقيم متعددة.

• يجب أن يظهر مربّع الحوار المنبثق أو الرسالة أو الإشعار داخل اللعبة للمستخدم إلى أن ينقر على تأكيد مثل متابعة أو حسنًا. يجب ألا يكون هناك زر إلغاء، لأنّ الهدف من هذه الرسالة هو إعلام المستخدمين بالعناصر التي تلقّوها داخل اللعبة. إذا لم يكن هناك زر تأكيد، يجب أن تظهر الرسالة للمستخدمين لمدة 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.

• إذا كنت تستخدم Inappproducts: list على خادمك، تحقَّق مما إذا كنت بحاجة إلى فصل عناصر استبدال مكافآت Play عن المنتجات الأخرى داخل التطبيق باستخدام قيم productId.

• راجِع أفضل الممارسات التالية للتحقّق مما إذا كنت بحاجة إلى إجراء تغييرات إضافية:

  • المراجع:
    • مكافحة الاحتيال وإساءة الاستخدام
    • أفضل الممارسات المتعلّقة بالمعرّفات الفريدة
  • تنفيذ عملية التحقّق من التوقيع من جهة الخادم
  • تأكَّد من أنّ قيمتَي purchaseToken وorderId فريدتان ولم يتم استخدامهما من قبل.

تحديد المشاكل وحلّها

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

حسابات مستخدمين متعددة

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

السلع المتأخرة أو المفقودة

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