Unity v3 (लेगसी) के लिए Google Analytics प्लग इन - डेवलपर गाइड

इस दस्तावेज़ में Unity के लिए Google Analytics प्लगिन का इस्तेमाल करने से जुड़े ज़रूरी सिद्धांतों के बारे में बताया गया है.

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

शुरू करने से पहले, यह पक्का करें कि आपने ये काम पूरे कर लिए हैं:

आपके पास कम से कम एक Google Analytics प्रॉपर्टी और एक व्यू (प्रोफ़ाइल) होनी चाहिए, ताकि आप अपने गेम से डेटा भेज सकें.
अगर आपको ई-कॉमर्स लेन-देन ट्रैक करने हैं, तो अपनी रिपोर्ट में ई-कॉमर्स चालू करें.
Google Analytics for Unity रेपो से googleanalyticsv3.unitypackage को डाउनलोड करें और इसे अपने Unity प्रोजेक्ट में इंपोर्ट करें. इसके लिए, आप फ़ाइल पर दो बार क्लिक करके ऐसा कर सकते हैं.

सेटअप और कॉन्फ़िगरेशन

कॉन्फ़िगरेशन की जानकारी के लिए कोई प्लैटफ़ॉर्म चुनें:

Android

अगर आपके प्रोजेक्ट में पहले से ही <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.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>

iOS के लिए

अपने Xcode प्रोजेक्ट में ये लाइब्रेरी जोड़ें:
- AdSupport.framework
- CoreData.framework
- SystemConfiguration.framework
- libz.dylib
- libsqlite3.dylib
अगर आपको यह पसंद है कि iOS के लिए लाइब्रेरी बनाते समय, लाइब्रेरी अपने-आप जुड़ जाएं, तो iOS Extras डायरेक्ट्री से PostProcessBuildPlayer_GA फ़ाइल को कॉपी करें और उसे <YOUR PROJECT ROOT>/Assets/Editor डायरेक्ट्री में डालें.
mod_pbxproj.py स्क्रिप्ट डाउनलोड करके, एडिटर डायरेक्ट्री में कॉपी करें. बिल्ड होने के दौरान, अब लाइब्रेरी अपने-आप जुड़ जाएंगी.

ध्यान दें: libsqlite3.dylib की ज़रूरत सिर्फ़ तब होती है, जब Xcode में -ObjC लिंकर फ़्लैग का इस्तेमाल किया जा रहा हो. साथ ही, अगर इस फ़्लैग का इस्तेमाल नहीं किया जा रहा हो, तो इसे PostProcessBuildPlayer_GA फ़ाइल से सुरक्षित तरीके से हटाया जा सकता है.

GAv3 प्रीफ़ैब को कॉन्फ़िगर करना

GAv3 प्रीफ़ैब को कॉन्फ़िगर करने के लिए, यहां दिया गया तरीका अपनाएं:

GAv3.prefab प्रीफ़ैब ऑब्जेक्ट पर क्लिक करें. यह आपको प्रोजेक्ट व्यू में मौजूद ऐसेट/प्लगिन/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 ऑब्जेक्ट को फ़ील्ड पर खींचें और छोड़ें.
अगर आपको GAv3 प्रीफ़ैब जोड़ने के लिए फ़ील्ड नहीं दिखता है, तो यह पक्का करें कि आपकी स्क्रिप्ट में कोई कंपाइलेशन गड़बड़ी न हो. मौजूदा गड़बड़ियां होने पर, जांच करने वाला व्यक्ति अपडेट नहीं करेगा.
अब आप उस GameObject को ट्रैक करने के लिए तैयार हैं. इसी प्रीफ़ैब का इस्तेमाल करके, उन अन्य ऑब्जेक्ट के लिए भी यह प्रोसेस दोहराएं जिन्हें आपको ट्रैक करना है.

अगले चरण

Google Analytics को किस तरह के हिट भेजे जा सकते हैं, यह जानने के लिए एपीआई रेफ़रंस देखें.
उपयोगकर्ता इंटरैक्शन को मापने और गेम के इस्तेमाल से जुड़े सवालों के जवाब पाने के लिए, Google Analytics का इस्तेमाल करने का तरीका जानने के लिए, मोबाइल ऐप्लिकेशन लागू करने की गाइड पढ़ें.