iOS के लिए Google Tag Manager

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

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

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

• Firebase कंसोल में, अपने ऐप्लिकेशन को Firebase प्रोजेक्ट से जोड़ें.
• अपने ऐप्लिकेशन के लिए Google Analytics सेट अप करें. इसके लिए, अपने Firebase प्रोजेक्ट में Google Analytics चालू करें और अपने ऐप्लिकेशन में Google Analytics for Firebase SDK टूल जोड़ें.
• Tag Manager खाता बनाएं.
• Tag Manager कंटेनर को कॉन्फ़िगर करें.

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

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

1. Tag Manager पैकेज जोड़ें:

   CocoaPods

   CocoaPods के ज़रिए Tag Manager जोड़ने के लिए:

   1. टर्मिनल में, यह कमांड चलाएं:

      $ sudo gem install cocoapods
      

   2. अपनी प्रोजेक्ट डायरेक्ट्री पर जाएं.

   3. Podfile नाम की फ़ाइल बनाने के लिए, यह कमांड चलाएं:

      $ pod init
      

   4. Podfile में यह जोड़ें:

      pod 'GoogleTagManager', '~> 6.0'
      

   5. अपने प्रोजेक्ट में Tag Manager की ज़रूरी फ़ाइलें डाउनलोड और इंस्टॉल करने के लिए, यह कमांड चलाएं:

      $ pod install
      

   Swift Package Manager

   Swift Package Manager के ज़रिए Tag Manager जोड़ने के लिए:

   1. अगर CocoaPods पर आधारित प्रोजेक्ट से माइग्रेट किया जा रहा है, तो अपने Xcode प्रोजेक्ट से CocoaPods हटाने के लिए pod deintegrate चलाएं. CocoaPods से जनरेट हुई .xcworkspace फ़ाइल को बाद में सुरक्षित तरीके से मिटाया जा सकता है. अगर किसी प्रोजेक्ट में पहली बार Firebase जोड़ा जा रहा है, तो इस चरण को अनदेखा किया जा सकता है.
   2. Xcode 12 में, Tag Manager लाइब्रेरी इंस्टॉल करने के लिए, File > Tag Manager Packages > Add Package Dependency… पर जाएं

   3. दिखने वाले प्रॉम्प्ट में, Tag Manager GitHub रिपॉज़िटरी डालें:

      https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
      

   4. Tag Manager का वह वर्शन चुनें जिसका आपको इस्तेमाल करना है. नए प्रोजेक्ट के लिए, हमारा सुझाव है कि Tag Manager के नए वर्शन का इस्तेमाल करें.

   5. अपने प्रोजेक्ट की बिल्ड सेटिंग में जाकर, अन्य लिंक करने वाले फ़्लैग में -ObjC जोड़ें.

2. अगर आपके Tag Manager खाते में कोई iOS कंटेनर नहीं है, तो एक कंटेनर बनाएं:

   1. अपने Tag Manager खाते में साइन इन करें.
   2. खाते टैब में जाकर, अपना iOS कंटेनर चुनें.
   3. सबसे ऊपर मौजूद नेविगेशन बार में जाकर, एडमिन पर क्लिक करें.
   4. कंटेनर कॉलम में, कंटेनर बनाने के लिए '+' आइकॉन पर क्लिक करें.
   5. कंटेनर का नाम डालें.
   6. iOS कंटेनर चुनें.
   7. बनाएं पर क्लिक करें.

3. अपना कंटेनर डाउनलोड करें:

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

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

4. डाउनलोड किए गए कंटेनर को अपने प्रोजेक्ट में जोड़ें:

   1. डाउनलोड की गई फ़ाइल को XCode प्रोजेक्ट रूट में मौजूद container नाम के फ़ोल्डर में कॉपी करें. यह आम तौर पर PROJECT_ROOT/container/GTM-XXXXXX.json होता है.
   2. Xcode खोलें.
   3. फ़ाइल मेन्यू में जाकर, इसमें फ़ाइलें जोड़ें... चुनें
   4. container फ़ोल्डर चुनें.
   5. विकल्प पर क्लिक करें. इसके बाद, पक्का करें कि फ़ोल्डर के रेफ़रंस बनाएं विकल्प चुना गया हो.
   6. पूरा करें पर क्लिक करें.

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

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

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

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

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

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

Analytics.logEvent("share_image", parameters: [
  "image_name": name,
  "full_text": text
])

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

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

और:

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

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

Analytics.setUserProperty(food, forName: "favorite_food")

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

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

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

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

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

कंटेनर की झलक देखने के लिए, Tag Manager के वेब इंटरफ़ेस में झलक देखने वाला यूआरएल जनरेट करें:

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

6. पूर्वावलोकन शुरू करें लिंक जनरेट करें पर क्लिक करें.

   

   इस झलक वाले यूआरएल को बाद के चरणों के लिए सेव करें.

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

URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_

अपने ऐप्लिकेशन को बंद करें और एम्युलेटर या फ़िज़िकल डिवाइस पर झलक दिखाने वाला यूआरएल खोलें. इससे आपको अपने ऐप्लिकेशन में ड्राफ़्ट कंटेनर की झलक दिखेगी.

कंटेनर डीबग करना

सिम्युलेटर या झलक मोड में ऐप्लिकेशन चलाने पर, Tag Manager अपने-आप लॉगिंग को वर्बोस पर सेट कर देता है.

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

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

इसी विषय से जुड़े लिंक

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