Biểu ngữ

Quảng cáo biểu ngữ chiếm một vị trí trong bố cục của ứng dụng, ở đầu hoặc cuối màn hình thiết bị. Những quảng cáo này lưu lại trên màn hình trong khi người dùng tương tác với ứng dụng và có thể tự động làm mới sau một khoảng thời gian nhất định.

Hướng dẫn này giúp bạn bắt đầu sử dụng quảng cáo biểu ngữ thích ứng cố định. Biểu ngữ thích ứng cố định tối ưu hoá kích thước quảng cáo cho từng thiết bị bằng cách sử dụng chiều rộng quảng cáo mà bạn chỉ định.

Quảng cáo biểu ngữ thích ứng cố định là quảng cáo có tỷ lệ khung hình cố định thay vì quảng cáo có kích thước cố định. Tỷ lệ khung hình tương tự như 320x50. Sau khi bạn chỉ định chiều rộng đầy đủ có sẵn, SDK quảng cáo trên thiết bị di động của Google sẽ trả về một quảng cáo có chiều cao tối ưu cho chiều rộng đó. Chiều cao tối ưu cho quảng cáo luôn giữ nguyên trên các yêu cầu quảng cáo khác nhau và nội dung xung quanh quảng cáo vẫn giữ nguyên vị trí khi quảng cáo làm mới.

Luôn thử nghiệm bằng quảng cáo thử nghiệm

Khi tạo và thử nghiệm ứng dụng, hãy nhớ sử dụng quảng cáo thử nghiệm thay vì quảng cáo đang chạy trong thực tế. Nếu không làm như vậy, tài khoản của bạn có thể bị tạm ngưng.

Cách dễ nhất để tải quảng cáo thử nghiệm là sử dụng mã đơn vị quảng cáo thử nghiệm dành riêng cho quảng cáo biểu ngữ:

/21775744923/example/adaptive-banner

Các đơn vị quảng cáo thử nghiệm được định cấu hình để trả về quảng cáo thử nghiệm cho mọi yêu cầu, và bạn có thể sử dụng các đơn vị quảng cáo này trong ứng dụng của mình khi lập trình, thử nghiệm và gỡ lỗi. Bạn chỉ cần nhớ thay thế mã này bằng mã đơn vị quảng cáo của mình trước khi xuất bản ứng dụng.

Lấy kích thước quảng cáo

Để yêu cầu quảng cáo biểu ngữ có kích thước quảng cáo chính xác, hãy làm theo các bước sau:

1. Lấy chiều rộng của màn hình thiết bị theo pixel không phụ thuộc vào mật độ (dp) bằng cách sử dụng MediaQuery.of(context). Nếu không muốn sử dụng chiều rộng toàn màn hình, bạn có thể đặt chiều rộng riêng.

2. Sử dụng phương thức tĩnh thích hợp trên lớp AdSize để lấy đối tượng AdSize. Ví dụ: sử dụng AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(int width) để lấy kích thước quảng cáo cho hướng hiện tại.

// Get an AnchoredAdaptiveBannerAdSize before loading the ad.
final size = await AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(
    MediaQuery.sizeOf(context).width.truncate());

Tải quảng cáo

Sau đây là ví dụ về một đoạn mã tạo quảng cáo biểu ngữ:

class BannerExampleState extends State<BannerExample>{
  AdManagerBannerAd? _bannerAd;
  bool _isLoaded = false;

  // TODO: replace this test ad unit with your own ad unit.
  final adUnitId = '/21775744923/example/adaptive-banner';

  /// Loads a banner ad.
  void loadAd() async {
    // Get an AnchoredAdaptiveBannerAdSize before loading the ad.
    final size = await AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(
        MediaQuery.sizeOf(context).width.truncate());

    _bannerAd = AdManagerBannerAd(
      adUnitId: adUnitId,
      request: const AdManagerAdRequest(),
      size: size,
      listener: AdManagerBannerAdListener(
        // Called when an ad is successfully received.
        onAdLoaded: (ad) {
          debugPrint('$ad loaded.');
          setState(() {
            _isLoaded = true;
          });
        },
        // Called when an ad request failed.
        onAdFailedToLoad: (ad, err) {
          debugPrint('AdManagerBannerAd failed to load: $error');
          // Dispose the ad here to free resources.
          ad.dispose();
        },
      ),
    )..load();
  }
}

Sự kiện quảng cáo biểu ngữ

Khi sử dụng AdManagerBannerAdListener, bạn có thể theo dõi các sự kiện trong vòng đời của quảng cáo, chẳng hạn như khi người dùng tải một quảng cáo. Sau đây là ví dụ về cách triển khai từng phương thức và ghi nhật ký thông báo vào bảng điều khiển:

class BannerExampleState extends State<BannerExample> {
  AdManagerBannerAd? _bannerAd;
  bool _isLoaded = false;

  // TODO: replace this test ad unit with your own ad unit.
  final adUnitId = '/21775744923/example/adaptive-banner';


  /// Loads a banner ad.
  void loadAd() async {
    // Get an AnchoredAdaptiveBannerAdSize before loading the ad.
    final size = await AdSize.getCurrentOrientationAnchoredAdaptiveBannerAdSize(
        MediaQuery.sizeOf(context).width.truncate());

    _bannerAd = AdManagerBannerAd(
      adUnitId: adUnitId,
      request: const AdManagerAdRequest(),
      size: size,
      listener: AdManagerBannerAdListener(
        // Called when an ad is successfully received.
        onAdLoaded: (ad) {
          debugPrint('$ad loaded.');
          setState(() {
            _isLoaded = true;
          });
        },
        // Called when an ad request failed.
        onAdFailedToLoad: (ad, err) {
          debugPrint('AdManagerBannerAd failed to load: $error');
          // Dispose the ad here to free resources.
          ad.dispose();
        },
        // Called when an ad opens an overlay that covers the screen.
        onAdOpened: (Ad ad) {},
        // Called when an ad removes an overlay that covers the screen.
        onAdClosed: (Ad ad) {},
        // Called when an impression occurs on the ad.
        onAdImpression: (Ad ad) {},
      ),
    )..load();
  }
}

Làm mới quảng cáo

Nếu đã định cấu hình đơn vị quảng cáo để làm mới, bạn không cần yêu cầu một quảng cáo khác khi quảng cáo không tải được. SDK quảng cáo trên thiết bị di động của Google sẽ tuân theo mọi tốc độ làm mới mà bạn chỉ định trong giao diện người dùng Ad Manager. Nếu bạn chưa bật tính năng làm mới, hãy đưa ra yêu cầu mới. Để biết thêm thông tin chi tiết về việc làm mới đơn vị quảng cáo, chẳng hạn như việc đặt tốc độ làm mới, hãy xem bài viết Tốc độ làm mới của quảng cáo trong ứng dụng dành cho thiết bị di động.

Lưu ý: Khi bạn đặt tốc độ làm mới trong giao diện người dùng của Ad Manager, tính năng làm mới tự động chỉ xảy ra nếu biểu ngữ hiển thị trên màn hình.

Hiển thị quảng cáo biểu ngữ

Để hiển thị AdManagerBannerAd dưới dạng một tiện ích, bạn phải tạo bản sao AdWidget với một quảng cáo được hỗ trợ sau khi gọi load(). Bạn có thể tạo tiện ích trước khi gọi load(), nhưng phải gọi load() trước khi thêm tiện ích đó vào cây tiện ích.

AdWidget kế thừa từ lớp Tiện ích của Flutter và có thể được sử dụng như bất kỳ tiện ích nào khác. Trên iOS, hãy nhớ đặt tiện ích này trong một tiện ích đã được chỉ định chiều rộng và chiều cao. Nếu không, quảng cáo của bạn có thể sẽ không hiển thị. Bạn có thể đặt AdManagerBannerAd trong một vùng chứa có kích thước phù hợp với quảng cáo:

if (_bannerAd != null) {
  Align(
    alignment: Alignment.bottomCenter,
    child: SafeArea(
      child: SizedBox(
        width: _bannerAd!.size.width.toDouble(),
        height: _bannerAd!.size.height.toDouble(),
        child: AdWidget(ad: _bannerAd!),
      ),
    ),
  )
}

Bạn phải loại bỏ quảng cáo khi không cần truy cập vào quảng cáo đó nữa. Bạn nên gọi dispose() sau khi AdWidget bị xoá khỏi cây tiện ích hoặc trong lệnh gọi lại AdManagerBannerAdListener.onAdFailedToLoad().

Vậy là xong! Ứng dụng của bạn hiện đã sẵn sàng hiển thị quảng cáo biểu ngữ.

Giới hạn cuộn trên Android 9 trở xuống

Chúng tôi nhận thấy rằng một số thiết bị cũ hoặc kém mạnh chạy Android 9 trở xuống có thể có hiệu suất không tối ưu khi hiển thị quảng cáo biểu ngữ nội tuyến trong chế độ xem cuộn. Bạn chỉ nên sử dụng các loại biểu ngữ này trên Android 10 trở lên. Biểu ngữ vị trí cố định (chẳng hạn như biểu ngữ neo) không bị ảnh hưởng và có thể được sử dụng với hiệu suất tối ưu trên tất cả các cấp độ API Android.

Tìm hiểu về các loại biểu ngữ khác

Làm quen với các loại biểu ngữ khác được xác định trong phần này cho ứng dụng Flutter.

Biểu ngữ thích ứng cùng dòng

Biểu ngữ thích ứng cùng dòng có chiều cao thay đổi và là biểu ngữ lớn hơn, cao hơn so với biểu ngữ thích ứng cố định. Bạn nên sử dụng biểu ngữ thích ứng cùng dòng thay vì quảng cáo biểu ngữ thích ứng cố định cho những ứng dụng đặt quảng cáo biểu ngữ trong nội dung có thể cuộn. Để biết thêm thông tin chi tiết, hãy xem bài viết biểu ngữ thích ứng nội tuyến.

Biểu ngữ có thể thu gọn

Quảng cáo biểu ngữ có thể thu gọn là quảng cáo biểu ngữ ban đầu được trình bày dưới dạng một lớp phủ lớn hơn, với một nút để thu gọn quảng cáo về kích thước nhỏ hơn. Hãy cân nhắc sử dụng biểu ngữ này để tối ưu hoá hiệu suất hơn nữa. Để biết thêm thông tin, hãy xem phần quảng cáo biểu ngữ có thể thu gọn.