موارد درون برنامه را شناسایی و تحویل دهید، موارد درون برنامه را شناسایی و تحویل دهید

این مبحث نحوه شناسایی و ارائه محصولات درون‌برنامه‌ای در بازی شما را پس از خرید آنها توسط بازیکنان با استفاده از امتیازهای بازی در برنامه Google Play شرح می‌دهد.

به محض اینکه کاربران امتیازهای بازی خود را برای یک محصول درون‌برنامه‌ای در برنامه Google Play استفاده کنند، اقلام باید بلافاصله در بازی شما تحویل داده شوند. شکل زیر نحوه خرید اقلام توسط کاربر با امتیازهای بازی را نشان می‌دهد.

۱. روی نقاط بازی کلیک کنید. ۱. برای مشاهده موارد، روی برگه «استفاده» کلیک کنید. ۲. یک کالا را انتخاب کنید و برای تکمیل خرید، روی «استفاده از امتیازها» کلیک کنید. ۳. کالا را دریافت کنید.
اسکرین شاتی از زمان انتشار نامشخصاسکرین شاتی از زمان انتشار نامشخصاسکرین شاتی از زمان انتشار نامشخصاسکرین شاتی از زمان انتشار نامشخص

در مثال، بازی در حالی که محصول خریداری شده است، اجرا نمی‌شود. کاربران همچنین می‌توانند امتیازهای بازی را در ازای محصولات، زمانی که بازی روی دستگاهشان نصب نشده است، مبادله کنند. به همین دلیل، شما باید بازی خود را طوری طراحی کنید که تحویل اقلام درون برنامه‌ای از خارج از فروشگاه درون بازی را مدیریت کند.

قبل از اینکه شروع کنید

قبل از اینکه یک محصول درون‌برنامه‌ای را شناسایی و ارائه دهید، باید محصول و تبلیغات امتیاز بازی (Play Points) را ایجاد کنید .

الزامات تحویل

وقتی با استفاده از طرح تشویقی امتیاز بازی، محصولات درون‌برنامه‌ای را در بازی خود ارائه می‌دهید، باید الزامات این بخش را رعایت کنید.

زمان تحویل

وقتی یک بازیکن امتیازهای بازی را با یک محصول درون‌برنامه‌ای مبادله می‌کند، از کتابخانه پرداخت گوگل پلی برای تحویل به موقع کالا استفاده کنید.

پیام تحویل

زمانی که کاربر پس از خرید یک محصول درون‌برنامه‌ای خارج از بازی، به بازی شما بازمی‌گردد، باید تأییدیه‌ای مبنی بر اعطای موفقیت‌آمیز محصول در بازی نمایش دهید. این پیام باید به صورت یک پنجره‌ی پاپ‌آپ یا یک پیام درون‌بازی باشد. کاربران نباید برای دریافت کالا هیچ اقدام اضافی انجام دهند.

قالب پیام‌رسانی مورد نیاز به شرح زیر است:

  • پیامی واضح مبنی بر دریافت کالا.

  • به نام کالا به طور واضح اشاره کنید و به «امتیاز پخش» مراجعه کنید تا مطمئن شوید کاربران می‌توانند آن را از سایر محتوایی که دریافت می‌کنند، تشخیص دهند.

  • در صورت وجود اقلام مشابه با چندین نام تجاری، نام کالا باید شامل نام صحیح آن نیز باشد.

  • پنجره‌ی بازشو، پیام یا اعلان درون بازی باید تا زمانی که کاربر روی تأییدی مانند «ادامه» یا «تأیید» کلیک کند، برای کاربر قابل مشاهده باشد. نباید دکمه‌ی لغو وجود داشته باشد، زیرا این پیام فقط برای اطلاع‌رسانی به کاربران در مورد کالایی است که در بازی دریافت کرده‌اند. اگر دکمه‌ی تأییدی وجود ندارد، پیام باید حداقل ۳ ثانیه قبل از ناپدید شدن برای کاربران قابل مشاهده باشد تا کاربران مطمئن شوند که کالای خود را دریافت کرده‌اند.

در اینجا یک پیام نمونه آورده شده است:

«کالا دریافت شد! شما همین الان ۱۰۰ جم به همراه امتیاز بازی دریافت کردید. ادامه دهید.»

کاربران باید یک انیمیشن یا تأیید تصویری ببینند که افزایش موجودی ارز درون بازی آنها را نشان می‌دهد. اگر کالا یک کالای درون برنامه‌ای بادوام یا مصرفی باشد، کاربران باید به جایی که کالا قفل‌گشایی شده یا در بازی در دسترس است، هدایت شوند.

تشخیص آیتم‌های دریافتی خارج از بازی

اگر بازی شما از سیستم پرداخت گوگل پلی استفاده می‌کند، برای شناسایی محصولات درون‌برنامه‌ای که خارج از بازی دریافت می‌شوند، به بخش شناسایی و پردازش خریدها مراجعه کنید.

نمایش تایید تحویل

وقتی کاربران امتیازهای بازی را بازخرید می‌کنند و یک کالای مبادله‌ای دریافت می‌کنند، انتظار دارند بازی یک پیام درون بازی نشان دهد یا از نوعی اعلان استفاده کند تا به آنها اطلاع دهد که بازی کالا را به درستی دریافت و پردازش کرده است. برای تأیید خرید موفق، به «اطلاع‌رسانی به کاربر» مراجعه کنید.

به‌روزرسانی‌ها برای موتورهای بازی خاص

در اینجا چند نکته برای موتورهای بازی خاص وجود دارد:

  • اگر بازی شما با Unity ساخته شده است، توصیه می‌کنیم بررسی کنید که آیا پیاده‌سازی IAP که استفاده می‌کنید از قبل از تبلیغات Play Points پشتیبانی می‌کند یا خیر.

  • اگر بازی شما با Cocos2d-x یا Unreal Engine (C/C++) ساخته شده است، به احتمال زیاد باید کد JNI را بنویسید که APIهای جاوا را از کد C/C++ شما فراخوانی کند.

بهترین شیوه‌های سمت سرور

این بخش شامل بهترین شیوه‌های سمت سرور برای استفاده در طرح‌های تشویقی امتیاز بازی است:

  • اگر Purchases.products: get و بررسی کنید که آیا نیاز دارید اقلام تبادل پاداش‌های Play و سایر محصولات درون‌برنامه‌ای را به‌طور جداگانه و بر اساس مقادیر productId مدیریت کنید یا خیر.

  • اگر از Inappproducts: list در سرور خود استفاده می‌کنید، بررسی کنید که آیا نیاز دارید آیتم‌های تبادل پاداش Play را از سایر محصولات درون‌برنامه‌ای بر اساس مقادیر productId جدا کنید یا خیر.

  • برای بررسی اینکه آیا نیاز به ایجاد تغییرات اضافی دارید یا خیر، بهترین شیوه‌های زیر را مرور کنید:

عیب‌یابی

این بخش شامل توصیه‌هایی برای سناریوهایی است که می‌تواند منجر به سوالات مشتریان شود.

حساب‌های کاربری چندگانه

اگر کاربری چندین حساب گوگل روی دستگاه خود داشته باشد و امتیازهای بازی را با حساب اشتباهی استفاده کند، گوگل نمی‌تواند اقلام را به حساب‌های دیگر منتقل کند. به همین ترتیب، برنامه شما نمی‌تواند با فراخوانی متد getPurchases() اقلام را منتقل کند. در این سناریو، می‌توانید اقلام درون برنامه‌ای را با استفاده از عملیات پشتیبانی مشتری خود به صورت دستی در اختیار کاربر قرار دهید.

موارد با تأخیر یا گم‌شده

اگر بازیکنان با تأخیر یا گم شدن آیتم‌های پاداش مواجه شدند، به راهنمای عیب‌یابی برای خریدهای درون‌برنامه‌ای در مستندات راهنمای گوگل پلی مراجعه کنند.