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

1. परिचय

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

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

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

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

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

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

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

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

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

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

Unity लॉन्च करें

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

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

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

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

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

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

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

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

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

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

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

2. iOS ऐप्लिकेशन के लिए अपने Unity प्रोजेक्ट में, बिल्ड सेटिंग डायलॉग खोलें, फ़ाइल > बिल्ड सेटिंग (अगर प्लैटफ़ॉर्म, iOS पर सेट नहीं है, तो iOS प्लैटफ़ॉर्म चुनें. इसके बाद, प्लैटफ़ॉर्म स्विच करें बटन पर क्लिक करें)

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

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

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

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

ध्यान दें: अगर अभी अपने Unity प्रोजेक्ट का सिर्फ़ एक बिल्ड टारगेट रजिस्टर किया जाता है, तो दूसरे बिल्ड टारगेट को रजिस्टर करने के लिए बाद में कभी भी सेटअप वर्कफ़्लो पर वापस जाया जा सकता है.

4. अपने Unity प्रोजेक्ट के प्लैटफ़ॉर्म के लिए खास आईडी डालें.

• iOS के लिए — iOS बंडल आईडी फ़ील्ड में, अपने Unity प्रोजेक्ट का iOS आईडी डालें.
• Android के लिए — Android पैकेज का नाम फ़ील्ड में, अपने Unity प्रोजेक्ट का Android आईडी डालें. पैकेज का नाम और ऐप्लिकेशन आईडी शब्दों का इस्तेमाल, अक्सर एक-दूसरे की जगह पर किया जाता है.

5. आपको अपने Unity प्रोजेक्ट का आईडी कहां मिलता है?

ध्यान दें: पक्का करें कि आपने वही आईडी डाला है जिसका इस्तेमाल आपके प्रोजेक्ट में किया जा रहा है. आईडी की वैल्यू केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होती है. आपके Firebase प्रोजेक्ट के साथ रजिस्टर होने के बाद, इन Firebase ऐप्लिकेशन के लिए इसे बदला नहीं जा सकता.

6. (ज़रूरी नहीं) अपने Unity प्रोजेक्ट के लिए प्लैटफ़ॉर्म के हिसाब से कोई दूसरा नाम डालें. ये निकनेम, अंदरूनी और सुविधा आइडेंटिफ़ायर की तरह हैं. साथ ही, ये सिर्फ़ Firebase कंसोल में आपको दिखते हैं.
7. ऐप्लिकेशन रजिस्टर करें पर क्लिक करें.

Firebase Analytics यूनिटी SDK टूल जोड़ना

1. Firebase कंसोल में, Firebase Unity SDK टूल डाउनलोड करें पर क्लिक करें. इसके बाद, SDK टूल को किसी दूसरी जगह अनज़िप करें.

• Firebase Unity SDK टूल को किसी भी समय फिर से डाउनलोड किया जा सकता है.
• Firebase यूनिटी SDK टूल, प्लैटफ़ॉर्म के हिसाब से नहीं होता.

2. अपने खुले हुए Unity प्रोजेक्ट में, ऐसेट पर जाएं > पैकेज इंपोर्ट करें > कस्टम पैकेज.
3. ज़िप नहीं किए गए SDK टूल से, काम करने वाले वे Firebase प्रॉडक्ट चुनें जिन्हें आपको अपने ऐप्लिकेशन में इस्तेमाल करना है.

• Google Analytics के लिए Firebase पैकेज जोड़ें: FirebaseAnalytics.unitypackage
• आपको जिन Firebase प्रॉडक्ट का इस्तेमाल अपने ऐप्लिकेशन में करना है उनके लिए पैकेज जोड़ें. उदाहरण के लिए, Firebase से पुष्टि और Firebase रीयल टाइम डेटाबेस का इस्तेमाल करने के लिए: FirebaseAuth.unitypackage और FirebaseDatabase.unitypackage

Unity 5.x और इससे पहले का वर्शन, .NET 3.x फ़्रेमवर्क का इस्तेमाल करता है. इसलिए, dotnet3/ पैकेज इंपोर्ट करें. Unity 2017.x और इसके बाद के वर्शन, .NET 4.x फ़्रेमवर्क का इस्तेमाल करने की अनुमति देते हैं. अगर आपके Unity प्रोजेक्ट में .NET 4.x का इस्तेमाल किया गया है, तो dotnet4/ पैकेज इंपोर्ट करें. Unity 2019 और इसके बाद के वर्शन पर अब .NET 3.x फ़्रेमवर्क काम नहीं करता. इसलिए, dotnet4/ पैकेज इंपोर्ट करें.

4. Unity पैकेज को इंपोर्ट करें विंडो में, इंपोर्ट करें पर क्लिक करें.
5. Firebase कंसोल पर वापस जाएं और सेटअप वर्कफ़्लो में, आगे बढ़ें पर क्लिक करें.

अहम जानकारी: iOS के लिए Firebase यूनिटी SDK टूल का इस्तेमाल करके, स्विज़लिंग के तरीके को बंद न करें. SDK टूल के लिए स्विज़लिंग ज़रूरी है; इसके बिना, Firebase की मुख्य सुविधाएं (जैसे कि FCM टोकन हैंडलिंग) ठीक से काम नहीं करती हैं.

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

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

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

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

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

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

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

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

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

1. Xcode में, प्रॉडक्ट > स्कीम > स्कीम में बदलाव करें...
2. बाईं ओर दिए गए मेन्यू में जाकर, Run चुनें.
3. आर्ग्युमेंट टैब चुनें.
4. लॉन्च करने पर पास किए गए आर्ग्युमेंट सेक्शन में, -FIRAnalyticsDebugEnabled जोड़ें.

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

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

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

‘text_search’ को मार्क किया जाएगा ‘कन्वर्ज़न के रूप में मार्क करें’ को स्लाइड करके कन्वर्ज़न के तौर पर सेट करते हैं दाएं स्विच करें.

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

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

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

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

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

चेतावनी: अगर टारगेट इवेंट को कन्वर्ज़न के तौर पर मार्क नहीं किया गया है, तो Google Ads उसे इंपोर्ट नहीं कर पाएगा. पक्का करें कि इवेंट को कन्वर्ज़न के तौर पर सही तरीके से मार्क किया गया हो.

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

अब Google Ads पर जाएं और लॉगिन करें.

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

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

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

5. इंपोर्ट करें और जारी रखें बटन की जांच करें और उस पर क्लिक करें.

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

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

अहम जानकारी: किसी ऐप्लिकेशन कैंपेन को लॉन्च करने के लिए, आपके पास Google Play में प्रोडक्शन लेवल का ऐप्लिकेशन होना चाहिए. अगर आप ऐप्लिकेशन को पब्लिश करने के लिए तैयार नहीं हैं, तो फ़िलहाल इस चरण को छोड़ दें.

6. अपने वर्तमान खाते के अभियान टैब पर जाएं और + बटन पर क्लिक करके एक नया अभियान शुरू करें. नए कैंपेन पर क्लिक करें और जारी रखें.
7. इस समय, हम ऐप्लिकेशन इंस्टॉल के विकल्प के साथ एक ऐप्लिकेशन प्रमोशन कैंपेन लॉन्च करेंगे.

8. ऐप्लिकेशन का नाम, पैकेज का नाम या पब्लिशर की जानकारी देकर, अपना ऐप्लिकेशन ढूंढें.
9. कार्रवाइयों पर फ़ोकस करने के लिए, बिडिंग सेक्शन में Google Ads के लिए ड्रॉपबॉक्स में इन-ऐप्लिकेशन कार्रवाइयां चुनें.
10. दी गई सूची में, अपने कस्टम इवेंट देखे जा सकते हैं. हर ऐक्शन के लिए खर्च का टारगेट सेट करें और दूसरे विकल्प भी भरें.

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

9. बधाई हो

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

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

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

पहचान फ़ाइलें

• अपने Unity प्रोजेक्ट में Firebase जोड़ना
• GitHub: Firebase/क्विकस्टार्ट-यूनिटी