Android के लिए Google Analytics के साथ Google Ads में कस्टम इवेंट बनाने की सुविधा

1. शुरुआती जानकारी

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

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

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

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

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

  • Firebase प्रोजेक्ट बनाने का तरीका
  • Android ऐप्लिकेशन में Firebase SDK टूल लागू करने का तरीका
  • इवेंट और पैरामीटर बनाने का तरीका.
  • Firebase से Google Ads में इवेंट इंपोर्ट करने का तरीका
  • कस्टम इवेंट का इस्तेमाल करके, Google Ads के ऐक्शन कैंपेन लॉन्च करें.

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

  • Android Studio 3.6 या इसके बाद वाला वर्शन
  • Firebase खाता
  • Google Ads खाता

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

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

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

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

Firebase कंसोल में, प्रोजेक्ट जोड़ें(या प्रोजेक्ट बनाएं) पर क्लिक करें और अपने Firebase प्रोजेक्ट को अपनी पसंद का नाम दें.

8525e77df3536fbb.png

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

e58151a081f0628.png

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

  1. Google Analytics खाता चुनें. अगर आपके पास कोई नया पिन है, तो उसे चुनें या नया खाता बनाएं. 'प्रोजेक्ट बनाएं' बटन पर क्लिक करें.

ac928e5947ba7cbf.png

  1. अब Firebase प्रोजेक्ट का बिल्ड पूरा हो गया है!

अगले चरण में, आपको अपने Android ऐप्लिकेशन में Firebase को जोड़ने का तरीका बताया जाएगा.

3. अपने Android ऐप्लिकेशन में Firebase जोड़ना

ऐप्लिकेशन रजिस्टर करें

  1. Firebase कंसोल में, बाएं नेविगेशन में 'प्रोजेक्ट की खास जानकारी' चुनें. इसके बाद, "अपने ऐप्लिकेशन में Firebase जोड़कर शुरू करें" में दिए Android बटन पर क्लिक करें

6cbb33ad3e7c9132.png

  1. ज़रूरी जानकारी भरें.

3b7d3b33d81fe8ea.png

Android पैकेज के नाम के लिए, Android Studio में ऐप्लिकेशन डायरेक्ट्री पर जाएं. इसके बाद, build.gradle फ़ाइल खोलें. फ़ाइल में, applicationId खोजें. यह मान Android पैकेज का नाम है. इस वैल्यू को कॉपी करके चिपकाएं.

हमें यहां SHA-1 कुंजी की ज़रूरत नहीं है, जब तक कि आप Google साइन इन या Firebase डाइनैमिक लिंक का इस्तेमाल करने की योजना न बना रहे हों (ध्यान दें कि ये इस कोडलैब का हिस्सा नहीं हैं, SHA-1 कुंजी के बारे में ज़्यादा जानकारी के लिए, कृपया यह दस्तावेज़ देखें.).

  1. ऐप्लिकेशन रजिस्टर करें बटन पर क्लिक करें.

कॉन्फ़िगरेशन फ़ाइल डाउनलोड करें

  1. कॉन्फ़िगरेशन फ़ाइल google-services.json डाउनलोड करने के लिए, google-services.json डाउनलोड करें बटन पर क्लिक करें.

52f08aa18c8d59d0.png

  1. Android Studio में, app डायरेक्ट्री में जाएं और google-services.json फ़ाइल (जिसे आपने अभी-अभी डाउनलोड किया है) को app डायरेक्ट्री में ले जाएं. Firebase कंसोल पर वापस जाएं और 'आगे बढ़ें' बटन पर क्लिक करें.

अपने ऐप्लिकेशन में Firebase चालू करना

  1. Firebase से जनरेट की गई google-services.json फ़ाइल को पढ़ने के लिए, आपको Google सेवाओं के ग्रेडल प्लगिन की ज़रूरत होगी.
  2. Android Studio में, <project>/build.gradle खोलें. इसके बाद, फ़ाइल में ये लाइनें जोड़ें:
buildscript { 
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
   }
   dependencies {
      ...
      // Add this line
      classpath 'com.google.gms:google-services:4.3.4'
   }
}

allprojects {
   ...
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
      ...
      }
   }
}
  1. <project>/<app-module>/build.gradle को खोलकर, फ़ाइल में ये लाइनें जोड़ें:
apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'

अब, आपने अपने Android ऐप्लिकेशन में Firebase जोड़ लिया है!

अगले चरण में, आपको अपने ऐप्लिकेशन में Firebase SDK टूल जोड़ने का तरीका बताया जाएगा.

4. अपने ऐप्लिकेशन में Firebase SDK टूल जोड़ना

इस चरण में, आपको Firebase SDK टूल जोड़ना होगा. खास तौर पर, Google Analytics के लिए Firebase SDK टूल.

हम Firebase Android BoM का इस्तेमाल करेंगे. इसकी मदद से, आप BoM के वर्शन तय करके अपने ऐप्लिकेशन में इस्तेमाल किए जा रहे Firebase लाइब्रेरी के वर्शन को मैनेज कर सकते हैं. यह जानने के लिए कि Firebase लाइब्रेरी के कौनसे वर्शन को किसी खास BoM वर्शन पर मैप किया गया है, उस BoM वर्शन की प्रॉडक्ट की जानकारी देखें.

  1. <project>/<app-module>/build.gradle को खोलकर, फ़ाइल में ये लाइनें जोड़ें:
dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx'

जैसा कि सिर्फ़ BoM के वर्शन के बारे में बताने पर, आपको Firebase के आंकड़ों वाली लाइब्रेरी का वर्शन तय करने की ज़रूरत नहीं है. हालांकि, अगर आपको Firebase लाइब्रेरी के लिए अपनी पसंद के वर्शन का इस्तेमाल करना है, तो इससे कोई फ़र्क़ नहीं पड़ता कि BoM में कौनसा वर्शन दिया गया है, आपको बस इस तरह से मनचाहा वर्शन तय करना होगा:

dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx:17.0.0'
  1. अब Sync Now बटन पर क्लिक करके अपनी ऐप्लिकेशन सिंक करें. 937206076c88ae5c.png

अब, आपने अपने Android ऐप्लिकेशन में Google Analytics के लिए Firebase SDK टूल जोड़ लिया है!

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

5. Firebase Analytics की मदद से इवेंट लॉग करें

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

इवेंट लॉग करने के दो तरीके हैं: सुझाए गए इवेंट या कस्टम इवेंट का इस्तेमाल करना.

सुझाए गए इवेंट का इस्तेमाल करना

Firebase Analytics SDK टूल, सुझाए गए कई इवेंट तय करता है. इनका इस्तेमाल गेमिंग, रीटेल, यात्रा, और ई-कॉमर्स जैसे अलग-अलग तरह के ऐप्लिकेशन में किया जा सकता है. इसके अलावा, कुछ ऐसे इवेंट भी होते हैं जिनके लिए तय पैरामीटर की ज़रूरत होती है. इन पैरामीटर का इस्तेमाल करके, Firebase रिपोर्ट में उपलब्ध जानकारी को बढ़ाया जा सकता है. ( सुझाए गए इवेंट का रेफ़रंस)

  1. गतिविधि के ऊपर FirebaseAnalytics ऑब्जेक्ट का एलान करें:
private lateinit var firebaseAnalytics: FirebaseAnalytics
  1. ऑब्जेक्ट को onCreate() तरीके में शुरू करें:
firebaseAnalytics = Firebase.analytics
  1. logEvent() तरीके की मदद से इवेंट लॉग करना शुरू करें. जब कोई उपयोगकर्ता, ऐप्लिकेशन में कोई आइटम खरीदता है, तो यह कोड PURCHASE इवेंट को लॉग करता है:
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
   param(FirebaseAnalytics.Param.VALUE, 10)
   param(FirebaseAnalytics.Param.CURRENCY, "USE")
}

कस्टम इवेंट का इस्तेमाल करना

अगर आपको ऐसे इवेंट चाहिए जो सुझाए गए इवेंट में शामिल नहीं हैं, तो अपने कस्टम इवेंट को कस्टम पैरामीटर से लॉग करें:

firebaseAnalytics.logEvent("delete_item"){
   param("item name", name)
   param("reason", text)
}

डीबग इवेंट

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

तुरंत टेस्ट करने और डीबग करने के लिए, Firebase डीबगव्यू का इस्तेमाल किया जा सकता है. DebugView की मदद से, डेवलपमेंट डिवाइसों पर अपने ऐप्लिकेशन से लॉग किया गया इवेंट डेटा करीब-करीब रीयल-टाइम में देखा जा सकता है. DebugView के लिए, कृपया डीबग करने का इवेंट सेक्शन देखें.

अब आपने अपने Android ऐप्लिकेशन में इवेंट लॉग करने की प्रक्रिया पूरी कर ली है!

अगले चरण में, आपको उन इवेंट को Google Ads में इंपोर्ट करने का तरीका बताया जाएगा.

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

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

  1. प्रोजेक्ट की खास जानकारी के बगल में मौजूद बटन पर क्लिक करके, Firebase की सेटिंग में जाएं.

412830708c61fdc0.png

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

796c921fb2b873ae.png

  1. वह Google Ads खाता चुनें जिसे लिंक करना है.

अब आपने Firebase और Google Ads को लिंक कर लिया है. आइए, Google Ads में Firebase इवेंट इंपोर्ट करें.

Firebase इवेंट इंपोर्ट करना

  1. Firebase कंसोल में, इवेंट मेन्यू में जाकर उस इवेंट को मार्क करें जिसे कन्वर्ज़न के तौर पर इंपोर्ट करना है.

a5f302ba01a1863c.png

  1. अब, Google Ads पर जाएं और उस खाते में लॉगिन करें जिसे आपने Firebase से लिंक किया है.
  2. Google Ads में, टूल → मेज़रमेंट → कन्वर्ज़न 7acf268d7e799a7e.png पर जाएं
  3. + बटन d0eed72946d038d8.png पर क्लिक करें
  4. ऐप्लिकेशन → Google Analytics 4 प्रॉपर्टी (Firebase) चुनें और 'जारी रखें' पर क्लिक करें. 983f06edb15724de.png अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
  5. Analytics के वे सभी इवेंट देखे जा सकते हैं जिन्हें कन्वर्ज़न के तौर पर मार्क किया गया है. वह इवेंट ढूंढें जिसे इंपोर्ट करना है. इस मामले में, वह delete_item इवेंट चुनें जिसे हमने पहले लागू किया है. इंपोर्ट करें और जारी रखें बटन पर क्लिक करें. f9bdee80c0d40999.png अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
  6. आपने Firebase से एक कन्वर्ज़न इवेंट इंपोर्ट कर लिया है. be75f6a11913236.png अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

अब आपने Google Ads में Firebase इवेंट इंपोर्ट कर लिए हैं.

अगले चरण में, आपको उस इवेंट के साथ ऐक्शन कैंपेन को लॉन्च करने का तरीका पता चलेगा जिसे आपने अभी इंपोर्ट किया है.

7. इंपोर्ट किए गए इवेंट के साथ ऐप्लिकेशन ऐक्शन कैंपेन लॉन्च करना

  1. अपने मौजूदा Google Ads खाते में, ऐप्लिकेशन कैंपेन टैब पर जाएं और + बटन पर क्लिक करके नया कैंपेन शुरू करें.

19856a65ab999ad7.png

  1. हम ऐप्लिकेशन इंस्टॉल विकल्प के साथ ऐप्लिकेशन प्रमोशन कैंपेन लॉन्च करेंगे. सबसे नीचे, वह ऐप्लिकेशन चुनें जिसका आपको प्रमोशन करना है. इसके बाद, 'जारी रखें' पर क्लिक करें. 8146b5a7a4f961bd.png अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
  2. बिडिंग सेक्शन में, अगर ड्रॉपडाउन मेन्यू में इन-ऐप्लिकेशन कार्रवाइयों को चुना जाता है, तो आपको इवेंट दिख सकते हैं. वह(वे) इवेंट चुनें जिस पर फ़ोकस करना है.

b75e410c7dbdfec8.png

  1. कैंपेन की बाकी सेटिंग को सेट करें और हो गया.

8. बधाई

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

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

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