AbstractAdRequestBuilder

public abstract class AbstractAdRequestBuilder<T extends AbstractAdRequestBuilder<T>>


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

摘要

公共方法

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

此方法已弃用。

请改用 addNetworkExtrasBundle

T

添加自定义定位参数。

T

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

T

添加用于定位的关键字。

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

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

T

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

T

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

T

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

T

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

T

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

T

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

受保护的方法

abstract T

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

公共方法

addCustomEventExtrasBundle

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

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

参数
Class<CustomEvent> adapterClass

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

Bundle customEventExtras

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

addCustomTargeting

@CanIgnoreReturnValue
public T addCustomTargeting(String key, String value)

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

addCustomTargeting

@CanIgnoreReturnValue
public T addCustomTargeting(String key, List<String> values)

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

addKeyword

@CanIgnoreReturnValue
public T addKeyword(String keyword)

添加用于定位的关键字。

addNetworkExtrasBundle

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

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

参数
Class<MediationExtrasReceiver> adapterClass

应接收 extra 的适配器的 Class

Bundle networkExtras

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

setAdString

@CanIgnoreReturnValue
public T setAdString(String adString)

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

setContentUrl

@CanIgnoreReturnValue
public T setContentUrl(String contentUrl)

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

抛出
java.lang.NullPointerException

如果 contentUrl 为 {code null}。

java.lang.IllegalArgumentException

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

setHttpTimeoutMillis

@CanIgnoreReturnValue
public T setHttpTimeoutMillis(int httpTimeoutMillis)

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

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

参数
int httpTimeoutMillis

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

setNeighboringContentUrls

@CanIgnoreReturnValue
public T setNeighboringContentUrls(List<String> neighboringContentUrls)

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

参数
List<String> neighboringContentUrls

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

setPlacementId

@CanIgnoreReturnValue
public T setPlacementId(long placementId)

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

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

参数
long placementId

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

setRequestAgent

@CanIgnoreReturnValue
public T setRequestAgent(String requestAgent)

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

受保护的方法

self

protected abstract T self()

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