Android के लिए Google Tag Manager

डेवलपर के तौर पर, अपने मोबाइल ऐप्लिकेशन में मेज़रमेंट टैग और पिक्सल लागू करने और मैनेज करने के लिए, Google Tag Manager का इस्तेमाल किया जा सकता है. इसके लिए, ऐप्लिकेशन बायनरी को फिर से बनाने और ऐप्लिकेशन मार्केटप्लेस में फिर से सबमिट करने की ज़रूरत नहीं होती. 'Firebase के लिए Google Analytics' SDK टूल के साथ काम करने वाले डेवलपर, ऐप्लिकेशन के शिप हो जाने के बाद भी, लागू करने की प्रोसेस को मैनेज करने और उसमें बदलाव करने में मदद के लिए, Tag Manager को आसानी से जोड़ सकते हैं.

डेवलपर, अहम इवेंट को लॉग कर सकते हैं और बाद में यह तय कर सकते हैं कि किन टैग या पिक्सल को ट्रिगर किया जाना चाहिए.

ज़रूरी शर्तें

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

नीचे दिए गए सेक्शन में, अपने Android ऐप्लिकेशन में Google Tag Manager को कॉन्फ़िगर करने और उसका इस्तेमाल करने का तरीका बताया गया है.

1. अपने प्रोजेक्ट में Google Tag Manager जोड़ना

  1. अपनी मॉड्यूल Gradle फ़ाइल (आम तौर पर app/build.gradle) में, Tag Manager लाइब्रेरी के लिए यह डिपेंडेंसी जोड़ें:

    dependencies {
  // ...
  compile 'com.google.android.gms:play-services-tagmanager:18.1.1'
}

  2. अपने Tag Manager खाते में साइन इन करें.

  3. कोई मोबाइल कंटेनर चुनें.

  4. सबसे ऊपर मौजूद नेविगेशन बार में, वर्शन पर क्लिक करें.

  5. उस कंटेनर वर्शन पर क्लिक करें जिसका आपको इस्तेमाल करना है.

  6. डाउनलोड करें पर क्लिक करें.

  7. अगर app/src/main/assets/containers फ़ोल्डर मौजूद नहीं है, तो उसे बनाएं. डाउनलोड किए गए कंटेनर को फ़ोल्डर में कॉपी करें.

2. इवेंट और वैरिएबल लॉग करें

Tag Manager, 'Firebase के लिए Google Analytics' SDK टूल से लॉग किए गए इवेंट, पैरामीटर, और उपयोगकर्ता प्रॉपर्टी का इस्तेमाल करता है. इससे, Google Tag Manager में कॉन्फ़िगर किए गए टैग को ट्रिगर और बनाएं जा सकते हैं.

इवेंट को लॉग करने और उपयोगकर्ता प्रॉपर्टी सेट करने का तरीका जानने के लिए, Firebase डेवलपर दस्तावेज़ पढ़ें.

Tag Manager में वैरिएबल कॉन्फ़िगर करना

Google Tag Manager में इस्तेमाल करने के लिए, इवेंट पैरामीटर और उपयोगकर्ता प्रॉपर्टी की वैल्यू कैप्चर करने के लिए, Tag Manager इंटरफ़ेस में वैरिएबल कॉन्फ़िगर किए जा सकते हैं.

उदाहरण के लिए, अपने ऐप्लिकेशन में यह कस्टम इवेंट लॉग किया जा सकता है:

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

इसके बाद, image_name और full_text parameter वैल्यू कैप्चर करने के लिए, Tag Manager में नए इवेंट पैरामीटर वैरिएबल को इस तरह कॉन्फ़िगर किया जा सकता है:

  • वैरिएबल का नाम: इमेज का नाम
  • वैरिएबल टाइप: इवेंट पैरामीटर
  • इवेंट पैरामीटर की कुंजी का नाम: image_name

और:

  • वैरिएबल का नाम: पूरा टेक्स्ट
  • वैरिएबल टाइप: इवेंट पैरामीटर
  • इवेंट पैरामीटर की कुंजी का नाम: full_text

इसी तरह, अपने ऐप्लिकेशन में यहां दी गई उपयोगकर्ता प्रॉपर्टी भी सेट की जा सकती है:

mFirebaseAnalytics.setUserProperty("favorite_food", mFavoriteFood);

इसके बाद, favorite_food वैल्यू कैप्चर करने के लिए, Google Tag Manager में एक नई Firebase उपयोगकर्ता प्रॉपर्टी वैरिएबल कॉन्फ़िगर की जा सकती है:

  • वैरिएबल नाम: पसंदीदा खाना
  • वैरिएबल टाइप: Firebase उपयोगकर्ता प्रॉपर्टी
  • इवेंट पैरामीटर की कुंजी का नाम: favorite_food

इवेंट में बदलाव करना और उसे ब्लॉक करना

Tag Manager की मदद से, Firebase के लिए Google Analytics SDK टूल से लॉग किए जाने से पहले, इवेंट में बदलाव किया जा सकता है और उन्हें ब्लॉक किया जा सकता है. इवेंट में बदलाव करने से, इवेंट पैरामीटर की वैल्यू जोड़ी जा सकती हैं, हटाई जा सकती हैं या बदली जा सकती हैं. इसके अलावा, ऐप्लिकेशन को अपडेट किए बिना इवेंट के नामों में बदलाव किया जा सकता है. जिन इवेंट को ब्लॉक नहीं किया गया है उन्हें Firebase के लिए Google Analytics SDK टूल से लॉग किया जाएगा.

Firebase SDK टूल के लिए Google Analytics, कुछ इवेंट और उपयोगकर्ता प्रॉपर्टी को भी अपने-आप लॉग करता है. Tag Manager में, अपने-आप इकट्ठा होने वाले इवेंट और प्रॉपर्टी का इस्तेमाल किया जा सकता है. इसके लिए, आपको कोई कोड जोड़ने की ज़रूरत नहीं है. हालांकि, उन्हें ब्लॉक नहीं किया जा सकता.

3. इवेंट भेजना

ट्रिगर सेट अप करने के लिए, Firebase इवेंट के नाम वाले वैरिएबल, Firebase इवेंट पैरामीटर वाले वैरिएबल, और अन्य वैरिएबल का इस्तेमाल किया जाता है. जब भी Firebase इवेंट लॉग किया जाता है, तब ट्रिगर की शर्तों का आकलन किया जाता है. डिफ़ॉल्ट रूप से, 'Firebase के लिए Google Analytics' इवेंट अपने-आप सक्रिय हो जाते हैं. टैग मैनेजर में Firebase के लिए Google Analytics टैग जोड़ा जा सकता है, ताकि Google Analytics को इवेंट नहीं भेजे जा सकें.

4. अपने कंटेनर की झलक देखना, उसे डीबग, और पब्लिश करना

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

कंटेनर की झलक

किसी कंटेनर की झलक देखने से पहले, Google Tag Manager के वेब इंटरफ़ेस में झलक का यूआरएल जनरेट करें. इसके लिए, उस कंटेनर का वर्शन चुनें जिसकी आपको झलक देखनी है. इसके बाद, झलक देखें को चुनें. झलक वाले इस यूआरएल को बाद के चरणों के लिए सेव करें.

झलक वाले यूआरएल, Tag Manager के वेब इंटरफ़ेस की झलक वाली विंडो में उपलब्ध होते हैं
पहली इमेज: Tag Manager के वेब इंटरफ़ेस से झलक का यूआरएल पाएं.

अपने कंटेनर की झलक देखने के लिए (अगर Android Studio का इस्तेमाल किया जा रहा है, तो सीधे तीसरे चरण पर जाएं):

  1. अपनी AndroidManifest फ़ाइल में झलक दिखाने वाली यह गतिविधि जोड़ें:

    <!--  Add preview activity. -->
<activity
  android:name="com.google.android.gms.tagmanager.TagManagerPreviewActivity"
  android:noHistory="true"> <!-- optional, removes previewActivity from activity stack. -->
  <intent-filter>
    <data android:scheme="tagmanager.c.com.example.app" />
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE"/>
  </intent-filter>
</activity>

  2. अपने ऐप्लिकेशन के पैकेज का नाम शामिल करने के लिए, इस लाइन में बदलाव करें:

    <data android:scheme="tagmanager.c.com.example.app"/>

  3. Google Tag Manager के वेब इंटरफ़ेस में, झलक वाला लिंक जनरेट करें:

    1. अपने Tag Manager खाते में साइन इन करें.
    2. कोई मोबाइल कंटेनर चुनें.
    3. सबसे ऊपर मौजूद नेविगेशन बार में, वर्शन पर क्लिक करें.
    4. जिस कंटेनर वर्शन की झलक देखनी है उस पर कार्रवाइयां > झलक देखें पर क्लिक करें.
    5. अपने ऐप्लिकेशन का पैकेज नाम डालें.
    6. 'शुरुआत की झलक' लिंक जनरेट करें पर क्लिक करें.

  4. अपना ऐप्लिकेशन बंद करें और उसे लॉन्च करने के लिए, जनरेट किए गए झलक लिंक या क्यूआर कोड का इस्तेमाल करें.

  5. वेब इंटरफ़ेस में झलक दिखाने वाला लिंक जनरेट करें विकल्प से जनरेट किए गए लिंक पर क्लिक करके, 'झलक देखें' मोड से बाहर निकला जा सकता है.

डीबग कंटेनर

कंटेनर लागू करने से जुड़ी समस्या हल करने के लिए, ज़्यादा जानकारी वाली लॉगिंग चालू करें:

$ adb shell setprop log.tag.GoogleTagManager VERBOSE

कंटेनर पब्लिश करना

अपने कंटेनर की झलक देखने और यह पुष्टि करने के बाद कि वह काम कर रहा है, आपके पास उसे पब्लिश करने का विकल्प होता है. कंटेनर पब्लिश करने के बाद, आपके टैग कॉन्फ़िगरेशन, मोबाइल ऐप्लिकेशन के उपयोगकर्ताओं के लिए उपलब्ध हो जाएंगे.

अगले चरण

ऐडवांस कॉन्फ़िगरेशन पढ़ें.