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.0'
}

  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);

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

  • वैरिएबल नाम: इमेज का नाम
  • वैरिएबल टाइप: इवेंट पैरामीटर
  • इवेंट पैरामीटर की कुंजी का नाम: 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 के लिए Google Analytics' SDK टूल की मदद से, कुछ इवेंट और उपयोगकर्ता प्रॉपर्टी भी अपने-आप लॉग होती हैं. अपने-आप इकट्ठा होने वाले इवेंट और प्रॉपर्टी को 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

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

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

अगले चरण

बेहतर कॉन्फ़िगरेशन के बारे में पढ़ें.