शुरू करें

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

Google Mobile Ads Unity प्लग इन को किसी ऐप्लिकेशन में इंटिग्रेट करके, AdMob विज्ञापन दिखाना और कमाई करना, यह पहला कदम है. इंटिग्रेशन पूरा होने के बाद, विज्ञापन को लागू करने के तरीके के बारे में ज़्यादा जानकारी पाने के लिए, विज्ञापन फ़ॉर्मैट (जैसे कि नेटिव या इनाम वाले वीडियो) चुनें.

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

  • Unity 2019 या इसके बाद का वर्शन इस्तेमाल करें
  • iOS पर डिप्लॉय करने के लिए
    • Xcode 14.1 या उसके बाद का वर्शन
    • iOS 11.0 या इसके बाद के वर्शन को टारगेट करें
    • कोकोपोड
  • Android पर डिप्लॉय करने के लिए
    • Google Play सेवाएं 18.1.0 या इसके बाद का वर्शन
    • टारगेट एपीआई लेवल 16 या इसके बाद वाला वर्शन
  • सुझाया गया: AdMob खाता बनाएं और Android और/या iOS ऐप्लिकेशन रजिस्टर करें

मोबाइल विज्ञापन यूनिटी प्लग इन डाउनलोड करें

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

प्लग इन के लिए Unity पैकेज डाउनलोड करने या GitHub पर उसका कोड देखने के लिए, नीचे दिए गए लिंक इस्तेमाल करें.

प्लग इन डाउनलोड करें स्रोत देखें

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

Unity एडिटर में अपना प्रोजेक्ट खोलें. एसेट > पैकेज इंपोर्ट करें > कस्टम पैकेज चुनें और डाउनलोड की गई GoogleMobileAdsPlugin.unitypackage फ़ाइल ढूंढें.

पक्का करें कि सभी फ़ाइलें चुनी गई हैं. इसके बाद, इंपोर्ट करें पर क्लिक करें.

मोबाइल विज्ञापन SDK शामिल करें

Google मोबाइल विज्ञापन यूनिटी प्लग इन Unity Play Services रिज़ॉल्वर लाइब्रेरी के साथ काम करता है. यह लाइब्रेरी, किसी भी Unity प्लगिन के इस्तेमाल के लिए तैयार है. इसके लिए, Android की खास लाइब्रेरी (जैसे, AAR) या iOS CoaaPods. इससे, Unity की डिपेंडेंसी के बारे में पता चलता है. इसके बाद, ये अपने-आप ठीक हो जाती हैं और आपके यूनिटी प्रोजेक्ट में कॉपी हो जाती हैं.

नीचे दिए गए तरीके अपनाकर पक्का करें कि आपके प्रोजेक्ट में मोबाइल विज्ञापन SDK टूल शामिल है.

Android

यूनिटी एडिटर में, एसेट > एक्सटर्नल डिपेंडेंसी मैनेजर > Android रिज़ॉल्वर > रिज़ॉल्व चुनें. Unity बाहरी डिपेंडेंसी मैनेजर लाइब्रेरी, आपकी डिपेंडेंसी को आपके Unity ऐप्लिकेशन की Assets/Plugins/Android डायरेक्ट्री में कॉपी कर देगी.

में दी गई हैं

iOS

मोबाइल विज्ञापन SDK को यूनिटी प्रोजेक्ट में शामिल करने के लिए कुछ और करने की ज़रूरत नहीं है.

  • Unity 5.6 और उसके बाद वाले वर्शन का इस्तेमाल करते समय, एक xcworkspace जनरेट होता है, जिसमें ज़रूरी डिपेंडेंसी लाइब्रेरी शामिल होती हैं. स्टैंडर्ड Xcode प्रोजेक्ट के बजाय, जनरेट किए गए xcworkspace का इस्तेमाल करें.
  • Unity के पुराने वर्शन का इस्तेमाल करते समय, डिपेंडेंसी स्टैंडर्ड Xcode प्रोजेक्ट में शामिल की जाती हैं.

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

यूनिटी एडिटर में, मेन्यू से एसेट > Google मोबाइल विज्ञापन > सेटिंग चुनें.

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

Unity के मुख्य थ्रेड पर विज्ञापन इवेंट बढ़ाएं

Google मोबाइल विज्ञापन SDK कभी-कभी, यूनिट में मुख्य थ्रेड के बजाय, किसी दूसरी थ्रेड पर इवेंट आयोजित करता है. इससे, Google Mobile Ads SDK से भेजे गए इवेंट के Unity ऑब्जेक्ट के साथ इंटरैक्ट करने में समस्या आ सकती है. एक काम के तौर पर, मोबाइल विज्ञापन SDK इवेंट को Unity के मुख्य थ्रेड के साथ सिंक करने के लिए, आपको कोड जोड़ना पड़ सकता है.

अगर आप चाहते हैं कि मोबाइल विज्ञापन SDK टूल आपके लिए थ्रेडिंग की इस समस्या को ठीक करे, तो MobileAds.RaiseAdEventsOnUnityMainThread को true पर सेट करें. इसलिए, यह मोबाइल विज्ञापन SDK को, यूनिटी के मुख्य थ्रेड पर सभी इवेंट और कॉलबैक को बढ़ाने के लिए मजबूर कर देगा.

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // When true all events raised by GoogleMobileAds will be raised
        // on the Unity main thread. The default value is false.
        MobileAds.RaiseAdEventsOnUnityMainThread = true;
    }
}

मोबाइल विज्ञापन SDK शुरू करना

विज्ञापन लोड करने से पहले, अपने ऐप्लिकेशन को MobileAds.Initialize() पर कॉल करके मोबाइल विज्ञापन SDK टूल को शुरू करने के लिए कहें. आपको ऐसा सिर्फ़ एक बार करना होगा, खासकर ऐप्लिकेशन लॉन्च के दौरान.

यहां एक उदाहरण दिया गया है कि GameObject से जुड़ी स्क्रिप्ट की Start() प्रक्रिया में, Initialize() को कैसे कॉल करें:

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

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

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

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

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

बैनर लागू करना

मध्यवर्ती

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

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

नेटिव विज्ञापन

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

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

इनाम दिया गया

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

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

ऐप्लिकेशन ट्रैकिंग की पारदर्शिता के लिए अनुमति देने का अनुरोध करें

IDFA ऐक्सेस करने के लिए, ऐप्लिकेशन ट्रैकिंग ट्रांसपेरंसी (ATT) अनुमति का अनुरोध दिखाने के लिए, Unity के iOS 14 की विज्ञापन सहायता पैकेज का इस्तेमाल करें.

एक जैसी 'ऐप्लिकेशन कुंजी'

ज़रूरी शर्तें: Google मोबाइल विज्ञापन यूनिटी प्लग इन 6.1.0 या इसके बाद का वर्शन

Google Mobile Ads SDK, उसी ऐप्लिकेशन कुंजी का इस्तेमाल करता है. इसकी मदद से, उपयोगकर्ता के इस्तेमाल किए जा रहे ऐप्लिकेशन से इकट्ठा किए गए डेटा का इस्तेमाल करके, ज़्यादा काम के और दिलचस्पी के मुताबिक विज्ञापन दिखाए जा सकते हैं.

एक जैसी 'ऐप्लिकेशन कुंजी' डिफ़ॉल्ट रूप से चालू होती है. हालांकि, इसे नीचे दिए गए एपीआई से बंद किया जा सकता है:

public void Start()
    {
        RequestConfiguration requestConfiguration =
            new RequestConfiguration.Builder()
            .SetSameAppKeyEnabled(true).build();
        MobileAds.SetRequestConfiguration(requestConfiguration);

        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(HandleInitCompleteAction);
    }