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

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

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

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

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

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

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

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 मेन्यू का विकल्प चुनें बदलाव करें > प्रोजेक्ट सेटिंग > पैकेज मैनेजर.

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

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

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

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

   

5. पैकेज की सूची से, Unity के लिए Google Mobile Ads पैकेज चुनें और इंस्टॉल करें दबाएं.

.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. सबसे हाल ही में रिलीज़ किए गए वर्शन का टैग फ़ेच करें. v प्रीफ़िक्स को छोड़कर, वापस किया गया टैग Google Mobile Ads Unity Plugin वर्शन है.

   • macOS और Linux

     curl -sS https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest | jq -r '.tag_name'

   • Windows PowerShell

     (Invoke-RestMethod -Uri "https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest").tag_name
     

2. Packages/manifest.json फ़ाइल में बदलाव करें, ताकि OpenUPM स्कोप्ड रजिस्ट्री और डिपेंडेंसी को जोड़ा जा सके. इसके लिए, पिछले निर्देश से मिले वर्शन का इस्तेमाल करें:

   {
     "scopedRegistries": [
       {
         "name": "google",
         "url": "https://package.openupm.com",
         "scopes": [
           "com.google"
         ]
       }
     ],
     "dependencies": {
       "com.google.ads.mobile": "11.6.0"
     }
   }
   

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

ज़रूरी नहीं: External Dependency Manager को बंद करना

अगर Android और iOS लाइब्रेरी को अपने बिल्ड टूल से मैनेज किया जाता है, तो com.unity.external-dependency-manager पैकेज को बंद किया जा सकता है:

Unity Editor में, Window > Package Manager को चुनें और External Dependency Manager (com.unity.external-dependency-manager) पैकेज को हटाएं. इस पैकेज को हटाने से, Assets > Google Mobile Ads > Settings में जाकर, Enable External Dependency Manager को अनचेक कर दिया जाता है.

ध्यान दें: GoogleMobileAdsSettings.asset फ़ाइल को मिटाने से, आपकी सेटिंग रीसेट हो जाती हैं. साथ ही, अगली बार इंपोर्ट करने या Editor लोड करने पर, com.unity.external-dependency-manager पैकेज फिर से इंस्टॉल हो जाता है. पैकेज को बाद में फिर से इंस्टॉल करने के लिए, ऐसेट > Google Mobile Ads > सेटिंग को चुनें. इसके बाद, एक्सटर्नल डिपेंडेंसी मैनेजर चालू करें को चुनें.

लेगसी External Dependency Manager इंस्टॉल करना

अगर आपका प्रोजेक्ट Unity 2022.2 या इससे पहले के वर्शन का इस्तेमाल करता है, तो Unity के पैकेज को बंद करने के बाद, Google का लेगसी com.google.external-dependency-manager पैकेज इंस्टॉल किया जा सकता है:

• External Dependency Manager for Unity के रिलीज़ पेज से, सबसे नई .unitypackage फ़ाइल डाउनलोड करें. इसके बाद, Assets > Import Package > Custom Package को चुनें.

• यहां दिया गया OpenUPM CLI कमांड चलाएं:

  openupm add com.google.external-dependency-manager

नेटिव डिपेंडेंसी को मैन्युअल तरीके से कॉन्फ़िगर करना

अगर आपने External Dependency Manager पैकेज का इस्तेमाल नहीं किया है, तो Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml और Assets/GoogleMobileAds/Editor/GoogleUmpDependencies.xml फ़ाइलों से ज़रूरी लाइब्रेरी को अपनी बिल्ड फ़ाइलों में जोड़ें:

• Android के लिए, Edit > प्रोजेक्ट सेटिंग > Player > Android > Publishing Settings > Build को चुनें. इसके बाद, Custom Main Gradle Template को चालू करें. GoogleMobileAdsDependencies.xml और GoogleUmpDependencies.xml फ़ाइलों से ज़रूरी लाइब्रेरी को Assets/Plugins/Android/mainTemplate.gradle फ़ाइल में मौजूद dependencies ब्लॉक में जोड़ें:

  implementation 'com.google.android.gms:play-services-ads:25.5.0'
  implementation 'com.google.android.ump:user-messaging-platform:4.0.0'
  

  GoogleMobileAdsDependencies.xml फ़ाइल में मौजूद वर्शन का इस्तेमाल करके, androidx.constraintlayout:constraintlayout, androidx.lifecycle:lifecycle-process, और androidx.fragment:fragment पैकेज भी जोड़ें.

• iOS के लिए, अपना Xcode प्रोजेक्ट एक्सपोर्ट करें. एक्सपोर्ट किए गए प्रोजेक्ट फ़ोल्डर में मौजूद Podfile फ़ाइल में, GoogleMobileAdsDependencies.xml और GoogleUmpDependencies.xml फ़ाइलों से ज़रूरी पॉड जोड़ें:

  pod 'Google-Mobile-Ads-SDK'
  pod 'GoogleUserMessagingPlatform'
  

  इसके बाद, एक्सपोर्ट किए गए iOS प्रोजेक्ट फ़ोल्डर में यह कमांड चलाएं:

  pod install --repo-update

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

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

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

Google Mobile Ads Unity Plugin इन सेटिंग को Assets/GoogleMobileAds/Resources/GoogleMobileAdsSettings.asset कॉन्फ़िगरेशन फ़ाइल में टेक्स्ट के तौर पर सेव करता है.

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

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

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

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects on the main thread here.
    });
});
GoogleMobileAdsController.cs

मुख्य थ्रेड पर Unity ऑब्जेक्ट के साथ इंटरैक्ट करना

Google Mobile Ads Unity Plugin, बैकग्राउंड थ्रेड पर विज्ञापन इवेंट को ट्रिगर करता है. अगर विज्ञापन कॉलबैक, UnityEngine जैसे Unity ऑब्जेक्ट के साथ इंटरैक्ट करते हैं, तो MobileAdsEventExecutor.ExecuteInUpdate तरीके का इस्तेमाल करके, Unity के मुख्य थ्रेड पर उस काम को साफ़ तौर पर शेड्यूल करें. लागू करने के बारे में ज़्यादा जानकारी के लिए, Unity के मुख्य थ्रेड पर विज्ञापन इवेंट ट्रिगर करना लेख पढ़ें.

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

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

बैनर

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

बैनर विज्ञापनों का इस्तेमाल करना

मध्यवर्ती

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

अचानक दिखने वाले (इंटरस्टीशियल) विज्ञापनों का इस्तेमाल करना

मूल भाषा वाला

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

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

इनाम दिया गया

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

इनाम वाले विज्ञापन दिखाना