बैनर व्यू, रेक्टैंगल के आकार वाली इमेज या टेक्स्ट विज्ञापन होते हैं. ये स्क्रीन पर एक जगह घेरते हैं. जब उपयोगकर्ता आपके ऐप्लिकेशन से इंटरैक्ट करते हैं, तब स्क्रीन पर बैनर विज्ञापन दिखते रहते हैं. इसके अलावा, ये विज्ञापन कुछ समय बाद अपने-आप रीफ़्रेश हो सकते हैं. अगर आपने मोबाइल पर विज्ञापन दिखाने की शुरुआत की है, तो बैनर विज्ञापन आपके लिए सबसे सही विकल्प हैं. केस स्टडी.
इस गाइड में, Unity ऐप्लिकेशन में बैनर व्यू इंटिग्रेट करने का तरीका बताया गया है. इसमें कोड स्निपेट और निर्देशों के अलावा, बैनर का साइज़ सही तरीके से तय करने के बारे में जानकारी भी शामिल है. साथ ही, इसमें अन्य संसाधनों के लिंक भी दिए गए हैं.
ज़रूरी शर्तें
आगे बढ़ने से पहले, सेट अप करें Google Mobile Ads Unity Plugin.
हमेशा टेस्ट विज्ञापनों का इस्तेमाल करके टेस्ट करना
यहां दिए गए सैंपल कोड में, एक विज्ञापन यूनिट आईडी शामिल है. इसका इस्तेमाल, टेस्ट विज्ञापनों के लिए अनुरोध करने के लिए किया जा सकता है. इसे खास तौर पर इस तरह कॉन्फ़िगर किया गया है कि हर अनुरोध के लिए प्रोडक्शन विज्ञापनों के बजाय टेस्ट विज्ञापन दिखाए जा सकें. इसलिए, इसका इस्तेमाल करना सुरक्षित है.
Android
ca-app-pub-3940256099942544/6300978111
iOS
ca-app-pub-3940256099942544/2934735716
Google Mobile Ads Unity Plugin को शुरू करना
विज्ञापन लोड करने से पहले, अपने ऐप्लिकेशन में Google Mobile Ads Unity Plugin को शुरू करें. इसके लिए,
MobileAds.Initialize() को कॉल करें. इसे सिर्फ़ एक बार करना होगा. सबसे सही तरीका है कि इसे ऐप्लिकेशन लॉन्च के समय किया जाए.
using GoogleMobileAds;
using GoogleMobileAds.Api;
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
public void Start()
{
// Initialize Google Mobile Ads Unity Plugin.
MobileAds.Initialize((InitializationStatus initStatus) =>
{
// This callback is called once the MobileAds SDK is initialized.
});
}
}
अगर मीडिएशन का इस्तेमाल किया जा रहा है, तो विज्ञापन लोड करने से पहले, कॉलबैक होने तक इंतज़ार करें. इससे यह पक्का होगा कि सभी मीडिएशन अडैप्टर शुरू हो गए हैं.
BannerView का उदाहरण
यहां दिए गए सैंपल कोड में, बैनर व्यू का इस्तेमाल करने का तरीका बताया गया है. उदाहरण के लिए, बैनर व्यू का इंस्टेंस बनाएं. इसके बाद, बैनर व्यू में विज्ञापन लोड करने के लिए, AdRequest का इस्तेमाल करें. इसके बाद, लाइफ़साइकल इवेंट को मैनेज करके, इसकी क्षमताओं को बढ़ाएं.
बैनर व्यू बनाना
बैनर व्यू का इस्तेमाल करने के लिए, सबसे पहले बैनर व्यू का इंस्टेंस बनाएं.
AD_UNIT_ID की जगह, अपना विज्ञापन यूनिट आईडी डालें.
BannerView के कंस्ट्रक्टर में ये पैरामीटर होते हैं:
adUnitId: लोड किए जाने वाले बैनर विज्ञापन का विज्ञापन यूनिट आईडी.AdSize: वह बैनर साइज़ जिसका इस्तेमाल करना है.AdPosition: वह जगह जहां बैनर व्यू प्लेस किए जाने चाहिए.
(ज़रूरी नहीं) कस्टम पोज़िशन के साथ बैनर व्यू बनाना
AdPosition की वैल्यू से ज़्यादा कंट्रोल पाने के लिए, स्क्रीन पर बैनर व्यू को कहां प्लेस करना है, उस कंस्ट्रक्टर का इस्तेमाल करें जिसमें x- और y-कोऑर्डिनेट पैरामीटर के तौर पर मौजूद हों:
बैनर व्यू का सबसे ऊपर वाला बायां कोना, कंस्ट्रक्टर को पास की गई x और y वैल्यू पर प्लेस किया जाता है. यहां ऑरिजिन, स्क्रीन का सबसे ऊपर वाला बायां कोना होता है.
(ज़रूरी नहीं) कस्टम साइज़ के साथ बैनर व्यू बनाना
AdSize कॉन्सटेंट का इस्तेमाल करने के अलावा, अपने विज्ञापन के लिए कस्टम साइज़ भी तय किया जा सकता है:
बैनर विज्ञापन लोड करना
विज्ञापन लोड करने के लिए, AdRequest बनाएं और इसे LoadAd() तरीके से पास करें.
// Send a request to load an ad into the banner view.
bannerView.LoadAd(new AdRequest());
बैनर व्यू के इवेंट को मॉनिटर करना
विज्ञापन के व्यवहार को पसंद के मुताबिक बनाने के लिए, विज्ञापन के लाइफ़साइकल में कुछ इवेंट को हुक किया जा सकता है. जैसे, लोड करना, खोलना या बंद करना. इन इवेंट को मॉनिटर करने के लिए, कोई डेलिगेट रजिस्टर करें:
bannerView.OnBannerAdLoaded += () =>
{
// Raised when an ad is loaded into the banner view.
};
bannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
{
// Raised when an ad fails to load into the banner view.
};
bannerView.OnAdPaid += (AdValue adValue) =>
{
// Raised when the ad is estimated to have earned money.
};
bannerView.OnAdImpressionRecorded += () =>
{
// Raised when an impression is recorded for an ad.
};
bannerView.OnAdClicked += () =>
{
// Raised when a click is recorded for an ad.
};
bannerView.OnAdFullScreenContentOpened += () =>
{
// Raised when an ad opened full screen content.
};
bannerView.OnAdFullScreenContentClosed += () =>
{
// Raised when the ad closed full screen content.
};
बैनर व्यू को डिस्ट्रॉय करना
बैनर को डिस्ट्रॉय करने के लिए, संसाधनों को रिलीज़ करने के लिए Destroy() तरीके को कॉल करें:
if (bannerView != null)
{
// Always destroy the banner view when no longer needed.
bannerView.Destroy();
bannerView = null;
}
जिन बैनर को लोड नहीं किया जा सका उनके लिए, हमारा सुझाव है कि उन्हें डिस्ट्रॉय करने और नया बैनर बनाने के बजाय, रीफ़्रेश करें. ज़्यादा जानकारी के लिए, विज्ञापन रीफ़्रेश करना लेख पढ़ें.
विज्ञापन रीफ़्रेश करना
अगर आपने अपनी विज्ञापन यूनिट को रीफ़्रेश करने के लिए कॉन्फ़िगर किया है, तो विज्ञापन लोड न होने पर, आपको किसी दूसरे विज्ञापन के लिए अनुरोध करने की ज़रूरत नहीं है. Google Mobile Ads Unity Plugin AdMob के यूज़र इंटरफ़ेस (यूआई) में तय की गई किसी भी रीफ़्रेश दर का पालन करता है. अगर आपने रीफ़्रेश की सुविधा चालू नहीं की है, तो नया अनुरोध करें. विज्ञापन यूनिट को रीफ़्रेश करने के बारे में ज़्यादा जानने के लिए, जैसे कि रीफ़्रेश दर सेट करना, देखें बैनर विज्ञापनों के लिए, अपने-आप रीफ़्रेश होने की सुविधा का इस्तेमाल करना.
बैनर आकार
यहां दी गई टेबल में, बैनर के स्टैंडर्ड साइज़ दिए गए हैं:
| डीपी में साइज़ (चौड़ाई x ऊंचाई) | ब्यौरा | उपलब्धता | AdSize कॉन्सटेंट |
|---|---|---|---|
| 320x50 | स्टैंडर्ड बैनर | फ़ोन और टेबलेट | BANNER |
| 320x100 | बड़ा बैनर | फ़ोन और टेबलेट | LARGE_BANNER |
| 300x250 | IAB मीडियम रेक्टैंगल | फ़ोन और टेबलेट | MEDIUM_RECTANGLE |
| 468x60 | IAB फ़ुल-साइज़ बैनर | टैबलेट | FULL_BANNER |
| 728x90 | IAB लीडरबोर्ड | टैबलेट | LEADERBOARD |
| दी गई चौड़ाई x अडैप्टिव ऊंचाई | अडैप्टिव बैनर | फ़ोन और टेबलेट | लागू नहीं |
| स्क्रीन की चौड़ाई x 32|50|90 | स्मार्ट बैनर | फ़ोन और टेबलेट | SMART_BANNER |
| अडैप्टिव बैनर के बारे में ज़्यादा जानें. इन्हें स्मार्ट बैनर की जगह इस्तेमाल किया जा सकता है. | |||
अन्य संसाधन
- HelloWorld का उदाहरण: इसमें सभी विज्ञापन फ़ॉर्मैट को मिनिमल तरीके से लागू किया गया है.