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

1. परिचय

पिछली बार अपडेट किया गया: 14-12-2020

आपको क्या बनाना होगा

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

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

आपको इनके बारे में जानकारी मिलेगी

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

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

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

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

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

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

  1. अगर आपके पास खुले प्रोजेक्ट नहीं हैं, तो स्वागत पेज से 'नया Xcode प्रोजेक्ट बनाएं' चुनें.
  2. डायलॉग बॉक्स में सबसे ऊपर, iOS चुनें.
  3. 'ऐप्लिकेशन' सेक्शन में, 'ऐप्लिकेशन' चुनें. इसके बाद, 'आगे बढ़ें' पर क्लिक करें.
  4. इसके बाद, आपको एक डायलॉग बॉक्स दिखेगा. इसमें अपने ऐप्लिकेशन का नाम डालें और अपने प्रोजेक्ट के लिए अन्य विकल्प चुनें. इसके बाद, 'आगे बढ़ें' पर क्लिक करें :
  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. आप बिल्कुल तैयार हैं! कंसोल पर जाएं.

अब आप कुछ कस्टम इवेंट लॉग करने के लिए तैयार हैं!

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

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

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

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

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 डीबग कंसोल में इवेंट देखना

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

आप इस तरह से वर्बोज़ लॉगिंग को सक्षम कर सकते हैं:

  1. Xcode में, प्रॉडक्ट > स्कीम > स्कीम में बदलाव करें... चुनें
  2. बाईं ओर दिए गए मेन्यू में जाकर, Run चुनें.
  3. आर्ग्युमेंट टैब चुनें.
  4. लॉन्च के समय पास किए गए आर्ग्युमेंट सेक्शन में, -FIRAnalyticsDebugEnabled जोड़ें.

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

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

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

286b640ed4646163.png

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

a933a338990cba3a.png

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

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

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. कार्रवाइयों पर फ़ोकस करने के लिए, बिडिंग सेक्शन में Google Ads के लिए ड्रॉपबॉक्स में इन-ऐप्लिकेशन कार्रवाइयां चुनें.
  3. आपको दी गई सूची में अपने कस्टम इवेंट मिल सकते हैं. हर ऐक्शन के लिए खर्च का टारगेट सेट करें. साथ ही, अन्य विकल्प भी भरें.

a1f145794f949109.png 3dc838d7f4eeeba5.png

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

9. बधाई हो

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

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

आपको सीख मिली है

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