Android के लिए Google Tag Manager

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

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

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

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

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

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

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

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

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

इवेंट लॉग करने और उपयोगकर्ता प्रॉपर्टी सेट करने के निर्देशों के लिए, 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);

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

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

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

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

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

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

ट्रिगर सेट अप करने के लिए, Firebase के इवेंट के नाम वाले वैरिएबल, Firebase के इवेंट पैरामीटर वाले वैरिएबल, और अन्य वैरिएबल का इस्तेमाल किया जाता है. जब भी कोई Firebase इवेंट लॉग किया जाता है, तो ट्रिगर करने की स्थिति का मूल्यांकन किया जाता है. डिफ़ॉल्ट रूप से, 'Firebase के लिए Google Analytics' इवेंट अपने-आप ट्रिगर होते हैं. Tag Manager में Google Analytics for 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

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

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

अगले चरण

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