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 những quảng cáo cố định có kích thước nhỏ hơn. Hướng dẫn này trình bày cách bật quảng cáo biểu ngữ có thể thu gọn cho các vị trí đặt biểu ngữ hiện có.

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

Triển khai

Hãy đảm bảo chế độ xem biểu ngữ của bạn được xác định theo kích thước mà bạn muốn người dùng nhìn thấy ở trạng thái biểu ngữ thông thường (đã được thu gọn). Đưa một thông số bổ sung vào yêu cầu quảng cáo với collapsible là 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 được thu gọn. Quảng cáo được đặt ở cuối màn hình.

Nếu quảng cáo được tải là một 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 AdMob, 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ể tác độ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ỉ áp dụng cho nhu cầu của Google trong giai đoạn thử nghiệm. Quảng cáo được phân phát thông qua tính năng dàn xếp sẽ hiển thị dưới dạng quảng cáo biểu ngữ thông thường, không thể thu gọn.