गेम के आंकड़े इंटिग्रेट करना

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

इवेंट बनाना या इंपोर्ट करना

Google Play Console का इस्तेमाल करके, पहली बार इवेंट जोड़ने के दो तरीके हैं:

• इवेंट बनाएं: एक बार में एक इवेंट जोड़ें.
• इवेंट इंपोर्ट करें: एक से ज़्यादा इवेंट इंपोर्ट करें.

कोई इवेंट बनाना

किसी गेम के लिए इवेंट बनाने के लिए, यह तरीका अपनाएं:

1. Google Play Console में जाकर कोई गेम चुनें.
2. Play की गेम सेवाएं - गेम के आंकड़े पेज (उपयोगकर्ताओं की संख्या बढ़ाएं > Play की गेम सेवाएं > सेटअप और मैनेजमेंट > गेम के आंकड़े) पर जाकर, इवेंट जोड़ें > इवेंट बनाएं को चुनें.
3. इवेंट बनाएं पेज पर जाकर, फ़ॉर्म भरें.
4. बदलाव सेव करें पर क्लिक करें.

इवेंट इंपोर्ट करना

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

1. इवेंट की CSV फ़ाइल PlayerGameEvent.csv बनाएं.
2. Google Play Console में जाकर कोई गेम चुनें.
3. Play की गेम सेवाएं - गेम के आंकड़े पेज (उपयोगकर्ताओं की संख्या बढ़ाएं > Play की गेम सेवाएं > सेटअप और मैनेजमेंट > गेम के आंकड़े) पर जाकर, इवेंट जोड़ें > CSV फ़ाइल के ज़रिए इंपोर्ट करें को चुनें.
4. इवेंट कॉन्फ़िगरेशन पेज पर, अपलोड करने के लिए CSV फ़ाइल को खींचकर छोड़ें.
5. इवेंट बनाने के बाद, आंकड़े सेट अप करें.

आंकड़े बनाना या इंपोर्ट करना

Google Play Console का इस्तेमाल करके, पहली बार आंकड़े जोड़ने के दो तरीके हैं:

• कोई स्टैट बनाएं: एक बार में एक स्टैट जोड़ें.
• आंकड़े इंपोर्ट करें: एक से ज़्यादा आंकड़े इंपोर्ट करें.

कोई स्टैट बनाएं

किसी गेम के लिए आंकड़े बनाने के लिए, यह तरीका अपनाएं:

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

इंपोर्ट के आंकड़े

आंकड़े इंपोर्ट करने के लिए, यह तरीका अपनाएं:

1. आंकड़ों के लिए ZIP फ़ाइल से जुड़े दिशा-निर्देशों के मुताबिक, आंकड़ों, स्थानीय भाषाओं में अनुवाद, और आइकॉन की फ़ाइलों वाली ZIP फ़ाइल बनाएं.
2. Google Play Console में जाकर कोई गेम चुनें.
3. Google Play की गेम सेवाएं - गेम के आंकड़े पेज (उपयोगकर्ताओं की संख्या बढ़ाएं > Google Play की गेम सेवाएं > सेटअप और मैनेजमेंट > गेम के आंकड़े) पर जाकर, आंकड़ा जोड़ें > ZIP फ़ाइल के ज़रिए इंपोर्ट करें को चुनें.
4. अपलोड करने के लिए, गेम के आंकड़ों के कॉन्फ़िगरेशन पेज पर ZIP फ़ाइल को खींचकर छोड़ें.
5. सभी आंकड़े अपलोड करने के बाद, अपना गेम पब्लिश करें.

गेम के आंकड़ों की जांच करना

यह पुष्टि करने के लिए कि गेम के आंकड़े सही तरीके से काम कर रहे हैं, उन्हें टेस्ट करने के लिए यह तरीका अपनाएं:

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

टेस्टिंग के लिए, अपने डिवाइस पर गेम के आंकड़ों की विज़िबिलिटी मैनेज करना

Play Console में आपके टेस्टर के लिए गेम उपलब्ध होने के बाद, अपने डिवाइस पर गेम के आंकड़े देखने के लिए, यह तरीका अपनाएं:

1. Google Play Store की कैश मेमोरी मिटाएं:

   1. अपने डिवाइस पर सेटिंग ऐप्लिकेशन खोलें.
   2. ऐप्लिकेशन > Google Play Store पर टैप करें.
   3. स्टोरेज और कैश मेमोरी पर टैप करें. इसके बाद, कैश मेमोरी मिटाएं पर टैप करें.

2. Google Play Store ऐप्लिकेशन खोलें.

3. आपने कितने समय तक गेम खेला सेक्शन या अपनी गेमर प्रोफ़ाइल का इस्तेमाल करके, गेम से जुड़े आंकड़े देखें:

पहला तरीका: 'आपने कितने समय तक गेम खेला' सेक्शन का इस्तेमाल करना

गेम खेलने का समय ट्रैक करें सेक्शन पर जाएं. इसके बाद, गेम के आंकड़े देखने के लिए उस पर टैप करें.

दूसरा तरीका: अपनी गेमर प्रोफ़ाइल का इस्तेमाल करना

1. आप टैब पर टैप करें. इसके बाद, अपनी गेमर प्रोफ़ाइल पर टैप करें.
2. गेम के आंकड़े सेक्शन पर जाएं.
3. समयसीमा के लिए, सभी को चुनें.
4. अगर आपको गेम नहीं दिख रहा है, तो सभी गेम देखें पर टैप करें.
5. आंकड़े देखने के लिए, अपना गेम चुनें.

अपने डिवाइस पर लॉग देखना

यह पुष्टि करने के लिए कि गेम के आंकड़े, डिज़ाइन के मुताबिक काम कर रहे हैं, अपने डिवाइस में लॉग चालू करें:

1. अपने डिवाइस पर adb डीबगिंग चालू करें और टर्मिनल में ये निर्देश चलाएं:

   adb shell setprop log.tag.Games INFO
   adb logcat -s "PlayGamesServices[GameStatsAgent]:I"

2. पुष्टि करें कि लॉग मैसेज दिख रहा हो. उदाहरण के लिए, यहां देखें:

   Successfully uploaded batch of X events.
   

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

3. अगर सबमिट किए गए किसी इवेंट की पुष्टि नहीं हो पाती है, तो आपको गड़बड़ी का एक मैसेज दिखेगा. इसमें पुष्टि न होने की वजह बताई जाएगी:

   BatchRecordEvents validation failed for X event(s): ...
   

गेम के आंकड़े पब्लिश करना

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

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

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

गेम के आंकड़ों में बदलाव करना

अगर आपके पास पहले से गेम के आंकड़े मौजूद हैं और आपको उनमें बदलाव करना है, तो:

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

गेम के आंकड़े मिटाना

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

टेस्टर के लिए उपलब्ध है स्टेटस वाले इवेंट या आंकड़े को मिटाया जा सकता है.

1. Google Play Console में जाकर कोई गेम चुनें.
2. Play की गेम सेवाएं - गेम के आंकड़े पेज पर जाएं (उपयोगकर्ताओं की संख्या बढ़ाएं > Play की गेम सेवाएं > सेटअप और मैनेजमेंट > गेम के आंकड़े).
3. किसी इवेंट को मिटाने के लिए:
   1. इवेंट कॉन्फ़िगरेशन सेक्शन में जाकर, कोई इवेंट चुनें.
   2. इवेंट मिटाएं पर क्लिक करें.
4. किसी आंकड़े को मिटाने के लिए:
   1. गेम के आंकड़ों का कॉन्फ़िगरेशन में जाकर , वह आंकड़ा चुनें जिसे आपको मिटाना है.
   2. गेम के आंकड़े मिटाएं पर क्लिक करें.

इवेंट के लिए CSV फ़ाइल से जुड़े दिशा-निर्देश

CSV फ़ाइल की पहली लाइन, हेडर वाली लाइन है. आपको इवेंट इंपोर्ट करने के लिए, इवेंट की CSV फ़ाइल का इस्तेमाल करना होगा. उदाहरण के लिए, PlayerGameEvent.csv.

PlayerGameEvent.csv फ़ॉर्मैट

इस CSV फ़ाइल में, बताए गए इवेंट और उसकी प्रॉपर्टी को कॉमा लगाकर अलग की गई वैल्यू के तौर पर, इस क्रम में शामिल किया जाता है:

 Event Name,Property Name,Property Type

अगर आपको progressUpdate के लिए progressionStat इवेंट भेजना है, तो इस इवेंट के लिए एक लाइन जोड़ें. इस इवेंट में कम से कम एक currentProgress प्रॉपर्टी होनी चाहिए. इसका टाइप INT या STRING होना चाहिए. साथ ही, इसमें वे सभी प्रॉपर्टी शामिल होनी चाहिए जिन्हें आपको भेजना है.

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

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

• इस फ़ाइल में ज़्यादा से ज़्यादा 20 यूनीक इवेंट नाम हो सकते हैं. साथ ही, हर इवेंट के लिए ज़्यादा से ज़्यादा 20 प्रॉपर्टी हो सकती हैं.
• फ़ाइल का कॉन्टेंट खाली नहीं होना चाहिए. साथ ही, इसमें कम से कम एक लाइन होनी चाहिए.

आंकड़ों के लिए ZIP फ़ाइल से जुड़े दिशा-निर्देश

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

ZIP फ़ाइल इन ज़रूरी शर्तों के मुताबिक होनी चाहिए:

• ZIP फ़ाइल के साइज़ की सीमा: कंप्रेस किए बिना, फ़ाइल का कुल साइज़ 10 एमबी से ज़्यादा नहीं होना चाहिए.
• ज़्यादा से ज़्यादा फ़ाइलें: ZIP फ़ॉर्मैट वाले आर्काइव में कुल 53 फ़ाइलें (3 CSV और 50 आइकॉन) होनी चाहिए.
• कुल आंकड़ों की ज़्यादा से ज़्यादा सीमा: ProgressionStatConfig.csv और RepetitiveStatsConfig.csv में कुल मिलाकर ज़्यादा से ज़्यादा 50 आंकड़े.
• इन CSV फ़ाइलों का इस्तेमाल किया जा सकता है: ProgressionStatConfig.csv, RepetitiveStatsConfig.csv, और StatLocalizations.csv (ज़रूरी नहीं). अगर आपको सिर्फ़ प्रोग्रेशन स्टैट अपलोड करना है, तो ZIP फ़ाइल में बार-बार होने वाले स्टैट की CSV फ़ाइल शामिल न करें. ऐसा न करने पर, कंसोल एक गड़बड़ी दिखाएगा. अगर आपको सिर्फ़ बार-बार दिखने वाले आंकड़े अपलोड करने हैं, तो भी यही तरीका अपनाएं.
• आइकॉन इमेज फ़ाइलें: PNG (.png) या JPEG (.jpg, .jpeg).
  • CSV फ़ाइलों में रेफ़र किए गए सभी आइकॉन, ZIP फ़ाइल के रूट में मौजूद होने चाहिए.
  • ZIP फ़ाइल में मौजूद सभी इमेज फ़ाइलों का रेफ़रंस, कम से कम एक आंकड़े में दिया गया होना चाहिए.
• डायरेक्ट्री स्ट्रक्चर: सभी फ़ाइलें, ZIP फ़ाइल के रूट में होनी चाहिए. सबडायरेक्ट्री इस्तेमाल करने की अनुमति नहीं है.

RepetitiveStatsConfig.csv फ़ॉर्मैट

इस CSV फ़ाइल में, बताए गए इवेंट और उसकी प्रॉपर्टी को कॉमा लगाकर अलग की गई वैल्यू के तौर पर, इस क्रम में शामिल किया जाता है:

Stat Id,Event Name,Event Property Name,Aggregation Type,Stat Display Name,Stat Description,Filter Property,Filter Operator,Filter Value,Is Competitive,Min limit,Max limit,Icon File Name,Good value direction,Unit

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

अगर आपको फ़िल्टर करने की शर्त का इस्तेमाल नहीं करना है, तो सेल को खाली छोड़ दें.

ProgressionStatConfig.csv फ़ॉर्मैट

इस CSV फ़ाइल में, बताए गए इवेंट और उसकी प्रॉपर्टी को कॉमा लगाकर अलग की गई वैल्यू के तौर पर, इस क्रम में शामिल किया जाता है:

Stat Id,Event Property Name,Stat Display Name,Stat Description,Icon File Name,Good value direction,Unit

प्रोग्रेशन के आंकड़े, गेमर प्रोफ़ाइल में सबसे पहले दिखेंगे.

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

StatLocalizations.csv फ़ॉर्मैट

इस CSV फ़ाइल में, बताए गए इवेंट और उसकी प्रॉपर्टी को कॉमा लगाकर अलग की गई वैल्यू के तौर पर, इस क्रम में शामिल किया जाता है:

Stat Id,Stat Display Name,Locale,Localized Stat Display Name,Localized Stat Description

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

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

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

आइकॉन की पुष्टि करने के नियम ये हैं:

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

आइकॉन, 512 x 512 पिक्सल वाले PNG, JPEG या JPG फ़ॉर्मैट में बनाए जाने चाहिए. साथ ही, उनका बैकग्राउंड पारदर्शी होना चाहिए.

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

यूनिट की जानकारी

यूनिट कॉलम से यह कंट्रोल किया जाता है कि खिलाड़ियों के लिए, रॉ स्टैट वैल्यू को कैसे फ़ॉर्मैट किया जाए और स्थानीय भाषा में कैसे दिखाया जाए.

संख्या वाले आंकड़े की प्रॉपर्टी (INT64, DOUBLE)

कुल समय की जानकारी देने वाली प्रॉपर्टी (DURATION)

संख्या के अलावा अन्य तरह के आंकड़ों की प्रॉपर्टी (STRING, BOOL)

यूनिट कॉलम को खाली छोड़ना ज़रूरी है.