यह दस्तावेज़ Unity के लिए Google Analytics प्लगिन का इस्तेमाल करने से जुड़े अहम सिद्धांतों के बारे में बताता है.
शुरू करने से पहले
शुरू करने से पहले, पक्का करें कि आपने ये काम पूरे कर लिए हों:
- आपके पास कम से कम एक Google Analytics प्रॉपर्टी और एक व्यू (प्रोफ़ाइल) होनी चाहिए, जहां आपको अपने गेम से डेटा भेजना है.
- अगर आपको ई-कॉमर्स लेन-देन ट्रैक करना है, तो अपनी रिपोर्ट में ई-कॉमर्स चालू करें.
- Unity के लिए Google Analytics प्लगिन से googleanalyticsv3.unitypackage को डाउनलोड करके, इसे अपने Unity प्रोजेक्ट में इंपोर्ट करें. इसके लिए, आप फ़ाइल पर दो बार क्लिक करके ऐसा कर सकते हैं.
सेटअप और कॉन्फ़िगरेशन
कॉन्फ़िगरेशन की जानकारी के लिए कोई प्लैटफ़ॉर्म चुनें:
- अगर आपके प्रोजेक्ट के पास <YOUR PROJECT ROOT>/Assets/Plugins/Android/ डायरेक्ट्री में पहले से AndroidManifest.xml नाम की कोई फ़ाइल नहीं है, तो Android के लिए प्रोजेक्ट बनाएं. इसके बाद, temp/StagingArea/ डायरेक्ट्री से AndroidManifest.xml को कॉपी करें. यह डायरेक्ट्री उस डायरेक्ट्री में होगी जिसे आपने बनाने के लिए चुना है. इसे <YOUR PROJECT ROOT>/Assets/Plugins/Android/ में चिपकाएं.
<application>
टैग के ऊपर मौजूद <YOUR PROJECT ROOT> /Assets/Plugins/Android/ AndroidManifest.xml में ये अनुमतियां जोड़ें:<uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
- अगर आपको कैंपेन ट्रैकिंग की सुविधा चालू करनी है, तो सेवा को इस तरह जोड़ें:
<service android:name="com.google.analytics.tracking.android.CampaignTrackingService" /> <receiver android:name="com.google.analytics.tracking.android.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 स्क्रिप्ट डाउनलोड करें और उसे Editor डायरेक्ट्री में कॉपी करें. बिल्ड के दौरान लाइब्रेरी अब अपने-आप जुड़ जाएंगी.
GAv3 प्रीफ़ैब को कॉन्फ़िगर करें
GAv3 प्रीफ़ैब को कॉन्फ़िगर करने के लिए, नीचे दिया गया तरीका अपनाएं:
GAv3.prefab
प्रीफ़ैब ऑब्जेक्ट पर क्लिक करें. यह आपको प्रोजेक्ट व्यू में, Assets/Plugins/GoogleAnalyticsV3 में मिलेगा.- जांच करने वाले व्यक्ति का व्यू, प्रीफ़ैब से अटैच स्क्रिप्ट
कॉम्पोनेंट दिखाएगा. इसमें कई प्रॉपर्टी शामिल होंगी.
इन प्रॉपर्टी में अपने प्रोजेक्ट के लिए सही वैल्यू डालें. यह ऑब्जेक्ट को
पॉप्युलेट कर देगा, ताकि इसे आपके प्रोजेक्ट में हर जगह इस्तेमाल किया जा सके. उदाहरण
के लिए:
Android Property ID: UA-XXXXXXX-1
iOS Property ID: UA-XXXXXXX-2
Other Property ID: UA-XXXXXXX-3
App Name: MyGame
Bundle ID: com.example.games
App Version: 1.0
Dispatch Period: 5
Sample Frequency: 100
Debug Mode: VERBOSE
Anonymize IP: false
Dry Run: false
- अपने-आप भरे हुए GAv3 को प्रोजेक्ट व्यू से, ऑब्जेक्ट की हैरारकी में ऊपर की ओर खींचें और छोड़ें.
किसी ऑब्जेक्ट को ट्रैक करें
GAv3 प्रीफ़ैब कॉन्फ़िगर करने के बाद, नीचे दिया गया तरीका अपनाकर Google Analytics का इस्तेमाल करके, किसी ऑब्जेक्ट को ट्रैक करने के लिए तैयार रहें:
- उस GameObject की पहचान करें जिसे ट्रैक करना है (उदाहरण के लिए, कोई प्लेयर ऑब्जेक्ट) और उस पर ऑब्जेक्ट हैरारकी व्यू में क्लिक करें. अगर आपके पास उस ऑब्जेक्ट में पहले से कोई स्क्रिप्ट नहीं है जिसे ट्रैक करना है, तो जांच करने वाले टूल की सूची में कॉम्पोनेंट जोड़ें बटन का इस्तेमाल करके, एक नई स्क्रिप्ट बनाएं.
- GoogleAnalyticsV3 ऑब्जेक्ट को होल्ड करने के लिए, क्लास में सार्वजनिक वैरिएबल बनाएं. उदाहरण के लिए:
public GoogleAnalyticsV3 googleAnalytics;
- स्क्रिप्ट को सेव करें और Unity विंडो पर वापस जाएं.
- आपको जिस GameObject को ट्रैक करना है उसके जांच करने वाले व्यक्ति के व्यू में, आपको अपनी बनाई हुई स्क्रिप्ट और Google Analytics (या आपके चुने गए वैरिएबल का नाम) को पॉप्युलेट करने के लिए एक फ़ील्ड दिखेगा. ऑब्जेक्ट हैरारकी व्यू से, GAv3 ऑब्जेक्ट को फ़ील्ड पर खींचें और छोड़ें.
- अब आप उस GameObject को ट्रैक करने के लिए तैयार हैं. इसी प्रीफ़ैब का इस्तेमाल करके, जिन अन्य ऑब्जेक्ट को ट्रैक करना है उनके लिए यह प्रोसेस दोहराएं.
अगले चरण
- Google Analytics को किस तरह के हिट भेजे जा सकते हैं, यह जानने के लिए एपीआई के रेफ़रंस को देखें.
- Google Analytics का इस्तेमाल करके, उपयोगकर्ता इंटरैक्शन को मेज़र करने और गेम के इस्तेमाल से जुड़े सवालों के जवाब देने का तरीका जानने के लिए, मोबाइल ऐप्लिकेशन लागू करने की गाइड पढ़ें.