Quảng cáo biểu ngữ có thể thu gọn

Chọn nền tảng: Android iOS Unity Flutter

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, có nút để thu gọn về kích thước biểu ngữ được yêu cầu ban đầu. Quảng cáo biểu ngữ có thể thu gọn được thiết kế để 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 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

Đảm bảo rằng 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 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à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 Đầu quảng cáo mở rộng sẽ căn chỉnh với đầu quảng cáo thu gọn. Quảng cáo nằm ở đầu màn hình.
bottom Phần dưới cùng của quảng cáo được mở rộng sẽ căn chỉnh với phần dưới cùng của quảng cáo bị 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 khung hiển thị.

Java

private void loadCollapsibleBanner() {
  // 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");

  // Create an ad request.
  AdRequest adRequest =
      new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();

  // ...

  // Start loading a collapsible banner ad.
  adView.loadAd(adRequest);
}

CollapsibleBannerFragment.java

Kotlin

private fun loadCollapsibleBanner() {
  // 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")

  // Create an ad request.
  val adRequest =
    AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()

  // ...

  // Start loading a collapsible banner ad.
  adView.loadAd(adRequest)
}

CollapsibleBannerFragment.kt

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

Đối với những ứ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 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ùng quảng cáo 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à vì 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 về 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ữ được tải gần đây nhất 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(
      MainActivity.LOG_TAG,
      String.format("Ad loaded. adView.isCollapsible() is %b.", adView.isCollapsible()));
}
CollapsibleBannerFragment.java

Kotlin

override fun onAdLoaded() {
  Log.i(
    MainActivity.LOG_TAG,
    "Ad loaded. adView.isCollapsible() is ${adView.isCollapsible}.",
  )
}
CollapsibleBannerFragment.kt

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 hoạt độ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.