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

1. परिचय

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

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

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

इस कोडलैब की मदद से, ऐप्लिकेशन कारोबार की उस पूरी प्रोसेस का अनुभव लिया जा सकता है जिसका हमारे क्लाइंट सामना कर रहे हैं. अगर आपको Firebase iOS के बारे में सामान्य जानकारी चाहिए, तो Firebase iOS कोडलैब 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 ऐप्लिकेशन

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

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

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

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

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

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

  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 के साथ कस्टम इवेंट को लॉग करने का तरीका
  • इवेंट इंपोर्ट करने और ऐक्शन कैंपेन में उनका इस्तेमाल करने का तरीका.