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

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

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.0 या इसके बाद के वर्शन को टारगेट करें
    • CocoaPods
  • Android पर डिप्लॉय करने के लिए
    • Android का एपीआई लेवल कम से कम 23 या इसके बाद का वर्शन होना चाहिए
    • Android के एपीआई लेवल 35 या इसके बाद के वर्शन को टारगेट करें

Android का एपीआई लेवल, Project Settings > 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 मेन्यू में 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

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

    {
  "scopedRegistries": [
    {
      "name": "google",
      "url": "https://package.openupm.com",
      "scopes": [
        "com.google"
      ]
    }
  ],
  "dependencies": {
    "com.google.ads.mobile": "11.5.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 मेन्यू में Assets > Import package > Custom Package विकल्प चुनें और सभी आइटम इंपोर्ट करें.

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

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

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

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

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

विज्ञापन लोड करने से पहले, अपने ऐप्लिकेशन में Google Mobile Ads Unity Plugin को शुरू करें. इसके लिए, 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."); MobileAdsEventExecutor.ExecuteInUpdate(() => { // Interact with UnityEngine objects on the main thread here. }); });

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

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

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

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

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

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

मध्यवर्ती

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

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

मूल भाषा वाला

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

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

इनाम दिया गया

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

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

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

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

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

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

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

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

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

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