AdRequest

public class AdRequest

已知的直接子類別
AdManagerAdRequest

AdManagerAdRequest 包含用於從 Google Ad Manager 擷取廣告的指定目標資訊。

AdRequest 包含用於擷取廣告的指定目標資訊。廣告請求是使用 AdRequest.Builder 建立。

使用 Ad Manager 的發布商應使用 com.google.android.gms.ads.admanager.AdManagerAdRequest。

摘要

巢狀類型

建構 AdRequest。

常數
static final String
DEVICE_ID_EMULATOR = "B3EEABB8EE11C2BE770B684D95219ECB"

deviceId 適用於與 setTestDeviceIds 搭配使用的模擬器。
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

內容網址長度上限。

公用方法
@Nullable String

取得廣告字串。
String

傳回內容網址指定目標資訊。
@Nullable Bundle
<T extends CustomEvent> getCustomEventExtrasBundle(Class<T> adapterClass)

此方法已淘汰。

請改用 getNetworkExtrasBundle。
Set<String>

傳回指定資訊關鍵字。
List<String>

傳回相鄰內容網址清單，如果未設定網址，則傳回空白清單。
@Nullable Bundle
<T extends MediationExtrasReceiver> getNetworkExtrasBundle(
    Class<T> adapterClass
)

傳回要傳遞至特定廣告聯播網轉接程式的額外參數。
String

傳回要求代理程式字串，用於識別廣告請求的來源。
boolean

如果這部裝置會接收測試廣告，則會傳回 true。

常數

DEVICE_ID_EMULATOR

public static final String DEVICE_ID_EMULATOR = "B3EEABB8EE11C2BE770B684D95219ECB"

deviceId 適用於與 setTestDeviceIds 搭配使用的模擬器。

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

內容網址長度上限。

公用方法

getAdString

public @Nullable String getAdString()

取得廣告字串。

getContentUrl

public String getContentUrl()

傳回內容網址指定目標資訊。如果未設定 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()

傳回相鄰內容網址清單，如果未設定網址，則傳回空白清單。

getNetworkExtrasBundle

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

傳回要傳遞至特定廣告聯播網轉接程式的額外參數。如果未設定所提供類型的聯播網額外資訊，就會傳回 null。

getRequestAgent

public String getRequestAgent()

傳回要求代理程式字串，用於識別廣告請求的來源。

isTestDevice

public boolean isTestDevice(Context context)

如果這部裝置會接收測試廣告，則會傳回 true。