Android v3 (लेगसी) के लिए Google Analytics SDK - शुरू करना

इस दस्तावेज़ में Android v3 के लिए Google Analytics SDK का इस्तेमाल शुरू करने का तरीका बताया गया है.

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

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() तरीकों में ईमेल भेजने के तरीके जोड़ें, जैसा कि नीचे दिए गए उदाहरण में बताया गया है:

package com.example.app;

import android.app.Activity;

import com.google.analytics.tracking.android.EasyTracker;

/**
 * An example Activity using Google Analytics and EasyTracker.
 */
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(this).activityStart(this);  // Add this method.
  }

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

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

जब EasyTracker का इस्तेमाल किया जाता है, तो ग्लोबल कॉन्फ़िगरेशन सेटिंग को एक्सएमएल में बताए गए रिसॉर्स का इस्तेमाल करके मैनेज किया जाता है. अपने प्रोजेक्ट की res/values डायरेक्ट्री में, analytics.xml नाम की एक फ़ाइल बनाएं और ये रिसॉर्स जोड़ें:

<?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 पैरामीटर रेफ़रंस देखें जिनका इस्तेमाल लागू करने की प्रोसेस को कॉन्फ़िगर करने के लिए किया जा सकता है. आपके ऐप्लिकेशन की शर्तों के आधार पर, डिस्पैच अवधि बदली जा सकती है, ताकि इस बात की पुष्टि की जा सके कि हिट सही तरीके से भेजे जा रहे हैं. उदाहरण के लिए, अगर आपको रीयल-टाइम डेटा देखना है, तो इसे कम वैल्यू पर सेट करें, जैसे कि 5s.

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

अगले चरण

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

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

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