iOS के लिए Google Tag Manager

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

    Swift पैकेज मैनेजर की मदद से Tag Manager जोड़ने के लिए:

    1. CocoaPods पर आधारित प्रोजेक्ट से माइग्रेट करने पर, अपने Xcode प्रोजेक्ट से CocoaPods को हटाने के लिए pod deintegrate चलाएं. CocoaPods से जनरेट की गई .xcworkspace फ़ाइल को बाद में सुरक्षित तरीके से मिटाया जा सकता है. अगर किसी प्रोजेक्ट में पहली बार Firebase जोड़ा जा रहा है, तो इस चरण को अनदेखा किया जा सकता है.
    2. Xcode 12 में, यहां जाकर Tag Manager लाइब्रेरी इंस्टॉल करें फ़ाइल > Tag Manager पैकेज > पैकेज डिपेंडेंसी जोड़ें... पर जाएं
    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 कंटेनर नहीं है, तो एक iOS कंटेनर बनाएं:

    1. अपने Tag Manager खाते में साइन इन करें.
    2. खाता टैब में, अपना iOS कंटेनर चुनें.
    3. सबसे ऊपर मौजूद नेविगेशन बार में, एडमिन पर क्लिक करें.
    4. कंटेनर बनाने के लिए, CONTAINER कॉलम में '+' आइकॉन पर क्लिक करें.
    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, 'Firebase के लिए Google Analytics' 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 उपयोगकर्ता प्रॉपर्टी वैरिएबल कॉन्फ़िगर किया जा सकता है:

  • वैरिएबल नाम: पसंदीदा खाना
  • वैरिएबल टाइप: 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. अपने कंटेनर की झलक देखना, उसे डीबग, और पब्लिश करना

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

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

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

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

    झलक के यूआरएल, Tag Manager वेब इंटरफ़ेस की झलक विंडो में उपलब्ध होते हैं

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

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

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

URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_
अपने ऐप्लिकेशन की प्रॉपर्टी सूची फ़ाइल में, टैग मैनेजर की झलक दिखाने वाले यूआरएल स्कीम को रजिस्टर करें.
दूसरी इमेज: अपने ऐप्लिकेशन की प्रॉपर्टी की सूची वाली फ़ाइल में, Tag Manager की झलक वाले यूआरएल की स्कीम जोड़ें.

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

डीबग कंटेनर

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

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

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

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