Sử dụng biểu ngữ có thể thu gọn

Chọn nền tảng: Android (beta) 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 lớp phủ lớn hơn, có một nút để thu gọn về kích thước biểu ngữ được yêu cầu ban đầu. Biểu ngữ có thể thu gọn nhằm mục đích cải thiện hiệu quả của quảng cáo neo 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

• Hoàn tất hướng dẫn bắt đầu sử dụng quảng cáo biểu ngữ.

Triển khai

Đảm bảo rằng chế độ xem biểu ngữ đượ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). Thêm một tham số bổ sung vào yêu cầu quảng cáo với collapsible làm khoá và vị trí đặt quảng cáo làm giá trị.

Vị trí đặt có thể thu gọn xác định cách vùng mở rộng neo vào quảng cáo biểu ngữ.

Nếu quảng cáo đã 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 view.

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

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 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 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ượt 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 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 tham 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.

public void onAdLoaded() {
  Log.i(
      MainActivity.LOG_TAG,
      String.format("Ad loaded. adView.isCollapsible() is %b.", adView.isCollapsible()));
}
CollapsibleBannerFragment.java

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ỉ áp dụng 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.