इस विषय में बताया गया है कि Google Play ऐप्लिकेशन में, Play Points का इस्तेमाल करके खरीदारी करने के बाद, अपने गेम में इन-ऐप्लिकेशन प्रॉडक्ट का पता कैसे लगाया जाए और उन्हें कैसे डिलीवर किया जाए.
जब उपयोगकर्ता, Google Play ऐप्लिकेशन में जाकर, ऐप्लिकेशन में खरीदने के लिए मौजूद किसी प्रॉडक्ट के बदले अपने Play पॉइंट रिडीम करते हैं, तो उन्हें आपके गेम में तुरंत आइटम मिल जाने चाहिए. यहां बताया गया है कि कोई व्यक्ति Play Points का इस्तेमाल करके आइटम कैसे खरीदता है.
1. Play पॉइंट पर क्लिक करें. | 1. आइटम देखने के लिए, इस्तेमाल करें टैब पर क्लिक करें. | 2. कोई आइटम चुनें और खरीदारी पूरी करने के लिए, पॉइंट इस्तेमाल करें पर क्लिक करें. | 3. आइटम पाएं. |
![]() |
![]() |
![]() |
![]() |
उदाहरण में, प्रॉडक्ट खरीदते समय गेम नहीं चल रहा है. उपयोगकर्ता, अपने डिवाइस पर गेम इंस्टॉल न होने पर भी, Play पॉइंट का इस्तेमाल करके प्रॉडक्ट खरीद सकते हैं. इसलिए, आपको अपने गेम को इस तरह से डिज़ाइन करना होगा कि वह गेम में मौजूद स्टोर के बाहर से, ऐप्लिकेशन में मौजूद आइटम की डिलीवरी को मैनेज कर सके.
शुरू करने से पहले
ऐप्लिकेशन में खरीदने के लिए प्रॉडक्ट का पता लगाने और उसे डिलीवर करने से पहले, आपको प्रॉडक्ट और Play Points प्रमोशन बनाने होंगे.
डिलीवरी की ज़रूरी शर्तें
Play Points प्रमोशन का इस्तेमाल करके, अपने गेम में ऐप्लिकेशन में खरीदने के लिए प्रॉडक्ट उपलब्ध कराते समय, आपको इस सेक्शन में दी गई ज़रूरी शर्तों का पालन करना होगा.
डिलीवरी का समय
जब कोई खिलाड़ी, Play पॉइंट के बदले ऐप्लिकेशन में खरीदारी के लिए मौजूद कोई प्रॉडक्ट खरीदता है, तो आपको उसे तुरंत आइटम डिलीवर करना होगा. इसके लिए, खिलाड़ी को गेम रीस्टार्ट करने की ज़रूरत नहीं होनी चाहिए. ऐसे मामलों में जहां गेम के कॉन्टेंट को पहले से पूरा करना ज़रूरी है, जैसे कि ट्यूटोरियल पूरा करना, आइटम को तुरंत डिलीवर किया जाना चाहिए.
डिलीवरी का मैसेज
जब कोई उपयोगकर्ता, गेम से बाहर जाकर इन-ऐप्लिकेशन प्रॉडक्ट खरीद लेता है और फिर आपके गेम पर वापस आता है, तो आपको उसे यह पुष्टि दिखानी होगी कि गेम में उसे प्रॉडक्ट मिल गया है. यह सूचना किसी पॉप-अप डायलॉग से या गेम के अंदर मैसेज भेजकर देनी चाहिए. उपयोगकर्ताओं को आइटम पाने के लिए, कोई और कार्रवाई करने की ज़रूरत नहीं पड़नी चाहिए.
मैसेज का ज़रूरी फ़ॉर्मैट यहां दिया गया है:
यह साफ़ तौर पर बताया गया हो कि आइटम मिल गया है.
आइटम के नाम के बारे में साफ़ तौर पर बताएं. साथ ही, “Play पॉइंट” के बारे में भी बताएं, ताकि उपयोगकर्ता इसे मिले हुए अन्य कॉन्टेंट से अलग कर सकें.
अगर एक जैसे आइटम अलग-अलग कीमत में उपलब्ध हैं, तो आइटम के नाम में उसकी सही कीमत भी शामिल होनी चाहिए.
पॉप-अप डायलॉग, मैसेज या गेम में दिखने वाली सूचना, उपयोगकर्ता को तब तक दिखनी चाहिए, जब तक वह जारी रखें या ठीक है जैसे किसी विकल्प पर क्लिक करके पुष्टि नहीं कर देता. इसमें 'रद्द करें' बटन नहीं होना चाहिए, क्योंकि इस मैसेज का मकसद सिर्फ़ उपयोगकर्ताओं को यह सूचना देना है कि उन्हें गेम में कौनसी चीज़ मिली है. अगर पुष्टि करने वाला बटन नहीं है, तो उपयोगकर्ताओं को मैसेज कम से कम तीन सेकंड तक दिखना चाहिए. इसके बाद, यह गायब हो जाना चाहिए. इससे यह पक्का किया जा सकेगा कि उपयोगकर्ताओं को पता चल गया है कि उन्हें उनका आइटम मिल गया है.
यहां एक उदाहरण मैसेज दिया गया है:
"आइटम मिल गया! आपको Play Points के ज़रिए 100 Gems मिले हैं. जारी रखें."
उपयोगकर्ताओं को एक ऐनिमेशन या कोई विज़ुअल पुष्टि दिखनी चाहिए, जिसमें गेम में इस्तेमाल होने वाली मुद्रा के बैलेंस में बढ़ोतरी दिखाई गई हो. अगर आइटम, ऐप्लिकेशन में इस्तेमाल किया जा सकने वाला या बार-बार इस्तेमाल किया जा सकने वाला आइटम है, तो उपयोगकर्ताओं को उस जगह पर रीडायरेक्ट किया जाना चाहिए जहां आइटम अनलॉक किया गया है या गेम में उपलब्ध है.
गेम के बाहर से मिले आइटम का पता लगाना
अगर आपका गेम Google Play Billing Library का इस्तेमाल करता है, तो गेम के बाहर से मिले इन-ऐप्लिकेशन प्रॉडक्ट का पता लगाने के लिए, ये बदलाव करें.
अपने गेम के
onResume()
कॉलबैक में,queryPurchases()
तरीके को कॉल करें, ताकि आपको आइटम की सूची मिल सके. इससे आपको यह पता चल पाएगा कि किन आइटम की पुष्टि नहीं हुई है.अगर आपके गेम में सर्वर है, तो हमारा सुझाव है कि आप Subscriptions and In-App Purchases API का इस्तेमाल करके, अपने सर्वर से खरीदारी की पुष्टि करें.
अगर आपके पास ऐसे आइटम हैं जिनकी पुष्टि नहीं की गई है, तो खरीदारी की पुष्टि करें. इसके लिए,
consumeAsync()
का इस्तेमाल करके, इस्तेमाल किए जा सकने वाले आइटम की पुष्टि करें याacknowledgePurchase()
का इस्तेमाल करके, इस्तेमाल नहीं किए जा सकने वाले आइटम की पुष्टि करें.गेम में खरीदे गए आइटम का एनटाइटलमेंट दें.
स्प्लिट स्क्रीन मोड में मिले आइटम का पता लगाना
अगर आपका गेम मल्टी-विंडो मोड के साथ काम करता है, तो उपयोगकर्ता Play Store ऐप्लिकेशन और आपके गेम को एक साथ चलाते हुए, Play पॉइंट रिडीम करके आइटम पा सकते हैं. इस स्क्रीनशॉट में एक उदाहरण दिखाया गया है:
Google Play Billing Library के साथ इस स्थिति को मैनेज करने के लिए, यह तरीका अपनाएं:
Google Play,
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 के इनाम के बदले मिलने वाले आइटम और ऐप्लिकेशन में खरीदने के लिए उपलब्ध अन्य प्रॉडक्ट को अलग-अलग मैनेज करना है या नहीं.अगर सर्वर पर
Inappproducts: list
का इस्तेमाल किया जाता है, तो पुष्टि करें कि क्या आपको Play के इनामों के बदले मिलने वाले आइटम को, ऐप्लिकेशन में मौजूद अन्य प्रॉडक्ट सेproductId
वैल्यू के हिसाब से अलग करना है.यहां दिए गए सबसे सही तरीके देखें. इनसे आपको यह पता चलेगा कि आपको कोई और बदलाव करने की ज़रूरत है या नहीं:
- रेफ़रंस:
- सर्वर-साइड पर सिग्नेचर की पुष्टि करने की सुविधा लागू करें.
- पक्का करें कि
purchaseToken
औरorderId
की वैल्यू यूनीक हों और उनका इस्तेमाल पहले न किया गया हो.
समस्या का हल
इस सेक्शन में, उन स्थितियों के लिए सुझाव दिए गए हैं जिनकी वजह से खरीदार पूछताछ कर सकते हैं.
एक से ज़्यादा उपयोगकर्ता खाते
अगर किसी व्यक्ति के डिवाइस पर एक से ज़्यादा Google खाते हैं और वह गलत खाते से Play पॉइंट रिडीम करता है, तो Google उन आइटम को दूसरे खातों में ट्रांसफ़र नहीं कर सकता. इसी तरह, आपका ऐप्लिकेशन getPurchases()
तरीके का इस्तेमाल करके आइटम ट्रांसफ़र नहीं कर सकता. इस स्थिति में, ग्राहक सहायता टीम की मदद से उपयोगकर्ता को ऐप्लिकेशन में मौजूद आइटम मैन्युअल तरीके से दें.
सामान मिलने में देरी हुई या सामान नहीं मिला
अगर खिलाड़ियों को इनाम में मिलने वाले आइटम मिलने में देरी हो रही है या वे आइटम नहीं मिल रहे हैं, तो Google Play के सहायता दस्तावेज़ में इन-ऐप्लिकेशन खरीदारी से जुड़ी समस्या हल करने की गाइड देखें.