बैनर विज्ञापन

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

इस गाइड में, Unity ऐप्लिकेशन में बैनर व्यू को इंटिग्रेट करने का तरीका बताया गया है. इसमें कोड स्निपेट और निर्देशों के साथ-साथ, बैनर का साइज़ सही तरीके से तय करने के बारे में जानकारी भी दी गई है. साथ ही, अन्य संसाधनों के लिंक भी दिए गए हैं.

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

• शुरुआती निर्देश पढ़ें.

हमेशा टेस्ट विज्ञापनों का इस्तेमाल करके टेस्ट करें

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

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

Mobile Ads SDK को शुरू करना

विज्ञापन लोड करने से पहले, अपने ऐप्लिकेशन में Mobile Ads SDK को शुरू करें. इसके लिए, MobileAds.Initialize() को कॉल करें. इसे सिर्फ़ एक बार करना होता है. सबसे सही समय, ऐप्लिकेशन लॉन्च करने के दौरान होता है.

using GoogleMobileAds;
using GoogleMobileAds.Api;

public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize((InitializationStatus initStatus) =>
        {
            // This callback is called once the MobileAds SDK is initialized.
        });
    }
}

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

BannerView का उदाहरण

यहां दिए गए सैंपल कोड में, बैनर व्यू का इस्तेमाल करने का तरीका बताया गया है. इस उदाहरण में, बैनर व्यू का एक इंस्टेंस बनाएं. इसके बाद, बैनर व्यू में विज्ञापन लोड करने के लिए AdRequest का इस्तेमाल करें. इसके बाद, लाइफ़साइकल इवेंट मैनेज करके इसकी क्षमताओं को बढ़ाएं.

बैनर व्यू बनाना

बैनर व्यू का इस्तेमाल करने के लिए, सबसे पहले बैनर व्यू का इंस्टेंस बनाएं.

// Create a 320x50 banner at top of the screen.
bannerView = new BannerView("AD_UNIT_ID", AdSize.Banner, AdPosition.Top);
BannerViewSnippets.cs

AD_UNIT_ID की जगह अपना विज्ञापन यूनिट आईडी डालें.

BannerView के कंस्ट्रक्टर में ये पैरामीटर होते हैं:

• adUnitId: लोड किए जाने वाले बैनर विज्ञापन की यूनिट का आईडी.
• AdSize: आपको जिस बैनर साइज़ का इस्तेमाल करना है.
• AdPosition: वह जगह जहां बैनर व्यू को रखा जाना चाहिए.

(ज़रूरी नहीं) कस्टम पोज़िशन के साथ बैनर व्यू बनाना

AdPosition वैल्यू से ज़्यादा कंट्रोल पाने के लिए, स्क्रीन पर बैनर व्यू को कहां रखा जाए, इसके लिए ऐसे कंस्ट्रक्टर का इस्तेमाल करें जिसमें x- और y-कोऑर्डिनेट पैरामीटर के तौर पर हों:

// Create a 320x50 banner views at coordinate (0,50) on screen.
bannerView = new BannerView("AD_UNIT_ID", AdSize.Banner, 0, 50);
BannerViewSnippets.cs

बैनर व्यू का सबसे ऊपर बायां कोना, कंस्ट्रक्टर को पास की गई x और y वैल्यू पर होता है. इसमें ऑरिजिन, स्क्रीन का सबसे ऊपर बायां हिस्सा होता है.

(ज़रूरी नहीं) कस्टम साइज़ वाला बैनर व्यू बनाएं

AdSize कॉन्स्टेंट का इस्तेमाल करने के अलावा, अपने विज्ञापन के लिए कस्टम साइज़ भी तय किया जा सकता है:

// Create a 250x250 banner at the bottom of the screen.
AdSize adSize = new AdSize(250, 250);
bannerView = new BannerView("AD_UNIT_ID", adSize, AdPosition.Bottom);
BannerViewSnippets.cs

बैनर विज्ञापन लोड करना

विज्ञापन लोड करने के लिए, एक AdRequest बनाएं और उसे LoadAd() तरीके से पास करें.

// Send a request to load an ad into the banner view.
bannerView.LoadAd(new AdRequest());
BannerViewSnippets.cs

बैनर व्यू इवेंट सुनने की अनुमति

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

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.
};
BannerViewSnippets.cs

बैनर व्यू को डिस्ट्रॉय करना

बैनर व्यू का इस्तेमाल पूरा होने के बाद, Destroy() को कॉल करके संसाधनों को रिलीज़ करना न भूलें.

if (bannerView != null)
{
    // Always destroy the banner view when no longer needed.
    bannerView.Destroy();
    bannerView = null;
}
BannerViewSnippets.cs

हो गया! आपका ऐप्लिकेशन अब बैनर विज्ञापन दिखाने के लिए तैयार है.

विज्ञापन रीफ़्रेश करना

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

बैनर आकार

यहां दी गई टेबल में, स्टैंडर्ड बैनर के साइज़ दिए गए हैं:

अन्य संसाधन

• HelloWorld का उदाहरण: इसमें सभी विज्ञापन फ़ॉर्मैट को कम से कम लागू किया गया है.

• इस्तेमाल का उदाहरण