Android के लिए Google Tag Manager

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

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

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

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

• Firebase कंसोल में, अपने ऐप्लिकेशन को Firebase प्रोजेक्ट से जोड़ें.
• अपने ऐप्लिकेशन के लिए Google Analytics सेट अप करें. इसमें, अपने Firebase प्रोजेक्ट में Google Analytics को चालू करना और अपने ऐप्लिकेशन में 'Firebase के लिए Google Analytics' SDK टूल जोड़ना शामिल है.
• Tag Manager खाता बनाएं.
• Google 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' इवेंट अपने-आप ट्रिगर होते हैं. Tag Manager में 'Firebase के लिए Google Analytics' टैग जोड़ा जा सकता है, ताकि इवेंट को Google Analytics को भेजने से रोका जा सके.

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

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

कंटेनर की झलक

किसी कंटेनर की झलक देखने से पहले, Google 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

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

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

अगले चरण

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