iOS के लिए Google Analytics के साथ Google Ads कस्टम इवेंट

1. परिचय

पिछली बार अपडेट किए जाने की तारीख: 14-12-2020

आपको क्या बनाने को मिलेगा

इस कोडलैब में, आपको GA4F iOS SDK टूल की मदद से कस्टम इवेंट लागू करने और Google Ads के ज़रिए ऐक्शन कैंपेन लॉन्च करने का तरीका बताया जाएगा.

इस कोडलैब की मदद से, आपको ऐप्लिकेशन कारोबार की पूरी प्रोसेस के बारे में पता चलेगा. यह वही प्रोसेस है जिसका सामना हमारे क्लाइंट करते हैं. अगर आपको Firebase iOS के बारे में बुनियादी जानकारी चाहिए, तो Firebase iOS Codelab Swift से शुरुआत करें

आपको क्या सीखने को मिलेगा

  • iOS Swift में GA4F (Google Analytics for Firebase) को शुरू करने का तरीका
  • कस्टम इवेंट और पैरामीटर बनाने का तरीका.
  • Firebase से Google Ads में इवेंट इंपोर्ट करने का तरीका
  • कस्टम इवेंट की मदद से, ऐक्शन कैंपेन लॉन्च करें.

आपको इन चीज़ों की ज़रूरत होगी

  • Xcode
  • Firebase खाता
  • Google Ads खाता

2. नया iOS Swift प्रोजेक्ट शुरू करना

एक आसान टेंप्लेट वाला iOS Swift ऐप्लिकेशन बनाएं. इस स्टार्टर ऐप्लिकेशन में बदलाव करके, पूरा ऐप्लिकेशन बनाया जाता है.

सबसे पहले, Xcode लॉन्च करें.

  1. अगर आपके पास कोई प्रोजेक्ट खुला हुआ नहीं है, तो वेलकम पेज पर जाकर, नया Xcode प्रोजेक्ट बनाएं को चुनें.
  2. डायलॉग बॉक्स में सबसे ऊपर, iOS को चुनें.
  3. ऐप्लिकेशन सेक्शन में जाकर, ऐप्लिकेशन चुनें. इसके बाद, आगे बढ़ें पर क्लिक करें.
  4. इसके बाद, आपको एक डायलॉग बॉक्स दिखेगा. इसमें, अपने ऐप्लिकेशन का नाम डालने के लिए इन वैल्यू का इस्तेमाल करें. साथ ही, अपने प्रोजेक्ट के लिए अन्य विकल्प चुनें. इसके बाद, Next पर क्लिक करें :
  5. प्रॉडक्ट का नाम: उदाहरण के लिए, ios-app

Xcode, आपके प्रोजेक्ट और ऐप्लिकेशन का नाम रखने के लिए, आपके डाले गए प्रॉडक्ट के नाम का इस्तेमाल करता है.

  1. टीम: अगर यह जानकारी अपने-आप नहीं भरी जाती है, तो टीम को 'कोई नहीं' पर सेट करें.
  2. संगठन का नाम: आपके संगठन का नाम या आपका नाम.
  3. बंडल आइडेंटिफ़ायर: यह वैल्यू, आपके प्रॉडक्ट के नाम और संगठन के आइडेंटिफ़ायर के आधार पर अपने-आप जनरेट होती है.
  4. भाषा: Swift
  5. अपने प्रोजेक्ट को सेव करने के लिए कोई जगह चुनें और 'बनाएं' पर क्लिक करें.
  6. Xcode, आपके नए प्रोजेक्ट को वर्कस्पेस विंडो में खोलता है.

3. Firebase प्रोजेक्ट बनाना और उसे सेट अप करना

Firebase का इस्तेमाल शुरू करने के लिए, आपको एक Firebase प्रोजेक्ट बनाना और उसे सेट अप करना होगा.

Firebase प्रोजेक्ट बनाना

अगर आपके पास कोई ऐसा मौजूदा Firebase प्रोजेक्ट है जिसमें Google Analytics चालू नहीं है, तो सेटिंग > प्रोजेक्ट सेटिंग के इंटिग्रेशन टैब से Google Analytics को चालू किया जा सकता है. Firebase कॉन्फ़िगरेशन के चरण पर जाएं.

  1. Firebase में साइन इन करें.

Firebase कंसोल में, 'प्रोजेक्ट जोड़ें' (या 'प्रोजेक्ट बनाएं') पर क्लिक करें. इसके बाद, अपने Firebase प्रोजेक्ट का नाम Firebase-iOS-Ads रखें

9b0ae97cc3c6f1d0.png

  1. प्रोजेक्ट बनाने के विकल्पों पर क्लिक करें. अगर आपसे Firebase की शर्तें स्वीकार करने के लिए कहा जाता है, तो उन्हें स्वीकार करें. आपको इस प्रोजेक्ट के लिए Google Analytics चालू करना चाहिए, क्योंकि आपको ऐक्शन इवेंट और कन्वर्ज़न को ट्रैक करने के लिए Google Analytics इवेंट की ज़रूरत होती है.

e58151a081f0628.png

Firebase प्रोजेक्ट के बारे में ज़्यादा जानने के लिए, Firebase प्रोजेक्ट के बारे में जानकारी लेख पढ़ें.

4. Firebase कॉन्फ़िगरेशन

  1. Firebase कंसोल में, बाईं ओर मौजूद नेविगेशन बार में जाकर, प्रोजेक्ट की खास जानकारी > प्रोजेक्ट की सेटिंग चुनें. इसके बाद, सामान्य > आपके ऐप्लिकेशन में जाकर, iOS बटन पर क्लिक करें

आपको यहां दी गई स्क्रीन में दिखाया गया डायलॉग दिखेगा.

425bb1c07921e71d.png

  1. आपको iOS बंडल आईडी की वैल्यू देनी होगी. इसे पाने के लिए, यह तरीका अपनाएं.
  2. iOS ऐप्लिकेशन के लिए Xcode प्रोजेक्ट में, प्रोजेक्ट नेविगेटर में सबसे ऊपर मौजूद ऐप्लिकेशन को चुनें. इसके बाद, सामान्य टैब को चुनें.
  3. बंडल आइडेंटिफ़ायर फ़ील्ड की वैल्यू, iOS बंडल आईडी होती है. यह com.yourcompany.yourproject की तरह दिखती है. इस वैल्यू को कॉपी करें.
  4. Firebase डायलॉग में, कॉपी किए गए बंडल आईडी को iOS bundle ID फ़ील्ड में चिपकाएं.
  5. ऐप्लिकेशन रजिस्टर करें पर क्लिक करें.
  6. Firebase में जारी रखने के लिए, कॉन्फ़िगरेशन फ़ाइल डाउनलोड करने से जुड़े निर्देशों का पालन करें GoogleService-Info.plist

26e5b98711c2787a.png

  1. अपने Xcode प्रोजेक्ट पर जाएं. इसके बाद, अभी डाउनलोड की गई GoogleService-Info.plist फ़ाइल को अपने Xcode प्रोजेक्ट के रूट में ले जाएं.
  2. बाकी चरणों को छोड़ें और Firebase कंसोल के मुख्य पेज पर वापस जाएं.

5. Xcode में Firebase Analytics को कॉन्फ़िगर करना

इस चरण में, आपको अपने Xcode प्रोजेक्ट में Firebase SDK टूल जोड़ना होगा.

  1. टर्मिनल विंडो खोलें और अपने ऐप्लिकेशन के Xcode प्रोजेक्ट की जगह पर जाएं.
  2. अगर आपके पास कोई Podfile नहीं है, तो एक बनाएं:

$ pod init

  1. अपना Podfile खोलें और जोड़ें :

$ vi Podfile

$ pod 'Firebase/Analytics' 54204c9ce2a49666.png

  1. फ़ाइल सेव करें और चलाएं :

$ pod install

  1. शुरू करने के लिए कोड जोड़ें :

ऐप्लिकेशन के शुरू होते ही, Firebase को कनेक्ट करने के लिए, यहां दिया गया शुरू करने वाला कोड अपने मुख्य AppDelegate क्लास में जोड़ें.

import UIKit
import Firebase

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  var window: UIWindow?

  func application(_ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions:
      [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    FirebaseApp.configure()
    return true
  }
}
  1. आप बिल्कुल तैयार हैं! Console पर जारी रखें.

अब कस्टम इवेंट लॉग ट्रिगर किए जा सकते हैं!

6. Firebase Analytics की मदद से कस्टम इवेंट लॉग करना

इस चरण में, आपको iOS ऐप्लिकेशन में Firebase Analytics की मदद से कस्टम इवेंट लॉग करने का तरीका बताया जाएगा.

Firebase Analytics, आपके लिए कुछ इवेंट अपने-आप लॉग करता है. इन्हें पाने के लिए, आपको कोई कोड जोड़ने की ज़रूरत नहीं होती. अगर आपके ऐप्लिकेशन को अतिरिक्त डेटा इकट्ठा करने की ज़रूरत है, तो अपने ऐप्लिकेशन में Analytics के 500 अलग-अलग कस्टम इवेंट टाइप लॉग किए जा सकते हैं.

इवेंट लॉग करना

FirebaseApp इंस्टेंस को कॉन्फ़िगर करने के बाद, logEvent() तरीके का इस्तेमाल करके इवेंट लॉग किए जा सकते हैं.

Analytics.logEvent("text_search", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject
  ])

इवेंट के डिफ़ॉल्ट पैरामीटर सेट करना

setDefaultEventParameters का इस्तेमाल करके, सभी इवेंट के लिए पैरामीटर लॉग किए जा सकते हैं. डिफ़ॉल्ट पैरामीटर, लॉग किए गए आने वाले समय के सभी इवेंट से जुड़े होते हैं.

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

Xcode डीबग कंसोल में इवेंट देखना

ज़्यादा जानकारी वाली लॉगिंग की सुविधा चालू की जा सकती है. इससे SDK टूल के ज़रिए इवेंट की लॉगिंग को मॉनिटर किया जा सकता है. इससे यह पुष्टि करने में मदद मिलती है कि इवेंट को सही तरीके से लॉग किया जा रहा है. इसमें अपने-आप और मैन्युअल तरीके से लॉग किए गए इवेंट, दोनों शामिल हैं.

Verbose logging को इस तरह चालू किया जा सकता है:

  1. Xcode में, Product > Scheme > Edit scheme... को चुनें
  2. बाईं ओर मौजूद मेन्यू से, Run को चुनें.
  3. Arguments टैब चुनें.
  4. Arguments Passed On Launch सेक्शन में, -FIRAnalyticsDebugEnabled जोड़ें.

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

डैशबोर्ड में इवेंट देखना

लॉग किया गया इवेंट, आपको कुछ घंटों में Firebase कंसोल में दिखने लगेगा. यह Analytics → इवेंट में मौजूद होता है. इवेंट पर क्लिक करके भी पैरामीटर वैल्यू देखी जा सकती हैं.

286b640ed4646163.png

‘कन्वर्ज़न के तौर पर मार्क करें' स्विच को दाईं ओर स्लाइड करके, ‘text_search' को कन्वर्ज़न के तौर पर मार्क करें.

a933a338990cba3a.png

Firebase Analytics के कन्वर्ज़न टैब में जाकर, यह पुष्टि की जा सकती है कि इवेंट को कन्वर्ज़न के तौर पर मार्क किया गया है या नहीं. इवेंट को कन्वर्ज़न के तौर पर मार्क करने पर, Google Ads भी इवेंट को कन्वर्ज़न के तौर पर इंपोर्ट कर पाएगा.

7. Google Ads में Analytics इवेंट इंपोर्ट करना

Firebase-iOS का सेटअप पूरा हो गया है. अब लॉग किए गए ऐक्शन इवेंट के साथ ऐप्लिकेशन कैंपेन लॉन्च किया जा सकता है. इसके लिए, आपको Firebase को Google Ads से लिंक करना होगा. Firebase को Google Ads से लिंक करने पर, ऐप्लिकेशन कैंपेन को ऑडियंस के बारे में ज़्यादा जानकारी मिलेगी. साथ ही, ऐप्लिकेशन कैंपेन की लर्निंग को बढ़ावा मिलेगा. इससे आम तौर पर, परफ़ॉर्मेंस बेहतर होती है और कन्वर्ज़न बढ़ते हैं.

  1. प्रोजेक्ट की खास जानकारी के ठीक बगल में मौजूद बटन पर क्लिक करके, Firebase की सेटिंग पर जाएं.
  2. इंटिग्रेशन टैब में, आपको Google Ads और लिंक करें बटन दिखेगा. 'लिंक करें और जारी रखें' पर क्लिक करें.

b711bf2e94fa0895.png

  1. Google Ads खाता चुनें.

अब Firebase का काम पूरा हो गया है.

अब Google Ads पर जाएं और लॉगिन करें.

  1. कस्टम इवेंट को कन्वर्ज़न के तौर पर इंपोर्ट करने के लिए, Google Ads पर जाएं और लॉग इन करें. इसके बाद, टूल और सेटिंग → मेज़रमेंट → कन्वर्ज़न पर जाएं.
  2. नया कन्वर्ज़न ऐक्शन जोड़ने के लिए, + बटन पर क्लिक करें.

73cec8d2e80eab03.png

  1. Google Analytics 4 प्रॉपर्टी (Firebase) चुनें और जारी रखें पर क्लिक करें.

4b1d8f6a712b2ac6.png

  1. आपको कन्वर्ज़न के तौर पर मार्क किए गए सभी Analytics इवेंट दिख सकते हैं. हमने पहले जिस clicked_counter इवेंट को लागू किया था उसे ढूंढें.

ba1bbe6b2924fac8.png 2b9abde9fb95d188.png

  1. 'इंपोर्ट करें और जारी रखें' बटन पर क्लिक करें.

ab35e341dff32e48.png

text_search को कन्वर्ज़न ऐक्शन के तौर पर सेट करने के बाद, अब ऐसे कैंपेन को लॉन्च करने का समय है जो उन उपयोगकर्ताओं को टारगेट कर रहा है जो text_search इवेंट को ट्रिगर करेंगे.

8. इंपोर्ट किए गए इवेंट की मदद से, ऐप्लिकेशन ऐक्शन कैंपेन लॉन्च करना

  1. अपने मौजूदा खाते के कैंपेन टैब पर जाएं और + बटन पर क्लिक करके, एक नया कैंपेन शुरू करें. नया कैंपेन पर क्लिक करें और जारी रखें.
  2. इस दौरान, हम ऐप्लिकेशन इंस्टॉल करने का बढ़ावा देने वाला कैंपेन लॉन्च करेंगे. इसमें ऐप्लिकेशन इंस्टॉल करने का विकल्प होगा.

af98c44d1476558.png

  1. ऐप्लिकेशन का नाम, पैकेज का नाम या पब्लिशर का नाम डालकर, अपना ऐप्लिकेशन ढूंढें.
  2. बिडिंग सेक्शन में, 'कार्रवाइयों पर फ़ोकस करने के लिए विज्ञापन' के ड्रॉपबॉक्स में जाकर, इन-ऐप्लिकेशन कार्रवाइयां चुनें.
  3. आपको दी गई सूची में, अपने कस्टम इवेंट दिखेंगे. हर ऐक्शन के लिए खर्च का टारगेट सेट करें. साथ ही, अन्य विकल्प भी भरें.

a1f145794f949109.png 3dc838d7f4eeeba5.png

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

9. बधाई हो

बधाई हो, आपने Firebase और Google Ads को इंटिग्रेट कर लिया है! इससे आपको अपने कैंपेन की परफ़ॉर्मेंस को बेहतर बनाने में मदद मिलेगी.

आपने स्क्रिप्ट इंस्टॉल की हो, नया कोडलैब बदलावों की सूची बनाई हो और उसे स्टेज किया हो, कोडलैब बदलावों की सूची को अपडेट किया हो और उसे स्टेज किया हो, कोडलैब बदलावों की सूची की समीक्षा की हो और उसे मंज़ूरी दी हो, और कोडलैब बदलावों की सूची सबमिट और पब्लिश की हो.

आपने सीखा

  • iOS के लिए Firebase को कैसे कॉन्फ़िगर करें
  • iOS और Firebase Analytics की मदद से कस्टम इवेंट लॉग करने का तरीका
  • इवेंट इंपोर्ट करने और उन्हें ऐक्शन कैंपेन के लिए इस्तेमाल करने का तरीका.