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

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

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

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

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

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

सबसे पहले, बैनर दिखाएं. इसके लिए, GameObject से जुड़ी C# स्क्रिप्ट में, BannerView ऑब्जेक्ट बनाएं.

यूनिटी एडिटर का इस्तेमाल करके, विज्ञापनों को आसानी से इंटिग्रेट करने के लिए, नया विज्ञापन प्लेसमेंट बीटा आज़माएं.

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

        this.RequestBanner();
    }

    private void RequestBanner()
    {
        #if UNITY_ANDROID
            string adUnitId = "ca-app-pub-3940256099942544/6300978111";
        #elif UNITY_IPHONE
            string adUnitId = "ca-app-pub-3940256099942544/2934735716";
        #else
            string adUnitId = "unexpected_platform";
        #endif

        // Create a 320x50 banner at the top of the screen.
        this.bannerView = new BannerView(adUnitId, AdSize.Banner, AdPosition.Top);
    }
}

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

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

यह ध्यान रखना ज़रूरी है कि अलग-अलग प्लैटफ़ॉर्म पर विज्ञापन यूनिट का इस्तेमाल कैसे किया जाता है. आपको iOS पर विज्ञापन अनुरोध करने के लिए, iOS विज्ञापन यूनिट और Android पर अनुरोध करने के लिए Android विज्ञापन यूनिट का इस्तेमाल करना होगा.

(ज़रूरी नहीं) कस्टम विज्ञापन स्थिति

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

// Create a 320x50 banner ad at coordinate (0,50) on screen.
BannerView bannerView = new BannerView(adUnitId, AdSize.Banner, 0, 50);

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

(ज़रूरी नहीं) कस्टम विज्ञापन साइज़

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

AdSize adSize = new AdSize(250, 250);
BannerView bannerView = new BannerView(adUnitId, adSize, AdPosition.Bottom);

हमेशा टेस्ट विज्ञापनों की मदद से टेस्ट करें

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

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

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

BannerView के इंस्टैंशिएट होने के बाद, अगला कदम विज्ञापन को लोड करना है. यह BannerView की कक्षा में loadAd() तरीके से किया गया. यह AdRequest आर्ग्युमेंट लेता है, जिसमें एक ही विज्ञापन अनुरोध के बारे में रनटाइम की जानकारी (जैसे कि टारगेटिंग की जानकारी) होती है.

विज्ञापन लोड करने का एक उदाहरण यहां दिया गया है:

...
    private void RequestBanner()
    {
        #if UNITY_ANDROID
            string adUnitId = "ca-app-pub-3940256099942544/6300978111";
        #elif UNITY_IPHONE
            string adUnitId = "ca-app-pub-3940256099942544/2934735716";
        #else
            string adUnitId = "unexpected_platform";
        #endif

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

        // Create an empty ad request.
        AdRequest request = new AdRequest.Builder().Build();

        // Load the banner with the request.
        this.bannerView.LoadAd(request);
    }
...

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

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

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

...
using System;
using UnityEngine;
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    private BannerView bannerView;

    public void Start()
    {
        this.RequestBanner();
    }

    private void RequestBanner()
    {

        #if UNITY_ANDROID
            string adUnitId = "ca-app-pub-3940256099942544/6300978111";
        #elif UNITY_IPHONE
            string adUnitId = "ca-app-pub-3940256099942544/2934735716";
        #else
            string adUnitId = "unexpected_platform";
        #endif

        this.bannerView = new BannerView(adUnitId, AdSize.Banner, AdPosition.Top);

        // Called when an ad request has successfully loaded.
        this.bannerView.OnAdLoaded += this.HandleOnAdLoaded;
        // Called when an ad request failed to load.
        this.bannerView.OnAdFailedToLoad += this.HandleOnAdFailedToLoad;
        // Called when an ad is clicked.
        this.bannerView.OnAdOpening += this.HandleOnAdOpened;
        // Called when the user returned from the app after an ad click.
        this.bannerView.OnAdClosed += this.HandleOnAdClosed;

        // Create an empty ad request.
        AdRequest request = new AdRequest.Builder().Build();

        // Load the banner with the request.
        this.bannerView.LoadAd(request);
    }

    public void HandleOnAdLoaded(object sender, EventArgs args)
    {
        MonoBehaviour.print("HandleAdLoaded event received");
    }

    public void HandleOnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
    {
        MonoBehaviour.print("HandleFailedToReceiveAd event received with message: "
                            + args.LoadAdError.GetMessage());
    }

    public void HandleOnAdOpened(object sender, EventArgs args)
    {
        MonoBehaviour.print("HandleAdOpened event received");
    }

    public void HandleOnAdClosed(object sender, EventArgs args)
    {
        MonoBehaviour.print("HandleAdClosed event received");
    }
}

OnAdFailedToLoad इवेंट में खास इवेंट आर्ग्युमेंट शामिल हैं. यह गड़बड़ी की जानकारी देने वाले Message के साथ, HandleAdFailedToLoadEventArgs का इंस्टेंस पास करता है:

public void HandleOnAdFailedToLoad(object sender, AdFailedToLoadEventArgs args)
{
  MonoBehaviour.print("Banner failed to load: " + args.Message);
  // Handle the ad failed to load event.
};
विज्ञापन इवेंटजानकारी
OnAdLoaded OnAdLoaded इवेंट तब लागू होता है, जब कोई विज्ञापन लोड हो जाता है.
OnAdFailedToLoad OnAdFailedToLoad इवेंट तब शुरू होता है, जब कोई विज्ञापन लोड नहीं हो पाता. Message पैरामीटर से पता चलता है कि गड़बड़ी किस तरह की है.
OnAdOpening यह तरीका तब शुरू किया जाता है, जब उपयोगकर्ता किसी विज्ञापन पर टैप करता है. अगर आप क्लिकथ्रू ट्रैक करने के लिए किसी एनालिटिक्स पैकेज का उपयोग कर रहे हैं, तो यह रिकॉर्ड करने के लिए एक अच्छी जगह है.
OnAdClosed जब कोई उपयोगकर्ता, विज्ञापन के डेस्टिनेशन यूआरएल (विज्ञापन के लैंडिंग पेज का यूआरएल) देखने के बाद ऐप्लिकेशन पर वापस आता है, तो इस तरीके को शुरू किया जाता है. इसका इस्तेमाल, आपका ऐप्लिकेशन निलंबित गतिविधियों को फिर से शुरू करने के लिए या इंटरैक्शन के लिए खुद को तैयार करने के लिए ज़रूरी अन्य काम करने में इसका इस्तेमाल कर सकता है.

नीचे दी गई टेबल में स्टैंडर्ड बैनर साइज़ की सूची दी गई है.

dp में साइज़ (WxH) जानकारी सुपर थैंक्स की सुविधा कहां उपलब्ध है AdSize कॉन्सटेंट
320x50 स्टैंडर्ड बैनर फ़ोन और टेबलेट BANNER
320x100 बड़ा बैनर फ़ोन और टेबलेट LARGE_BANNER
300x250 IAB मध्यम आयत फ़ोन और टेबलेट MEDIUM_RECTANGLE
468x60 IAB का फ़ुल साइज़ बैनर टैबलेट FULL_BANNER
728x90 IAB लीडरबोर्ड टैबलेट LEADERBOARD
दी गई चौड़ाई x अडैप्टिव ऊंचाई अडैप्टिव बैनर फ़ोन और टेबलेट लागू नहीं
स्क्रीन की चौड़ाई x 32|50|90 स्मार्ट बैनर फ़ोन और टेबलेट SMART_BANNER
अडैप्टिव बैनर, स्मार्ट बैनर की जगह लेने के बारे में ज़्यादा जानें.

बैनर विज्ञापन हटाएं

जब आप BannerView इस्तेमाल कर लें, तो ध्यान रखें कि उसका रेफ़रंस देने से पहले, Destroy() मेथड को कॉल किया जाए:

bannerView.Destroy();

इससे प्लग इन को यह सूचना मिल जाती है कि ऑब्जेक्ट को अब इस्तेमाल नहीं किया जा रहा है. साथ ही, उसमें मौजूद मेमोरी पर फिर से दावा किया जा सकता है. इस तरीके से कॉल न होने पर, मेमोरी लीक हो सकती है.

अन्य लिंक

नमूने

सफलता की कहानियां