Google Analytics कस्टम इवेंट और Flutter की मदद से Google Ads कैंपेन लॉन्च करना

1. परिचय

पिछली बार अपडेट किया गया: 25-01-2021

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

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

हम एक आसान काउंटर विजेट के साथ, डिफ़ॉल्ट Flutter ऐप्लिकेशन का इस्तेमाल करेंगे. हम संभावित उपयोगकर्ताओं को अपने ऐप्लिकेशन का विज्ञापन दिखाएंगे. ये ऐसे उपयोगकर्ता हो सकते हैं जो काउंटर विजेट पर क्लिक करेंगे.

bdbf1fc3cbf49ac7.png

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

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

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

  • Android Studio 3.6 या इसके बाद वाला वर्शन
  • Xcode (iOS समर्थन के लिए)
  • Firebase खाता
  • Google Ads खाता

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

आसान टेंप्लेट वाला Flutter ऐप्लिकेशन बनाएं. आपको इस कोडलैब के लिए, इस स्टार्टर ऐप्लिकेशन में बदलाव करना होगा.

Android Studio लॉन्च करें.

  1. अगर आपके पास ओपन प्रोजेक्ट नहीं हैं, तो वेलकम पेज से एक नया Flutter ऐप्लिकेशन शुरू करें चुनें. अन्यथा, फ़ाइल > नया > नया Flutter प्रोजेक्ट.
  2. प्रोजेक्ट टाइप के तौर पर, Flutter का ऐप्लिकेशन चुनें और आगे बढ़ें पर क्लिक करें.
  3. पुष्टि करें कि Flutter SDK टूल के पाथ से SDK टूल की जगह की जानकारी मिलती है. अगर टेक्स्ट फ़ील्ड खाली है, तो SDK टूल इंस्टॉल करें चुनें.
  4. प्रोजेक्ट का नाम डालें और आगे बढ़ें पर क्लिक करें.
  5. Android Studio से मिले पैकेज के लिए डिफ़ॉल्ट नाम का इस्तेमाल करें और आगे बढ़ें पर क्लिक करें.
  6. पूरा करें पर क्लिक करें.
  7. तब तक इंतज़ार करें, जब तक Android Studio, SDK टूल इंस्टॉल नहीं करता और प्रोजेक्ट बनाता है.

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

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

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

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

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

e9a8e1b1c7c52125.png

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

e58151a081f0628.png

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

4. प्लैटफ़ॉर्म के हिसाब से Firebase कॉन्फ़िगरेशन (Android)

3e5b8f1b6ca538c4.png

Android को कॉन्फ़िगर करना

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

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

3b7d3b33d81fe8ea.png

  1. Android पैकेज का नाम देना ज़रूरी है. यह नाम आपको इस तरीके से मिलेगा.
  1. अपनी Flutter ऐप्लिकेशन डायरेक्ट्री में android/app/src/main/AndroidManifest.xml फ़ाइल खोलें.
  2. manifest एलिमेंट में, package एट्रिब्यूट की स्ट्रिंग की वैल्यू ढूंढें. यह वैल्यू Android पैकेज का नाम है (कुछ ऐसा com.yourcompany.yourproject). इस वैल्यू को कॉपी करें.
  3. Firebase डायलॉग में, कॉपी किए गए पैकेज का नाम Android package name फ़ील्ड में चिपकाएं.
  4. हमें यहां SHA-1 कुंजी की ज़रूरत नहीं है, जब तक कि आप Google साइन इन या Firebase डाइनैमिक लिंक का इस्तेमाल करने की योजना न बना रहे हों (ध्यान दें कि ये इस कोडलैब का हिस्सा नहीं हैं). अगर आपको Google Play से in_app_purchase का डेटा इंपोर्ट करना है, तो आपको बाद में पासकोड सेट करना होगा.
  5. ऐप्लिकेशन रजिस्टर करें पर क्लिक करें.
  6. Firebase में जारी रखते हुए, google-services.json कॉन्फ़िगरेशन फ़ाइल डाउनलोड करने के लिए, निर्देशों का पालन करें.

52f08aa18c8d59d0.png

  1. अपनी Flutter ऐप्लिकेशन डायरेक्ट्री पर जाएं. इसके बाद, google-services.json फ़ाइल (जिसे आपने अभी-अभी डाउनलोड किया है) को android/app डायरेक्ट्री में ले जाएं.
  2. Firebase कंसोल के ज़रिए, बाकी चरणों को छोड़ें. इसके बाद, Firebase कंसोल के मुख्य पेज पर वापस जाएं.
  3. आखिर में, Firebase से जनरेट की गई google-services.json फ़ाइल को पढ़ने के लिए, आपको Google सेवाओं के ग्रेडल प्लगिन की ज़रूरत पड़ेगी.
  4. अपने IDE या Editor में, android/app/build.gradle खोलें. इसके बाद, नीचे दी गई लाइन को फ़ाइल की आखिरी लाइन के तौर पर जोड़ें:
apply plugin: 'com.google.gms.google-services'
  1. android/build.gradle खोलें, फिर buildscript टैग में, एक नई डिपेंडेंसी जोड़ें:
buildscript { 
   repositories {
      // ...
   }
   dependencies {
      // ...
      Classpath 'com.google.gms:google-services:4.3.3'
   }
}
  1. अगर आपका ऐप्लिकेशन अब भी चल रहा है, तो उसे बंद करके फिर से बनाएं, ताकि gradle को डिपेंडेंसी इंस्टॉल करने की अनुमति मिल सके.

आपने Android के लिए, Flutter ऐप्लिकेशन को कॉन्फ़िगर कर लिया है! iOS के लिए, हो सकता है कि आप यह कोडलैब देखना चाहें ( Flutter के लिए Firebase के बारे में जानें)

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

इस चरण में, आप firebase_analytics नाम के Firebase Analytics पैकेज का इस्तेमाल शुरू करेंगे, जिसमें Firebase Analytics सुविधाएं शामिल हैं.

pubspec फ़ाइल, Flutter ऐप्लिकेशन के लिए ऐसेट मैनेज करती है. pubspec.yaml में, firebase_analytics: ^6.2.0 (firebase_analytics 6.2.0 या उसके बाद के वर्शन) को डिपेंडेंसी सूची में जोड़ें :

dependencies: 
   flutter: 
      sdk: flutter 
   cupertino_icons: ^0.1.2 
   firebase_analytics: ^6.2.0   # add this line

Android Studio के एडिटर व्यू में pubspec देखते समय, पैकेज पाएं पर क्लिक करें. यह पैकेज को आपके प्रोजेक्ट में ले आता है. आपको कंसोल में यह जानकारी दिखेगी:

flutter packages get 
Running "flutter packages get" in startup_namer... 
Process finished with exit code 0

Pub get लागू करने पर, pubspec.lock फ़ाइल अपने-आप जनरेट हो जाती है. इसमें, प्रोजेक्ट में शामिल सभी पैकेज और उनके वर्शन नंबर की सूची होती है.

lib/main.dart में, यह नया पैकेज इंपोर्ट करें:

import 'package:firebase_analytics/firebase_analytics.dart';

MyApp क्लास में, कंस्ट्रक्टर को कॉल करके FirebaseAnalytics ऑब्जेक्ट शुरू करें.

class MyApp extends StatelessWidget {
 static FirebaseAnalytics analytics = FirebaseAnalytics();
   ...
}

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

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

अगर आपको Flutter ऐप्लिकेशन में नया टेंप्लेट जनरेट करना है, तो आपको डिफ़ॉल्ट State क्लास में _counter वैरिएबल और _incrementCounter() मेथड दिखेगा. अब, जब बहुत ज़्यादा उत्साही उपयोगकर्ताओं ने 'बढ़ोतरी' बटन पर पांच से ज़्यादा बार क्लिक किया हो, तब कस्टम इवेंट लॉग करने के लिए. बाद में, हम संभावित उत्साही उपयोगकर्ताओं को आकर्षित करने के लिए एक ऐप्लिकेशन कैंपेन लॉन्च करेंगे

सबसे पहले, हम उन ऐनलिटिक्स ऑब्जेक्ट को पास करना चाहते हैं जिन्हें हमने Stateful विजेट में शुरू किया है. हम MyHomePage कंस्ट्रक्टर में Analytics पैरामीटर जोड़कर शुरुआत करते हैं.

MyHomePage({Key key, this.title, this.analytics}) : super(key: key);

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

home: MyHomePage(
   title: 'Flutter Demo Home Page',
   analytics: analytics,
),

अब logEvent() तरीके से इवेंट को आसानी से लॉग किया जा सकता है. तरीका जोड़ें और _counter वैरिएबल की वैल्यू बढ़ाएं.

void _incrementCounter() {
 setState(() {
   _counter++;

   //add this
   if(_counter > 5) { 
     widget.analytics.logEvent(name: "clicked_counter"); 
   }

 });
}

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

इवेंट ट्रिगर करने के लिए, पहले से बने तरीकों का भी इस्तेमाल किया जा सकता है.

f0742c956977df1d.png

अब सब कुछ तैयार है. अपने Android Studio में, "main.dart" चलाएं.

(ज़रूरी नहीं) पैरामीटर का इस्तेमाल करके Firebase Analytics को ज़्यादा जानकारी भेजना

पैरामीटर का इस्तेमाल करके, ज़्यादा जानकारी भेजी जा सकती है. कस्टम पैरामीटर आपकी Analytics रिपोर्ट में रिपोर्टिंग के लिए रजिस्टर किए जा सकते हैं. ऑडियंस की परिभाषाओं में फ़िल्टर के तौर पर भी इनका इस्तेमाल किया जा सकता है. इन्हें हर रिपोर्ट पर लागू किया जा सकता है. अगर आपका ऐप्लिकेशन किसी BigQuery प्रोजेक्ट से लिंक है, तो BigQuery में कस्टम पैरामीटर भी मिलते हैं. Firebase के लिए BigQuery Export देखें.

हम यहां _counter वैल्यू को पैरामीटर के तौर पर सेट कर रहे हैं.

void _incrementCounter() {
 setState(() {
   _counter++;

   if(_counter > 5) {
     widget.analytics.logEvent(name: "clicked_counter", parameters: {'count' : _counter});
   }
 });
}

इवेंट की जांच करना और उन्हें डीबग करना

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

32b01a1412ab2ba5.png

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

e6b420a73db88f03.png

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

डीबग करने के लिए, Firebase DebugView का इस्तेमाल करें. ज़्यादा जानकारी के लिए, डीबग करने का इवेंट देखें.

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

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

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

b711bf2e94fa0895.png

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

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

Google Ads पर जाएं.

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

73cec8d2e80eab03.png

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

4b1d8f6a712b2ac6.png

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

ba1bbe6b2924fac8.png

  1. कार्रवाई की जांच करें, इंपोर्ट करें पर क्लिक करें. इसके बाद,जारी रखें पर क्लिक करें.

ab35e341dff32e48.png

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

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

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

af98c44d1476558.png

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

885956ad00592eb3.png

  1. अपने कैंपेन की सेटिंग पूरी करें.

9. बधाई हो

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

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

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