इस दस्तावेज़ में Unity के लिए Google Analytics प्लगिन का इस्तेमाल करने से जुड़े ज़रूरी सिद्धांतों के बारे में बताया गया है.
शुरू करने से पहले
शुरू करने से पहले, यह पक्का करें कि आपने ये काम पूरे कर लिए हैं:
- आपके पास कम से कम एक Google Analytics प्रॉपर्टी और एक व्यू (प्रोफ़ाइल) होनी चाहिए, ताकि आप अपने गेम से डेटा भेज सकें.
- Unity के लिए Google Analytics प्लगिन से सही Unity पैकेज डाउनलोड करें और इसे अपने Unity प्रोजेक्ट में इंपोर्ट करें (आप फ़ाइल पर दो बार क्लिक करके ऐसा कर सकते हैं).
- बिटकोड की सुविधा के साथ:
GoogleAnalyticsV4_bitcode.unitypackage
- बिटकोड इस्तेमाल नहीं किया जा सकता:
GoogleAnalyticsV4.unitypackage
- बिटकोड की सुविधा के साथ:
सेटअप और कॉन्फ़िगरेशन
कॉन्फ़िगरेशन की जानकारी के लिए कोई प्लैटफ़ॉर्म चुनें:
- अगर आपके प्रोजेक्ट में पहले से ही <YOUR PROJECT ROOT>/Assets/Plugins/Android/ डायरेक्ट्री में AndroidManifest.xml पहले से मौजूद नहीं है, तो Android के लिए प्रोजेक्ट बनाएं. इसके बाद, temp/StagingArea/ डायरेक्ट्री से AndroidManifest.xml को कॉपी करें (यह उस डायरेक्ट्री में होगी जिसे आपने बनाने के लिए चुना होगा). इसे <YOUR PROJECT ROOT>/Assets/Plugins/Android/ में चिपकाएं.
- <YOUR PROJECT ROOT>
/Assets/Plugins/Android/ के
<application>
टैग के ऊपर मौजूद AndroidManifest.xml में ये अनुमतियां जोड़ें:<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
- अगर आपको कैंपेन ट्रैकिंग की सुविधा चालू करनी है, तो इस तरह से सेवा जोड़ें:
<service android:name="com.google.android.gms.analytics.CampaignTrackingService" /> <receiver android:name="com.google.android.gms.analytics.CampaignTrackingReceiver" android:exported="true" > <intent-filter> <action android:name="com.android.vending.INSTALL_REFERRER" /> </intent-filter> </receiver>
-
अपने Xcode प्रोजेक्ट में ये लाइब्रेरी जोड़ें:
- AdSupport.framework
- CoreData.framework
- SystemConfiguration.framework
- libz.dylib
- libsqlite3.dylib
- अगर आपको यह पसंद है कि iOS के लिए लाइब्रेरी बनाते समय, लाइब्रेरी अपने-आप जुड़ जाएं, तो iOS Extras डायरेक्ट्री से PostProcessBuildPlayer_GA फ़ाइल को कॉपी करें और उसे <YOUR PROJECT ROOT>/Assets/Editor डायरेक्ट्री में डालें.
- mod_pbxproj.py स्क्रिप्ट डाउनलोड करके, एडिटर डायरेक्ट्री में कॉपी करें. बिल्ड होने के दौरान, अब लाइब्रेरी अपने-आप जुड़ जाएंगी.
GAv4 प्रीफ़ैब को कॉन्फ़िगर करना
GAv4 प्रीफ़ैब को कॉन्फ़िगर करने के लिए:
GAv4.prefab
प्रीफ़ैब ऑब्जेक्ट पर क्लिक करें. यह आपको प्रोजेक्ट व्यू में मौजूद ऐसेट/प्लगिन/GoogleAnalyticsV4 में मिल जाएगा. इसे गेम की हैरारकी में खींचें और छोड़ें.- जांच करने वाला व्यू, प्रीफ़ैब से अटैच किया गया एक स्क्रिप्ट
कॉम्पोनेंट दिखाएगा. इसमें, कई प्रॉपर्टी की सूची होगी.
इन प्रॉपर्टी में अपने प्रोजेक्ट के लिए सही वैल्यू डालें. इससे,
ऑब्जेक्ट में जानकारी अपने-आप भर जाएगी. इससे आपके प्रोजेक्ट में हर जगह इसका इस्तेमाल किया जा सकेगा. उदाहरण
के लिए:
Android Tracking Code: UA-XXXXXXX-1
iOS Tracking Code: UA-XXXXXXX-2
Other Tracking Code: UA-XXXXXXX-3
Product Name: MyGame
Bundle Identifier: com.example.games
Bundle Version: 1.0
Dispatch Period: 5
Sample Frequency: 100
Log Level: VERBOSE
Anonymize IP: false
Uncaught Exception Reporting: false
Send Launch Event: false
Session Timeout: 1800
Dry Run: false
Advertiser Id Support - Send IDFA/AdID: false
किसी ऑब्जेक्ट को ट्रैक करें
GAv4 प्रीफ़ैब को कॉन्फ़िगर करने के बाद, Google Analytics की मदद से किसी ऑब्जेक्ट को ट्रैक करने के लिए:
- उस GameObject की पहचान करें जिसे ट्रैक करना है (उदाहरण के लिए, कोई प्लेयर ऑब्जेक्ट) और उस पर ऑब्जेक्ट हैरारकी व्यू में क्लिक करें. अगर आपके पास उस ऑब्जेक्ट के साथ पहले से कोई स्क्रिप्ट नहीं है जिसे ट्रैक करना है, तो जांच करने वाले व्यू में कॉम्पोनेंट जोड़ें बटन का इस्तेमाल करके एक नई स्क्रिप्ट बनाएं.
- GoogleAnalyticsV4 ऑब्जेक्ट को होल्ड करने के लिए, क्लास में कोई पब्लिक वैरिएबल बनाएं. उदाहरण के लिए:
public GoogleAnalyticsV4 googleAnalytics;
- स्क्रिप्ट को सेव करें और Unity विंडो पर वापस जाएं.
- आपको जिस GameObject को ट्रैक करना है उसके जांच करने वाले व्यू में, आपको अपनी बनाई हुई स्क्रिप्ट और Google Analytics (या आपके चुने गए वैरिएबल नाम) को भरने के लिए एक फ़ील्ड दिखेगा. ऑब्जेक्ट हैरारकी व्यू से, GAv4 ऑब्जेक्ट को फ़ील्ड पर खींचें और छोड़ें.
- अब आप उस GameObject को ट्रैक करने के लिए तैयार हैं. इसी प्रीफ़ैब का इस्तेमाल करके, उन अन्य ऑब्जेक्ट के लिए भी यह प्रोसेस दोहराएं जिन्हें आपको ट्रैक करना है.
अगले चरण
- Google Analytics को किस तरह के हिट भेजे जा सकते हैं, यह जानने के लिए एपीआई रेफ़रंस देखें.
- उपयोगकर्ता इंटरैक्शन को मापने और गेम के इस्तेमाल से जुड़े सवालों के जवाब पाने के लिए, Google Analytics का इस्तेमाल करने का तरीका जानने के लिए, मोबाइल ऐप्लिकेशन लागू करने की गाइड पढ़ें.