Google Ads में 'Firebase के लिए Google Analytics' के कस्टम इवेंट - Unity

1. परिचय

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

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

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

इस कोडलैब में, आपको ऐप्लिकेशन कारोबार की पूरी प्रोसेस के बारे में जानकारी मिलेगी. साथ ही, आपको यह भी पता चलेगा कि हमारे क्लाइंट को किन समस्याओं का सामना करना पड़ता है. अगर आपको iOS पर Firebase और AdMob के बारे में बुनियादी जानकारी चाहिए, तो AdMob+Firebase 101 Unity: Setup & Analytics Basics से शुरुआत करें.

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

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

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

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

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

एक सामान्य टेंप्लेट वाला Unity ऐप्लिकेशन बनाएं. इस सामान्य ऐप्लिकेशन में बदलाव करके, पूरा ऐप्लिकेशन बनाया जा सकता है.

Unity लॉन्च करें

  1. अगर आपके पास कोई प्रोजेक्ट खुला हुआ नहीं है, तो नया प्रोजेक्ट बनाएं चुनें.
  2. डायलॉग बॉक्स से 3D टेंप्लेट चुनें.
  3. प्रोजेक्ट का नाम डालें. उदाहरण के लिए, Unity Firebase Custom Event.
  4. प्रोजेक्ट सेव करने के लिए कोई जगह चुनें और बनाएं पर क्लिक करें.
  5. Unity, आपके नए प्रोजेक्ट को वर्कस्पेस विंडो में खोलता है.

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

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

अगर आपके पास कोई ऐसा मौजूदा Firebase प्रोजेक्ट है जिसमें Google Analytics चालू नहीं है, तो सेटिंग > प्रोजेक्ट सेटिंग के इंटिग्रेशन टैब से Google Analytics को चालू किया जा सकता है. Firebase कॉन्फ़िगरेशन के चरण पर जाएं.

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

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

d9519856fc3b4bd0.png

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

e58151a081f0628.png

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

4. Unity कॉन्फ़िगरेशन

  1. Unity > File > Build Settings में. इसमें iOS बंडल आईडी सेट करना ज़रूरी है. यह आईडी आपको यहां दिए गए तरीके से मिलेगा.

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

7dbfc36bef1d035c.png

  1. iOS ऐप्लिकेशन के लिए अपने Unity प्रोजेक्ट में, Build Settings डायलॉग खोलें. इसके लिए, File > Build Settings पर जाएं. अगर प्लैटफ़ॉर्म को iOS पर सेट नहीं किया गया है, तो iOS प्लैटफ़ॉर्म को चुनें और Switch Platform बटन पर क्लिक करें

8be5416883a70def.png

  1. प्लैटफ़ॉर्म बदलने के बाद, बंडल आईडी सेट करने के लिए, प्लेयर सेटिंग बटन पर क्लिक करें. आपको पहचान सेक्शन के आस-पास टेक्स्ट फ़ील्ड दिखेगा.
  2. बंडल आइडेंटिफ़ायर फ़ील्ड की वैल्यू, iOS बंडल आईडी होती है. यह com.yourcompany.yourproject की तरह होती है. इस वैल्यू को कॉपी करें या अपनी वैल्यू सेट करके उसे कॉपी करें.
  3. Firebase डायलॉग में, कॉपी किए गए बंडल आईडी को iOS bundle ID फ़ील्ड में चिपकाएं.
  4. ऐप्लिकेशन रजिस्टर करें पर क्लिक करें.
  5. Firebase में जारी रखने के लिए, कॉन्फ़िगरेशन फ़ाइल डाउनलोड करने से जुड़े निर्देशों का पालन करें GoogleService-Info.plist
  6. अपने यूनिटी प्रोजेक्ट की प्रोजेक्ट विंडो खोलें. इसके बाद, अपनी कॉन्फ़िगरेशन फ़ाइलें ऐसेट फ़ोल्डर में ले जाएं.
  7. बाकी चरणों को छोड़ें और Firebase कंसोल के मुख्य पेज पर वापस जाएं.

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

इस चरण में, आपको अपने Unity प्रोजेक्ट में Firebase SDK टूल जोड़ना होगा.

  1. Firebase कंसोल पर जाएं.
  2. सेटअप वर्कफ़्लो लॉन्च करने के लिए, प्रोजेक्ट की खास जानकारी वाले पेज के बीच में मौजूद Unity आइकॉन ( 8c8fc0e0e05dc749.png) पर क्लिक करें. अगर आपने पहले से ही अपने Firebase प्रोजेक्ट में कोई ऐप्लिकेशन जोड़ा है, तो प्लैटफ़ॉर्म के विकल्प देखने के लिए, ऐप्लिकेशन जोड़ें पर क्लिक करें.
  3. अपने Unity प्रोजेक्ट का वह बिल्ड टारगेट चुनें जिसे आपको रजिस्टर करना है. इसके अलावा, आपके पास दोनों टारगेट को एक साथ रजिस्टर करने का विकल्प भी है.
  1. अपने Unity प्रोजेक्ट के प्लैटफ़ॉर्म के हिसाब से आईडी डालें.
  • iOS के लिए — iOS बंडल आईडी फ़ील्ड में, अपने Unity प्रोजेक्ट का iOS आईडी डालें.
  • Android के लिए — Android पैकेज का नाम फ़ील्ड में, अपने Unity प्रोजेक्ट का Android आईडी डालें. पैकेज का नाम और ऐप्लिकेशन आईडी शब्दों का इस्तेमाल अक्सर एक-दूसरे की जगह किया जाता है.
  1. आपको अपने Unity प्रोजेक्ट का आईडी कहां मिलता है?
  1. (ज़रूरी नहीं) अपने Unity प्रोजेक्ट के प्लैटफ़ॉर्म के हिसाब से निकनेम डालें. ये निकनेम इंटरनल होते हैं. ये सिर्फ़ आपको Firebase कंसोल में दिखते हैं.
  2. ऐप्लिकेशन रजिस्टर करें पर क्लिक करें.

Firebase Analytics Unity SDK टूल जोड़ना

  1. Firebase कंसोल में, Firebase Unity SDK डाउनलोड करें पर क्लिक करें. इसके बाद, SDK को किसी सुविधाजनक जगह पर अनज़िप करें.
  • आपके पास Firebase Unity SDK को कभी भी फिर से डाउनलोड करने का विकल्प होता है.
  • Firebase Unity SDK, प्लैटफ़ॉर्म के हिसाब से नहीं होता है.
  1. खुले हुए यूनिटी प्रोजेक्ट में, ऐसेट > पैकेज इंपोर्ट करें > कस्टम पैकेज पर जाएं.
  2. अनज़िप किए गए SDK टूल से, Firebase के वे प्रॉडक्ट चुनें जिन्हें आपको अपने ऐप्लिकेशन में इस्तेमाल करना है.
  • Google Analytics के लिए Firebase पैकेज जोड़ें: FirebaseAnalytics.unitypackage
  • अपने ऐप्लिकेशन में इस्तेमाल किए जाने वाले अन्य Firebase प्रॉडक्ट के पैकेज जोड़ें. उदाहरण के लिए, Firebase Authentication और Firebase Realtime Database का इस्तेमाल करने के लिए: FirebaseAuth.unitypackage और FirebaseDatabase.unitypackage
  1. Import Unity Package विंडो में, Import पर क्लिक करें.
  2. Firebase कंसोल में वापस जाकर, सेटअप वर्कफ़्लो में आगे बढ़ें पर क्लिक करें.

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

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

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

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

FirebaseApp इंस्टेंस को कॉन्फ़िगर करने के बाद, logEvent() तरीके का इस्तेमाल करके इवेंट लॉग किए जा सकते हैं.

Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);

Xcode डीबग कंसोल में इवेंट देखना

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

Verbose logging को इस तरह चालू किया जा सकता है:

  1. Xcode में, Product > Scheme > Edit scheme... को चुनें
  2. बाईं ओर मौजूद मेन्यू से, Run को चुनें.
  3. Arguments टैब चुनें.
  4. Arguments Passed On Launch सेक्शन में, -FIRAnalyticsDebugEnabled जोड़ें.

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

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

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

286b640ed4646163.png

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

a933a338990cba3a.png

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

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

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

  1. 'इंपोर्ट करें और जारी रखें' बटन पर क्लिक करें.

ab35e341dff32e48.png

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

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

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

af98c44d1476558.png

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

a1f145794f949109.png

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

9. बधाई हो

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

आपने सीखा

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

रेफ़रंस दस्तावेज़