این سند نحوه شناسایی و ارائه محصولات یکبارمصرف در بازی شما را پس از خرید آنها توسط بازیکنان با امتیازهای بازی در برنامه 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به طور جداگانه مدیریت کنید یا خیر.اگر از
Onetimeproducts: listدر سرور خود استفاده میکنید، بررسی کنید که آیا نیاز دارید اقلام تبادل پاداشهای Play را از سایر محصولات یکبار مصرف بر اساس مقادیرproductIdجدا کنید یا خیر.برای بررسی اینکه آیا نیاز به ایجاد تغییرات اضافی دارید یا خیر، بهترین شیوههای زیر را مرور کنید:
- مرجع:
- پیادهسازی تأیید امضا در سمت سرور
- مطمئن شوید که مقادیر
purchaseTokenوorderIdمنحصر به فرد هستند و قبلاً استفاده نشدهاند.
عیبیابی
این بخش شامل توصیههایی برای سناریوهایی است که میتواند منجر به سوالات مشتریان شود.
حسابهای کاربری چندگانه
اگر کاربری چندین حساب گوگل روی دستگاه خود داشته باشد و امتیازهای بازی را با حساب اشتباهی استفاده کند، گوگل نمیتواند اقلام را به حسابهای دیگر منتقل کند. به همین ترتیب، برنامه شما نمیتواند با فراخوانی متد getPurchases() اقلام را منتقل کند. در این سناریو، میتوانید اقلام درون برنامهای را با استفاده از عملیات پشتیبانی مشتری خود به صورت دستی در اختیار کاربر قرار دهید.
موارد با تأخیر یا گمشده
اگر بازیکنان با تأخیر یا گم شدن آیتمهای پاداش مواجه شدند، به راهنمای عیبیابی برای خریدهای درونبرنامهای در مستندات راهنمای گوگل پلی مراجعه کنند.



