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

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

इस गाइड में ऐंकर किए गए अडैप्टिव बैनर वाले विज्ञापनोंका इस्तेमाल करने का तरीका बताया गया है. ये विज्ञापन की चौड़ाई के हिसाब से, हर डिवाइस के लिए विज्ञापन के साइज़ को ऑप्टिमाइज़ करके, परफ़ॉर्मेंस को बेहतर बनाते हैं.

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

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

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

अपने ऐप्लिकेशन बनाते और उनकी जांच करते समय पक्का करें कि आप लाइव, प्रोडक्शन विज्ञापनों के बजाय टेस्ट विज्ञापनों का इस्तेमाल करें. ऐसा न करने पर, आपका खाता निलंबित किया जा सकता है.

टेस्ट विज्ञापन लोड करने का सबसे आसान तरीका, Android बैनर के लिए बने हमारे टेस्ट विज्ञापन यूनिट आईडी का इस्तेमाल करना है:

ca-app-pub-3940256099942544/9214589741

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

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

लेआउट में AdView जोड़ें

बैनर दिखाने के लिए सबसे पहले, AdView को उस Activity या Fragment लेआउट में रखें जिसमें आपको बैनर दिखाना है.:

Java

private AdSize getAdSize() {
  // Determine the screen width (less decorations) to use for the ad width.
  Display display = getWindowManager().getDefaultDisplay();
  DisplayMetrics outMetrics = new DisplayMetrics();
  display.getMetrics(outMetrics);

  float density = outMetrics.density;

  float adWidthPixels = adContainerView.getWidth();

  // If the ad hasn't been laid out, default to the full screen width.
  if (adWidthPixels == 0) {
    adWidthPixels = outMetrics.widthPixels;
  }

  int adWidth = (int) (adWidthPixels / density);
  return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth);
}

private void loadBanner() {
  
  // Create a new ad view.
  AdView adView = new AdView(this);
  adView.setAdSizes(getAdSize());
  adView.setAdUnitId("ca-app-pub-3940256099942544/9214589741");

  // Replace ad container with new ad view.
  adContainerView.removeAllViews();
  adContainerView.addView(adView);

  // Start loading the ad in the background.
  AdRequest adRequest = new AdRequest.Builder().build();
  adView.loadAd(adRequest);
}

Kotlin


// Determine the screen width (less decorations) to use for the ad width.
// If the ad hasn't been laid out, default to the full screen width.
private val adSize: AdSize
  get() {
    val display = windowManager.defaultDisplay
    val outMetrics = DisplayMetrics()
    display.getMetrics(outMetrics)

    val density = outMetrics.density

    var adWidthPixels = binding.adViewContainer.width.toFloat()
    if (adWidthPixels == 0f) {
      adWidthPixels = outMetrics.widthPixels.toFloat()
    }

    val adWidth = (adWidthPixels / density).toInt()
    return AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(this, adWidth)
  }

private fun loadBanner() {
  
  // Create a new ad view.
  val adView = AdView(this)
  adView.adSizes = adSize
  adView.adUnitId = "ca-app-pub-3940256099942544/9214589741"

  // Create an ad request.
  val adRequest = AdRequest.Builder().build()

  // Start loading the ad in the background.
  adView.loadAd(adRequest)
}

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

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

यहां एक उदाहरण दिया गया है, जिसमें Activity के onCreate() तरीके में विज्ञापन लोड करने का तरीका बताया गया है:

Java

private void loadBanner() {
  // Create a new ad view.
  adView = new AdView(this);
  adView.setAdUnitId(AD_UNIT);
  adView.setAdSize(getAdSize());
  
  // Replace ad container with new ad view.
  adContainerView.removeAllViews();
  adContainerView.addView(adView);

  // Start loading the ad in the background.
  AdRequest adRequest = new AdRequest.Builder().build();
  adView.loadAd(adRequest);
}

Kotlin

private fun loadBanner() {
  // This is an ad unit ID for a test ad. Replace with your own banner ad unit ID.
  adView.adUnitId = "/6499/example/banner"
  adView.setAdSize(adSize)
  
  // Create an ad request.
  val adRequest = AdRequest.Builder().build()

  // Start loading the ad in the background.
  adView.loadAd(adRequest)
}

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

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

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

विज्ञापन के लाइफ़साइकल में कई इवेंट सुने जा सकते हैं. इनमें लोड होने, विज्ञापन इंप्रेशन, और क्लिक के साथ-साथ, विज्ञापन को खोलने और बंद करने के इवेंट भी शामिल हैं. हमारा सुझाव है कि बैनर लोड करने से पहले, कॉलबैक को सेट करें.

Java

AdView.setAdListener(new AdListener() {
    @Override
    public void onAdClicked() {
      // Code to be executed when the user clicks on an ad.
    }

    @Override
    public void onAdClosed() {
      // Code to be executed when the user is about to return
      // to the app after tapping on an ad.
    }

    @Override
    public void onAdFailedToLoad(LoadAdError adError) {
      // Code to be executed when an ad request fails.
    }

    @Override
    public void onAdImpression() {
      // Code to be executed when an impression is recorded
      // for an ad.
    }

    @Override
    public void onAdLoaded() {
      // Code to be executed when an ad finishes loading.
    }

    @Override
    public void onAdOpened() {
      // Code to be executed when an ad opens an overlay that
      // covers the screen.
    }
});

Kotlin

AdView.adListener = object: AdListener() {
    override fun onAdClicked() {
      // Code to be executed when the user clicks on an ad.
    }

    override fun onAdClosed() {
      // Code to be executed when the user is about to return
      // to the app after tapping on an ad.
    }

    override fun onAdFailedToLoad(adError : LoadAdError) {
      // Code to be executed when an ad request fails.
    }

    override fun onAdImpression() {
      // Code to be executed when an impression is recorded
      // for an ad.
    }

    override fun onAdLoaded() {
      // Code to be executed when an ad finishes loading.
    }

    override fun onAdOpened() {
      // Code to be executed when an ad opens an overlay that
      // covers the screen.
    }
}

AdListener में ओवरराइड किया जा सकने वाला हर तरीका, विज्ञापन के लाइफ़साइकल में होने वाले किसी इवेंट से मेल खाता है.

ऐसे तरीके जिन्हें बदला जा सकता है
onAdClicked() किसी विज्ञापन के लिए क्लिक रिकॉर्ड होने पर, onAdClicked() तरीका शुरू किया जाता है.
onAdClosed() onAdClosed() तरीका तब शुरू होता है, जब उपयोगकर्ता किसी विज्ञापन का डेस्टिनेशन यूआरएल देखने के बाद, ऐप्लिकेशन पर वापस आता है. आपका ऐप्लिकेशन, निलंबित की गई गतिविधियों को फिर से शुरू करने के लिए इसका इस्तेमाल कर सकता है. इसके अलावा, वह इंटरैक्शन के लिए तैयार होने के लिए कोई दूसरा ज़रूरी काम भी कर सकता है. Android API के डेमो ऐप्लिकेशन में, विज्ञापन लिसनर के तरीकों को लागू करने के लिए, AdMob AdListener का उदाहरण देखें.
onAdFailedToLoad() सिर्फ़ onAdFailedToLoad() तरीके में पैरामीटर शामिल होता है. LoadAdError टाइप के गड़बड़ी पैरामीटर से पता चलता है कि कौनसी गड़बड़ी हुई थी. ज़्यादा जानकारी के लिए, विज्ञापन लोड करने से जुड़ी गड़बड़ियों को डीबग करने से जुड़ा दस्तावेज़ देखें.
onAdImpression() onAdImpression() तरीका तब शुरू किया जाता है, जब किसी विज्ञापन के लिए इंप्रेशन रिकॉर्ड किया जाता है.
onAdLoaded() विज्ञापन लोड होने के बाद, onAdLoaded() तरीका लागू किया जाता है. उदाहरण के लिए, अगर आपको अपनी गतिविधि या फ़्रैगमेंट में AdView को जोड़ने से रोकना है, तो इसकी जानकारी यहां दी जा सकती है.
onAdOpened() जब कोई विज्ञापन, स्क्रीन को कवर करने वाला ओवरले खोलता है, तब onAdOpened() तरीका शुरू किया जाता है.

वीडियो विज्ञापनों में हार्डवेयर की मदद से तेज़ी लाने की सुविधा

अपने बैनर विज्ञापन व्यू में वीडियो विज्ञापन दिखाने के लिए, हार्डवेयर से तेज़ी लाएं की सुविधा चालू होनी चाहिए.

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

हार्डवेयर की मदद से तेज़ी लाने की सुविधा चालू करना

अगर आपका ऐप्लिकेशन दुनिया भर में हार्डवेयर से तेज़ी लाने की सुविधा चालू होने पर, सही तरीके से काम नहीं करता है, तो आपके पास इसे अलग-अलग गतिविधियों के लिए कंट्रोल करने का विकल्प भी होता है. 'हार्डवेयर से तेज़ी लाएं' सुविधा को चालू या बंद करने के लिए, अपने AndroidManifest.xml में <application> और <activity> एलिमेंट के लिए android:hardwareAccelerated एट्रिब्यूट का इस्तेमाल करें. नीचे दिया गया उदाहरण पूरे ऐप्लिकेशन के लिए हार्डवेयर से तेज़ी लाने की सुविधा को चालू करता है, लेकिन इसे एक गतिविधि के लिए बंद कर देता है:

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>

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

अन्य संसाधन

GitHub पर उदाहरण

  • ऐंकर किए गए अडैप्टिव बैनर वाले विज्ञापनों का उदाहरण: Java | Kotlin
  • बेहतर सुविधाओं का डेमो: Java | Kotlin

अगले चरण

छोटे किए जा सकने वाले बैनर

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

इनलाइन अडैप्टिव बैनर

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

दूसरे विषय एक्सप्लोर करें