Google Mobile Ads Unity प्लगिन सेट अप करना

प्लैटफ़ॉर्म चुनें: Android Android iOS Unity Flutter

Google Mobile Ads Unity प्लगिन की मदद से, Unity के डेवलपर, Android और iOS ऐप्लिकेशन पर Google के मोबाइल विज्ञापन दिखा सकते हैं. इसके लिए, उन्हें Java या Objective-C कोड लिखने की ज़रूरत नहीं होती. यह प्लगिन, विज्ञापन का अनुरोध करने के लिए C# इंटरफ़ेस उपलब्ध कराता है. इसका इस्तेमाल, आपके Unity प्रोजेक्ट में C# स्क्रिप्ट से किया जाता है.

यह गाइड उन पब्लिशर के लिए है जो Unity ऐप्लिकेशन से कमाई करना चाहते हैं.

ज़रूरी शर्तें

• Unity Editor 2019.4 या इसके बाद के वर्शन का इस्तेमाल करें.
  • हम 2022.2 या इसके बाद के वर्शन का इस्तेमाल करने का सुझाव देते हैं.
• iOS पर डिप्लॉय करने के लिए
  • Xcode 16.0 या इसके बाद का वर्शन
  • iOS 13.3 या इसके बाद के वर्शन को टारगेट करें
  • CocoaPods
• Android पर डिप्लॉय करने के लिए
  • Android का एपीआई लेवल 23 या इसके बाद का वर्शन
  • Android का एपीआई लेवल 35 या इसके बाद के वर्शन को टारगेट करें

• सुझाव: AdMob खाता बनाएं और Android या iOS ऐप्लिकेशन रजिस्टर करें

Android का एपीआई लेवल, Project Settings > Player > Android > Other Settings > Other Settings में सेट किया जाता है.

Unity के लिए Mobile Ads प्लगिन इंपोर्ट करना

OpenUPM-CLI

अगर आपने OpenUPM CLI इंस्टॉल किया है, तो OpenUPM रजिस्ट्री को इस कमांड से इंस्टॉल किया जा सकता है:

openupm add com.google.ads.mobile

.unitypackage प्लगिन की ऐसेट हटाना

अगर .unitypackage का इस्तेमाल करने के बजाय OpenUPM का इस्तेमाल किया जा रहा है, तो आपको पुरानी जगह से ऐसेट को मैन्युअल तरीके से अनइंस्टॉल करना होगा. .unitypackage से इंपोर्ट की गई इन डायरेक्ट्री को हटाएं:

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

1. पैकेज मैनेजर की सेटिंग खोलने के लिए, Unity मेन्यू में Edit > Project Settings > Package Manager विकल्प चुनें.

2. पैकेज मैनेजर विंडो में, OpenUPM को ऐसी रजिस्ट्री के तौर पर जोड़ें जो उसके स्कोप में हो:

   Name: OpenUPM
   URL: https://package.openupm.com
   Scopes: com.google
   

3. पैकेज मैनेजर मेन्यू खोलने के लिए, Unity मेन्यू में Window > Package Manager विकल्प चुनें.

4. मैनेजर स्कोप ड्रॉप-डाउन को सेट करके, मेरी रजिस्ट्री चुनें.

   

5. पैकेज की सूची से, Google Mobile Ads for Unity पैकेज चुनें और Install दबाएं.

.unitypackage प्लगिन की ऐसेट हटाना

अगर .unitypackage का इस्तेमाल करने के बजाय OpenUPM का इस्तेमाल किया जा रहा है, तो आपको पुरानी जगह से ऐसेट को मैन्युअल तरीके से अनइंस्टॉल करना होगा. .unitypackage से इंपोर्ट की गई इन डायरेक्ट्री को हटाएं:

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

GitHub से इंपोर्ट करना

1. GitHub से .unitypackage का सबसे नया वर्शन डाउनलोड करें.
2. .unitypackage फ़ाइल को इंपोर्ट करने के लिए, Unity मेन्यू का विकल्प चुनें Assets > Import package > Custom Package और सभी आइटम इंपोर्ट करें.

AdMob ऐप्लिकेशन आईडी सेट करना

Unity एडिटर में, मेन्यू से Assets > Google Mobile Ads > Settings चुनें.

हर फ़ील्ड में, Android और iOS AdMob ऐप्लिकेशन आईडी डालें.

SDK टूल को शुरू करना

विज्ञापन लोड करने से पहले, अपने ऐप्लिकेशन में Google Mobile Ads Unity Plugin को शुरू करें. इसके लिए, को कॉल करें.MobileAds.Initialize() इसे सिर्फ़ एक बार करना होता है. हमारा सुझाव है कि इसे ऐप्लिकेशन लॉन्च होने पर करें.

चेतावनी: Google Mobile Ads Unity Plugin या मीडिएशन पार्टनर के SDK टूल, MobileAds.Initialize() को कॉल करने पर विज्ञापन पहले से लोड कर सकते हैं. अगर आपको यूरोपीय आर्थिक क्षेत्र (ईईए) के उपयोगकर्ताओं से अनुमति लेनी है, तो अनुरोध-विशिष्ट फ़्लैग सेट करें. जैसे, tagForChildDirectedTreatment या tag_for_under_age_of_consent. इसके अलावा, विज्ञापन लोड करने से पहले कोई कार्रवाई करें. Google Mobile Ads Unity प्लगिन को शुरू करने से पहले, पक्का करें कि आपने यह काम कर लिया हो.

Google Mobile Ads Unity Plugin

MobileAds.Initialize() को कॉल करने का तरीका यहां दिया गया है:

MobileAds.Initialize((InitializationStatus initstatus) =>
{
    if (initstatus == null)
    {
        Debug.LogError("Google Mobile Ads initialization failed.");
        return;
    }

    Debug.Log("Google Mobile Ads initialization complete.");

    // Google Mobile Ads events are raised off the Unity Main thread. If you need to
    // access UnityEngine objects after initialization,
    // use MobileAdsEventExecutor.ExecuteInUpdate(). For more information, see:
    // https://developers.google.com/admob/unity/global-settings#raise_ad_events_on_the_unity_main_thread
});
GoogleMobileAdsController.cs

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

विज्ञापन फ़ॉर्मैट चुनना

Google Mobile Ads Unity Plugin Android या iOS प्लैटफ़ॉर्म पर डिप्लॉय करने पर, अब आपके Unity ऐप्लिकेशन में शामिल है. अब विज्ञापन लागू किया जा सकता है. AdMob, अलग-अलग तरह के कई विज्ञापन फ़ॉर्मैट उपलब्ध कराता है. इसलिए, ऐसा फ़ॉर्मैट चुनें जिससे उपयोगकर्ताओं को बेहतर अनुभव मिले.

बैनर

बैनर विज्ञापन यूनिट, रेक्टैंगल के आकार वाले विज्ञापन दिखाती हैं. ये विज्ञापन, ऐप्लिकेशन के लेआउट का कुछ हिस्सा घेरते हैं. वे तय समय अवधि के बाद अपने-आप रीफ़्रेश हो सकते हैं. इसका मतलब है कि उपयोगकर्ताओं को समय-समय पर एक नया विज्ञापन दिखेगा, भले ही वे आपके ऐप्लिकेशन में एक ही स्क्रीन का इस्तेमाल करें. साथ ही, ये सबसे आसानी से लागू किए जा सकने वाले विज्ञापन फ़ॉर्मैट भी हैं.

बैनर विज्ञापन लागू करना

मध्यवर्ती

पेज पर अचानक दिखने वाली विज्ञापन यूनिट, आपके ऐप्लिकेशन में पूरे पेज को कवर करने वाले विज्ञापन दिखाती हैं. इन्हें अपने ऐप्लिकेशन के इंटरफ़ेस में इस तरह सेट करें कि वे तय समय और ट्रांज़िशन के दौरान दिखें. उदाहरण के लिए, किसी गेमिंग ऐप्लिकेशन में लेवल पूरा होने के बाद.

पेज पर अचानक दिखने वाले विज्ञापन लागू करना

मूल भाषा वाला

नेटिव विज्ञापन ऐसे विज्ञापन होते हैं जिनमें आपके पास, अपने ऐप्लिकेशन में हेडलाइन और कॉल-टू-ऐक्शन जैसी ऐसेट को दिखाने का तरीका तय करने का विकल्प होता है. विज्ञापन को खुद स्टाइल करके, ऐसे विज्ञापन बनाए जा सकते हैं जो स्वाभाविक तौर पर दिखते हैं और उपयोगकर्ताओं को परेशान नहीं करते. इससे, उपयोगकर्ताओं को बेहतर अनुभव मिलता है.

नेटिव विज्ञापन लागू करना

इनाम दिया गया

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

इनाम वाले विज्ञापन लागू करना

इनाम वाला इंटरस्टीशियल

इनाम वाले इंटरस्टीशियल विज्ञापन, नए तरह से तैयार किए गए विज्ञापन फ़ॉर्मैट हैं. इनकी मदद से, ऐप्लिकेशन में स्वाभाविक तौर पर हुए ट्रांज़िशन के दौरान दिखने वाले विज्ञापनों के लिए, सिक्के या खेलने के कुछ और मौके जैसे इनाम दिए जा सकते हैं.

उपयोगकर्ताओं को इनाम वाले इंटरस्टीशियल विज्ञापन देखने के लिए, ऑप्ट-इन करना ज़रूरी नहीं होता. इनाम वाले विज्ञापनों के लिए ऐसा करना ज़रूरी है.

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

इनाम वाले इंटरस्टीशियल विज्ञापन लागू करना

ऐप्लिकेशन काम कर रहा है

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

ऐप्लिकेशन काम कर रहा है विज्ञापन लागू करना