Swift के लिए शुरुआती निर्देश

इस गाइड में, Swift में iOS ऐप्लिकेशन बनाने और उसे लागू करने का तरीका बताया गया है Google टैग की मदद से, खुली हुई स्क्रीन और बटन दबाए गए इवेंट को ट्रैक करने के लिए मैनेजर (GTM).

1. नया प्रोजेक्ट बनाएं

1. Xcode खोलें.
2. नया Xcode प्रोजेक्ट बनाएं पर क्लिक करें.
3. एक व्यू ऐप्लिकेशन चुनें.
4. आगे बढ़ें पर क्लिक करें.
5. अपने प्रोजेक्ट को नाम दें और इसके लिए अन्य विकल्प चुनें. आपके प्रोजेक्ट का नाम और ऐप्लिकेशन का नाम वही होगा जो प्रॉडक्ट का नाम होगा.
   
6. आगे बढ़ें पर क्लिक करें.
7. प्रोजेक्ट की जगह (डायरेक्ट्री) चुनें.
8. बनाएं पर क्लिक करें.

2. Google Tag Manager डिपेंडेंसी इंस्टॉल करना

1. Xcode को छोड़ें.
2. टर्मिनल में, इंस्टॉल करने के लिए नीचे दिया गया निर्देश चलाएं कोकोपॉड:

   $ sudo gem install cocoapods

3. अपनी प्रोजेक्ट डायरेक्ट्री में बदलें.
4. Podfile नाम की फ़ाइल बनाने के लिए, नीचे दिया गया निर्देश चलाएं:

   $ pod init

5. Podfile में, use_frameworks! की टिप्पणी हटाएं और टारगेट में pod 'GoogleTagManager' जोड़ें:

# Uncomment this line if you're using Swift
use_frameworks!

target 'GtmSwiftTutorial' do
  pod 'GoogleTagManager'
end

6. Google Tag Manager (GTM) डाउनलोड और इंस्टॉल करने के लिए, यह कमांड चलाएं ये चीज़ें आपके प्रोजेक्ट पर निर्भर करती हैं:

   $ pod install

   इस निर्देश से वर्क स्पेस GtmSwiftTutorial.xcworkspace भी बनता है. अब से, GtmSwiftTutorial ऐप्लिकेशन को डेवलप करने के लिए इस वर्क स्पेस का इस्तेमाल करें.

3. Objective-C लाइब्रेरी के लिए ब्रिजिंग हेडर जोड़ें

ब्रिजिंग हेडर फ़ाइल बनाने के लिए:

1. Xcode खोलें.
2. फ़ाइल > नया > फ़ाइल.
3. iOS > सोर्स में, हेडर फ़ाइल चुनें.
4. आगे बढ़ें पर क्लिक करें.
5. हेडर फ़ाइल का नाम BridgingHeader.h डालें.
   
6. बनाएं पर क्लिक करें.
7. हेडर फ़ाइल में ये import स्टेटमेंट जोड़ें:

   #ifndef BridgingHeader_h
   #define BridgingHeader_h
   
   #import <GoogleTagManager/TAGManager.h>
   #import <GoogleTagManager/TAGContainer.h>
   #import <GoogleTagManager/TAGContainerOpener.h>
   #import <GoogleTagManager/TAGDataLayer.h>
   #import <GoogleTagManager/TAGLogger.h>
   
   #endif /* BridgingHeader_h */

बिल्ड सेटिंग में Objective-C ब्रिजिंग हेडर जोड़ने के लिए:

1. Xcode में, अपने प्रोजेक्ट पर क्लिक करें.
2. एडिटर एरिया में बिल्ड सेटिंग पर क्लिक करें.
   
3. सभी और मिलाए गए को चुनें और ब्रिजिंग खोजें.
   
4. Objective-C ब्रिजिंग हेडर वाली लाइन के दाएं कॉलम में, BridgingHeader.h डालें.
   

4. अपने प्रोजेक्ट में एक डिफ़ॉल्ट कंटेनर जोड़ें

अपने प्रोजेक्ट में डिफ़ॉल्ट कंटेनर जोड़ने से पहले, डाउनलोड करें मोबाइल कंटेनर बाइनरी:

1. अपने में साइन इन करें Google Tag Manager खाते से लिंक किया जा सकता है.
2. एक मोबाइल कंटेनर चुनें.
3. मेन्यू बार में, वर्शन पर क्लिक करें.
4. कार्रवाइयां > चयनित कंटेनर पर डाउनलोड करें वर्शन है.
डाउनलोड की गई फ़ाइल का नाम कंटेनर आईडी होता है, उदाहरण के लिए, GTM-PT3L9Z.

अपने प्रोजेक्ट में डिफ़ॉल्ट कंटेनर बाइनरी जोड़ने के लिए:

1. Xcode खोलें.
2. डॉक पर Finder आइकॉन पर क्लिक करें.
3. Downoloads फ़ोल्डर पर क्लिक करें.
4. कंटेनर बाइनरी फ़ाइल को Downloads फ़ोल्डर में खींचें और छोड़ें उसे आपके Xcode प्रोजेक्ट के रूट फ़ोल्डर में भेज दिया जाएगा.

5. Google Tag Manager को अपने ऐप्लिकेशन से लिंक करना

1. Xcode में, AppDelegate.swift फ़ाइल खोलें.
2. AppDelegate क्लास की अवधि बढ़ाएं TAGContainerOpenerNotifier क्लास:

   import UIKit
   
   @UIApplicationMain
   class AppDelegate: UIResponder, UIApplicationDelegate, TAGContainerOpenerNotifier {
     // ...
   }

   कक्षा बढ़ाने के बाद, आपको Type 'AppDelegate' does not conform to protocol 'TAGContainerOpenerNotifier' अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है गड़बड़ी. ऐसा करने से यह गड़बड़ी ठीक हो जाएगी.

3. AppDelegate क्लास की परिभाषा के नीचे, नीचे दिया गया फ़ंक्शन जोड़ें:

   func containerAvailable(container: TAGContainer!) {
     container.refresh()
   }

4. application फ़ंक्शन में, यह कोड जोड़ें return true स्टेटमेंट से पहले:

   let GTM = TAGManager.instance()
   GTM.logger.setLogLevel(kTAGLoggerLogLevelVerbose)
   
   TAGContainerOpener.openContainerWithId("GTM-PT3L9Z",  // change the container ID "GTM-PT3L9Z" to yours
       tagManager: GTM, openType: kTAGOpenTypePreferFresh,
       timeout: nil,
       notifier: self)

6. स्क्रीन ओपन इवेंट ट्रैक करें

स्क्रीन खुली होने के इवेंट को ट्रैक करने के लिए:

1. ट्रैकिंग आईडी को स्टोर करने के लिए वैरिएबल बनाएं.
2. screenName नाम का डेटा लेयर वैरिएबल बनाएं.
3. स्क्रीन व्यू टाइटल वाला एक GTM टैग बनाएं.
4. स्क्रीन ट्रैकिंग कोड जोड़ें.

a. ट्रैकिंग आईडी को स्टोर करने के लिए वैरिएबल बनाएं

1. Google Tag Manager में साइन इन करें जोड़ें.
2. एक मोबाइल कंटेनर चुनें.
3. बाईं ओर मौजूद नेविगेशन बार में, वैरिएबल पर क्लिक करें.
4. उपयोगकर्ता के तय किए गए वैरिएबल में, नया पर क्लिक करें.
5. वैरिएबल का नाम डालने के लिए बिना टाइटल वाला वैरिएबल पर क्लिक करें ट्रैकिंग आईडी.
6. वैरिएबल टाइप के तौर पर कॉन्सटेंट चुनें.
7. ट्रैकिंग आईडी डालें (UA-XXXXXXXX-X रूप में, जहां X एक अंक है) वैरिएबल की वैल्यू के रूप में.
   मिटाया जाने के लिए, UA-47605289-5 का इस्तेमाल करें.
8. वैरिएबल बनाएं पर क्लिक करें.

b. screenName नाम का डेटा लेयर वैरिएबल बनाएं

1. Google Tag Manager में साइन इन करें जोड़ें.
2. एक मोबाइल कंटेनर चुनें.
3. बाईं ओर मौजूद नेविगेशन बार में, वैरिएबल पर क्लिक करें.
4. उपयोगकर्ता के तय किए गए वैरिएबल में, नया पर क्लिक करें.
5. शीर्षक डालने के लिए बिना टाइटल वाला वैरिएबल पर क्लिक करें स्क्रीन का नाम.
6. वैरिएबल टाइप के तौर पर डेटा लेयर वैरिएबल चुनें.
7. डेटा लेयर वैरिएबल नाम के तौर पर screenName डालें.
8. डिफ़ॉल्ट वैल्यू सेट करें पर क्लिक करें.
9. डिफ़ॉल्ट वैल्यू स्क्रीन की जानकारी नहीं है डालें.
10. वैरिएबल बनाएं पर क्लिक करें.

c. स्क्रीन व्यू शीर्षक वाला एक GTM टैग बनाएं

1. Google Tag Manager में साइन इन करें जोड़ें.
2. एक मोबाइल कंटेनर चुनें.
3. बाईं ओर मौजूद नेविगेशन बार पर, टैग पर क्लिक करें.
4. नया पर क्लिक करें.
5. टैग का नाम डालने के लिए, बिना टाइटल वाला टैग पर क्लिक करें स्क्रीन व्यू.
6. प्रॉडक्ट Google Analytics चुनें.
7. सूची से ट्रैकिंग आईडी चुनें.
8. ट्रैक टाइप के तौर पर ऐप्लिकेशन व्यू चुनें.
9. ज़्यादा सेटिंग पर क्लिक करें.
10. सेट किए जाने वाले फ़ील्ड पर क्लिक करें.
11. + फ़ील्ड जोड़ें पर क्लिक करें.
12. फ़ील्ड का नाम screenName और उसकी वैल्यू स्क्रीन का नाम चुनें.
13. जारी रखें पर क्लिक करें.
14. सक्रिय करें के अंतर्गत, कोई भी इवेंट चुनें.
15. टैग बनाएं पर क्लिक करें.

स्क्रीन व्यू GTM टैग बनाने का स्क्रीनशॉट देखें.

d. स्क्रीन ट्रैकिंग कोड जोड़ें

1. ViewController.swift फ़ाइल को Xcode में खोलें.
2. इसके अंदर dataLayer नाम का वैरिएबल तय करें ViewController क्लास:

   var dataLayer: TAGDataLayer = TAGManager.instance().dataLayer

3. viewDidLoad() फ़ंक्शन में, पुश डेटा लेयर के लिए OpenScreen इवेंट:

   dataLayer.push(["event": "OpenScreen", "screenName": "Home Screen"])

ViewController क्लास की परिभाषा इस तरह दिखती है:

import UIKit

class ViewController: UIViewController {
  var dataLayer: TAGDataLayer = TAGManager.instance().dataLayer

  override func viewDidLoad() {
    super.viewDidLoad()
    dataLayer.push(["event": "OpenScreen", "screenName": "Home Screen"])
  }

  override func didReceiveMemoryWarning() {
    super.didReceiveMemoryWarning()
    // Dispose of any resources that cant be recreated
  }
}

7. 'ट्रैक करें' बटन दबाया गया इवेंट

बटन दबाए गए इवेंट को ट्रैक करने के लिए:

1. eventAction नाम का डेटा लेयर वैरिएबल बनाएं.
2. इवेंट नाम का कस्टम इवेंट वैरिएबल बनाएं.
3. बटन दबाया गया शीर्षक वाला एक GTM टैग बनाएं.
4. कोई बटन बनाएं और वह बटन दबाया गया ट्रैक करने के लिए कोड जोड़ें.

a. eventAction के नाम से डेटा लेयर वैरिएबल बनाएं

1. Google Tag Manager में साइन इन करें जोड़ें.
2. एक मोबाइल कंटेनर चुनें.
3. बाईं ओर मौजूद नेविगेशन बार में, वैरिएबल पर क्लिक करें.
4. उपयोगकर्ता के तय किए गए वैरिएबल में, नया पर क्लिक करें.
5. शीर्षक डालने के लिए बिना टाइटल वाला वैरिएबल पर क्लिक करें इवेंट की कार्रवाई.
6. वैरिएबल टाइप के तौर पर डेटा लेयर वैरिएबल चुनें.
7. डेटा लेयर वैरिएबल नाम के तौर पर eventAction डालें.
8. डिफ़ॉल्ट वैल्यू सेट करें पर क्लिक करें.
9. डिफ़ॉल्ट वैल्यू अनजान इवेंट डालें.
10. वैरिएबल बनाएं पर क्लिक करें.

b. इवेंट नाम का कस्टम इवेंट वैरिएबल बनाएं

1. Google Tag Manager में साइन इन करें जोड़ें.
2. एक मोबाइल कंटेनर चुनें.
3. बाईं ओर मौजूद नेविगेशन बार में, वैरिएबल पर क्लिक करें.
4. उपयोगकर्ता के तय किए गए वैरिएबल में, नया पर क्लिक करें.
5. वैरिएबल का नाम इवेंट डालने के लिए बिना टाइटल वाला वैरिएबल पर क्लिक करें.
6. वैरिएबल टाइप के तौर पर कस्टम इवेंट चुनें.
7. वैरिएबल बनाएं पर क्लिक करें.

c. 'बटन दबाया गया' शीर्षक वाला GTM टैग बनाएं

1. Google Tag Manager में साइन इन करें जोड़ें.
2. एक मोबाइल कंटेनर चुनें.
3. बाईं ओर मौजूद नेविगेशन बार पर, टैग पर क्लिक करें.
4. नया पर क्लिक करें.
5. टैग का नाम डालने के लिए, बिना टाइटल वाला टैग पर क्लिक करें बटन दबाया गया.
6. प्रॉडक्ट Google Analytics चुनें.
7. सूची से ट्रैकिंग आईडी चुनें.
8. ट्रैक टाइप के तौर पर इवेंट चुनें.
9. इवेंट कैटगरी चुनें.
10. इवेंट की कार्रवाई चुनें.
11. जारी रखें पर क्लिक करें.
12. सक्रिय करें के अंतर्गत, कोई भी इवेंट चुनें.
13. टैग बनाएं पर क्लिक करें.

बटन दबाया गया GTM टैग बनाने का स्क्रीनशॉट देखें.

d. कोई बटन बनाएं और उसे दबाकर रखने के लिए कोड जोड़ें

1. अपना Xcode प्रोजेक्ट खोलें.
2. Main.storyboard खोलें.
3. खोलने के लिए, Xcode टूलबार में सबसे ऊपर दाईं ओर मौजूद बटन पर क्लिक करें यूटिलिटी एरिया (दाएं साइडबार) पर क्लिक करें.
4. बिजली, पानी जैसी सुविधाओं वाली जगह पर सबसे नीचे,
   

   ऑब्जेक्ट लाइब्रेरी दिखाएं बटन (नीला बटन) पर क्लिक करें:

   
5. खोज बॉक्स में बटन डालें.
   
6. बटन को स्टोरीबोर्ड पर खींचें और सबसे ऊपर छोड़ें बाईं ओर.
   
7. Assistant एडिटर बटन पर क्लिक करें अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है Xcode टूलबार पर क्लिक करें.
8. Ctrl कुंजी को दबाकर रखते हुए, बटन को खींचें और छोड़ें ViewController क्लास की परिभाषा के निचले हिस्से में मौजूद है.
   
9. डायलॉग बॉक्स में, कार्रवाई कनेक्शन चुनें और फ़ंक्शन का नाम डालें buttonPressed और buttonPressed पर क्लिक करें.
   

   इससे यहां दिए गए फ़ंक्शन को ViewController क्लास की परिभाषा:

   @IBAction func buttonPressed(sender: AnyObject) {
   }

   हर बार बटन दबाने पर फ़ंक्शन एक्ज़ीक्यूट होता है.

10. buttonPressed फ़ंक्शन में, यह कोड ButtonPressed इवेंट को दिन की लेयर में पुश करें:

    @IBAction func buttonPressed(sender: AnyObject) {
      dataLayer.push(["event": "ButtonPressed", "eventAction": "Test Event"])
    }

8. अपना ऐप्लिकेशन बनाएं और चलाएं

Xcode में, प्रॉडक्ट > चलाएं. Xcode, ऐप्लिकेशन बनाएगा और उसे चलाएगा: