इस दस्तावेज़ में बताया गया है कि Google Play ऐप्लिकेशन में, Play पॉइंट का इस्तेमाल करके खरीदे गए वन-टाइम प्रॉडक्ट को आपके गेम में कैसे पता लगाया जाए और डिलीवर किया जाए.
जब उपयोगकर्ता Google Play ऐप्लिकेशन में, वन-टाइम प्रॉडक्ट के लिए अपने Play पॉइंट रिडीम कर लेते हैं, तो आइटम तुरंत आपके गेम में डिलीवर हो जाने चाहिए. यहां बताया गया है कि कोई उपयोगकर्ता, Play पॉइंट का इस्तेमाल करके आइटम कैसे खरीदता है.
| 1. Play पॉइंट पर क्लिक करें. | 2. आइटम देखने के लिए, इस्तेमाल करें टैब पर क्लिक करें. | 3. कोई आइटम चुनें और खरीदारी पूरी करने के लिए, पॉइंट इस्तेमाल करें पर क्लिक करें. | 4. आइटम पाएं. |
|
|
|
|
उदाहरण में, प्रॉडक्ट खरीदते समय गेम नहीं चल रहा है. उपयोगकर्ता, अपने डिवाइस पर गेम इंस्टॉल न होने पर भी, Play पॉइंट का इस्तेमाल करके प्रॉडक्ट खरीद सकते हैं. इसलिए, आपको अपने गेम को इस तरह से डिज़ाइन करना होगा कि वह गेम में मौजूद स्टोर के बाहर से, ऐप्लिकेशन में मौजूद आइटम की डिलीवरी को मैनेज कर सके.
शुरू करने से पहले
वन-टाइम प्रॉडक्ट का पता लगाने और उसे डिलीवर करने से पहले, आपको प्रॉडक्ट और Play Points प्रमोशन बनाने होंगे.
डिलीवरी की ज़रूरी शर्तें
Play Points प्रमोशन का इस्तेमाल करके, अपने गेम में वन-टाइम प्रॉडक्ट डिलीवर करते समय, आपको इस सेक्शन में दी गई ज़रूरी शर्तों का पालन करना होगा.
डिलीवरी का समय
जब कोई खिलाड़ी, वन-टाइम प्रॉडक्ट के लिए Play Points बदलता है, तो आपको उसे तुरंत आइटम डिलीवर करना होगा. इसके लिए, खिलाड़ी को गेम रीस्टार्ट करने की ज़रूरत नहीं होनी चाहिए. ऐसे मामलों में जहां गेम के कॉन्टेंट को पहले से पूरा करना ज़रूरी है, जैसे कि ट्यूटोरियल पूरा करना, आइटम को तुरंत डिलीवर किया जाना चाहिए.
डिलीवरी का मैसेज
अगर कोई उपयोगकर्ता, गेम से बाहर जाकर एक बार खरीदा जाने वाला प्रॉडक्ट खरीदता है और फिर आपके गेम पर वापस आता है, तो आपको उसे यह पुष्टि दिखानी होगी कि गेम में उसे प्रॉडक्ट मिल गया है. यह सूचना किसी डायलॉग या गेम के अंदर मैसेज भेजकर देनी चाहिए. उपयोगकर्ताओं को आइटम पाने के लिए, कोई और कार्रवाई करने की ज़रूरत नहीं पड़नी चाहिए.
मैसेज का ज़रूरी फ़ॉर्मैट यहां दिया गया है:
यह साफ़ तौर पर बताया गया हो कि आइटम मिल गया है.
आइटम का नाम साफ़ तौर पर बताएं और "Play Points" का ज़िक्र करें, ताकि उपयोगकर्ताओं को यह पता चल सके कि उन्हें मिलने वाले अन्य कॉन्टेंट से यह अलग है.
अगर एक जैसे आइटम अलग-अलग कीमत में उपलब्ध हैं, तो आइटम के नाम में उसकी सही कीमत भी शामिल होनी चाहिए.
डायलॉग, मैसेज या गेम में दिखने वाली सूचना, उपयोगकर्ता को तब तक दिखनी चाहिए, जब तक वह जारी रखें या ठीक है जैसे पुष्टि करने वाले बटन पर क्लिक नहीं कर देता. इसमें 'रद्द करें' बटन नहीं होना चाहिए, क्योंकि इस मैसेज का मकसद सिर्फ़ उपयोगकर्ताओं को यह सूचना देना है कि उन्हें गेम में कौनसी चीज़ मिली है. अगर पुष्टि करने वाला बटन नहीं है, तो उपयोगकर्ताओं को मैसेज कम से कम तीन सेकंड तक दिखना चाहिए. इसके बाद, यह गायब हो जाना चाहिए. इससे यह पक्का किया जा सकेगा कि उपयोगकर्ताओं को पता चल गया है कि उन्हें उनका आइटम मिल गया है.
यहां एक उदाहरण मैसेज दिया गया है:
"आइटम मिल गया! आपको Play Points के ज़रिए 100 Gems मिले हैं. जारी रखें."
उपयोगकर्ताओं को एक ऐनिमेशन या कोई विज़ुअल पुष्टि दिखनी चाहिए, जिसमें गेम में इस्तेमाल होने वाली मुद्रा के बैलेंस में बढ़ोतरी दिखाई गई हो. अगर आइटम, ऐप्लिकेशन में इस्तेमाल किया जा सकने वाला या बार-बार इस्तेमाल किया जा सकने वाला आइटम है, तो उपयोगकर्ताओं को उस जगह पर रीडायरेक्ट किया जाना चाहिए जहां आइटम अनलॉक किया गया है या गेम में उपलब्ध है.
गेम के बाहर से मिले आइटम का पता लगाना
अगर आपका गेम Google Play Billing Library का इस्तेमाल करता है, तो गेम के बाहर से मिले वन-टाइम प्रॉडक्ट का पता लगाने के लिए, यहां दिए गए बदलाव करें.
अपने गेम के
[onResume()][onResume]कॉलबैक में,[queryPurchases()][queryPurchases]तरीके को कॉल करें, ताकि आपको आइटम की सूची मिल सके. इससे आपको यह पता चल पाएगा कि कौनसे आइटम स्वीकार नहीं किए गए हैं.अगर आपके गेम में सर्वर है, तो हमारा सुझाव है कि आप Subscriptions and In-App Purchases API का इस्तेमाल करके, अपने सर्वर से खरीदारी की पुष्टि करें.
अगर आपके पास ऐसे आइटम हैं जिनकी पुष्टि नहीं की गई है, तो खरीदारी की पुष्टि करें. इसके लिए, इस्तेमाल किए जा सकने वाले आइटम के लिए
[consumeAsync()][consumeAsync]या इस्तेमाल न किए जा सकने वाले आइटम के लिए[acknowledgePurchase()][acknowledgePurchase]का इस्तेमाल करें.गेम में खरीदे गए आइटम का एनटाइटलमेंट दें.
स्प्लिट स्क्रीन मोड में मिले आइटम का पता लगाना
अगर आपका गेम मल्टी-विंडो मोड के साथ काम करता है, तो उपयोगकर्ता Play Store ऐप्लिकेशन और आपके गेम को एक साथ चलाते हुए, Play पॉइंट रिडीम करके आइटम पा सकते हैं. इस स्क्रीनशॉट में एक उदाहरण दिखाया गया है:
Google Play Billing Library के साथ इस स्थिति को मैनेज करने के लिए, यह तरीका अपनाएं:
Google Play,
[onPurchasesUpdated()][onPurchasesUpdated]मेथड को कॉल करता है, ताकि आपके गेम को यह सूचना दी जा सके कि कोई नया आइटम खरीदा गया है, लेकिन उसे अभी तक पूरा नहीं किया गया है.अगर आपके गेम में सर्वर है, तो हमारा सुझाव है कि आप Subscriptions and In-App Purchases API का इस्तेमाल करके, अपने सर्वर से खरीदारी की पुष्टि करें.
इस्तेमाल की जा सकने वाली चीज़ों के लिए
consumeAsync()या इस्तेमाल न की जा सकने वाली चीज़ों के लिएacknowledgePurchase()का इस्तेमाल करके, खरीदारी की पुष्टि करें.गेम में खरीदे गए आइटम का एनटाइटलमेंट दें.
डिलीवरी की पुष्टि करने वाला मैसेज दिखाना
जब उपयोगकर्ता Play पॉइंट रिडीम करते हैं और उन्हें बदले में कोई आइटम मिलता है, तो उन्हें उम्मीद होती है कि गेम में उन्हें कोई मैसेज दिखेगा. इसके अलावा, वे यह भी उम्मीद करते हैं कि उन्हें किसी तरह की सूचना मिलेगी, ताकि उन्हें पता चल सके कि गेम को आइटम मिल गया है और उसने उसे प्रोसेस कर लिया है. डिलीवरी की पुष्टि करने के कुछ विकल्प यहां दिए गए हैं:
गेम में डायलॉग बॉक्स दिखाएं.
मैसेज को गेम में मौजूद मैसेज बॉक्स में भेजें. साथ ही, साफ़ तौर पर बताएं कि गेम में मौजूद मैसेज बॉक्स में एक नया मैसेज है.
ओएस की सूचना वाले मैसेज का इस्तेमाल करें.
प्रमोशन वाला आइटम मिलने पर, गेम किसी भी स्थिति में हो सकता है. जैसे, हो सकता है कि गेम डिवाइस पर इंस्टॉल न हो. आपको प्रमोशन वाले आइटम का पता लगाना होगा. भले ही, आइटम मिलने के समय गेम की स्थिति कुछ भी हो. हालांकि, कुछ मामलों में ऐसा हो सकता है कि उपयोगकर्ता को तुरंत यह सूचना न दी जाए कि उसे आइटम मिल गया है. उदाहरण के लिए:
गेम के दौरान, जब मैसेज दिखाने से उपयोगकर्ता का ध्यान भटक सकता है. ऐसे में, कार्रवाई पूरी होने के बाद आपको उपयोगकर्ता को इसकी सूचना देनी होगी.
कटसीन के दौरान, जहां मैसेज दिखाने से उपयोगकर्ता का ध्यान भटक सकता है. ऐसे मामले में, कटसीन खत्म होने के बाद आपको उपयोगकर्ता को सूचना देनी होगी.
गेम के शुरुआती ट्यूटोरियल और उपयोगकर्ता के सेटअप के दौरान. हमारा सुझाव है कि आप नए उपयोगकर्ताओं को इनाम के बारे में तुरंत सूचना दें. ऐसा तब करें, जब वे गेम खोलें या जब वे पहली बार गेम सेट अप कर रहे हों. हालांकि, उपयोगकर्ता को सूचना देने के लिए, मुख्य गेम सीक्वेंस के उपलब्ध होने तक इंतज़ार किया जा सकता है.
अगर आपके ऐप्लिकेशन में कई ऐसे कैरेक्टर या खाते हैं जिन पर आइटम लागू किया जा सकता है, तो हमारा सुझाव है कि आप उपयोगकर्ता को यह चुनने के लिए कहें कि किस खाते को प्रमोशनल आइटम मिलेंगे.
प्रमोशन वाले आइटम के बारे में लोगों को कब और कैसे सूचना देनी है, यह तय करते समय लोगों की ज़रूरतों का ध्यान रखें. अगर किसी उपयोगकर्ता को सूचना तुरंत नहीं मिलती है, तो वह भ्रमित हो सकता है, गेम खेलना बंद कर सकता है, उपयोगकर्ता सहायता टीम से संपर्क कर सकता है या सोशल मीडिया पर इसकी शिकायत कर सकता है.
चुनिंदा गेम इंजन के लिए अपडेट
यहां कुछ गेम इंजन के बारे में बताया गया है, जिनके लिए आपको इन बातों का ध्यान रखना होगा:
अगर आपका गेम Unity का इस्तेमाल करके बनाया गया है, तो हमारा सुझाव है कि आप पुष्टि करें कि जिस IAP को लागू किया जा रहा है वह Play पॉइंट प्रमोशन के साथ काम करता है या नहीं.
अगर आपका गेम Cocos2d-x या Unreal Engine (C/C++) की मदद से बनाया गया है, तो आपको JNI कोड लिखना होगा. यह कोड, C/C++ कोड से Java API को कॉल करता है.
सर्वर-साइड के सबसे सही तरीके
इस सेक्शन में, Play Points प्रमोशन के लिए सर्वर-साइड के सबसे सही तरीके बताए गए हैं:
अगर आपने अपने सर्वर पर
Purchases.products: getकॉल किया है, तो पुष्टि करें कि आपकोproductIdवैल्यू के आधार पर, Play के इनाम के बदले मिलने वाले आइटम और अन्य वन-टाइम प्रॉडक्ट को अलग-अलग मैनेज करना है या नहीं.अगर आपने अपने सर्वर पर
Onetimeproducts: listका इस्तेमाल किया है, तो पुष्टि करें कि क्या आपकोproductIdवैल्यू के हिसाब से, Play के इनाम के तौर पर मिलने वाले आइटम को वन-टाइम प्रॉडक्ट से अलग करना है.यहां दिए गए सबसे सही तरीकों को अपनाकर देखें कि आपको कोई और बदलाव करने की ज़रूरत है या नहीं:
- रेफ़रंस:
- सर्वर-साइड पर सिग्नेचर की पुष्टि करने की सुविधा लागू करें.
- पक्का करें कि
purchaseTokenऔरorderIdकी वैल्यू यूनीक हों और उनका इस्तेमाल पहले न किया गया हो.
समस्या का हल
इस सेक्शन में, उन स्थितियों के लिए सुझाव दिए गए हैं जिनकी वजह से खरीदार पूछताछ कर सकते हैं.
एक से ज़्यादा उपयोगकर्ता खाते
अगर किसी व्यक्ति के डिवाइस पर एक से ज़्यादा Google खाते हैं और वह गलत खाते पर Play पॉइंट रिडीम करता है, तो Google उन आइटम को दूसरे खातों में ट्रांसफ़र नहीं कर सकता. इसी तरह, आपका ऐप्लिकेशन getPurchases() तरीके का इस्तेमाल करके आइटम ट्रांसफ़र नहीं कर सकता. इस स्थिति में, ग्राहक सहायता टीम की मदद से उपयोगकर्ता को ऐप्लिकेशन में मौजूद आइटम मैन्युअल तरीके से दें.
सामान मिलने में देरी हुई या सामान नहीं मिला
अगर खिलाड़ियों को इनाम के आइटम मिलने में देरी हो रही है या वे नहीं मिल रहे हैं, तो Google Play के सहायता दस्तावेज़ में इन-ऐप्लिकेशन खरीदारी से जुड़ी समस्या हल करने की गाइड देखें.