Android v2 (लेगसी) के लिए Google Analytics SDK टूल - खास जानकारी

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

शुरुआती जानकारी

Android के लिए Google Analytics SDK की मदद से, डेवलपर अपने ऐप्लिकेशन से उपयोगकर्ता के जुड़ाव का डेटा आसानी से इकट्ठा कर सकते हैं. डेवलपर Google Analytics रिपोर्ट का इस्तेमाल करके ये मेज़र कर सकते हैं:

  • सक्रिय उपयोगकर्ताओं की संख्या, जो उनके ऐप्लिकेशन इस्तेमाल कर रहे हैं.
  • दुनिया में जहां से इस ऐप्लिकेशन का इस्तेमाल किया जा रहा है.
  • खास सुविधाओं को अपनाना और उनका इस्तेमाल.
  • इन-ऐप्लिकेशन खरीदारी और लेन-देन.
  • ऐप्लिकेशन क्रैश होने की संख्या और प्रकार.
  • साथ ही, काम की कई और मेट्रिक.

इसके अलावा, Android के लिए Google Analytics SDK आपको इन-ऐप खरीदारी और लेन-देन के ज़रिए Google Play से इंस्टॉल किए गए आपके मार्केटिंग चैनलों के परफ़ॉर्मेंस की एंड-टू-एंड जानकारी देकर, मोबाइल मार्केटिंग कैंपेन की सफलता पर नज़र रखने के टूल मुहैया कराता है.

आरंभ करने से पहले

SDK टूल का इस्तेमाल शुरू करने से पहले, पक्का करें कि आपके पास ये चीज़ें हों:

शुरू करें

SDK टूल का इस्तेमाल शुरू करने के तीन चरण हैं:

  1. AndroidManifest.xml को अपडेट करें
  2. EasyTracker के तरीके जोड़ें
  3. अपनी analytics.xml फ़ाइल बनाएं

इन चरणों को पूरा करने के बाद, Google Analytics की मदद से ये काम किए जा सकते हैं:

  • ऐप्लिकेशन इंस्टॉल किए जाने से जुड़ी रिपोर्ट
  • सक्रिय उपयोगकर्ता और डेमोग्राफ़िक्स (उम्र, लिंग, आय, शिक्षा वगैरह)
  • स्क्रीन और उपयोगकर्ता का जुड़ाव
  • क्रैश और अपवाद

1. AndroidManifest.xml अपडेट हो रहा है

नीचे दी गई अनुमतियां जोड़कर अपनी AndroidManifest.xml फ़ाइल अपडेट करें:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

2. EasyTracker के तरीके जोड़ना

अपने हर Activities के onStart() और onStop() तरीकों में ईमेल भेजने के तरीके जोड़ें, जैसा कि नीचे दिए गए उदाहरण में बताया गया है:

/**
 * An example Activity in your app with Analytics
 * implemented.
 */
public class myTrackedActivity extends Activity {
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
  }

  @Override
  public void onStart() {
    super.onStart();
    ... // The rest of your onStart() code.
    EasyTracker.getInstance().activityStart(this); // Add this method.
  }

  @Override
  public void onStop() {
    super.onStop();
    ... // The rest of your onStop() code.
    EasyTracker.getInstance().activityStop(this); // Add this method.
  }
}

ध्यान दें कि EasyTracker के तरीकों को कॉल करने से पहले, Context की ज़रूरत होती है. ऊपर दिए गए उदाहरण में, यह लाइन: 

EasyTracker.getInstance.activityStart(this);

संदर्भ सेट करने का ध्यान रखता है. हालांकि, अगर आपको अन्य क्लास या तरीकों में EasyTracker कॉल करना हो, तो पहले आपको EasyTracker के setContext(Context ctx) तरीके को कॉल करना होगा:

// Set Context before using EasyTracker. Note that the SDK will
// use the application context.
EasyTracker.getInstance().setContext(this);

// EasyTracker is now ready for use.

3. आपकी analytics.xml फ़ाइल बनाई जा रही है

Android के लिए Google Analytics SDK टूल के दूसरे वर्शन में, कॉन्फ़िगरेशन के विकल्पों को इस गाइड में analytics.xml नाम की एक एक्सएमएल रिसॉर्स फ़ाइल से मैनेज किया जाता है. आपको यह फ़ाइल अपने प्रोजेक्ट की res/values डायरेक्ट्री में बनानी होगी और अपना ट्रैकिंग आईडी जोड़ना होगा. यहां दिए गए उदाहरण में, ट्रैकिंग आईडी जोड़ने के साथ-साथ Activity और अपवाद मेज़रमेंट को चालू करने का तरीका बताया गया है:

<?xml version="1.0" encoding="utf-8" ?>

<resources>
  <!--Replace placeholder ID with your tracking ID-->
  <string name="ga_trackingId">UA-XXXX-Y</string>

  <!--Enable automatic activity tracking-->
  <bool name="ga_autoActivityTracking">true</bool>

  <!--Enable automatic exception tracking-->
  <bool name="ga_reportUncaughtExceptions">true</bool>
</resources>

आपका लिंट चेकर, ट्रैकिंग आईडी में फ़िगर डैश ('-') का इस्तेमाल किए जाने के बारे में आपको चेतावनी दे सकता है. इस चेतावनी को रोकने के लिए, अपने <resources> टैग में अन्य एट्रिब्यूट जोड़ें:

<resources xmlns:tools="http://schemas.android.com/tools"
tools:ignore="TypographyDashes">

उन पैरामीटर की पूरी सूची देखने के लिए analytics.xml पैरामीटर रेफ़रंस देखें जिनका इस्तेमाल लागू करने की प्रोसेस को कॉन्फ़िगर करने के लिए किया जा सकता है.

बधाई हो! आपका ऐप्लिकेशन अब Google Analytics को डेटा भेजने के लिए तैयार है.

अगले चरण

Google Analytics की मदद से कई काम किए जा सकते हैं. इनमें कैंपेन, इन-ऐप्लिकेशन पेमेंट, लेन-देन, और उपयोगकर्ता इंटरैक्शन इवेंट को मेज़र करना शामिल है. इन्हें लागू करने के तरीके में इन सुविधाओं को जोड़ने का तरीका जानने के लिए, नीचे दी गई डेवलपर गाइड देखें:

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