इस पेज का अनुवाद Cloud Translation API से किया गया है.

ऐंकर किए गए अडैप्टिव बैनर

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

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

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

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

Mobile Ads Flutter प्लगिन इंपोर्ट करने के तरीके के बारे में जानने के लिए, शुरू करने की गाइड में दिए गए निर्देशों का पालन करें.

अडैप्टिव बैनर का इस्तेमाल कब करना चाहिए

अडैप्टिव बैनर इस तरह से डिज़ाइन किए गए हैं कि वे इंडस्ट्री स्टैंडर्ड वाले 320x50 बैनर साइज़ और उनकी जगह लागू होने वाले स्मार्ट बैनर फ़ॉर्मैट, दोनों की जगह नए बदलाव कर लें.

आम तौर पर, इन बैनर साइज़ का इस्तेमाल ऐंकर किए गए बैनर के तौर पर किया जाता है. ये बैनर आम तौर पर स्क्रीन के सबसे ऊपर या सबसे नीचे लॉक होते हैं.

ऐसे ऐंकर बैनर के लिए, अडैप्टिव बैनर का आसपेक्ट रेशियो, स्टैंडर्ड 320x50 विज्ञापन के आसपेक्ट रेशियो जैसा ही होगा. इसकी जानकारी यहां दिए गए तीन उदाहरणों में दी गई है:

320x50 बैनर

अडैप्टिव बैनर

स्मार्ट बैनर

अडैप्टिव बैनर, उपलब्ध स्क्रीन साइज़ का बेहतर तरीके से इस्तेमाल करता है. इसके अलावा, स्मार्ट बैनर की तुलना में अडैप्टिव बैनर एक बेहतर विकल्प है, क्योंकि:

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

लागू करने के बारे में ज़रूरी बातें

अपने ऐप्लिकेशन में अडैप्टिव बैनर का इस्तेमाल करते समय इन बातों का ध्यान रखें:

आपको उस व्यू की चौड़ाई पता होनी चाहिए जिसमें विज्ञापन दिखाया जाएगा. इसमें डिवाइस की चौड़ाई और लागू होने वाले सेफ़ एरिया या कटआउट को ध्यान में रखना चाहिए.
पक्का करें कि आपके विज्ञापन व्यू का बैकग्राउंड अपारदर्शी हो, ताकि AdMob की नीतियों का पालन किया जा सके. ऐसा तब ज़रूरी होता है, जब विज्ञापन के छोटे साइज़ दिखाए जाते हैं, जो विज्ञापन स्लॉट को नहीं भरते.
पक्का करें कि Google Mobile Ads Flutter प्लगिन के सबसे नए वर्शन का इस्तेमाल किया जा रहा है.
अडैप्टिव बैनर के साइज़, उपलब्ध पूरी चौड़ाई का इस्तेमाल करने पर सबसे बेहतर तरीके से काम करने के लिए डिज़ाइन किए गए हैं. ज़्यादातर मामलों में, यह इस्तेमाल किए जा रहे डिवाइस की स्क्रीन की पूरी चौड़ाई होगी. उन जगहों का भी ध्यान रखें जहां सुरक्षा सुविधाएं लागू होती हैं.
अडैप्टिव AdSize API का इस्तेमाल करते समय, Google Mobile Ads SDK, दी गई चौड़ाई के लिए विज्ञापन की ऑप्टिमाइज़ की गई ऊंचाई के साथ बैनर का साइज़ तय करेगा.
अडैप्टिव विज्ञापन के लिए साइज़ पाने के दो तरीके हैं: AdSize.getAnchoredAdaptiveBannerAdSize(Orientation orientation, int width) किसी खास ओरिएंटेशन के लिए अनुरोध करना और AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(int width) विज्ञापन दिखाने के समय मौजूदा ओरिएंटेशन के लिए अनुरोध करना.
किसी डिवाइस पर दी गई चौड़ाई के लिए लौटाया गया आकार हमेशा एक जैसा ही रहेगा इसलिए, किसी डिवाइस पर अपने लेआउट की जांच करने के बाद, आप भरोसा रख सकते हैं कि विज्ञापन का आकार नहीं बदलेगा.
ऐंकर किए गए बैनर की ऊंचाई, डिवाइस की ऊंचाई के 15% या 90 डेंसिटी इंडिपेंडेंट पिक्सल से ज़्यादा नहीं होनी चाहिए. साथ ही, यह 50 डेंसिटी इंडिपेंडेंट पिक्सल से कम नहीं होनी चाहिए.

क्विकस्टार्ट

ऐंकर किया गया आसान अडैप्टिव बैनर लागू करने के लिए, यहां दिया गया तरीका अपनाएं.

अडैप्टिव बैनर विज्ञापन का साइज़ पाएं. आपको स्टैटिक मेथड से साइज़ की जानकारी मिलती है. अडैप्टिव बैनर का अनुरोध करते समय, इस साइज़ का इस्तेमाल किया जाता है. विज्ञापन का अडैप्टिव साइज़ पाने के लिए, पक्का करें कि आपने:
1. डिवाइस की चौड़ाई को डेंसिटी इंडिपेंडेंट पिक्सल में पाएं. अगर आपको स्क्रीन की पूरी चौड़ाई का इस्तेमाल नहीं करना है, तो अपनी पसंद के मुताबिक चौड़ाई सेट करें. स्क्रीन की चौड़ाई जानने के लिए, MediaQuery.of(context) का इस्तेमाल किया जा सकता है.
2. विज्ञापन साइज़ क्लास पर सही स्टैटिक तरीकों का इस्तेमाल करें. जैसे, मौजूदा ओरिएंटेशन के लिए, AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(int width) अडैप्टिव AdSize ऑब्जेक्ट पाने के लिए.
अपने विज्ञापन यूनिट आईडी, अडैप्टिव विज्ञापन साइज़, और विज्ञापन अनुरोध ऑब्जेक्ट के साथ BannerAd ऑब्जेक्ट बनाएं.
विज्ञापन को वैसे ही लोड करें जैसे किसी सामान्य बैनर विज्ञापन को लोड किया जाता है. साथ ही, इसे वैसे ही AdWidget से दिखाएं जैसे किसी सामान्य विज्ञापन व्यू को दिखाया जाता है.

कोड का उदाहरण

यहां एक उदाहरण दिया गया है, जिसमें स्क्रीन की चौड़ाई के हिसाब से अडैप्टिव बैनर लोड करने वाला विजेट दिखाया गया है:

import 'dart:io';

import 'package:flutter/material.dart';
import 'package:google_mobile_ads/google_mobile_ads.dart';

/// This example demonstrates anchored adaptive banner ads.
class AnchoredAdaptiveExample extends StatefulWidget {
  @override
  _AnchoredAdaptiveExampleState createState() =>
      _AnchoredAdaptiveExampleState();
}

class _AnchoredAdaptiveExampleState extends State<AnchoredAdaptiveExample> {
  BannerAd? _anchoredAdaptiveAd;
  bool _isLoaded = false;

  @override
  void didChangeDependencies() {
    super.didChangeDependencies();
    _loadAd();
  }

  Future<void> _loadAd() async {
    // Get an AnchoredAdaptiveBannerAdSize before loading the ad.
    final AnchoredAdaptiveBannerAdSize? size =
        await AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(
            MediaQuery.of(context).size.width.truncate());

    if (size == null) {
      print('Unable to get height of anchored banner.');
      return;
    }

    _anchoredAdaptiveAd = BannerAd(
      // TODO: replace these test ad units with your own ad unit.
      adUnitId: Platform.isAndroid
          ? 'ca-app-pub-3940256099942544/6300978111'
          : 'ca-app-pub-3940256099942544/2934735716',
      size: size,
      request: AdRequest(),
      listener: BannerAdListener(
        onAdLoaded: (Ad ad) {
          print('$ad loaded: ${ad.responseInfo}');
          setState(() {
            // When the ad is loaded, get the ad size and use it to set
            // the height of the ad container.
            _anchoredAdaptiveAd = ad as BannerAd;
            _isLoaded = true;
          });
        },
        onAdFailedToLoad: (Ad ad, LoadAdError error) {
          print('Anchored adaptive banner failedToLoad: $error');
          ad.dispose();
        },
      ),
    );
    return _anchoredAdaptiveAd!.load();
  }

  @override
  Widget build(BuildContext context) => Scaffold(
        appBar: AppBar(
          title: Text('Anchored adaptive banner example'),
        ),
        body: Center(
          child: Stack(
            alignment: AlignmentDirectional.bottomCenter,
            children: <Widget>[
              ListView.separated(
                  padding: const EdgeInsets.symmetric(horizontal: 16.0),
                  itemBuilder: (context, index) {
                    return Text(
                      'Placeholder text',
                      style: TextStyle(fontSize: 24),
                    );
                  },
                  separatorBuilder: (context, index) {
                    return Container(height: 40);
                  },
                  itemCount: 20),
              if (_anchoredAdaptiveAd != null && _isLoaded)
                Container(
                  color: Colors.green,
                  width: _anchoredAdaptiveAd!.size.width.toDouble(),
                  height: _anchoredAdaptiveAd!.size.height.toDouble(),
                  child: AdWidget(ad: _anchoredAdaptiveAd!),
                )
            ],
          ),
        ),
      );

  @override
  void dispose() {
    super.dispose();
    _anchoredAdaptiveAd?.dispose();
  }
}

यहां फ़ंक्शन AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize का इस्तेमाल, मौजूदा इंटरफ़ेस के ओरिएंटेशन के लिए, ऐंकर की गई स्थिति में बैनर का साइज़ पाने के लिए किया जाता है. किसी तय ओरिएंटेशन में ऐंकर किए गए बैनर को पहले से लोड करने के लिए, AdSize.getAnchoredAdaptiveBannerAdSize(Orientation orientation, int width) का इस्तेमाल करें और अपनी पसंद का ओरिएंटेशन पास करें.

GitHub पर पूरा उदाहरण

पूरा उदाहरण देखने के लिए, GitHub डेटा स्टोर करने की जगह पर बैनर का उदाहरण देखें.