SDK Quảng cáo của Google trên thiết bị di động đang ở chế độ bảo trì. Để sử dụng các tính năng và bản cập nhật mới nhất, hãy migrate và thiết lập GMA Next-Gen SDK.

Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

MediationBannerAdapter

Kotlin |Java

public interface MediationBannerAdapter extends MediationAdapter

Bộ chuyển đổi cho mạng quảng cáo bên thứ ba hỗ trợ quảng cáo biểu ngữ.

Vòng đời điển hình của một bộ chuyển đổi là gọi requestBannerAd một lần. Lúc này, bộ chuyển đổi sẽ yêu cầu quảng cáo từ mạng quảng cáo và báo cáo cho trình nghe onAdLoaded hoặc onAdFailedToLoad. Các yêu cầu tiếp theo sẽ được thực hiện bằng một phiên bản mới của bộ chuyển đổi. Khi kết thúc vòng đời, hệ thống sẽ cố gắng hết sức để gọi onDestroy, mặc dù không đảm bảo điều này. Xin lưu ý rằng requestBannerAd được gọi trên luồng giao diện người dùng, vì vậy, tất cả các biện pháp phòng ngừa tiêu chuẩn khi viết mã trên luồng đó đều được áp dụng. Cụ thể, mã không được gọi bất kỳ phương thức chặn nào.

Bộ chuyển đổi dự kiến sẽ hiển thị các sự kiện thông qua MediationBannerListener được truyền trong lệnh gọi requestBannerAd. Tất cả các thông số cần thiết để đưa ra yêu cầu quảng cáo đều phải được truyền trong các thông số serverParameters, MediationAdRequest và mediationExtras.

Các bộ chuyển đổi phải cố gắng tắt tính năng tự động làm mới quảng cáo ở phía máy khách. Quảng cáo được làm mới có thể bị bỏ qua, không hiển thị và được tính không chính xác.

Tóm tắt

Phương thức công khai
`abstract View`	`getBannerView()` Trả về một `View` có thể được hiển thị để cho thấy quảng cáo.
`abstract void`	`requestBannerAd( Context context, MediationBannerListener listener, Bundle serverParameters, AdSize adSize, MediationAdRequest mediationAdRequest, @Nullable Bundle mediationExtras )` Được thư viện dàn xếp gọi để yêu cầu quảng cáo biểu ngữ từ bộ chuyển đổi.

Các phương thức kế thừa

Từ com.google.android.gms.ads.mediation.MediationAdapter

`abstract void`	`onDestroy()` Tháo rời bộ điều khiển đầu nối.
`abstract void`	`onPause()` Được gọi khi ứng dụng gọi `onPause` trên `com.google.android.gms.ads.AdView`.
`abstract void`	`onResume()` Được gọi khi ứng dụng gọi `onResume` trên `com.google.android.gms.ads.AdView`.

Phương thức công khai

getBannerView

abstract View getBannerView()

Trả về một View có thể được hiển thị để cho thấy quảng cáo.

Giá trị này không được rỗng sau lệnh gọi requestBannerAd và trước lệnh gọi onDestroy. Giá trị này có thể rỗng vào bất kỳ thời điểm nào khác.

requestBannerAd

abstract void requestBannerAd(
    Context context,
    MediationBannerListener listener,
    Bundle serverParameters,
    AdSize adSize,
    MediationAdRequest mediationAdRequest,
    @Nullable Bundle mediationExtras
)

Được thư viện dàn xếp gọi để yêu cầu quảng cáo biểu ngữ từ bộ chuyển đổi.

Nếu yêu cầu thành công, bạn nên gọi phương thức onAdLoaded.

Nếu yêu cầu không thành công, phương thức onAdFailedToLoad sẽ được gọi trên listener với một nguyên nhân gây ra lỗi thích hợp.

Phương thức này được gọi trên luồng giao diện người dùng, vì vậy, mọi biện pháp phòng ngừa tiêu chuẩn khi viết mã trên luồng đó đều được áp dụng. Cụ thể, mã của bạn không được gọi bất kỳ phương thức chặn nào.

Thông số
`Context context`	`Context` của AdView sẽ chứa Chế độ xem biểu ngữ. Bạn nên dùng `android.app.Activity`.
`MediationBannerListener listener`	Trình nghe đến bộ chuyển đổi có lệnh gọi lại cho nhiều sự kiện
`Bundle serverParameters`	Các thông số bổ sung do nhà xuất bản xác định ở phía máy chủ dàn xếp
`AdSize adSize`	Kích thước của quảng cáo cần tìm nạp. Kích thước quảng cáo được trả về phải có kích thước gần với kích thước được chỉ định trong tham số này nhất có thể. Nếu kích thước quảng cáo này không được hỗ trợ, yêu cầu sẽ không thành công và onAdFailedToLoad sẽ được gọi.
`MediationAdRequest mediationAdRequest`	Các thông số chung mà nhà xuất bản này sử dụng khi đưa ra yêu cầu quảng cáo
`@Nullable Bundle mediationExtras`	Các thông số bổ sung do nhà xuất bản đặt trên cơ sở mỗi yêu cầu