AbstractAdRequestBuilder

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

既知の直接サブクラス
AdManagerAdRequest.Builder

AdManagerAdRequest をビルドします。

AdRequest.Builder

AdRequest をビルドします。


広告リクエストの作成に役立つ基本ビルダー クラス。

概要

パブリック関数

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

この関数は非推奨になりました。

addNetworkExtrasBundle を代わりに使用してください。

T!

カスタム ターゲティング パラメータを追加します。

T!

複数の値を持つカスタム ターゲティング パラメータを追加します。

T!

ターゲティング用のキーワードを追加します。

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

特定の広告ネットワーク アダプタに渡す追加のパラメータを追加します。

T!

広告レスポンスを表す広告文字列を設定します。

T!

アプリのメイン コンテンツと一致するコンテンツを持つウェブサイトのコンテンツ URL を設定します。

T!

広告リクエスト中に Google Mobile Ads SDK によって行われる HTTPS 呼び出しのカスタム タイムアウトを設定します。

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

広告の近くにあるウェブ コンテンツを表す URL を設定します。

T!

読み込まれた広告のデフォルトのプレースメント ID を設定します。

T!

広告リクエストの送信元を識別するリクエスト エージェント文字列を設定します。

プロテクト関数

abstract T!

指定されたサブタイプのセルフ インスタンスを返します。

パブリック関数

addCustomEventExtrasBundle

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

特定のカスタム イベント アダプタに渡す追加のパラメータを追加します。

パラメータ
adapterClass: Class<CustomEvent!>!

エクストラを提供するカスタム イベント アダプタの Class

customEventExtras: Bundle!

カスタム イベント アダプタに渡す追加情報の Bundle

addCustomTargeting

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

カスタム ターゲティング パラメータを追加します。同じキーで 2 回目に呼び出すと、古い値が上書きされます。

addCustomTargeting

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

複数の値を持つカスタム ターゲティング パラメータを追加します。同じキーで 2 回目に呼び出すと、古い値が上書きされます。

addKeyword

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

ターゲティング用のキーワードを追加します。

addNetworkExtrasBundle

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

特定の広告ネットワーク アダプタに渡す追加のパラメータを追加します。

パラメータ
adapterClass: Class<MediationExtrasReceiver!>!

エキストラを受け取るアダプタの Class

networkExtras: Bundle!

メディエーション アダプタに渡す追加情報の Bundle

setAdString

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

広告レスポンスを表す広告文字列を設定します。設定されている場合、SDK はこの広告をレンダリングし、このリクエストで設定されている他のすべてのターゲティング情報を無視します。

setContentUrl

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

アプリのメイン コンテンツと一致するコンテンツを持つウェブサイトのコンテンツ URL を設定します。このウェブサイトのコンテンツは、ターゲティングとブランド保護の目的で使用されます。

例外
java.lang.NullPointerException

contentUrl が {code null} の場合。

java.lang.IllegalArgumentException

contentUrl が空の場合、または長さが 512 を超える場合。

setHttpTimeoutMillis

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

広告リクエスト中に Google Mobile Ads SDK によって行われる HTTPS 呼び出しのカスタム タイムアウトを設定します。

アプリがメディエーションを使用する場合、このタイムアウトはサードパーティの広告ネットワーク SDK によって行われるネットワーク呼び出しには適用されません。

パラメータ
httpTimeoutMillis: Int

HTTPS タイムアウトをミリ秒単位で指定する整数。5000(5 秒)より小さい値は無視されます。デフォルト値は 60000(60 秒)です。

setNeighboringContentUrls

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

広告の近くにあるウェブ コンテンツを表す URL を設定します。ブランド保護を促進し、表示される広告に、隣接するコンテンツにより適したアプリレベルのレーティング(MA、T、PG など)を設定できるようにします。

パラメータ
neighboringContentUrls: (Mutable)List<String!>!

既存の隣接コンテンツ URL に追加する隣接コンテンツ URL のリスト。

setPlacementId

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

読み込まれた広告のデフォルトのプレースメント ID を設定します。

バナー広告では、代わりに setPlacementId を使用することをおすすめします。プレースメント ID を設定するリクエストで loadAd を呼び出すと、setPlacementId を呼び出すのと同じ効果があります。

パラメータ
placementId: Long

構成されたプレースメント用に AdMob 管理画面から提供される長整数。

setRequestAgent

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

広告リクエストの送信元を識別するリクエスト エージェント文字列を設定します。Mobile Ads SDK を参照するサードパーティ ライブラリは、このメソッドを呼び出して、広告リクエストの発生元となったプラットフォームを指定する必要があります。たとえば、「CoolAds ネットワーク」というサードパーティの広告ネットワークが Mobile Ads SDK へのリクエストをメディエーションする場合、このメソッドを「CoolAds」で呼び出す必要があります。

プロテクト関数

self

protected abstract fun self(): T!

指定されたサブタイプのセルフ インスタンスを返します。