बैनर व्यू, रेक्टैंगल के आकार वाली इमेज या टेक्स्ट विज्ञापन होते हैं. ये स्क्रीन पर एक जगह घेरते हैं. जब उपयोगकर्ता आपके ऐप्लिकेशन के साथ इंटरैक्ट करते हैं, तब स्क्रीन पर बैनर विज्ञापन दिखते रहते हैं. साथ ही, ये विज्ञापन कुछ समय बाद अपने-आप रीफ़्रेश हो सकते हैं. अगर आपने मोबाइल पर विज्ञापन दिखाने की शुरुआत की है, तो बैनर विज्ञापन आपके लिए सबसे सही विकल्प हैं. केस स्टडी.
इस गाइड में, Unity ऐप्लिकेशन में बैनर व्यू इंटिग्रेट करने का तरीका बताया गया है. इसमें कोड स्निपेट और निर्देशों के अलावा, बैनर का साइज़ सही तरीके से सेट करने के बारे में जानकारी भी शामिल है. साथ ही, इसमें अन्य संसाधनों के लिंक भी दिए गए हैं.
ज़रूरी शर्तें
आगे बढ़ने से पहले, सेट अप करें Google Mobile Ads Unity Plugin.
हमेशा टेस्ट विज्ञापनों का इस्तेमाल करके टेस्ट करना
यहां दिए गए सैंपल कोड में, एक विज्ञापन यूनिट का आईडी शामिल है. इसका इस्तेमाल, टेस्ट विज्ञापनों के लिए अनुरोध करने के लिए किया जा सकता है. इसे खास तौर पर इस तरह कॉन्फ़िगर किया गया है कि हर अनुरोध के लिए प्रोडक्शन विज्ञापनों के बजाय टेस्ट विज्ञापन दिखाए जा सकें. इसलिए, इसका इस्तेमाल सुरक्षित है.
हालांकि, AdMob के वेब इंटरफ़ेस में किसी ऐप्लिकेशन को रजिस्टर करने और अपने ऐप्लिकेशन में इस्तेमाल के लिए विज्ञापन यूनिट आईडी बनाने के बाद, डेवलपमेंट के दौरान अपने डिवाइस को साफ़ तौर पर टेस्ट डिवाइस के तौर पर कॉन्फ़िगर करें.
Android
ca-app-pub-3940256099942544/1033173712
iOS
ca-app-pub-3940256099942544/4411468910
शुरू करना 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 के यूज़र इंटरफ़ेस (यूआई) में तय की गई किसी भी रीफ़्रेश दर का पालन करता है. अगर आपने रीफ़्रेश की सुविधा चालू नहीं की है, तो नया अनुरोध करें. विज्ञापन यूनिट को रीफ़्रेश करने के बारे में ज़्यादा जानने के लिए, जैसे कि रीफ़्रेश दर सेट करना, देखें बैनर विज्ञापनों के लिए, अपने-आप रीफ़्रेश होने की सुविधा का इस्तेमाल करना.
बैनर आकार
बड़े अडैप्टिव बैनर, बड़े फ़ॉर्मैट में डिज़ाइन किए जाते हैं. इनका इस्तेमाल, स्क्रोल नहीं किए जा सकने वाले लेआउट के लिए किया जाता है. स्टैंडर्ड ऐंकर किए गए अडैप्टिव बैनर की तुलना में, इन बैनर की ऊंचाई ज़्यादा हो सकती है. इनकी ऊंचाई, स्क्रीन की ऊंचाई के 20% तक हो सकती है. हालांकि, यह 50 से 150 dp के बीच होनी चाहिए. इस बढ़ी हुई जगह को वीडियो कॉन्टेंट के लिए ऑप्टिमाइज़ किया जाता है.
यहां दी गई टेबल में, स्टैंडर्ड बैनर के साइज़ की सूची दी गई है:
| dp में साइज़ (चौड़ाई 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 का उदाहरण: इसमें सभी विज्ञापन फ़ॉर्मैट को मिनिमल तरीके से लागू किया गया है.