शुरू करना

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

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

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

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

  • Unity Editor 2019.4 या इसके बाद के वर्शन का इस्तेमाल करना
  • iOS पर डिप्लॉय करने के लिए
    • Xcode 16.0 या इसके बाद का वर्शन
    • iOS 12.0 या इसके बाद के वर्शन को टारगेट करना होगा
    • CocoaPods
  • Android पर ऐप्लिकेशन को डिप्लॉय करने के लिए
    • Android का एपीआई लेवल 23 या उसके बाद का वर्शन
    • Android के एपीआई लेवल 34 या इसके बाद के वर्शन को टारगेट करना होगा

Android API लेवल, प्रोजेक्ट सेटिंग > प्लेयर > Android > अन्य सेटिंग > अन्य सेटिंग में सेट किया जाता है.

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

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. Package Manager विंडो में, 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 मेन्यू विकल्प ऐसेट > पैकेज इंपोर्ट करें > कस्टम पैकेज को चुनें. इसके बाद, सभी आइटम इंपोर्ट करें.

बाहरी डिपेंडेंसी शामिल करना

Google Mobile Ads Unity प्लगिन, Unity Play Services Resolver library के साथ डिस्ट्रिब्यूट किया जाता है. इस लाइब्रेरी का इस्तेमाल, Android के लिए बने किसी भी ऐसे Unity प्लगिन के साथ किया जा सकता है जिसे Android के लिए बनी लाइब्रेरी, जैसे कि AAR या iOS CocoaPods को ऐक्सेस करने की ज़रूरत होती है. इससे Unity प्लगिन को डिपेंडेंसी के बारे में बताने की सुविधा मिलती है. इसके बाद, ये डिपेंडेंसी अपने-आप हल हो जाती हैं और आपके Unity प्रोजेक्ट में कॉपी हो जाती हैं.

यह पक्का करने के लिए कि आपके प्रोजेक्ट में सभी डिपेंडेंसी शामिल हैं, यह तरीका अपनाएं:

Android

प्रोजेक्ट सेटिंग > प्लेयर > Android > पब्लिश करने की सेटिंग > बिल्ड करें पर जाएं और यह चुनें:

  • कस्टम मेन ग्रैडल टेंप्लेट
  • कस्टम Gradle प्रॉपर्टी टेंप्लेट

Unity एडिटर में, Assets > External Dependency Manager > Android Resolver > Resolve चुनें. इससे Unity External Dependency Manager लाइब्रेरी, बताई गई डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी कर देगी.

iOS

iOS के लिए Unity, CocoaPods का इस्तेमाल करके डिपेंडेंसी की पहचान करता है और उन्हें मैनेज करता है. अपनी iOS डिपेंडेंसी से जुड़ी खास ज़रूरी शर्तों या समस्या हल करने के तरीके जानने के लिए, CocoaPods के दस्तावेज़ देखें.

Google Mobile Ads Unity प्लगिन की डिपेंडेंसी की सूची Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml में दी गई है.

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

Unity Editor में, मेन्यू से Assets > Google Mobile Ads > Settings चुनें.

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

एसडीके टूल को शुरू करना

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

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

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

कोई विज्ञापन फ़ॉर्मैट चुनें

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

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

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

मध्यवर्ती

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

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

मूल भाषा वाला

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

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

इनाम दिया गया

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

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

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

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

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

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

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

ऐप्लिकेशन खोलने पर दिखने वाला विज्ञापन

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

ऐप्लिकेशन खोलने पर दिखने वाले विज्ञापन लागू करना