Dart के नेटिव टेंप्लेट

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

इस गाइड में, Dart API का इस्तेमाल करके प्लैटफ़ॉर्म व्यू को स्टाइल करने और विज्ञापन को रेंडर करने का तरीका बताया गया है.

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

  • Flutter 2.4.0 या इसके बाद का वर्शन.

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

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

  • /21775744923/example/native

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

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

इस उदाहरण में, medium साइज़ के नेटिव टेंप्लेट का इस्तेमाल करके नेटिव विज्ञापन लोड किया गया है:

class NativeExampleState extends State<NativeExample> {
  NativeAd? nativeAd;
  bool _nativeAdIsLoaded = false;

 // TODO: replace this test ad unit with your own ad unit.
 final _adUnitId = '/21775744923/example/native';

  /// Loads a native ad.
  void loadAd() {
    _nativeAd = NativeAd(
        adUnitId: _adUnitId,
        listener: NativeAdListener(
          onAdLoaded: (ad) {
            debugPrint('$NativeAd loaded.');
            setState(() {
              _nativeAdIsLoaded = true;
            });
          },
          onAdFailedToLoad: (ad, error) {
            // Dispose the ad here to free resources.
            debugPrint('$NativeAd failed to load: $error');
            ad.dispose();
          },
        ),
        request: const AdManagerAdRequest(),
        // Styling
        nativeTemplateStyle: NativeTemplateStyle(
            // Required: Choose a template.
            templateType: TemplateType.medium,
            // Optional: Customize the ad's style.
            mainBackgroundColor: Colors.purple,
            cornerRadius: 10.0,
            callToActionTextStyle: NativeTemplateTextStyle(
                textColor: Colors.cyan,
                backgroundColor: Colors.red,
                style: NativeTemplateFontStyle.monospace,
                size: 16.0),
            primaryTextStyle: NativeTemplateTextStyle(
                textColor: Colors.red,
                backgroundColor: Colors.cyan,
                style: NativeTemplateFontStyle.italic,
                size: 16.0),
            secondaryTextStyle: NativeTemplateTextStyle(
                textColor: Colors.green,
                backgroundColor: Colors.black,
                style: NativeTemplateFontStyle.bold,
                size: 16.0),
            tertiaryTextStyle: NativeTemplateTextStyle(
                textColor: Colors.brown,
                backgroundColor: Colors.amber,
                style: NativeTemplateFontStyle.normal,
                size: 16.0)))
      ..load();
  }
}

स्टाइल करने के उपलब्ध विकल्पों के लिए, NativeTemplateStyle और NativeTemplateTextStyle देखें.

विज्ञापन को पसंद के मुताबिक बनाना

नेटिव टेंप्लेट का इस्तेमाल करके नेटिव विज्ञापन को पसंद के मुताबिक बनाते समय, आपके विज्ञापन का यूज़र इंटरफ़ेस (यूआई) कॉन्फ़िगरेशन NativeTemplateStyle क्लास में रहेगा. इससे, आपको Dart कोड में पूरे नेटिव विज्ञापन का स्टाइल बनाने में मदद मिलेगी.

टेंप्लेट के साइज़

Flutter नेटिव विज्ञापन टेंप्लेट दो तरह के होते हैं: TemplateType.small और TemplateType.medium. छोटा टेंप्लेट, TableView या GridView के लिए आदर्श है. साथ ही, इन-फ़ीड विज्ञापनों या ऐसी जगहों के लिए भी आदर्श है जहां आपको पतले आयताकार विज्ञापन व्यू की ज़रूरत होती है. मीडियम टेंप्लेट का मतलब है कि पेज व्यू का आधा से तीन-चौथाई हिस्सा, जो लैंडिंग या स्प्लैश पेजों के लिए आदर्श है.

छोटा

Android
iOS
मीडियम

Android
iOS

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

नेटिव विज्ञापन इंटरैक्शन से जुड़े इवेंट की सूचना पाने के लिए, विज्ञापन की listener प्रॉपर्टी का इस्तेमाल करें. इसके बाद, विज्ञापन इवेंट कॉलबैक पाने के लिए, NativeAdListener इस्तेमाल करें.

class NativeExampleState extends State<NativeExample> {
  NativeAd? _nativeAd;
  bool _nativeAdIsLoaded = false;

 // TODO: replace this test ad unit with your own ad unit.
 final _adUnitId = '/21775744923/example/native';

  /// Loads a native ad.
  void loadAd() {
    _nativeAd = NativeAd(
        adUnitId: _adUnitId,
        listener: NativeAdListener(
          onAdLoaded: (ad) {
            print('$NativeAd loaded.');
            setState(() {
              _nativeAdIsLoaded = true;
            });
          },
          onAdFailedToLoad: (ad, error) {
            // Dispose the ad here to free resources.
            print('$NativeAd failedToLoad: $error');
            ad.dispose();
          },
          // Called when a click is recorded for a NativeAd.
          onAdClicked: (ad) {},
          // Called when an impression occurs on the ad.
          onAdImpression: (ad) {},
          // Called when an ad removes an overlay that covers the screen.
          onAdClosed: (ad) {},
          // Called when an ad opens an overlay that covers the screen.
          onAdOpened: (ad) {},
          // For iOS only. Called before dismissing a full screen view
          onAdWillDismissScreen: (ad) {},
          // Called when an ad receives revenue value.
          onPaidEvent: (ad, valueMicros, precision, currencyCode) {},
        ),
        request: const AdManagerAdRequest(),
        // Styling
        nativeTemplateStyle: NativeTemplateStyle(
            // Required: Choose a template.
            templateType: TemplateType.medium,
            // Optional: Customize the ad's style.
            mainBackgroundColor: Colors.purple,
            cornerRadius: 10.0,
            callToActionTextStyle: NativeTemplateTextStyle(
                textColor: Colors.cyan,
                backgroundColor: Colors.red,
                style: NativeTemplateFontStyle.monospace,
                size: 16.0),
            primaryTextStyle: NativeTemplateTextStyle(
                textColor: Colors.red,
                backgroundColor: Colors.cyan,
                style: NativeTemplateFontStyle.italic,
                size: 16.0),
            secondaryTextStyle: NativeTemplateTextStyle(
                textColor: Colors.green,
                backgroundColor: Colors.black,
                style: NativeTemplateFontStyle.bold,
                size: 16.0),
            tertiaryTextStyle: NativeTemplateTextStyle(
                textColor: Colors.brown,
                backgroundColor: Colors.amber,
                style: NativeTemplateFontStyle.normal,
                size: 16.0)))
      ..load();
  }
}

Display Network में दिखने वाला विज्ञापन

NativeAd को विजेट के तौर पर दिखाने के लिए, आपको load() को कॉल करने के बाद, काम करने वाले विज्ञापन के साथ AdWidget को इंस्टैंशिएट करना होगा. load() को कॉल करने से पहले विजेट बनाया जा सकता है. हालांकि, विजेट ट्री में जोड़ने से पहले load() को कॉल करना ज़रूरी है.

AdWidget, Flutter की Widget क्लास से इनहेरिट करता है और इसका इस्तेमाल किसी भी दूसरे विजेट की तरह किया जा सकता है. iOS पर, पक्का करें कि आपने विजेट को तय की गई चौड़ाई और ऊंचाई वाले कंटेनर में डाला हो. ऐसा न करने पर, हो सकता है कि आपका विज्ञापन न दिखे.

// Small template
final adContainer = ConstrainedBox(
  constraints: const BoxConstraints(
    minWidth: 320, // minimum recommended width
    minHeight: 90, // minimum recommended height
    maxWidth: 400,
    maxHeight: 200,
  ),
  child: AdWidget(ad: _nativeAd!),
);

// Medium template
final adContainer = ConstrainedBox(
  constraints: const BoxConstraints(
    minWidth: 320, // minimum recommended width
    minHeight: 320, // minimum recommended height
    maxWidth: 400,
    maxHeight: 400,
  ),
  child: AdWidget(ad: _nativeAd!),
);

विज्ञापन हटाना

जब NativeAd का ऐक्सेस ज़रूरी न हो, तो उसे हटा देना चाहिए. dispose() को कॉल करने का सबसे सही समय यह है कि नेटिव विज्ञापन से जुड़े AdWidget को विजेट ट्री से हटाने के बाद और AdListener.onAdFailedToLoad() कॉलबैक में.