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 Package Manager की मदद से 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. सबसे ऊपर मौजूद नेविगेशन बार में, एडमिन पर क्लिक करें.
    3. CONTAINER कॉलम पर, ड्रॉप-डाउन मेन्यू पर क्लिक करें और CONTAINER चुनें.
    4. कंटेनर का नाम डालें.
    5. iOS कंटेनर चुनें.
    6. Firebase (iOS) SDK टूल चुनें.
    7. बनाएं पर क्लिक करें.
  3. अपना कंटेनर डाउनलोड करें:

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

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

    1. डाउनलोड की गई फ़ाइल को XCode प्रोजेक्ट रूट (आम तौर पर PROJECT_ROOT/container/GTM-XXXXXX.json) में मौजूद container नाम के फ़ोल्डर में कॉपी करें.
    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
])

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

  • वैरिएबल नाम: इमेज का नाम
  • वैरिएबल टाइप: इवेंट पैरामीटर
  • इवेंट पैरामीटर कुंजी का नाम: 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' इवेंट अपने-आप चालू हो जाते हैं. Tag Manager में, '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 की झलक दिखाने वाली यूआरएल स्कीम को रजिस्टर करें.
दूसरी इमेज: अपने ऐप्लिकेशन की प्रॉपर्टी की सूची वाली फ़ाइल में, Tag Manager की झलक दिखाने वाली यूआरएल स्कीम जोड़ें.

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

डीबग कंटेनर

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

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

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

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