Quảng cáo 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 biểu ngữ ban đầu được yêu cầu. Quảng cáo biểu ngữ có thể thu gọn nhằm cải thiện hiệu suất của quảng cáo cố định có kích thước nhỏ hơn. Hướng dẫn này cho biết cách bật quảng cáo biểu ngữ có thể thu gọn cho các vị trí biểu ngữ hiện có.

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

Triển khai

Đảm bảo chế độ xem biểu ngữ của bạn được xác định bằng kích thước mà bạn muốn người dùng thấy ở trạng thái biểu ngữ thông thường (đã thu gọn). Thêm một thông số bổ sung vào yêu cầu quảng cáo với collapsible làm khoá và vị trí của quảng cáo làm giá trị.

Vị trí có thể thu gọn xác định cách vùng mở rộng liên kết với quảng cáo biểu ngữ.

Giá trị Placement Hành vi Trường hợp sử dụng dự kiến
top Phần trên cùng của quảng cáo mở rộng sẽ căn chỉnh với phần trên cùng của quảng cáo thu gọn. Quảng cáo được đặt ở đầu màn hình.
bottom Phần dưới cùng của quảng cáo mở rộng sẽ căn chỉnh với phần dưới cùng của quảng cáo thu gọn. Quảng cáo nằm ở cuối màn hình.

Nếu quảng cáo được tải là biểu ngữ có thể thu gọn, thì biểu ngữ sẽ hiển thị lớp phủ có thể thu gọn ngay sau khi được đặt trong hệ phân cấp chế độ xem.

Java

private void loadBannerAd() {
  adView = new AdView(this);
  adView.setAdUnitId("ca-app-pub-3940256099942544/2014213617")

  AdSize adSize = getAdSize();
  adView.setAdSize(adSize);
  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  Bundle extras = new Bundle();
  extras.putString("collapsible", "bottom");

  AdRequest adRequest = new AdRequest.Builder()
      .addNetworkExtrasBundle(AdMobAdapter.class, extras)
     .build();

  adView.loadAd(adRequest);
}

Kotlin

private fun loadBanner() {adView = AdView(this);
  adView.adUnitId = "ca-app-pub-3940256099942544/2014213617"

  adView.setAdSize(adSize)

  // Create an extra parameter that aligns the bottom of the expanded ad to
  // the bottom of the bannerView.
  val extras = Bundle()
  extras.putString("collapsible", "bottom")

  val adRequest = AdRequest.Builder()
    .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
    .build()

  adView.loadAd(adRequest)
}

Hành vi làm mới quảng cáo

Đối với các ứng dụng định cấu hình tính năng tự động làm mới cho quảng cáo biểu ngữ trong giao diện web của Ad Manager, khi một quảng cáo biểu ngữ có thể thu gọn được yêu cầu cho một vị trí biểu ngữ, thì các lượt làm mới quảng cáo tiếp theo sẽ không yêu cầu quảng cáo biểu ngữ có thể thu gọn. Lý do là việc hiển thị biểu ngữ có thể thu gọn trên mỗi lần làm mới có thể ảnh hưởng tiêu cực đến trải nghiệm người dùng.

Nếu muốn tải một quảng cáo biểu ngữ có thể thu gọn khác vào lúc khác trong phiên, bạn có thể tải quảng cáo theo cách thủ công bằng một yêu cầu chứa thông số có thể thu gọn.

Kiểm tra xem quảng cáo đã tải có thể thu gọn hay không

Quảng cáo biểu ngữ không thể thu gọn đủ điều kiện để trả về cho các yêu cầu quảng cáo biểu ngữ có thể thu gọn nhằm tối đa hoá hiệu suất. Gọi isCollapsible để kiểm tra xem biểu ngữ cuối cùng đã tải có thể thu gọn hay không. Nếu yêu cầu không tải được và biểu ngữ trước đó có thể thu gọn, thì API sẽ trả về giá trị true.

Java

public void onAdLoaded() {
  Log.i(TAG, String.format("The last loaded banner is %scollapsible.", adView.isCollapsible() ? "" : "not "));
}

Kotlin

fun onAdLoaded() {
  Log.i(TAG, "The last loaded banner is ${if (adView.isCollapsible) "" else "not "}collapsible.")
}

Dàn xếp

Quảng cáo biểu ngữ có thể thu gọn chỉ dành cho nhu cầu của Google. Quảng cáo được phân phát thông qua tính năng dàn xếp hiển thị dưới dạng quảng cáo biểu ngữ thông thường, không thể thu gọn.