AbstractAdRequestBuilder

abstract class AbstractAdRequestBuilder<T : AbstractAdRequestBuilder<T!>?>


一个有助于构建广告请求的基本构建器类。

摘要

公共函数

T!
@CanIgnoreReturnValue
addCustomEventExtrasBundle(
    adapterClass: Class<CustomEvent!>!,
    customEventExtras: Bundle!
)

此函数已弃用。

请改用 addNetworkExtrasBundle

T!

添加自定义定位参数。

T!

添加具有多个值的自定义定位参数。

T!

添加用于定位的关键字。

T!
@CanIgnoreReturnValue
addNetworkExtrasBundle(
    adapterClass: Class<MediationExtrasReceiver!>!,
    networkExtras: Bundle!
)

添加要传递给特定广告联盟适配器的额外参数。

T!

设置表示广告响应的广告字符串。

T!

为内容与应用的主要内容相符的网站设置内容网址。

T!

为 Google 移动广告 SDK 在广告请求期间发出的 HTTPS 调用设置自定义超时时间。

T!
@CanIgnoreReturnValue
setNeighboringContentUrls(
    neighboringContentUrls: (Mutable)List<String!>!
)

设置表示广告附近网页内容的网址。

T!

为加载的广告设置默认展示位置 ID。

T!

设置请求代理字符串以标识广告请求的来源。

受保护的函数

abstract T!

返回指定子类型的 self 实例。

公共函数

addCustomEventExtrasBundle

@CanIgnoreReturnValue
fun addCustomEventExtrasBundle(
    adapterClass: Class<CustomEvent!>!,
    customEventExtras: Bundle!
): T!

添加要传递给特定自定义事件适配器的额外参数。

参数
adapterClass: Class<CustomEvent!>!

您要为其提供 extra 信息的自定义事件适配器的 Class

customEventExtras: Bundle!

要传递给自定义事件适配器的额外信息 Bundle

addCustomTargeting

@CanIgnoreReturnValue
fun addCustomTargeting(key: String!, value: String!): T!

添加自定义定位参数。使用同一键再次调用此方法会覆盖旧值。

addCustomTargeting

@CanIgnoreReturnValue
fun addCustomTargeting(key: String!, values: (Mutable)List<String!>!): T!

添加具有多个值的自定义定位参数。使用同一键再次调用此方法会覆盖旧值。

addKeyword

@CanIgnoreReturnValue
fun addKeyword(keyword: String!): T!

添加用于定位的关键字。

addNetworkExtrasBundle

@CanIgnoreReturnValue
fun addNetworkExtrasBundle(
    adapterClass: Class<MediationExtrasReceiver!>!,
    networkExtras: Bundle!
): T!

添加要传递给特定广告联盟适配器的额外参数。

参数
adapterClass: Class<MediationExtrasReceiver!>!

应接收 extra 的适配器的 Class

networkExtras: Bundle!

要传递给中介适配器的额外信息。Bundle

setAdString

@CanIgnoreReturnValue
fun setAdString(adString: String!): T!

设置表示广告响应的广告字符串。如果设置了此参数,SDK 将呈现此广告,并忽略针对相应请求设置的所有其他定位信息。

setContentUrl

@CanIgnoreReturnValue
fun setContentUrl(contentUrl: String!): T!

为内容与应用的主要内容相符的网站设置内容网址。此网站内容用于定位和品牌保障目的。

抛出
java.lang.NullPointerException

如果 contentUrl 为 {code null}。

java.lang.IllegalArgumentException

如果 contentUrl 为空,或者其长度超过 512。

setHttpTimeoutMillis

@CanIgnoreReturnValue
fun setHttpTimeoutMillis(httpTimeoutMillis: Int): T!

为 Google 移动广告 SDK 在广告请求期间发出的 HTTPS 调用设置自定义超时时间。

如果您的应用使用中介功能,则此超时时间不适用于第三方广告联盟 SDK 发出的网络调用。

参数
httpTimeoutMillis: Int

一个整数,用于指定 HTTPS 超时时间(以毫秒为单位)。任何低于 5000(5 秒)的值都将被忽略。默认值为 60000(60 秒)。

setNeighboringContentUrls

@CanIgnoreReturnValue
fun setNeighboringContentUrls(
    neighboringContentUrls: (Mutable)List<String!>!
): T!

设置表示广告附近网页内容的网址。可提高品牌保障能力,并允许所展示的广告具有更适合相邻内容的应用级分级(MA、T、PG 等)。

参数
neighboringContentUrls: (Mutable)List<String!>!

要附加到现有相邻内容网址的相邻内容网址列表。

setPlacementId

@CanIgnoreReturnValue
fun setPlacementId(placementId: Long): T!

为加载的广告设置默认展示位置 ID。

对于横幅广告,建议改用 setPlacementId。使用设置了展示位置 ID 的请求调用 loadAd 与调用 setPlacementId 具有相同的效果

参数
placementId: Long

AdMob 界面为配置的展示位置提供的长整数。

setRequestAgent

@CanIgnoreReturnValue
fun setRequestAgent(requestAgent: String!): T!

设置请求代理字符串,以标识广告请求的来源。引用移动广告 SDK 的第三方库应调用此方法来指明广告请求的来源平台。例如,如果名为“CoolAds network”的第三方广告联盟中介请求至移动广告 SDK,则应使用“CoolAds”调用此方法。

受保护的函数

self

protected abstract fun self(): T!

返回指定子类型的 self 实例。