Unity के लिए Google Analytics प्लग इन - डेवलपर गाइड

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

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

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

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

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

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

Android

1. अगर आपके प्रोजेक्ट में पहले से ही <YOUR PROJECT ROOT>/Assets/Plugins/Android/ डायरेक्ट्री में AndroidManifest.xml पहले से मौजूद नहीं है, तो Android के लिए प्रोजेक्ट बनाएं. इसके बाद, temp/StagingArea/ डायरेक्ट्री से AndroidManifest.xml को कॉपी करें (यह उस डायरेक्ट्री में होगी जिसे आपने बनाने के लिए चुना होगा). इसे <YOUR PROJECT ROOT>/Assets/Plugins/Android/ में चिपकाएं.
2. <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" />
         

3. अगर आपको कैंपेन ट्रैकिंग की सुविधा चालू करनी है, तो इस तरह से सेवा जोड़ें:

   <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>
         

iOS के लिए

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

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

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

GAv4 प्रीफ़ैब को कॉन्फ़िगर करने के लिए:

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

ध्यान दें: सभी प्लैटफ़ॉर्म के लिए एक ही प्रॉपर्टी आईडी का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, मोबाइल ऐप्लिकेशन Analytics सेट अप करने के सबसे सही तरीके देखें.

किसी ऑब्जेक्ट को ट्रैक करें

GAv4 प्रीफ़ैब को कॉन्फ़िगर करने के बाद, Google Analytics की मदद से किसी ऑब्जेक्ट को ट्रैक करने के लिए:

1. उस GameObject की पहचान करें जिसे ट्रैक करना है (उदाहरण के लिए, कोई प्लेयर ऑब्जेक्ट) और उस पर ऑब्जेक्ट हैरारकी व्यू में क्लिक करें. अगर आपके पास उस ऑब्जेक्ट के साथ पहले से कोई स्क्रिप्ट नहीं है जिसे ट्रैक करना है, तो जांच करने वाले व्यू में कॉम्पोनेंट जोड़ें बटन का इस्तेमाल करके एक नई स्क्रिप्ट बनाएं.
2. GoogleAnalyticsV4 ऑब्जेक्ट को होल्ड करने के लिए, क्लास में कोई पब्लिक वैरिएबल बनाएं. उदाहरण के लिए:

   public GoogleAnalyticsV4 googleAnalytics;

3. स्क्रिप्ट को सेव करें और Unity विंडो पर वापस जाएं.
4. आपको जिस GameObject को ट्रैक करना है उसके जांच करने वाले व्यू में, आपको अपनी बनाई हुई स्क्रिप्ट और Google Analytics (या आपके चुने गए वैरिएबल नाम) को भरने के लिए एक फ़ील्ड दिखेगा. ऑब्जेक्ट हैरारकी व्यू से, GAv4 ऑब्जेक्ट को फ़ील्ड पर खींचें और छोड़ें.
   अगर आपको GAv4 प्रीफ़ैब जोड़ने के लिए फ़ील्ड नहीं दिखता है, तो यह पक्का करें कि आपकी स्क्रिप्ट में कोई कंपाइलेशन गड़बड़ी न हो. मौजूदा गड़बड़ियां होने पर, जांच करने वाला व्यक्ति अपडेट नहीं करेगा.
5. अब आप उस GameObject को ट्रैक करने के लिए तैयार हैं. इसी प्रीफ़ैब का इस्तेमाल करके, उन अन्य ऑब्जेक्ट के लिए भी यह प्रोसेस दोहराएं जिन्हें आपको ट्रैक करना है.

अगले चरण

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

रिसॉर्स

• समस्या हल करने से जुड़ी जानकारी
• समस्या की शिकायत करें
• सहायता पाएं
• बदलाव लॉग