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 Unity SDK टूल, किसी खास प्लैटफ़ॉर्म के लिए नहीं है.

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

• Google Analytics के लिए Firebase पैकेज जोड़ें: FirebaseAnalytics.unitypackage
• अपने ऐप्लिकेशन में इस्तेमाल करने के लिए, Firebase के अन्य प्रॉडक्ट के पैकेज जोड़ें. उदाहरण के लिए, Firebase Authentication और Firebase Realtime Database का इस्तेमाल करने के लिए: 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 Unity 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 डीबग कंसोल में इवेंट देखें

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

ज़्यादा जानकारी वाली लॉगिंग को इस तरह चालू किया जा सकता है:

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

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

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

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

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

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

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

आपके 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/क्विकस्टार्ट-यूनिटी