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
)

傳回要傳遞至特定廣告聯播網介面的額外參數。
long

取得此 AdRequest 中設定的刊登位置 ID
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。

getPlacementId

public long getPlacementId()

取得此 AdRequest 中設定的刊登位置 ID

getRequestAgent

public String getRequestAgent()

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

isTestDevice

public boolean isTestDevice(Context context)

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