Kết hợp yêu cầu quảng cáo gốc và quảng cáo biểu ngữ

Chỉ cần thay đổi một chút trong mã, bạn có thể kết hợp quảng cáo gốc và quảng cáo biểu ngữ trong các yêu cầu quảng cáo.

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

  • SDK Quảng cáo của Google trên thiết bị di động phiên bản 11.0.0 trở lên.

Tải một quảng cáo

Quảng cáo gốc do người dùng tuỳ chỉnh hiển thị được tải bằng lớp AdLoader. Lớp này có lớp AdLoader.Builder riêng để tuỳ chỉnh trong khi tạo. Bằng cách thêm trình nghe vào AdLoader trong khi tạo quảng cáo, ứng dụng sẽ chỉ định các loại định dạng quảng cáo có thể nhận. Sau đó, AdLoader sẽ chỉ yêu cầu các loại quảng cáo đó.

Bạn cũng có thể định cấu hình đối tượng AdLoader để đưa ra các yêu cầu quảng cáo có thể dẫn đến quảng cáo biểu ngữ hoặc quảng cáo gốc. Việc thêm một OnAdManagerAdViewLoadedListener vào AdLoader trong khi tạo sẽ chỉ định rằng quảng cáo biểu ngữ phải cạnh tranh với quảng cáo gốc để thực hiện yêu cầu.

Đoạn mã sau minh hoạ cách tạo một AdLoader có thể tải quảng cáo gốc hoặc quảng cáo biểu ngữ trong một yêu cầu duy nhất:

Java

AdLoader adLoader = new AdLoader.Builder(context, "/21775744923/example/native-and-banner")
    .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
      @Override
      public void onNativeAdLoaded(NativeAd nativeAd) {
        // Show the ad.
      }
    })
    .forAdManagerAdView(new OnAdManagerAdViewLoadedListener() {
      @Override
      public void onAdManagerAdViewLoaded(AdManagerAdView adView) {
        // Show the banner ad.
      }
    }, AdSize.BANNER, AdSize.MEDIUM_RECTANGLE)
    .withAdListener(new AdListener() {
      @Override
      public void onAdFailedToLoad(LoadAdError error) {
        // Handle the failure by logging, altering the UI, etc.
      }
    })
    .withAdManagerAdViewOptions(new AdManagerAdViewOptions.Builder()
      // Methods in the AdManagerAdViewOptions.Builder class can be
      // used here to specify individual options settings.
      .build())
    .build();

Kotlin

val adLoader = AdLoader.Builder(this, "/21775744923/example/native-and-banner")
    .forNativeAd { nativeAd ->
      // Show the ad.
    }
    .forAdManagerAdView({ adView ->
      // Show the banner ad.
    }, AdSize.BANNER, AdSize.MEDIUM_RECTANGLE)
    .withAdListener(object: AdListener() {
      override fun onAdFailedToLoad(adError: LoadAdError) {
        // Handle the failure by logging, altering the UI, etc.
      }
    })
    .withAdManagerAdViewOptions(AdManagerAdViewOptions.Builder()
      // Methods in the AdManagerAdViewOptions.Builder class can be
      // used here to specify individual options settings.
      .build())
    .build()

Phương thức forAdManagerAdView() chuẩn bị AdLoader để nhận quảng cáo biểu ngữ. Bạn phải chỉ định một danh sách có độ dài thay đổi gồm các kích thước quảng cáo hợp lệ cùng với OnAdManagerAdViewLoadedListener khi gọi forAdManagerAdView().

Để đưa ra một yêu cầu quảng cáo hợp lệ, bạn phải chỉ định ít nhất một kích thước quảng cáo hợp lệ. Khi một quảng cáo biểu ngữ đã tải thành công, hệ thống sẽ gọi phương thức onAdManagerAdViewLoaded() của đối tượng trình nghe được chỉ định.

Đặt đối tượng AdViewOptions

Hàm cuối cùng trong quá trình tạo AdLoader là một phương thức không bắt buộc khác, withAdManagerAdViewOptions():

Java

.withAdManagerAdViewOptions(new AdManagerAdViewOptions.Builder()
    // Methods in the AdManagerAdViewOptions.Builder class can be
    // used here to specify individual banner options settings.
    .build()

Kotlin

.withAdManagerAdViewOptions(AdManagerAdViewOptions.Builder()
    // Methods in the AdManagerAdViewOptions.Builder class can be
    // used here to specify individual banner options settings.
    .build()

Đối tượng AdManagerAdViewOptions cho phép nhà xuất bản đặt các lựa chọn cụ thể cho biểu ngữ do AdLoader tải, chẳng hạn như:

setManualImpressionsEnabled()
Cho phép báo cáo lượt hiển thị theo cách thủ công cho các lượt đặt trước của Google Ad Manager. Các ứng dụng sử dụng lượt hiển thị thủ công có thể tự xác định thời điểm ghi lại một lượt hiển thị và có thể thực hiện việc này bằng cách gọi AdManagerAdView.recordManualImpression().