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

1. परिचय

पिछले अपडेट की तारीख: 25-01-2021

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

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

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

bdbf1fc3cbf49ac7.png

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

  • Flutter में GA4F (Google Analytics for Firebase) को कैसे शुरू करें
  • कस्टम इवेंट और पैरामीटर बनाने का तरीका
  • 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 टूल के पाथ में, एसडीके टूल की लोकेशन दी गई हो. (अगर टेक्स्ट फ़ील्ड खाली है, तो एसडीके इंस्टॉल करें को चुनें.)
  4. प्रोजेक्ट का नाम डालें और आगे बढ़ें पर क्लिक करें.
  5. Android Studio की ओर से सुझाए गए डिफ़ॉल्ट पैकेज के नाम का इस्तेमाल करें. इसके बाद, आगे बढ़ें पर क्लिक करें.
  6. पूरा करें पर क्लिक करें.
  7. Android Studio को एसडीके इंस्टॉल करने और प्रोजेक्ट बनाने के लिए इंतज़ार करें.

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. आखिर में, आपको Google Services Gradle plugin की ज़रूरत होगी. इससे Firebase से जनरेट हुई google-services.json फ़ाइल को पढ़ा जा सकता है.
  4. अपने आईडीई या एडिटर में, 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 के लिए, इस कोडलैब ( Firebase for Flutter के बारे में जानें) को देखें

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 देखते समय, Packages get पर क्लिक करें. इससे पैकेज को आपके प्रोजेक्ट में शामिल कर दिया जाता है. आपको कंसोल में यह दिखेगा:

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() तरीका दिखेगा. अब आपको उन उपयोगकर्ताओं के लिए कस्टम इवेंट लॉग करने हैं जो उत्साह में आकर, इंक्रीमेंट बटन पर पांच से ज़्यादा बार क्लिक करते हैं. बाद में, हम दिलचस्पी रखने वाले संभावित उपयोगकर्ताओं का ध्यान खींचने के लिए, ऐप्लिकेशन कैंपेन लॉन्च करेंगे

सबसे पहले, हमें उन Analytics ऑब्जेक्ट को 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 में Analytics इवेंट इंपोर्ट करना

Firebase-Flutter सेटअप पूरा होने के बाद, ऐक्शन इवेंट के साथ ऐप्लिकेशन कैंपेन लॉन्च किए जा सकते हैं. सबसे पहले, Firebase को Google Ads से लिंक करें. Firebase को Google Ads से लिंक करने पर,ऐप्लिकेशन कैंपेन Firebase इवेंट इंपोर्ट कर सकते हैं. इस प्रोसेस से, Google Ads को ऐप्लिकेशन कैंपेन की परफ़ॉर्मेंस को बेहतर बनाने में भी मदद मिलती है. ऐसा इसलिए, क्योंकि इससे 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. अपने मौजूदा खाते के कैंपेन टैब पर जाएं और + बटन पर क्लिक करके, नया कैंपेन शुरू करें. [नया कैंपेन] पर क्लिक करें. इसके बाद, जारी रखें पर क्लिक करें.
  2. ऐप्लिकेशन इंस्टॉल विकल्प का इस्तेमाल करके, ऐप्लिकेशन का प्रमोशन करने वाला कैंपेन लॉन्च करें.

af98c44d1476558.png

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

885956ad00592eb3.png

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

9. बधाई हो

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

आपने सीखा

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