स्टैंडर्ड Universal Analytics (UA) प्रॉपर्टी ने 1 जुलाई, 2023 से डेटा प्रोसेस करना बंद कर दिया है. UA 360 प्रॉपर्टी, 1 जुलाई, 2024 से डेटा को प्रोसेस करना बंद कर देंगी. साथ ही, Google Analytics 4 पर माइग्रेट करने की वजह से, UA 360 की कुछ सुविधाएं इससे पहले ही बंद हो जाएंगी. Google Analytics 4 का इस्तेमाल करने के लिए, Firebase पर माइग्रेट करें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

कैंपेन मेज़रमेंट - Android SDK v2 (लेगसी)

इस दस्तावेज़ में Android v2 के लिए Google Analytics SDK टूल की मदद से कैंपेन और ट्रैफ़िक सोर्स को मापने के तरीके की खास जानकारी दी गई है.

खास जानकारी

Google Analytics में अभियानों का आकलन करके आप अपने ऐप्लिकेशन में उपयोगकर्ता गतिविधि के लिए अभियानों और ट्रैफ़िक स्रोतों के एट्रिब्यूशन को सक्षम करके अपने मार्केटिंग चैनलों का महत्व बढ़ा सकते हैं.

Android के लिए Google Analytics SDK में, कई तरह के कैंपेन मेज़रमेंट उपलब्ध हैं:

Google Play कैंपेन का मेज़रमेंट - देखें कि किन कैंपेन, वेबसाइटों, और ऐप्लिकेशन ने उपयोगकर्ता को आपके ऐप्लिकेशन के Google Play Store पेज पर भेजा है, ताकि वह आपका ऐप्लिकेशन डाउनलोड कर सके.
सामान्य कैंपेन मेज़र करना - देखें कि किन कैंपेन या ट्रैफ़िक सोर्स ने आपका ऐप्लिकेशन इंस्टॉल किया था.
रेफ़रल को मेज़र करना - देखें कि वेबसाइट या दूसरे ऐप्लिकेशन जैसे रेफ़र करने वाले किस ट्रैफ़िक सोर्स ने, आपका ऐप्लिकेशन इंस्टॉल होने के बाद उसे लॉन्च किया है.

नीचे दिए सेक्शन में बताया गया है कि आपके ऐप्लिकेशन में, हर तरह के कैंपेन मेज़रमेंट को कब और कैसे लागू किया जाए.

Google Play कैंपेन मेज़रमेंट

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

Google Play कैंपेन मेज़रमेंट के काम करने का तरीका

Google Play Store कैंपेन का मेज़रमेंट, Google Play Store से डाउनलोड किए जाने पर कैंपेन और ट्रैफ़िक सोर्स की जानकारी को आपके ऐप्लिकेशन में भेजने के लिए, कैंपेन पैरामीटर के इस्तेमाल पर निर्भर करता है.

Google Play कैंपेन मेज़रमेंट के काम करने के तरीके की पूरी जानकारी नीचे दी गई है:

उपयोगकर्ता किसी विज्ञापन, वेबसाइट या ऐप्लिकेशन पर मौजूद किसी लिंक पर क्लिक करता है और उसे आपके ऐप्लिकेशन के Google Play Store पेज पर ले जाता है. इस लिंक को कैंपेन पैरामीटर के साथ टैग किया जाता है.
उपयोगकर्ता के आपका ऐप्लिकेशन डाउनलोड और इंस्टॉल करने के बाद, Google Play Store उस डिवाइस पर INSTALL_REFERRER इंटेंट ब्रॉडकास्ट करेगा जिसमें वे कैंपेन पैरामीटर शामिल होंगे.
इसके बाद, आपका ऐप्लिकेशन इस इंटेंट का जवाब देगा. इसके लिए, यहां दिए गए BroadcastReceiver ऑब्जेक्ट का इस्तेमाल किया जाएगा और कैंपेन पैरामीटर को पढ़कर, Google Analytics कैंपेन की जानकारी को अपडेट किया जाएगा.

Google Play कैंपेन के मेज़रमेंट को लागू करना

Google Play Store पर कैंपेन की परफ़ॉर्मेंस का आकलन करने की सुविधा लागू करने के लिए:

1. अपनी AndroidManifest.xml फ़ाइल में नया BroadcastReceiver जोड़ें

आगे दिया गया BroadcastReceiver ऐप्लिकेशन इंस्टॉल होने पर, आपका ऐप्लिकेशन Google Play Store से मिलने वाले INSTALL_REFERRER इंटेंट ब्रॉडकास्ट का जवाब दे सकता है. उसे अपनी AndroidManifest.xml फ़ाइल में इस तरह जोड़ें:

<!-- Used for install referral measurement-->
<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>

आम समस्या: फ़िलहाल, CampaignTrackingReceiver के लिए javadoc पर इस स्निपेट का गलत उदाहरण दिखाया गया है.

2. Google Play Store के लिंक में कैंपेन पैरामीटर जोड़ना

कैंपेन पैरामीटर का इस्तेमाल उस कैंपेन या ट्रैफ़िक सोर्स के बारे में जानकारी भेजने के लिए किया जाता है जो उपयोगकर्ता को आपके ऐप्लिकेशन के Google Play Store पेज पर आपके ऐप्लिकेशन के Google Analytics लागू करने के लिए रेफ़र करता है.

कैंपेन पैरामीटर स्ट्रिंग बनाने का तरीका जानने के लिए, Google Play के यूआरएल बिल्डर का इस्तेमाल करें या कैंपेन पैरामीटर के रेफ़रंस सेक्शन को देखें.

कैंपेन पैरामीटर स्ट्रिंग बनाने के बाद, उसे अपने Google Play Store के यूआरएल में, referrer पैरामीटर की वैल्यू के तौर पर जोड़ें, जैसा कि इस उदाहरण में दिखाया गया है:

https://play.google.com/store/apps/details?id=com.example.app
&referrer=utm_source%3Dgoogle
%26utm_medium%3Dcpc
%26utm_term%3Drunning%252Bshoes
%26utm_content%3DdisplayAd1
%26utm_campaign%3Dshoe%252Bcampaign

Google Play Store सिर्फ़ आपके ऐप्लिकेशन के Google Analytics लागू करने में referrer पैरामीटर की वैल्यू पास करेगा, इसलिए यह पक्का करना ज़रूरी है कि वह आपके Google Play Store लिंक में मौजूद हो.

सामान्य अभियानों का आकलन करना

सामान्य कैंपेन मेज़रमेंट का इस्तेमाल करके, उपयोगकर्ता के कैंपेन या ट्रैफ़िक सोर्स को जोड़ने के लिए उसका इस्तेमाल किया जा सकता है. हालांकि, ऐसा तब किया जाता है, जब उपयोगकर्ता ने आपका ऐप्लिकेशन पहले ही इंस्टॉल कर लिया हो.

उदाहरण के लिए, अगर आप ऐसे मौजूदा उपयोगकर्ताओं तक पहुंचने के लिए पैसे देकर चलने वाला कैंपेन चला रहे हैं जिन्होंने आपका ऐप्लिकेशन पहले से इंस्टॉल किया हुआ है, तो आप सामान्य कैंपेन मेज़रमेंट का इस्तेमाल करके यह मेज़र कर सकते हैं कि कौनसे ऐप्लिकेशन लॉन्च की वजह से आपका ऐप्लिकेशन लॉन्च हुआ.

सामान्य कैंपेन मेज़रमेंट को लागू करना

किसी सामान्य कैंपेन के लिए कैंपेन वैल्यू सेट करने के लिए, setCampaign() को कॉल करें और तर्क के तौर पर कैंपेन पैरामीटर स्ट्रिंग को पास करें.

आम तौर पर, ऐप्लिकेशन लॉन्च होने पर setCampaign() को कॉल किया जा सकता है. साथ ही, लॉन्च करने वाले इंटेंट की जांच करके पता लगाया जा सकता है कि कैंपेन के मान्य पैरामीटर मौजूद हैं या नहीं:

public class SampleActivity extends Activity {

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Get the intent that started this Activity.
    Intent intent = this.getIntent();
    Uri uri = intent.getData();

    // Call setContext() here so that we can access EasyTracker
    // to update campaign information before calling activityStart().
    EasyTracker.getInstance().setContext(this);

    if (intent.getData() != null) {
      EasyTracker.getTracker().setCampaign(uri.getPath());
    }
    ... // The rest of your onCreate() code.
  }

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


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

रेफ़रल का आकलन करना

रेफ़रल मेज़रमेंट, दूसरे तरह के कैंपेन मेज़रमेंट की तरह ही है. इसकी मदद से, रेफ़र करने वाले ऐसे सोर्स को मेज़र किया जा सकता है जिसने उपयोगकर्ता के डिवाइस पर आपका ऐप्लिकेशन लॉन्च किया था. हालांकि, रेफ़रल मेज़रमेंट में कैंपेन पैरामीटर की स्ट्रिंग के बजाय, "google.com" या "myOtherApp" जैसी आसान स्ट्रिंग का इस्तेमाल किया जाता है.

जब "google.com" जैसा रेफ़र करने वाला सोर्स सेट किया जाता है, तो सोर्स डाइमेंशन "google.com" पर सेट होता है, जबकि मीडियम डाइमेंशन "रेफ़रर" पर सेट होता है

कैंपेन मेज़रमेंट की तरह ही, रेफ़र करने वाले सोर्स को सेट करने से, डिफ़ॉल्ट रूप से अगला 'भेजा गया कॉल' एक नया सेशन शुरू करने के लिए ज़िम्मेदार होगा.

नीचे दिए गए कोड स्निपेट में, हम मान लेते हैं कि आपने ऐसे किसी भी लिंक को टैग किया है जो आपके ऐप्लिकेशन को Google Analytics के कैंपेन पैरामीटर या रेफ़र करने वाले सोर्स की जानकारी देने वाले एक आसान referrer पैरामीटर से खोलेगा. अगर अन्य कैंपेन पैरामीटर मौजूद न होने पर referrer पैरामीटर मौजूद है, तो उपयोगकर्ता के कैंपेन की जानकारी नए रेफ़रिंग सोर्स से अपडेट हो जाती है:

public class SampleActivity extends Activity {

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Get the intent that started this Activity.
    Intent intent = this.getIntent();
    Uri uri = intent.getData();

    // Call setContext() here so that we can access EasyTracker
    // to update campaign information before activityStart() is called.
    EasyTracker.getInstance().setContext(this);

    if (uri != null) {
      if(uri.getQueryParmeter("utm_source") != null) {    // Use campaign parameters if avaialble.
        EasyTracker.getTracker().setCampaign(uri.getPath());
      } else if (uri.getQueryParameter("referrer") != null) {    // Otherwise, try to find a referrer parameter.
        EasyTracker.getTracker().setReferrer(uri.getQueryParameter("referrer"));
      }
    }
  }


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


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

आम समस्याएं

CampaignTrackingReceiver के लिए javadoc ने अपने इस्तेमाल के उदाहरण में गलत क्लास पाथ का इस्तेमाल किया है. सही इस्तेमाल के लिए, Google Play कैंपेन की परफ़ॉर्मेंस का आकलन करने की सुविधा को लागू करना देखें.
हर ऐप्लिकेशन के लिए सिर्फ़ एक BroadcastReceiver क्लास के बारे में बताया जा सकता है. अगर आपको अलग-अलग SDK टूल से दो या उससे ज़्यादा BroadcastReceivers को शामिल करना है, तो आपको अपनी खुद की BroadcastReceiver क्लास बनानी होगी, जिसे सभी ब्रॉडकास्ट मिलें. साथ ही, हर तरह के ब्रॉडकास्ट के लिए, सही BroadcastReceivers को कॉल करना होगा.
Google Play कैंपेन मेज़रमेंट, फ़िलहाल वेब Play Store से शुरू किए गए वेब-टू-डिवाइस इंस्टॉल के साथ काम नहीं करता.

कैंपेन पैरामीटर

कैंपेन पैरामीटर का इस्तेमाल उन ट्रैफ़िक सोर्स और कैंपेन के बारे में जानकारी भेजने के लिए किया जाता है जो उपयोगकर्ताओं को आपके ऐप्लिकेशन पर ला रहे हैं.

सामान्य कैंपेन मेज़रमेंट के मामले में, कोड में बदले गए कैंपेन पैरामीटर की स्ट्रिंग, setCampaign() को तर्क के तौर पर पास की जाती है .
Google Play कैंपेन मेज़रमेंट में, कोड में बदले गए कैंपेन पैरामीटर स्ट्रिंग के साथ referrer पैरामीटर की वैल्यू, आपके ऐप्लिकेशन के Play Store पेज पर ले जाने वाले सभी यूआरएल में जुड़ जाती है.

नीचे एक मान्य, कोड में बदली न गई कैंपेन स्ट्रिंग का एक उदाहरण दिया गया है, जिसका इस्तेमाल सामान्य कैंपेन मेज़रमेंट के लिए किया जा सकता है:

"utm_campaign=my_campaign&utm_source=google&utm_medium=cpc&utm_term=my_keyword&utm_content=ad_variation1"

नीचे दी गई टेबल में, कैंपेन के लिए उपलब्ध उन पैरामीटर की पूरी सूची दी गई है जिनका इस्तेमाल Google Play या कैंपेन के सामान्य मेज़रमेंट में किया जा सकता है.

पैरामीटर	ब्यौरा	उदाहरण
`utm_campaign`	कैंपेन का नाम; इसका इस्तेमाल कीवर्ड का विश्लेषण करने के लिए किया जाता है, ताकि किसी प्रॉडक्ट के प्रमोशन या रणनीतिक कैंपेन की पहचान की जा सके	`utm_campaign=spring_sale`
`utm_source`	कैंपेन का सोर्स; इसका इस्तेमाल किसी सर्च इंजन, न्यूज़लेटर या अन्य सोर्स की पहचान करने के लिए किया जाता है	`utm_source=google`
`utm_medium`	कैंपेन का मीडियम; इसका इस्तेमाल ईमेल या हर क्लिक की लागत (सीपीसी) जैसे मीडियम की पहचान करने के लिए किया जाता है	`utm_medium=cpc`
`utm_term`	कैंपेन शब्द; विज्ञापनों के लिए कीवर्ड उपलब्ध कराने के लिए पेड सर्च के साथ इस्तेमाल किया जाता है	`utm_term=running+shoes`
`utm_content`	कैंपेन का कॉन्टेंट; इसका इस्तेमाल A/B टेस्टिंग और कॉन्टेंट के हिसाब से दिखाए जाने वाले विज्ञापनों में किया जाता है. इससे एक ही यूआरएल पर ले जाने वाले विज्ञापनों और लिंक में अंतर किया जा सकता है	`utm_content=logolink` `utm_content=textlink`
`gclid`	Google Ads ऑटो-टैगिंग पैरामीटर; इसका इस्तेमाल, Google Ads को मेज़र करने के लिए किया जाता है. यह वैल्यू, डाइनैमिक तौर पर जनरेट होती है और इसमें कभी भी बदलाव नहीं किया जाना चाहिए.

Google Play यूआरएल बिल्डर

Google Play कैंपेन की परफ़ॉर्मेंस का आकलन करने के लिए यूआरएल जनरेट करने के लिए, Google Play के यूआरएल बिल्डर का इस्तेमाल करें.