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
)

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

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<StringgetKeywords()

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

getNeighboringContentUrls

public List<StringgetNeighboringContentUrls()

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

getNetworkExtrasBundle

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

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

getRequestAgent

public String getRequestAgent()

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

isTestDevice

public boolean isTestDevice(Context context)

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