Sử dụng biểu ngữ thích ứng cùng dòng cho biểu ngữ có thể cuộn

Biểu ngữ thích ứng là thế hệ quảng cáo thích ứng tiếp theo, giúp tối đa hoá hiệu suất bằng cách tối ưu hoá kích thước quảng cáo cho từng thiết bị. Cải thiện biểu ngữ có kích thước cố định (chỉ hỗ trợ chiều cao cố định), biểu ngữ thích ứng cho phép nhà phát triển chỉ định chiều rộng quảng cáo và sử dụng chiều rộng này để xác định kích thước quảng cáo tối ưu.

Để chọn kích thước quảng cáo phù hợp nhất, biểu ngữ thích ứng cùng dòng sử dụng chiều cao tối đa thay vì chiều cao cố định. Điều này mang lại cơ hội cải thiện hiệu suất.

Trường hợp nên sử dụng biểu ngữ thích ứng cùng dòng

Biểu ngữ thích ứng cùng dòng là biểu ngữ lớn hơn, cao hơn so với biểu ngữ thích ứng cố định. Các quảng cáo này có chiều cao thay đổi và có thể cao bằng màn hình thiết bị.

Loại quảng cáo này được thiết kế để đặt trong nội dung có thể cuộn, ví dụ:

Điều kiện tiên quyết

Trước khi bắt đầu

Khi triển khai biểu ngữ thích ứng trong ứng dụng, hãy lưu ý những điểm sau:

  • Đảm bảo bạn đang sử dụng phiên bản mới nhất của Google Mobile Ads Flutter Plugin và nếu sử dụng tính năng dàn xếp, hãy sử dụng phiên bản mới nhất của bộ chuyển đổi dàn xếp.

  • Kích thước biểu ngữ thích ứng cùng dòng được thiết kế để hoạt động hiệu quả nhất khi sử dụng toàn bộ chiều rộng có sẵn. Trong hầu hết các trường hợp, đây sẽ là toàn bộ chiều rộng của màn hình thiết bị đang dùng. Hãy nhớ tính đến các vùng an toàn hiện hành.

  • Bạn có thể cần cập nhật hoặc tạo mục hàng mới để sử dụng kích thước thích ứng. Tìm hiểu thêm.

  • Các phương thức để lấy kích thước quảng cáo là

    • AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(int width)
    • AdSize.getLandscapeInlineAdaptiveBannerAdSize(int width)
    • AdSize.getPortraitInlineAdaptiveBannerAdSize(int width)
    • AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight)
  • Khi sử dụng API biểu ngữ thích ứng cùng dòng, Google Mobile Ads Flutter Plugin sẽ trả về một AdSize có chiều rộng nhất định và cờ cùng dòng. Chiều cao là 0 hoặc maxHeight, tuỳ thuộc vào API bạn đang sử dụng. Chiều cao thực tế của quảng cáo sẽ được cung cấp khi quảng cáo được trả về.

  • Biểu ngữ thích ứng cùng dòng được thiết kế để đặt trong nội dung có thể cuộn. Biểu ngữ có thể cao bằng màn hình thiết bị hoặc bị giới hạn theo chiều cao tối đa, tuỳ thuộc vào API.

Triển khai

Làm theo các bước bên dưới để triển khai một biểu ngữ thích ứng cùng dòng đơn giản.

  1. Nhận kích thước quảng cáo biểu ngữ thích ứng cùng dòng. Kích thước mà bạn nhận được sẽ được dùng để yêu cầu biểu ngữ thích ứng. Để có kích thước quảng cáo thích ứng, hãy đảm bảo rằng bạn:
    1. Biết chiều rộng của thiết bị mà bạn đang sử dụng theo pixel không phụ thuộc vào mật độ hoặc đặt chiều rộng riêng nếu bạn không muốn sử dụng chiều rộng toàn màn hình. Bạn có thể dùng MediaQuery.of(context) để lấy chiều rộng màn hình.
    2. Sử dụng các phương thức tĩnh thích hợp trên lớp kích thước quảng cáo, chẳng hạn như AdSize.getCurrentOrientationInlineAdaptiveBannerAdSize(int width) để nhận đối tượng AdSize thích ứng cùng dòng cho hướng hiện tại.
    3. Nếu muốn giới hạn chiều cao của biểu ngữ, bạn có thể sử dụng phương thức tĩnh AdSize.getInlineAdaptiveBannerAdSize(int width, int maxHeight).
  2. Tạo đối tượng AdManagerBannerAd bằng mã đơn vị quảng cáo, kích thước quảng cáo thích ứng và đối tượng yêu cầu quảng cáo.
  3. Tải quảng cáo.
  4. Trong lệnh gọi lại onAdLoaded, hãy sử dụng AdManagerBannerAd.getPlatformAdSize() để lấy kích thước quảng cáo mới nhất của nền tảng và cập nhật chiều cao vùng chứa AdWidget.
  5. Trước khi hiển thị quảng cáo trong danh sách có thể cuộn, hãy kiểm tra thuộc tính AdManagerBannerAd.isMounted. Quá trình này đảm bảo rằng thực thể quảng cáo không được gắn vào cây tiện ích.

Ví dụ về mã

Dưới đây là một tiện ích mẫu tải biểu ngữ thích ứng cùng dòng để vừa với chiều rộng của màn hình, có tính đến các phần lồng ghép:

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 &&
            !_inlineAdaptiveAd!.isMounted &&
            _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();
  }
}