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

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

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

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

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

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

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

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

कंटेनर की झलक देखें

कंटेनर की झलक देखने से पहले, कंटेनर के जिस वर्शन की झलक देखनी है उसे चुनकर, 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

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

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

अगले चरण

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