यूनिवर्सल Analytics टैग

अगर आपको Google Analytics लागू करने के लिए, रन-टाइम बदलाव करने हैं और आपको मार्केटप्लेस में ऐप्लिकेशन बाइनरी फिर से बनाने और उसे फिर से सबमिट करने की ज़रूरत नहीं है, तो Google Tag Manager (GTM) की मदद से अपने ऐप्लिकेशन में Universal Analytics (UA) लागू करें.

इस गाइड में बताया गया है कि Android के लिए यूनिवर्सल Analytics टैग और Google Tag Manager SDK का इस्तेमाल करके, ये काम कैसे किए जाते हैं:

• स्क्रीन व्यू भेजना
• इवेंट भेजना
• ई-कॉमर्स लेन-देन भेजना

स्क्रीन व्यू भेजें

आपके ऐप्लिकेशन में हर बार नई स्क्रीन खोलने पर, Google Analytics को स्क्रीन व्यू भेजने के लिए:

1. स्क्रीन के नाम का वैरिएबल बनाना
2. ओपन स्क्रीन इवेंट ट्रिगर बनाना
3. Universal Analytics का स्क्रीन व्यू टैग बनाना
4. ओपन स्क्रीन इवेंट और स्क्रीन के नाम को डेटा लेयर में पुश करें

1. स्क्रीन के नाम का वैरिएबल बनाना

GTM में स्क्रीन नाम वैरिएबल बनाने के लिए:

1. Google Tag Manager खाते में साइन इन करें.
2. मोबाइल कंटेनर चुनें.
3. बाईं ओर मौजूद नेविगेशन बार में, वैरिएबल पर क्लिक करें.
4. उपयोगकर्ता के तय किए गए वैरिएबल में नया पर क्लिक करें.
5. वैरिएबल का नाम स्क्रीन का नाम डालने के लिए बिना टाइटल वाले वैरिएबल पर क्लिक करें.
6. वैरिएबल टाइप के तौर पर डेटा लेयर वैरिएबल चुनें.
7. डेटा लेयर वैरिएबल नाम के तौर पर screenName डालें और इसकी डिफ़ॉल्ट वैल्यू अज्ञात स्क्रीन सेट करें.

   स्क्रीन के नाम वाला वैरिएबल बनाने का स्क्रीनशॉट देखें.

   

8. वैरिएबल बनाएं पर क्लिक करें.

2. ओपन स्क्रीन इवेंट ट्रिगर बनाना

GTM में ट्रिगर बनाने के लिए, Universal Analytics स्क्रीन व्यू टैग को चालू करें:

1. Google Tag Manager खाते में साइन इन करें.
2. मोबाइल कंटेनर चुनें.
3. बाईं ओर मौजूद नेविगेशन बार में, ट्रिगर पर क्लिक करें.
4. नया पर क्लिक करें.
5. ट्रिगर का नाम OpenScreenEvent डालने के लिए, बिना टाइटल वाले ट्रिगर पर क्लिक करें.
6. कस्टम इवेंट चुनें.
7. चालू करें के तहत, नीचे दी गई शर्त डालें:

   

8. ट्रिगर बनाएं पर क्लिक करें.

3. यूनिवर्सल Analytics स्क्रीन व्यू टैग बनाना

ओपन स्क्रीन इवेंट से सक्रिय किया गया यूनिवर्सल Analytics स्क्रीन व्यू टैग बनाने के लिए:

1. Google Tag Manager खाते में साइन इन करें.
2. मोबाइल कंटेनर चुनें.
3. बाएं नेविगेशन बार में, टैग पर क्लिक करें.
4. नया पर क्लिक करें.
5. टैग का नाम ओपन स्क्रीन डालने के लिए, बिना टाइटल वाला टैग पर क्लिक करें.
6. Google Analytics प्रॉडक्ट चुनें.
7. ट्रैकिंग आईडी डालें.
8. ट्रैक टाइप के तौर पर ऐप्लिकेशन व्यू चुनें.
9. ज़्यादा सेटिंग पर क्लिक करें.
10. सेट किए जाने वाले फ़ील्ड पर क्लिक करें.
11. ये फ़ील्ड जोड़ने के लिए, बार-बार + फ़ील्ड जोड़ें पर क्लिक करें:

    

12. जारी रखें पर क्लिक करें.
13. चालू करें में जाकर, पसंद के मुताबिक बनाएं पर क्लिक करें.
14. कस्टम ट्रिगर OpenScreenEvent चुनें.
15. सेव करें पर क्लिक करें.
16. टैग बनाएं पर क्लिक करें.

4. ओपन स्क्रीन इवेंट और स्क्रीन के नाम को डेटा लेयर में पुश करें

डेटा लेयर में openScreen इवेंट और screenName वैल्यू पुश करने के लिए, अपने ऐप्लिकेशन में कोड जोड़ें, उदाहरण के लिए:

import com.google.tagmanager.DataLayer;
import com.google.tagmanager.TagManager;

import android.app.Activity;
import android.os.Bundle;

public class MainActivity extends Activity {

  private static final String SCREEN_NAME = "Home Screen";
  private DataLayer mDataLayer;

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

  @Override
  public void onStart() {
    super.onStart();
    mDataLayer = TagManager.getInstance(this).getDataLayer();

    // Push an openScreen event and a screenName value to the data layer.
    // This call assumes the container has already been opened, otherwise events
    // pushed to the data layer will not fire tags in that container.
    mDataLayer.push(DataLayer.mapOf("event", "openScreen", "screenName", SCREEN_NAME));
  }
}

इवेंट भेजें

जब कोई उपयोगकर्ता आपके ऐप्लिकेशन में यूज़र इंटरफ़ेस (यूआई) कंट्रोल या कॉन्टेंट से इंटरैक्ट करता है, तब Google Analytics को इवेंट भेजने के लिए:

1. (ज़रूरी नहीं) इवेंट वैरिएबल बनाना
2. इवेंट ट्रिगर बनाना
3. Universal Analytics इवेंट टैग बनाना
4. इवेंट और इवेंट वैरिएबल की वैल्यू को डेटा लेयर में पुश करें

नीचे दिए गए चरणों से पता चलता है कि जब कोई उपयोगकर्ता वीडियो चलाना शुरू करता है, तब Google Analytics को इवेंट कैसे भेजा जाता है.

1. (ज़रूरी नहीं) इवेंट वैरिएबल बनाना

अगर कोई इवेंट अपनी कैटगरी, कार्रवाई, लेबल या वैल्यू फ़ील्ड को दिखाने के लिए, डेटा लेयर वैरिएबल का इस्तेमाल करता है, तो सबसे पहले आपको वे वैरिएबल बनाने होंगे. इस उदाहरण में, वीडियो प्ले इवेंट टैग वीडियो का नाम पाने के लिए डेटा लेयर वैरिएबल का इस्तेमाल करता है.

GTM में वीडियो का नाम वैरिएबल बनाने के लिए:

1. Google Tag Manager खाते में साइन इन करें.
2. मोबाइल कंटेनर चुनें.
3. बाईं ओर मौजूद नेविगेशन बार में, वैरिएबल पर क्लिक करें.
4. उपयोगकर्ता के तय किए गए वैरिएबल में नया पर क्लिक करें.
5. वैरिएबल का नाम वीडियो का नाम डालने के लिए, बिना टाइटल वाले वैरिएबल पर क्लिक करें.
6. वैरिएबल टाइप के तौर पर डेटा लेयर वैरिएबल चुनें.
7. डेटा लेयर वैरिएबल नाम के तौर पर videoName डालें और उसकी डिफ़ॉल्ट वैल्यू अज्ञात वीडियो पर सेट करें.

   वीडियो के नाम वाला वैरिएबल बनाने का स्क्रीनशॉट देखें.

   

8. वैरिएबल बनाएं पर क्लिक करें.

2. इवेंट ट्रिगर बनाना

GTM में इवेंट ट्रिगर बनाने के लिए, Universal Analytics इवेंट टैग ट्रिगर करें:

1. Google Tag Manager खाते में साइन इन करें.
2. मोबाइल कंटेनर चुनें.
3. बाईं ओर मौजूद नेविगेशन बार में, ट्रिगर पर क्लिक करें.
4. नया पर क्लिक करें.
5. ट्रिगर का नाम VideoPlayEvent डालने के लिए, बिना टाइटल वाला ट्रिगर पर क्लिक करें.
6. कस्टम इवेंट चुनें.
7. चालू करें के तहत, नीचे दी गई शर्त डालें:

   

8. ट्रिगर बनाएं पर क्लिक करें.

3. Universal Analytics इवेंट टैग बनाना

वीडियो प्ले इवेंट से ट्रिगर होने वाला Universal Analytics इवेंट टैग बनाने के लिए:

1. Google Tag Manager खाते में साइन इन करें.
2. मोबाइल कंटेनर चुनें.
3. बाएं नेविगेशन बार में, टैग पर क्लिक करें.
4. नया पर क्लिक करें.
5. टैग का नाम वीडियो Play इवेंट डालने के लिए, बिना टाइटल वाला टैग पर क्लिक करें.
6. Google Analytics प्रॉडक्ट चुनें.
7. ट्रैकिंग आईडी डालें.
8. ट्रैक टाइप के तौर पर इवेंट चुनें.
9. नीचे दिए गए इवेंट ट्रैकिंग पैरामीटर डालें:

   

10. ज़्यादा सेटिंग पर क्लिक करें.
11. सेट किए जाने वाले फ़ील्ड पर क्लिक करें.
12. ये फ़ील्ड जोड़ने के लिए, बार-बार + फ़ील्ड जोड़ें पर क्लिक करें:

    

13. जारी रखें पर क्लिक करें.
14. चालू करें में जाकर, पसंद के मुताबिक बनाएं पर क्लिक करें.
15. कस्टम ट्रिगर VideoPlayEvent चुनें.
16. सेव करें पर क्लिक करें.
17. टैग बनाएं पर क्लिक करें.

4. इवेंट और इवेंट वैरिएबल वैल्यू को डेटा लेयर में पुश करें

डेटा लेयर में videoPlay इवेंट और videoName वैल्यू पुश करने के लिए कोड लिखें, उदाहरण के लिए:

import com.google.tagmanager.DataLayer;
import com.google.tagmanager.TagManager;

public class VideoPlayer {

  // Called when a user starts a video playback.
  public void onPlay(Video v) {
    DataLayer dataLayer = TagManager.getInstance(this).getDataLayer();

    // Push a videoPlay event and a videoName value to the data layer.
    // This call assumes the container has already been opened, otherwise events
    // pushed to the data layer will not fire tags in that container.
    dataLayer.push(DataLayer.mapOf("event", "videoPlay", "videoName", v.getName());
    play(v);
  }

  // Rest of the implementation.
  // ...
}

ई-कॉमर्स लेन-देन भेजें

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

1. लेन-देन ट्रिगर बनाना
2. Universal Analytics ट्रांज़ैक्शन टैग बनाना
3. ट्रांज़ैक्शन इवेंट, ट्रांज़ैक्शन, और आइटम को डेटा लेयर में पुश करें

इस्तेमाल किए जा सकने वाले ट्रांज़ैक्शन और आइटम वैरिएबल के नामों की सूची के लिए, काम करने वाले ई-कॉमर्स डेटा लेयर वैरिएबल देखें.

1. ट्रांज़ैक्शन ट्रिगर बनाना

Universal Analytics ट्रांज़ैक्शन टैग को सक्रिय करने के लिए, GTM में ट्रांज़ैक्शन ट्रिगर बनाने के लिए:

1. Google Tag Manager खाते में साइन इन करें.
2. मोबाइल कंटेनर चुनें.
3. बाईं ओर मौजूद नेविगेशन बार में, ट्रिगर पर क्लिक करें.
4. नया पर क्लिक करें.
5. ट्रिगर का नाम लेन-देन पूरा हुआ डालने के लिए, बिना टाइटल वाले ट्रिगर पर क्लिक करें.
6. कस्टम इवेंट चुनें.
7. चालू करें के तहत, नीचे दी गई शर्त डालें:

   

8. ट्रिगर बनाएं पर क्लिक करें.

2. Universal Analytics ट्रांज़ैक्शन टैग बनाना

लेन-देन इवेंट से ट्रिगर होने वाला Universal Analytics ट्रांज़ैक्शन टैग बनाने के लिए:

1. Google Tag Manager खाते में साइन इन करें.
2. मोबाइल कंटेनर चुनें.
3. बाएं नेविगेशन बार में, टैग पर क्लिक करें.
4. नया पर क्लिक करें.
5. टैग का नाम लेन-देन पूरा हुआ डालने के लिए, बिना टाइटल वाले टैग पर क्लिक करें.
6. Google Analytics प्रॉडक्ट चुनें.
7. ट्रैकिंग आईडी डालें.
8. ट्रैक टाइप के तौर पर लेन-देन चुनें.
9. ज़्यादा सेटिंग पर क्लिक करें.
10. सेट किए जाने वाले फ़ील्ड पर क्लिक करें.
11. ये फ़ील्ड जोड़ने के लिए, बार-बार + फ़ील्ड जोड़ें पर क्लिक करें:

    

12. जारी रखें पर क्लिक करें.
13. चालू करें में जाकर, पसंद के मुताबिक बनाएं पर क्लिक करें.
14. कस्टम ट्रिगर TransactionCompleted चुनें.
15. सेव करें पर क्लिक करें.
16. टैग बनाएं पर क्लिक करें.

3. ट्रांज़ैक्शन इवेंट, ट्रांज़ैक्शन, और आइटम को डेटा लेयर में पुश करें

ट्रांज़ैक्शन इवेंट, ट्रांज़ैक्शन, और उनसे जुड़े आइटम को डेटा लेयर में पुश करने के लिए, कोड लिखें. ट्रांज़ैक्शन और आइटम डेटा को डेटा लेयर में पुश करने के लिए, आपको साथ काम करने वाले ट्रांज़ैक्शन और आइटम वैरिएबल के नामों का इस्तेमाल करना होगा. उदाहरण के लिए:

// Called when a user completes a transaction.
public void onPurchaseCompleted(Purchase p) {

  DataLayer dataLayer = TagManager.getInstance(this).getDataLayer();

  // Put maps of item data into an array to be pushed to the data layer.
  ArrayList<Map<String, String>> purchasedItems = new ArrayList<Map<String, String>>();
  for (Item i : p.items) {
    HashMap<String, String> currentItem = new HashMap<String, String>();

    currentItem.put("name", i.getProductName());
    currentItem.put("sku", i.getProductSku());
    currentItem.put("category", i.getProductCategory());
    currentItem.put("price", i.getProductPrice());
    currentItem.put("currency", "USD");
    currentItem.put("quantity", i.getProductQty());

    purchasedItems.add(currentItem);
  }

  // This call assumes the container has already been opened, otherwise events
  // pushed to the [DataLayer] data layer will not fire tags in that container.
  dataLayer.push(DataLayer.mapOf("event", "transaction",
                                 "transactionId", p.getTransId(),
                                 "transactionTotal", p.getTotal(),
                                 "transactionAffiliation", "In-app Store",
                                 "transactionTax", p.getTax(),
                                 "transactionShipping", p.getShippingCost(),
                                 "transactionCurrency", "USD",
                                 "transactionProducts", purchasedItems));

  // Because the data layer is persistent, you should reset fields to null
  // after you are done pushing the transaction.
  dataLayer.push(DataLayer.mapOf("transactionId", null,
                                 "transactionTotal", null,
                                 "transactionAffiliation", null,
                                 "transactionTax", null,
                                 "transactionShipping", null,
                                 "transactionCurrency", null,
                                 "transactionProducts", null));
}

यूनिवर्सल Analytics की बेहतर ई-कॉमर्स सुविधाएं लागू करने के लिए, Android के लिए Google Tag Manager SDK टूल का इस्तेमाल करने के बारे में ज़्यादा जानकारी के लिए, बेहतर ई-कॉमर्स देखें.

साथ काम करने वाले ई-कॉमर्स डेटा लेयर वैरिएबल

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

चेतावनी: डेटा लेयर स्थायी होती है. इसलिए, ट्रांज़ैक्शन को डेटा लेयर में पुश करने के बाद, ट्रांज़ैक्शन और आइटम वैरिएबल की वैल्यू को null पर रीसेट करें.

ट्रांज़ैक्शन वैरिएबल

वैरिएबल का नाम	ब्यौरा	Type	ज़रूरी है
transactionId	यूनीक लेन-देन आइडेंटिफ़ायर	स्ट्रिंग	हां
transactionAffiliation	पार्टनर या स्टोर	स्ट्रिंग	नहीं
transactionTotal	लेन-देन की कुल कीमत	स्ट्रिंग	नहीं
transactionTax	लेन-देन पर लगने वाले टैक्स की रकम	स्ट्रिंग	नहीं
transactionShipping	लेन-देन की शिपिंग के लिए खरीदार से लिया जाने वाला शुल्क	स्ट्रिंग	नहीं
transactionCurrency	लेन-देन की मुद्रा	स्ट्रिंग	नहीं
transactionProducts	लेन-देन में खरीदे गए आइटम की सूची	आइटम वैरिएबल वाला कलेक्शन.	नहीं

आइटम वैरिएबल

वैरिएबल का नाम	ब्यौरा	Type	ज़रूरी है
name	प्रॉडक्ट का नाम	स्ट्रिंग	हां
sku	प्रॉडक्ट SKU	स्ट्रिंग	नहीं
category	प्रॉडक्ट कैटगरी	स्ट्रिंग	नहीं
price	प्रॉडक्ट का मूल्य	स्ट्रिंग	नहीं
currency	price का मुद्रा टाइप	स्ट्रिंग	नहीं
quantity	आइटम की संख्या	स्ट्रिंग	नहीं

रेफ़रलकर्ता एट्रिब्यूशन इंस्टॉल करें

अगर आपने नीचे दी गई सेवा और रिसीवर को अपनी AndroidManifest.xml फ़ाइल में रजिस्टर किया है, तो उपलब्ध इंस्टॉल का रेफ़रल देने वाला डेटा, किसी भी Google Analytics हिट या AdWords रीमार्केटिंग पिक्सल अनुरोधों के साथ अपने-आप शामिल हो जाएगा:

<service android:name="com.google.tagmanager.InstallReferrerService" />
<receiver android:name="com.google.tagmanager.InstallReferrerReceiver" android:exported="true">
  <intent-filter>
    <action android:name="com.android.vending.INSTALL_REFERRER" />
  </intent-filter>
</receiver>

ध्यान दें: आपको Google Analytics CampaignTrackingReceiver के बजाय, इंस्टॉल का रेफ़रल देने वाले को रजिस्टर करना चाहिए.