इस पेज का अनुवाद Cloud Translation API से किया गया है.

उपलब्धियों को इंटिग्रेट करना

इस दस्तावेज़ में, Google Play Console या एपीआई कॉल का इस्तेमाल करके, अपने गेम में उपलब्धियां जोड़ने का तरीका बताया गया है. इसमें उपलब्धियों के ज़रूरी एलिमेंट और स्थितियों के बारे में बताया गया है. साथ ही, उन्हें बनाने, इंपोर्ट करने, और मैनेज करने का तरीका बताया गया है.

शुरू करने से पहले

अच्छी क्वालिटी की उपलब्धियां डिज़ाइन करने से जुड़े दिशा-निर्देश पढ़ें.
उपलब्धियों की बुनियादी जानकारी में दी गई शब्दावली देखें.

नई उपलब्धियां बनाना या इंपोर्ट करना

शुरुआत से उपलब्धियां लागू करने के लिए, यह तरीका अपनाएं:

उपलब्धियां जोड़ें

Google Play Console पर पहली बार उपलब्धियां तैयार करने के लिए, दो मुख्य तरीके हैं:

कोई उपलब्धि बनाएं: हर उपलब्धि के लिए, एक-एक करके परिभाषा और मेटाडेटा जोड़ें.
उपलब्धियों की जानकारी इंपोर्ट करें: कई उपलब्धियों के लिए, एक ही चरण में परिभाषाएं और अन्य मेटाडेटा इंपोर्ट करें.

उपलब्धि बनाना

किसी नए और पब्लिश न किए गए गेम के लिए कोई उपलब्धि तैयार करते समय, ये चरण पूरे करें:

Google Play Console में जाकर कोई गेम चुनें.
Play की गेम सेवाएं - उपलब्धियां पेज (आगे बढ़ाएं > Play की गेम सेवाएं > सेटअप और मैनेजमेंट > उपलब्धियां) पर जाकर, उपलब्धि बनाएं को चुनें.
उपलब्धियां जोड़ें पेज पर फ़ॉर्म भरें.
ड्राफ़्ट के तौर पर सेव करें पर क्लिक करें.
उपलब्धि बनाने के बाद, आपको अपनी उपलब्धियां पब्लिश करनी होंगी.

उपलब्धियों की जानकारी इंपोर्ट करें

अपने गेम में एक ही बार में कई उपलब्धियां जोड़ने के लिए, यह तरीका अपनाएं:

अपनी उपलब्धियों की एक ZIP फ़ाइल बनाएं.
फ़ाइल अपलोड करें.

ZIP फ़ाइल के बारे में ज़्यादा जानने के लिए, ZIP फ़ाइल से जुड़े दिशा-निर्देश देखें.

उपलब्धियों की जानकारी इंपोर्ट करने के लिए:

Google Play Console में जाकर कोई गेम चुनें.
Play की गेम सेवाएं - उपलब्धियां पेज (आगे बढ़ाएं > Play की गेम सेवाएं > सेटअप और मैनेजमेंट > उपलब्धियां) पर जाकर, उपलब्धियों की जानकारी इंपोर्ट करें को चुनें.
उपलब्धियों की जानकारी इंपोर्ट करें पेज पर, अपलोड करें पर क्लिक करें.
अपलोड करने के लिए, ज़िप फ़ाइल को चुनें.
ड्राफ़्ट के तौर पर सेव करें पर क्लिक करें.
उपलब्धियां इंपोर्ट करने के बाद, आपको अपना गेम पब्लिश करना होगा.

ZIP फ़ाइल के लिए दिशा-निर्देश

ZIP फ़ाइल का इस्तेमाल करके, एक बार में कई उपलब्धियों की जानकारी इंपोर्ट की जा सकती है. अपनी ZIP फ़ाइल में इस्तेमाल करने के लिए, फ़ाइल के सटीक नामों की टेबल देखें:

फ़ाइल का नाम	ज़रूरी या वैकल्पिक	स्वीकार की जाने वाली वैल्यू
फ़ाइल का नाम	ज़रूरी या वैकल्पिक	स्वीकार की जाने वाली वैल्यू	`AchievementsMetadata.csv`	ज़रूरी है	हर उपलब्धि का मेटाडेटा. एट्रिब्यूट देखें.
`AchievementsLocalizations.csv`	वैकल्पिक	उपलब्धियों के नाम और ब्यौरे के अनुवाद उपलब्ध कराता है.
`AchievementsIconMappings.csv`	वैकल्पिक	उपलब्धियों को उनकी आइकॉन फ़ाइलों से जोड़ता है.
आइकॉन वाली फ़ाइलें	वैकल्पिक	PNG, JPEG या JPG फ़ॉर्मैट में आइकॉन.

ZIP फ़ाइल से जुड़ी ज़रूरी शर्तें:

कोई सबडायरेक्ट्री मौजूद नहीं.
फ़ाइल के यूनीक नाम.
सिर्फ़ CSV, PNG, JPEG या JPG फ़ाइलें.
CSV फ़ाइलों में हेडर वाली लाइन नहीं होनी चाहिए.
हर फ़ाइल का साइज़ 1 एमबी से कम होना चाहिए.
ज़िप फ़ाइल में 203 से ज़्यादा फ़ाइलें नहीं होनी चाहिए.
ज़िप फ़ाइल का कुल साइज़ 200 एमबी से कम होना चाहिए.

AchievementsMetadata.csv फ़ॉर्मैट

AchievementsMetadata.csv फ़ाइल में हर उपलब्धि का मेटाडेटा होता है. इसमें जानकारी को कॉमा लगाकर अलग की गई वैल्यू के तौर पर, इस क्रम में शामिल किया जाना चाहिए:

    Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order

यहां दी गई टेबल में, इन फ़ील्ड के बारे में बताया गया है:

CSV कॉलम के हेडर	ज़रूरी या वैकल्पिक	स्वीकार की जाने वाली वैल्यू
CSV कॉलम के हेडर	ज़रूरी या वैकल्पिक	स्वीकार की जाने वाली वैल्यू	नाम	ज़रूरी है	ज़्यादा से ज़्यादा 100 वर्ण
ब्यौरा	वैकल्पिक	ज़्यादा से ज़्यादा 500 वर्ण
इंंक्रीमेंटल वैल्यू	वैकल्पिक	`True` या `False`
ये काम करने ज़रूरी हैं	अगर `Incremental Value` की वैल्यू `True.` है, तो यह एट्रिब्यूट ज़रूरी है	संख्या (इसमें फ़्रैक्शन या दशमलव नहीं होने चाहिए)
शुरुआती स्थिति	ज़रूरी है	`Hidden` या `Revealed`
पॉइंट	ज़रूरी है	यह संख्या 5 का गुणज होनी चाहिए. साथ ही, इसकी वैल्यू 5 से 200 के बीच होनी चाहिए
सूची का क्रम	वैकल्पिक	संख्या (शून्य से बड़ी होनी चाहिए और इसमें फ़्रैक्शन या दशमलव नहीं होने चाहिए)

AchievementsMetadata.csv फ़ाइल से जुड़ी ज़रूरी शर्तें:

हर लाइन में सात वैल्यू होनी चाहिए. अगर आपको कोई वैल्यू शामिल नहीं करनी है, तो उसे खाली छोड़ दें.
Name और Description फ़ील्ड का इस्तेमाल, डिफ़ॉल्ट स्थानीय भाषा के तौर पर किया जाता है.
Name फ़ील्ड, सभी उपलब्धियों के लिए यूनीक होना चाहिए.
इन फ़ील्ड में कॉमा नहीं होने चाहिए: Name और Description.

AchievementsMetadata.csv फ़ाइल का सैंपल:

  Achievement1,Achievement One,True,100,Hidden,5,20
  Achievement2,Achievement Two,False,,Revealed,10,30

AchievementsLocalizations.csv फ़ॉर्मैट

AchievementsLocalizations.csv फ़ाइल उपलब्ध कराना ज़रूरी नहीं है. इसमें वह पूरा डेटा सेट अप किया जाता है जो लोगों को अलग-अलग स्थानीय भाषाओं में, हर उपलब्धि के बारे में बताने के लिए ज़रूरी होता है. उपलब्धियों का अनुवाद, गेम के लिए तय की गई स्थानीय भाषाओं के हिसाब से किया जाता है.

इसमें जानकारी को कॉमा लगाकर अलग की गई वैल्यू के तौर पर, इस क्रम में शामिल किया जाना चाहिए:

   Name, Localized name, Localized description, locale

यहां दी गई टेबल में, इन फ़ील्ड के बारे में बताया गया है:

CSV कॉलम के हेडर	ज़रूरी या वैकल्पिक	ब्यौरा	स्वीकार की जाने वाली वैल्यू
CSV कॉलम के हेडर	ज़रूरी या वैकल्पिक	ब्यौरा	स्वीकार की जाने वाली वैल्यू	नाम	ज़रूरी है	यह `AchievementsMetadata.csv` के `Name` कॉलम से मेल खाना चाहिए.	ज़्यादा से ज़्यादा 100 वर्ण
स्थानीय भाषा में नाम	ज़रूरी है	उपलब्धि का स्थानीय नाम.	ज़्यादा से ज़्यादा 100 वर्ण
स्थानीय भाषा में जानकारी	वैकल्पिक	तय की गई स्थानीय भाषा में, उपलब्धि के बारे में जानकारी.	ज़्यादा से ज़्यादा 500 वर्ण
स्थानीय भाषा	ज़रूरी है	स्थानीय भाषा का कोड, जैसे कि `en-US`.	स्थानीय भाषा तय करने से पहले, अपने गेम के लिए अनुवाद जोड़ें. ध्यान दें कि डिफ़ॉल्ट रूप से दी गई भाषा की जानकारी सबमिट नहीं की जा सकती. चुनी जा सकने वाली स्थानीय भाषाओं के कोड, चुनी जा सकने वाली भाषाओं की सूची में देखे जा सकते हैं.

AchievementsLocalizations.csv फ़ाइल से जुड़ी ज़रूरी शर्तें:

किसी गेम में उपलब्धि के नाम, हर स्थान-भाषा के हिसाब से अलग-अलग होने चाहिए.
उदाहरण के लिए, अगर कोई गेम en-US और fr-FR, दोनों भाषाओं में उपलब्ध है, तो en-US के लिए "Achievement1" नाम वाली उपलब्धि को fr-FR के लिए भी "Achievement1" नाम दिया जा सकता है.
हर लाइन में चार वैल्यू होनी चाहिए. अगर आपको स्थानीय भाषा में जानकारी की वैल्यू नहीं देनी है, तो उसे खाली छोड़ दें.

AchievementsLocalizations.csv फ़ाइल का सैंपल:

Achievement1,Achievement One,This is the description of achievement one in English.,en-US
Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR
Achievement2,Achievement Two,Description of achievement two.,en-US
Achievement2,Logro Dos,Descripción del logro dos.,es-ES
Achievement3,Achievement Three,,en-US
Achievement3,Erfolg Drei,,de-DE

AchievementsIconMappings.csv वाला फ़ॉर्मैट

AchievementsIconMappings.csv फ़ाइल उपलब्ध कराना ज़रूरी नहीं है. इसका इस्तेमाल, उपलब्धियों को उनके आइकॉन से मैप करने के लिए किया जाता है. इसमें जानकारी को कॉमा लगाकर अलग की गई वैल्यू के तौर पर, इस क्रम में शामिल किया जाना चाहिए:

Name, icon filename

यहां दी गई टेबल में, इन फ़ील्ड के बारे में बताया गया है

CSV कॉलम के हेडर	ज़रूरी या वैकल्पिक	ब्यौरा
CSV कॉलम के हेडर	ज़रूरी या वैकल्पिक	ब्यौरा	नाम	ज़रूरी है	यह `AchievementsMetadata.csv` के `Name` कॉलम से मेल खाना चाहिए.
आइकॉन फ़ाइल नाम	ज़रूरी है	आपकी आइकॉन फ़ाइल का नाम.

AchievementsIconMappings.csv फ़ाइल से जुड़ी ज़रूरी शर्तें:

हर लाइन में दो वैल्यू होनी चाहिए.
आइकॉन फ़ाइलें सिर्फ़ PNG या JPEG फ़ॉर्मैट में हो सकती हैं.

AchievementsIconMappings.csv फ़ाइल का सैंपल:

Valid Achievement,valid-achievement-icon.png
Incremental Achievement,incremental-achievement-icon.jpeg
No Description,no-description-icon.png
Hidden Initial State,hidden-initial-state-icon.png
Large Point Value,large-point-value-icon.jpeg

आइकॉन के लिए दिशा-निर्देश

आइकॉन, 512 x 512 पिक्सल वाले PNG, JPEG या JPG फ़ॉर्मैट में बनाए जाने चाहिए. आपको सिर्फ़ अनलॉक की गई उपलब्धि का आइकॉन देना होगा. हम दिखाए गए आइकॉन का ग्रेस्केल वर्शन अपने-आप जनरेट कर देंगे. इसलिए, हम सुझाव देते हैं कि आपके अचीवमेंट आइकॉन में रंगीन एलिमेंट शामिल हों, ताकि आपके उपयोगकर्ता, दिखाए गए और अनलॉक किए गए अचीवमेंट के बीच अंतर कर सकें.

जब किसी Android [toast][a] में किसी उपलब्धि का आइकॉन दिखता है, तो आइकॉन पर एक सर्कल ओवरले होता है और उसके बाहरी कोने छिपे होते हैं. पक्का करें कि इन स्थितियों में भी आपका आइकॉन अच्छा दिखे.

सभी भाषाओं में एक ही आइकॉन का इस्तेमाल किया जाता है. इसलिए, हमारा सुझाव है कि आप आइकॉन में कोई टेक्स्ट या स्थानीय भाषा में लिखा गया कॉन्टेंट शामिल न करें.

आइकॉन वाली फ़ाइलें

AchievementsIconMappings.csv फ़ाइल में बताए गए आइकॉन, इंपोर्ट किए गए मौजूदा ZIP फ़ॉर्मैट वाले संग्रह में मौजूद होने चाहिए.

मौजूदा उपलब्धियों वाले गेम अपडेट करना

Google Play Console में, किसी गेम में ज़्यादा उपलब्धियां जोड़ी जा सकती हैं. साथ ही, मौजूदा उपलब्धियों को अपडेट किया जा सकता है.

ज़्यादा उपलब्धियां जोड़ना

अगर आपने पहले से उपलब्धियां जोड़ी हैं और आपको ज़्यादा उपलब्धियां जोड़नी हैं, तो:

Google Play Console में जाकर, कोई गेम चुनें.
Play की गेम सेवाएं - उपलब्धियां पेज (आगे बढ़ाएं > Play की गेम सेवाएं > सेटअप और मैनेजमेंट > उपलब्धियां) पर जाकर, उपलब्धियां जोड़ें को चुनें.

उपलब्धियों में बदलाव करना

अगर आपने पहले से उपलब्धियां जोड़ी हैं और आपको उनमें बदलाव करना है, तो:

Google Play Console में जाकर, कोई गेम चुनें.
Play की गेम सेवाएं - उपलब्धियां पेज (आगे बढ़ाएं > Play की गेम सेवाएं > सेटअप और मैनेजमेंट > उपलब्धियां) पर जाकर, कोई उपलब्धि चुनें.
किसी भी फ़ील्ड में बदलाव किया जा सकता है.
ड्राफ़्ट के तौर पर सेव करें पर क्लिक करें.
Play की गेम सेवाएं - उपलब्धियां पेज पर, बदली गई उपलब्धि "टेस्टर के लिए उपलब्ध है" स्थिति में होती है.
उपलब्धि की जांच करने के बाद, समीक्षा करें और पब्लिश करें पर क्लिक करें.
इससे आपका गेम और अपडेट की गई सभी उपलब्धियां फिर से पब्लिश हो जाती हैं.

किसी उपलब्धि को मिटाना

किसी उपलब्धि को पब्लिश करने के बाद, उसे मिटाया नहीं जा सकता. किसी उपलब्धि को सिर्फ़ तब मिटाया जा सकता है, जब आपने उसे पब्लिश न किया हो

Play Games Services - उपलब्धियां पेज पर जाकर, कोई उपलब्धि चुनें.
उपलब्धि मिटाने के लिए, उपलब्धि मिटाएं पर क्लिक करें.

किसी उपलब्धि को रीसेट करना

आपके पास सिर्फ़ ड्राफ़्ट में मौजूद उपलब्धियों के लिए, खिलाड़ी की प्रोग्रेस से जुड़े डेटा को रीसेट करने का विकल्प होता है.

Play Games Services - उपलब्धियां पेज पर जाकर, कोई उपलब्धि चुनें.
उपलब्धियों को रीसेट करने के लिए, प्रोग्रेस रीसेट करें पर क्लिक करें.
उपलब्धि के डेटा को प्रोग्राम के हिसाब से, अपने-आप होने वाली प्रोसेस के ज़रिए रीसेट करने के लिए, Management API Achievements methods को कॉल करें.

उपलब्धियों के लिए अनुवाद जोड़ना

अपने गेम में मौजूद उपलब्धियों के लिए, अनुवाद खुद जोड़ा जा सकता है. ऐसा करने से पहले, अपने गेम के लिए अनुवाद जोड़ना में बताया गया तरीका अपनाएं.

अपने गेम के लिए अनुवाद जोड़ने के दो तरीके हैं:

एक साथ कई नई उपलब्धियों के अनुवाद अपलोड करने के लिए, उपलब्धियां इंपोर्ट करें विकल्प का इस्तेमाल करें. इस विकल्प का इस्तेमाल, पहले से मौजूद उपलब्धियों के अनुवाद अपलोड करने के लिए नहीं किया जा सकता.
अपने गेम में, हर उपलब्धि के लिए अनुवाद जोड़े जा सकते हैं. हर उपलब्धि का अपना अनुवाद जोड़ने के लिए:
1. Google Play Console में, अपने गेम के लिए उपलब्धियां टैब खोलें. इसके बाद, किसी मौजूदा उपलब्धि को चुनें.
2. उपलब्धियों की ज़्यादा जानकारी वाले पेज पर, उस भाषा के लिए टैब चुनें जिसे आपने पहले गेम की जानकारी टैब में जोड़ा था.
3. उस भाषा में मौजूद उपलब्धि की ज़्यादा जानकारी वाले पेज पर, उपलब्धि के लिए अनुवाद किए गए शब्दों का इस्तेमाल करके फ़ॉर्म में बदलाव करें.
4. उपलब्धि की अनुवाद की गई जानकारी सेव करने के लिए, सेव करें पर क्लिक करें.

क्लाइंट के लिए लागू करने की प्रोसेस

अपने प्लैटफ़ॉर्म के लिए उपलब्धियां लागू करने का तरीका जानने के लिए, यहां दिए गए रिसॉर्स देखें:

उपलब्धियों की जांच करना

यह पुष्टि करने के लिए कि उपलब्धियां सही तरीके से काम कर रही हैं, उनकी जांच करने के लिए यह तरीका अपनाएं:

इंटरनल टेस्ट ट्रैक सेट अप करें.
जांच करने वाले लोगों के लिए, अपने गेम प्रोजेक्ट में टेस्ट खाते जोड़ें.
Play Games ऐप्लिकेशन का इस्तेमाल करके, किसी एक टेस्ट खाते के लिए Play Games Services प्रोफ़ाइल बनाएं.
उसी टेस्ट खाते का इस्तेमाल करके गेम खोलें जिसके लिए आपने Play Games Services प्रोफ़ाइल बनाई थी.
पुष्टि करें कि गेम लॉन्च होने पर, Play की गेम सेवाओं का "वेलकम टोस्ट" स्क्रीन पर दिख रहा है. इससे यह पुष्टि होती है कि गेम लॉन्च होने पर, पुष्टि करने की प्रोसेस अपने-आप पूरी हो गई है.
गेम खेलें और उपलब्धियां अनलॉक करने के लिए ज़रूरी चरण पूरे करें.
उपलब्धियों की पुष्टि करने के लिए:
- पुष्टि करें कि उपलब्धि पूरी होने पर, स्क्रीन पर "उपलब्धि अनलॉक हो गई" पॉप-अप दिखता है.
- Play Store ऐप्लिकेशन खोलें और पुष्टि करें कि YouTab पर उपलब्धियां सेक्शन में, पूरी हो चुकी और जारी उपलब्धियां दिख रही हैं. साथ ही, उनकी प्रोग्रेस की जानकारी भी दिख रही है.

Play Console में उपलब्धियों की परफ़ॉर्मेंस को ट्रैक करना

हर उपलब्धि के लिए फटाफट आंकड़े पाने का तरीका यह है:

Google Play Console में.
सेटिंग> गेम प्रोजेक्ट पर जाएं.
कोई गेम चुनें.
बाईं ओर दिए गए मेन्यू में, उपलब्धियां पर क्लिक करें.
अपने उपलब्धियां पेज पर, आपको आंकड़े दिखेंगे. इनसे यह पता चलेगा कि आपके खिलाड़ियों ने उपलब्धियां अनलॉक की हैं या नहीं. जिन लोगों ने अपनी उपलब्धियां नहीं छिपाई हैं उनके लिए, यह देखा जा सकता है कि कितने प्रतिशत लोग उन्हें अनलॉक कर रहे हैं. शुरुआती चरण की उपलब्धियों के लिए, अनलॉक करने का प्रतिशत आम तौर पर 100% के आस-पास होता है.

आगे बढ़ाएं > Google Play की गेम सेवाएं > गेम के आंकड़े पेज पर जाकर, उपलब्धियों की टाइम सीरीज़ परफ़ॉर्मेंस को भी ट्रैक किया जा सकता है.

उपलब्धियां पब्लिश करना

टेस्टिंग पूरी होने के बाद, आपको अपना गेम पब्लिश करना होगा. गेम की सभी उपलब्धियां भी उसके साथ पब्लिश हो जाएंगी. उपलब्धियां पब्लिश करना ज़रूरी है, ताकि वे ठीक से काम कर सकें.

पब्लिश करने के लिए, यह तरीका अपनाएं:

Google Play Console में जाकर, कोई गेम चुनें.
Play की गेम सेवाएं - उपलब्धियां पेज (आगे बढ़ाएं > Play की गेम सेवाएं > सेटअप और मैनेजमेंट > उपलब्धियां) पर जाकर, समीक्षा करें और पब्लिश करें पर क्लिक करें.
Play की गेम सेवाएं - पब्लिश करना पेज (आगे बढ़ाएं > Play की गेम सेवाएं > सेटअप और मैनेजमेंट > पब्लिश करना) पर जाकर, कार्रवाइयों की समीक्षा करें और समस्याओं को ठीक करें.
पब्लिश करें पर क्लिक करें.
गेम की सभी उपलब्धियां पब्लिश हो जाती हैं.

आम तौर पर होने वाली गलतियों से बचें

इन पॉइंट में, गेम में उपलब्धियां लागू करते समय होने वाली सामान्य गलतियों के बारे में बताया गया है. इनमें इन बातों पर ज़ोर दिया गया है:

Play Console में, आगे बढ़ाएं > Play की गेम सेवाएं > सेटअप और मैनेजमेंट > उपलब्धियां पर जाएं.
- पब्लिश करने से पहले, पुष्टि करें कि Play Console में कॉन्फ़िगर की गई उपलब्धियां "ड्राफ़्ट" स्थिति में न हों.
- Play Console से मिली उपलब्धि आईडी की वैल्यू को गेम कोड में न जोड़ें. इसके बजाय, क्लाइंट के लिए उपलब्ध सुविधाओं का इस्तेमाल करें.
पक्का करें कि आपने अपने क्लाइंट पर भी अनलॉक करने का लॉजिक लागू किया हो.
- खिलाड़ी, ट्रिगर करने वाले उस चरण को नहीं छोड़ सकते जहां अनलॉक करने वाले एपीआई को कॉल किया जाता है. उदाहरण के लिए, ट्यूटोरियल पूरा करना एक उपलब्धि है, लेकिन खिलाड़ी ट्यूटोरियल को छोड़ सकते हैं.