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 पैकेज चुनें और इंस्टॉल करें दबाएं.

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

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

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

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

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

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

विज्ञापन लोड करने से पहले, अपने ऐप्लिकेशन में 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, अलग-अलग तरह के कई विज्ञापन फ़ॉर्मैट ऑफ़र करता है. इसलिए, ऐसा फ़ॉर्मैट चुनें जिससे उपयोगकर्ताओं को बेहतर अनुभव मिले.

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

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

मध्यवर्ती

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

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

मूल भाषा वाला

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

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

इनाम दिया गया

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

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