แบนเนอร์ที่ปรับเปลี่ยนได้แบบแทรกในบรรทัด

แบนเนอร์แบบปรับขนาดได้เป็นโฆษณาที่ปรับเปลี่ยนตามพื้นที่โฆษณารุ่นใหม่ ซึ่งเพิ่มประสิทธิภาพสูงสุดด้วยการเพิ่มประสิทธิภาพขนาดโฆษณาสำหรับอุปกรณ์แต่ละประเภท แบนเนอร์แบบปรับขนาดได้พัฒนามาจากแบนเนอร์ขนาดคงที่ที่รองรับเฉพาะความสูงแบบคงที่ โดยแบนเนอร์แบบใหม่นี้จะช่วยให้นักพัฒนาแอปสามารถระบุความกว้างของโฆษณาเพื่อนำไปใช้กำหนดขนาดโฆษณาให้เหมาะสมได้

แบนเนอร์แบบปรับขนาดได้ที่แทรกระหว่างเนื้อหาจะใช้ความสูงในระดับสูงสุดแทนความสูงคงที่ในการเลือกขนาดโฆษณาที่ดีที่สุด ซึ่งจะทําให้มีโอกาสปรับปรุงประสิทธิภาพ

กรณีที่ควรใช้แบนเนอร์แบบปรับขนาดได้ที่แทรกระหว่างเนื้อหา

แบนเนอร์แบบปรับขนาดได้ที่แทรกในบรรทัดคือแบนเนอร์ที่มีขนาดใหญ่และสูงกว่าเดิมเมื่อเทียบกับแบนเนอร์แบบปรับขนาดได้แบบโฆษณา Anchor มีความสูงที่ไม่คงที่และสูงเท่ากับหน้าจอของอุปกรณ์ได้

โดยมีจุดประสงค์เพื่อวางในเนื้อหาแบบเลื่อน เช่น

ข้อกำหนดเบื้องต้น

ก่อนเริ่มต้น

โปรดคำนึงถึงประเด็นต่อไปนี้เมื่อติดตั้งใช้งานแบนเนอร์แบบปรับขนาดได้ในแอป

  • ตรวจสอบว่าคุณใช้ Google Mobile Ads SDK เวอร์ชันล่าสุด และหากใช้สื่อกลาง ให้ใช้อะแดปเตอร์สื่อกลางเวอร์ชันล่าสุด

  • ขนาดแบนเนอร์แบบปรับขนาดได้ที่แทรกในบรรทัดได้รับการออกแบบให้ทำงานได้ดีที่สุดเมื่อใช้ความกว้างที่มีให้อย่างเต็มที่ ในกรณีส่วนใหญ่ จะเป็นความกว้างเต็มหน้าจอของอุปกรณ์ที่ใช้ อย่าลืมคำนึงถึงพื้นที่ปลอดภัยที่เกี่ยวข้อง

  • คุณอาจต้องอัปเดตหรือสร้างรายการโฆษณาใหม่เพื่อให้ทำงานร่วมกับขนาดที่ปรับได้ ดูข้อมูลเพิ่มเติม

  • วิธีรับขนาดโฆษณามีดังนี้

    • AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(int width)
    • AdSize.getLandscapeInlineAdaptiveBannerAdSize(int width)
    • AdSize.getPortraitInlineAdaptiveBannerAdSize(int width)
    • AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight)
  • เมื่อใช้ API แบนเนอร์แบบปรับขนาดได้แบบแทรกในบรรทัด จะทำให้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google แสดงผล AdSize ที่มีความกว้างที่กำหนดและแฟล็กในบรรทัด ความสูงจะเป็น 0 หรือ maxHeight ทั้งนี้ขึ้นอยู่กับ API ที่คุณใช้ ความสูงจริงของโฆษณาจะแสดงเมื่อโฆษณาแสดง

  • แบนเนอร์แทรกในบรรทัดที่ปรับเปลี่ยนได้มีไว้เพื่อวางในเนื้อหาแบบเลื่อนได้ แบนเนอร์อาจมีความสูงเท่ากับหน้าจออุปกรณ์หรือจำกัดความสูงสูงสุดก็ได้ ขึ้นอยู่กับ API

การใช้งาน

ทําตามขั้นตอนด้านล่างเพื่อติดตั้งใช้งานแบนเนอร์แบบปรับเปลี่ยนในบรรทัดอย่างง่าย

  1. ดูขนาดโฆษณาแบนเนอร์แบบปรับขนาดได้ที่แทรกในบรรทัด ระบบจะใช้ขนาดที่คุณได้รับเพื่อส่งคำขอแบนเนอร์แบบปรับขนาดได้ หากต้องการใช้ขนาดโฆษณาแบบปรับอัตโนมัติ โปรดตรวจสอบว่าคุณได้ดำเนินการต่อไปนี้
    1. รับความกว้างของอุปกรณ์ที่ใช้เป็นพิกเซลที่ไม่ขึ้นอยู่กับความหนาแน่น หรือตั้งค่าความกว้างของคุณเองหากไม่ต้องการเต็มความกว้างของหน้าจอ คุณใช้ MediaQuery.of(context) เพื่อรับความกว้างของหน้าจอได้
    2. ใช้เมธอดแบบคงที่ที่เหมาะสมในคลาสขนาดโฆษณา เช่น AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(int width) เพื่อรับออบเจ็กต์ AdSize แบบปรับเปลี่ยนในบรรทัดสำหรับการวางแนวปัจจุบัน
    3. หากต้องการจำกัดความสูงของแบนเนอร์ ให้ใช้เมธอดแบบคงที่ AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight)
  2. สร้างออบเจ็กต์ AdManagerBannerAd ด้วยรหัสหน่วยโฆษณา ขนาดโฆษณาแบบปรับเปลี่ยนได้ และออบเจ็กต์คําขอโฆษณา
  3. โหลดโฆษณา
  4. ใน onAdLoaded callback ให้ใช้ AdManagerBannerAd.getPlatformAdSize() เพื่อรับขนาดโฆษณาแพลตฟอร์มที่อัปเดตและอัปเดตความสูงของคอนเทนเนอร์ AdWidget

ตัวอย่างโค้ด

วิดเจ็ตต่อไปนี้เป็นตัวอย่างวิดเจ็ตที่โหลดแบนเนอร์แบบปรับขนาดได้แบบแทรกในบรรทัดให้พอดีกับความกว้างของหน้าจอ โดยพิจารณาชิ้นงานต่างๆ

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

/// This example demonstrates inline adaptive banner ads.
///
/// Loads and shows an inline adaptive banner ad in a scrolling view,
/// and reloads the ad when the orientation changes.
class InlineAdaptiveExample extends StatefulWidget {
  @override
  _InlineAdaptiveExampleState createState() => _InlineAdaptiveExampleState();
}

class _InlineAdaptiveExampleState extends State<InlineAdaptiveExample> {
  static const _insets = 16.0;
  AdManagerBannerAd? _inlineAdaptiveAd;
  bool _isLoaded = false;
  AdSize? _adSize;
  late Orientation _currentOrientation;

  double get _adWidth => MediaQuery.of(context).size.width - (2 * _insets);

  @override
  void didChangeDependencies() {
    super.didChangeDependencies();
    _currentOrientation = MediaQuery.of(context).orientation;
    _loadAd();
  }

  void _loadAd() async {
    await _inlineAdaptiveAd?.dispose();
    setState(() {
      _inlineAdaptiveAd = null;
      _isLoaded = false;
    });

    // Get an inline adaptive size for the current orientation.
    AdSize size = AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(
        _adWidth.truncate());

    _inlineAdaptiveAd = AdManagerBannerAd(
      // TODO: replace with your own ad unit.
      adUnitId: '/21775744923/example/adaptive-banner',
      size: size,
      request: AdManagerAdRequest(),
      listener: AdManagerBannerAdListener(
        onAdLoaded: (Ad ad) async {
          print('Inline adaptive banner loaded: ${ad.responseInfo}');

          // After the ad is loaded, get the platform ad size and use it to
          // update the height of the container. This is necessary because the
          // height can change after the ad is loaded.
          AdManagerBannerAd bannerAd = (ad as AdManagerBannerAd);
          final AdSize? size = await bannerAd.getPlatformAdSize();
          if (size == null) {
            print('Error: getPlatformAdSize() returned null for $bannerAd');
            return;
          }

          setState(() {
            _inlineAdaptiveAd = bannerAd;
            _isLoaded = true;
            _adSize = size;
          });
        },
        onAdFailedToLoad: (Ad ad, LoadAdError error) {
          print('Inline adaptive banner failedToLoad: $error');
          ad.dispose();
        },
      ),
    );
    await _inlineAdaptiveAd!.load();
  }

  /// Gets a widget containing the ad, if one is loaded.
  ///
  /// Returns an empty container if no ad is loaded, or the orientation
  /// has changed. Also loads a new ad if the orientation changes.
  Widget _getAdWidget() {
    return OrientationBuilder(
      builder: (context, orientation) {
        if (_currentOrientation == orientation &&
            _inlineAdaptiveAd != null &&
            _isLoaded &&
            _adSize != null) {
          return Align(
              child: Container(
            width: _adWidth,
            height: _adSize!.height.toDouble(),
            child: AdWidget(
              ad: _inlineAdaptiveAd!,
            ),
          ));
        }
        // Reload the ad if the orientation changes.
        if (_currentOrientation != orientation) {
          _currentOrientation = orientation;
          _loadAd();
        }
        return Container();
      },
    );
  }

  @override
  Widget build(BuildContext context) => Scaffold(
      appBar: AppBar(
        title: Text('Inline adaptive banner example'),
      ),
      body: Center(
        child: Padding(
          padding: const EdgeInsets.symmetric(horizontal: _insets),
          child: ListView.separated(
            itemCount: 20,
            separatorBuilder: (BuildContext context, int index) {
              return Container(
                height: 40,
              );
            },
            itemBuilder: (BuildContext context, int index) {
              if (index == 10) {
                return _getAdWidget();
              }
              return Text(
                'Placeholder text',
                style: TextStyle(fontSize: 24),
              );
            },
          ),
        ),
      ));

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