AdRequest

public class AdRequest

既知の直接サブクラス
AdManagerAdRequest

AdManagerAdRequest には、Google アド マネージャーから広告を取得するために使用されるターゲティング情報が含まれています。

AdRequest には、広告の取得に使用されるターゲット設定情報が含まれています。広告リクエストは AdRequest.Builder を使用して作成されます。

アド マネージャーを使用しているパブリッシャーは 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

コンテンツ URL の最大長。

パブリック メソッド
@Nullable String

広告文字列を取得します。
String

コンテンツ URL ターゲティング情報を返します。
@Nullable Bundle
<T extends CustomEvent> getCustomEventExtrasBundle(Class<T> adapterClass)

このメソッドは非推奨です。

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

Set<String>

ターゲティング情報のキーワードを返します。
List<String>

近隣コンテンツの URL のリストを返します。URL が設定されていない場合は空のリストを返します。
@Nullable Bundle
<T extends MediationExtrasReceiver> getNetworkExtrasBundle(
    Class<T> adapterClass
)

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

この AdRequest で設定されたプレースメント ID を取得します
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

コンテンツ URL の最大長。

パブリック メソッド

getAdString

public @Nullable String getAdString()

広告文字列を取得します。

getContentUrl

public String getContentUrl()

コンテンツ URL のターゲティング情報を返します。contentUrl が設定されていない場合は null を返します。

getCustomEventExtrasBundle

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

特定のカスタム イベント アダプタに渡す追加のパラメータを返します。指定されたタイプのカスタム イベント エクストラが設定されていない場合は、null を返します。

getKeywords

public Set<String> getKeywords()

ターゲティング情報のキーワードを返します。キーワードが追加されなかった場合は、空の Set を返します。

getNeighboringContentUrls

public List<String> getNeighboringContentUrls()

近隣コンテンツの URL のリストを返します。URL が設定されていない場合は空のリストを返します。

getNetworkExtrasBundle

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

特定の広告ネットワーク アダプタに渡す追加のパラメータを返します。指定されたタイプのネットワーク エクストラが設定されていない場合は、null を返します。

getPlacementId

public long getPlacementId()

この AdRequest で設定されたプレースメント ID を取得します

getRequestAgent

public String getRequestAgent()

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

isTestDevice

public boolean isTestDevice(Context context)

このデバイスがテスト広告を受信する場合は true を返します。