AdRequest

public class AdRequest

已知的直接子类
AdManagerAdRequest

AdManagerAdRequest 包含用于从 Google Ad Manager 提取广告的定位信息。

AdRequest 包含用于提取广告的定位信息。广告请求是使用 AdRequest.Builder 创建的。

使用 Ad Manager 的发布商应使用 com.google.android.gms.ads.admanager.AdManagerAdRequest。

摘要

嵌套类型

构建 AdRequest。

常量
static final String
DEVICE_ID_EMULATOR = "B3EEABB8EE11C2BE770B684D95219ECB"

适用于与 setTestDeviceIds 搭配使用的模拟器的 deviceId。
static final int

由于缺少应用 ID，因此未发出广告请求。
static final int

内部出现问题；例如，收到广告服务器的无效响应。
static final int

广告字符串无效。
static final int

广告请求无效；例如，广告单元 ID 不正确。
static final int

中介适配器未填充广告请求。
static final int

由于网络连接问题，广告请求失败。
static final int

广告请求成功，但由于缺少广告资源，未返回广告。
static final int

在广告字符串中找不到请求 ID。
static final int

内容网址的长度上限。

公共方法
@Nullable String

获取广告字符串。
String

返回内容网址定位信息。
@Nullable Bundle
<T extends CustomEvent> getCustomEventExtrasBundle(Class<T> adapterClass)

此方法已废弃。

请改用 getNetworkExtrasBundle。
Set<String>

返回定位信息关键字。
List<String>

返回相邻内容网址的列表，如果未设置任何网址，则返回空列表。
@Nullable Bundle
<T extends MediationExtrasReceiver> getNetworkExtrasBundle(
    Class<T> adapterClass
)

返回要传递给特定广告联盟适配器的额外参数。
String

返回请求代理字符串，用于识别广告请求的来源。
boolean

如果此设备将接收测试广告，则返回 true。

常量

DEVICE_ID_EMULATOR

public static final String DEVICE_ID_EMULATOR = "B3EEABB8EE11C2BE770B684D95219ECB"

适用于与 setTestDeviceIds 搭配使用的模拟器的 deviceId。

ERROR_CODE_APP_ID_MISSING

public static final int ERROR_CODE_APP_ID_MISSING = 8

由于缺少应用 ID，因此未发出广告请求。

ERROR_CODE_INTERNAL_ERROR

public static final int ERROR_CODE_INTERNAL_ERROR = 0

内部出现问题；例如，收到广告服务器的无效响应。

ERROR_CODE_INVALID_AD_STRING

public static final int ERROR_CODE_INVALID_AD_STRING = 11

广告字符串无效。例如，广告字符串中没有请求 ID。

ERROR_CODE_INVALID_REQUEST

public static final int ERROR_CODE_INVALID_REQUEST = 1

广告请求无效；例如，广告单元 ID 不正确。

ERROR_CODE_MEDIATION_NO_FILL

public static final int ERROR_CODE_MEDIATION_NO_FILL = 9

中介适配器未填充广告请求。如果 getCode 返回此错误，请检查 getCause 以找出根本原因。

ERROR_CODE_NETWORK_ERROR

public static final int ERROR_CODE_NETWORK_ERROR = 2

由于网络连接问题，广告请求失败。

ERROR_CODE_NO_FILL

public static final int ERROR_CODE_NO_FILL = 3

广告请求成功，但由于缺少广告资源，未返回广告。

ERROR_CODE_REQUEST_ID_MISMATCH

public static final int ERROR_CODE_REQUEST_ID_MISMATCH = 10

在广告字符串中找不到请求 ID。

MAX_CONTENT_URL_LENGTH

public static final int MAX_CONTENT_URL_LENGTH = 512

内容网址的长度上限。

公共方法

getAdString

public @Nullable String getAdString()

获取广告字符串。

getContentUrl

public String getContentUrl()

返回内容网址定位信息。如果未设置 contentUrl，则返回 null。

getCustomEventExtrasBundle

public @Nullable Bundle <T extends CustomEvent> getCustomEventExtrasBundle(Class<T> adapterClass)

返回要传递给特定自定义事件适配器的额外参数。如果未设置任何提供类型的自定义事件 extra，则返回 null。

getKeywords

public Set<String> getKeywords()

返回定位信息关键字。如果未添加任何关键字，则返回空的 Set。

getNeighboringContentUrls

public List<String> getNeighboringContentUrls()

返回相邻内容网址的列表，如果未设置任何网址，则返回空列表。

getNetworkExtrasBundle

public @Nullable Bundle <T extends MediationExtrasReceiver> getNetworkExtrasBundle(
    Class<T> adapterClass
)

返回要传递给特定广告联盟适配器的额外参数。如果未设置任何提供类型的广告联盟 extra，则返回 null。

getRequestAgent

public String getRequestAgent()

返回请求代理字符串，用于识别广告请求的来源。

isTestDevice

public boolean isTestDevice(Context context)

如果此设备将接收测试广告，则返回 true。