AdRequest

class AdRequest

Các lớp con trực tiếp đã biết
AdManagerAdRequest

AdManagerAdRequest chứa thông tin nhắm mục tiêu dùng để tìm nạp quảng cáo từ Google Ad Manager.

AdRequest chứa thông tin nhắm mục tiêu được dùng để tìm nạp quảng cáo. Yêu cầu quảng cáo được tạo bằng AdRequest.Builder.

Nhà xuất bản sử dụng Ad Manager nên dùng com.google.android.gms.ads.admanager.AdManagerAdRequest.

Tóm tắt

Các loại lồng nhau

Tạo một AdRequest.

Hằng số
const String!
DEVICE_ID_EMULATOR = "B3EEABB8EE11C2BE770B684D95219ECB"

deviceId cho các trình mô phỏng sẽ được dùng với setTestDeviceIds.
const Int

Yêu cầu quảng cáo không được thực hiện do thiếu mã ứng dụng.
const Int

Đã xảy ra lỗi nội bộ; ví dụ: bạn đã nhận được phản hồi không hợp lệ từ máy chủ quảng cáo.
const Int

Chuỗi quảng cáo không hợp lệ.
const Int

Yêu cầu quảng cáo không hợp lệ; ví dụ: mã đơn vị quảng cáo không chính xác.
const Int

Bộ chuyển đổi dàn xếp không đáp ứng yêu cầu quảng cáo.
const Int

Yêu cầu quảng cáo không thành công do không có kết nối mạng.
const Int

Yêu cầu quảng cáo đã được thực hiện thành công, nhưng hệ thống không trả về quảng cáo do thiếu khoảng không quảng cáo.
const Int

Không tìm thấy mã yêu cầu trong chuỗi quảng cáo.
const Int

Độ dài tối đa của URL nội dung.

Hàm công khai
String?

Lấy chuỗi quảng cáo.
String!

Trả về thông tin nhắm mục tiêu theo URL nội dung.
Bundle?
<T : CustomEvent?> getCustomEventExtrasBundle(adapterClass: Class<T!>!)

Hàm này không còn được dùng nữa.

Thay vào đó, hãy sử dụng getNetworkExtrasBundle.
(Mutable)Set<String!>!

Trả về các từ khoá thông tin nhắm mục tiêu.
(Mutable)List<String!>!

Trả về danh sách URL nội dung lân cận hoặc danh sách trống nếu không có URL nào được đặt.
Bundle?
<T : MediationExtrasReceiver?> getNetworkExtrasBundle(
    adapterClass: Class<T!>!
)

Trả về các thông số bổ sung để truyền đến một bộ chuyển đổi mạng quảng cáo cụ thể.
Long

Lấy mã vị trí được đặt trong AdRequest này
String!

Trả về chuỗi tác nhân yêu cầu để xác định nguồn gốc của yêu cầu quảng cáo.
Boolean
isTestDevice(context: Context!)

Trả về true nếu thiết bị này sẽ nhận được quảng cáo thử nghiệm.

Hằng số

DEVICE_ID_EMULATOR

const val DEVICE_ID_EMULATOR = "B3EEABB8EE11C2BE770B684D95219ECB": String!

deviceId cho các trình mô phỏng sẽ được dùng với setTestDeviceIds.

ERROR_CODE_APP_ID_MISSING

const val ERROR_CODE_APP_ID_MISSING = 8: Int

Yêu cầu quảng cáo không được thực hiện do thiếu mã ứng dụng.

ERROR_CODE_INTERNAL_ERROR

const val ERROR_CODE_INTERNAL_ERROR = 0: Int

Đã xảy ra lỗi nội bộ; ví dụ: bạn đã nhận được phản hồi không hợp lệ từ máy chủ quảng cáo.

ERROR_CODE_INVALID_AD_STRING

const val ERROR_CODE_INVALID_AD_STRING = 11: Int

Chuỗi quảng cáo không hợp lệ. Ví dụ: không có mã yêu cầu trong chuỗi quảng cáo.

ERROR_CODE_INVALID_REQUEST

const val ERROR_CODE_INVALID_REQUEST = 1: Int

Yêu cầu quảng cáo không hợp lệ; ví dụ: mã đơn vị quảng cáo không chính xác.

ERROR_CODE_MEDIATION_NO_FILL

const val ERROR_CODE_MEDIATION_NO_FILL = 9: Int

Bộ chuyển đổi dàn xếp không đáp ứng yêu cầu quảng cáo. Nếu lỗi này được trả về từ getCode, hãy kiểm tra getCause để biết nguyên nhân cơ bản.

ERROR_CODE_NETWORK_ERROR

const val ERROR_CODE_NETWORK_ERROR = 2: Int

Yêu cầu quảng cáo không thành công do không có kết nối mạng.

ERROR_CODE_NO_FILL

const val ERROR_CODE_NO_FILL = 3: Int

Yêu cầu quảng cáo đã được thực hiện thành công, nhưng hệ thống không trả về quảng cáo do thiếu khoảng không quảng cáo.

ERROR_CODE_REQUEST_ID_MISMATCH

const val ERROR_CODE_REQUEST_ID_MISMATCH = 10: Int

Không tìm thấy mã yêu cầu trong chuỗi quảng cáo.

MAX_CONTENT_URL_LENGTH

const val MAX_CONTENT_URL_LENGTH = 512: Int

Độ dài tối đa của URL nội dung.

Hàm công khai

getAdString

fun getAdString(): String?

Lấy chuỗi quảng cáo.

getContentUrl

fun getContentUrl(): String!

Trả về thông tin nhắm mục tiêu theo URL nội dung. Trả về null nếu contentUrl chưa được đặt.

getCustomEventExtrasBundle

fun <T : CustomEvent?> getCustomEventExtrasBundle(adapterClass: Class<T!>!): Bundle?

Trả về các tham số bổ sung để truyền đến một bộ chuyển đổi sự kiện tuỳ chỉnh cụ thể. Trả về null nếu không có lớp bổ sung sự kiện tuỳ chỉnh nào thuộc loại được cung cấp được đặt.

getKeywords

fun getKeywords(): (Mutable)Set<String!>!

Trả về các từ khoá thông tin nhắm mục tiêu. Trả về một Set trống nếu không có từ khoá nào được thêm.

getNeighboringContentUrls

fun getNeighboringContentUrls(): (Mutable)List<String!>!

Trả về danh sách URL nội dung lân cận hoặc danh sách trống nếu không có URL nào được đặt.

getNetworkExtrasBundle

fun <T : MediationExtrasReceiver?> getNetworkExtrasBundle(
    adapterClass: Class<T!>!
): Bundle?

Trả về các thông số bổ sung để truyền đến một bộ chuyển đổi mạng quảng cáo cụ thể. Trả về null nếu không có lớp bổ sung mạng nào thuộc loại được cung cấp được đặt.

getPlacementId

fun getPlacementId(): Long

Lấy mã vị trí được đặt trong AdRequest này

getRequestAgent

fun getRequestAgent(): String!

Trả về chuỗi tác nhân yêu cầu để xác định nguồn gốc của yêu cầu quảng cáo.

isTestDevice

fun isTestDevice(context: Context!): Boolean

Trả về true nếu thiết bị này sẽ nhận được quảng cáo thử nghiệm.