AdRequest

class AdRequest

알려진 직접 서브클래스
AdManagerAdRequest

AdManagerAdRequest에는 Google Ad Manager에서 광고를 가져오는 데 사용되는 타겟팅 정보가 포함되어 있습니다.


AdRequest에는 광고를 가져오는 데 사용되는 타겟팅 정보가 포함되어 있습니다. 광고 요청은 AdRequest.Builder를 사용하여 생성됩니다.

Ad Manager를 사용하는 게시자는 com.google.android.gms.ads.admanager.AdManagerAdRequest를 사용해야 합니다.

요약

중첩된 유형

AdRequest를 빌드합니다.

상수

const String!
DEVICE_ID_EMULATOR = "B3EEABB8EE11C2BE770B684D95219ECB"

setTestDeviceIds와 함께 사용되는 에뮬레이터용 deviceId입니다.

const Int

앱 ID가 누락되어 광고 요청이 이루어지지 않았습니다.

const Int

광고 서버에서 잘못된 응답을 받는 등 내부적으로 오류가 발생했습니다.

const Int

광고 문자열이 잘못되었습니다.

const Int

광고 요청이 잘못되었습니다(예: 광고 단위 ID가 잘못됨).

const Int

미디에이션 어댑터가 광고 요청을 처리하지 않았습니다.

const Int

네트워크 연결 문제로 인해 광고 요청에 성공하지 못했습니다.

const Int

광고 요청에는 성공했지만 광고 인벤토리가 부족하여 광고가 반환되지 않았습니다.

const Int

광고 문자열에서 요청 ID를 찾을 수 없습니다.

const Int

최대 콘텐츠 URL 길이입니다.

공개 함수

String?

광고 문자열을 가져옵니다.

String!

콘텐츠 URL 타겟팅 정보를 반환합니다.

Bundle?
<T : CustomEvent?> getCustomEventExtrasBundle(adapterClass: Class<T!>!)

이 함수는 지원 중단되었습니다.

대신 getNetworkExtrasBundle를 사용하세요.

(Mutable)Set<String!>!

타겟팅 정보 키워드를 반환합니다.

(Mutable)List<String!>!

인접 콘텐츠 URL 목록을 반환하거나 URL이 설정되지 않은 경우 빈 목록을 반환합니다.

Bundle?
<T : MediationExtrasReceiver?> getNetworkExtrasBundle(
    adapterClass: Class<T!>!
)

특정 광고 네트워크 어댑터에 전달할 추가 매개변수를 반환합니다.

String!

광고 요청의 출처를 식별하는 요청 에이전트 문자열을 반환합니다.

Boolean
isTestDevice(context: Context!)

이 기기에서 테스트 광고를 수신하는 경우 true을 반환합니다.

상수

DEVICE_ID_EMULATOR

const val DEVICE_ID_EMULATOR = "B3EEABB8EE11C2BE770B684D95219ECB": String!

setTestDeviceIds와 함께 사용되는 에뮬레이터용 deviceId입니다.

ERROR_CODE_APP_ID_MISSING

const val ERROR_CODE_APP_ID_MISSING = 8: Int

앱 ID가 누락되어 광고 요청이 이루어지지 않았습니다.

ERROR_CODE_INTERNAL_ERROR

const val ERROR_CODE_INTERNAL_ERROR = 0: Int

광고 서버에서 잘못된 응답을 받는 등 내부적으로 오류가 발생했습니다.

ERROR_CODE_INVALID_AD_STRING

const val ERROR_CODE_INVALID_AD_STRING = 11: Int

광고 문자열이 잘못되었습니다. 예를 들어 광고 문자열에 요청 ID가 없습니다.

ERROR_CODE_INVALID_REQUEST

const val ERROR_CODE_INVALID_REQUEST = 1: Int

광고 요청이 잘못되었습니다(예: 광고 단위 ID가 잘못됨).

ERROR_CODE_MEDIATION_NO_FILL

const val ERROR_CODE_MEDIATION_NO_FILL = 9: Int

미디에이션 어댑터가 광고 요청을 처리하지 않았습니다. 이 오류가 getCode에서 반환되면 getCause에서 근본 원인을 확인하세요.

ERROR_CODE_NETWORK_ERROR

const val ERROR_CODE_NETWORK_ERROR = 2: Int

네트워크 연결 문제로 인해 광고 요청에 성공하지 못했습니다.

ERROR_CODE_NO_FILL

const val ERROR_CODE_NO_FILL = 3: Int

광고 요청에는 성공했지만 광고 인벤토리가 부족하여 광고가 반환되지 않았습니다.

ERROR_CODE_REQUEST_ID_MISMATCH

const val ERROR_CODE_REQUEST_ID_MISMATCH = 10: Int

광고 문자열에서 요청 ID를 찾을 수 없습니다.

MAX_CONTENT_URL_LENGTH

const val MAX_CONTENT_URL_LENGTH = 512: Int

최대 콘텐츠 URL 길이입니다.

공개 함수

getAdString

fun getAdString(): String?

광고 문자열을 가져옵니다.

getContentUrl

fun getContentUrl(): String!

콘텐츠 URL 타겟팅 정보를 반환합니다. contentUrl이 설정되지 않은 경우 null을 반환합니다.

getCustomEventExtrasBundle

fun <T : CustomEvent?> getCustomEventExtrasBundle(adapterClass: Class<T!>!): Bundle?

특정 맞춤 이벤트 어댑터에 전달할 추가 매개변수를 반환합니다. 제공된 유형의 맞춤 이벤트 추가 항목이 설정되지 않은 경우 null을 반환합니다.

getKeywords

fun getKeywords(): (Mutable)Set<String!>!

타겟팅 정보 키워드를 반환합니다. 키워드가 추가되지 않은 경우 빈 Set를 반환합니다.

getNeighboringContentUrls

fun getNeighboringContentUrls(): (Mutable)List<String!>!

인접 콘텐츠 URL 목록을 반환하거나 URL이 설정되지 않은 경우 빈 목록을 반환합니다.

getNetworkExtrasBundle

fun <T : MediationExtrasReceiver?> getNetworkExtrasBundle(
    adapterClass: Class<T!>!
): Bundle?

특정 광고 네트워크 어댑터에 전달할 추가 매개변수를 반환합니다. 제공된 유형의 네트워크 추가 항목이 설정되지 않은 경우 null을 반환합니다.

getRequestAgent

fun getRequestAgent(): String!

광고 요청의 출처를 식별하는 요청 에이전트 문자열을 반환합니다.

isTestDevice

fun isTestDevice(context: Context!): Boolean

이 기기에서 테스트 광고를 수신하는 경우 true을 반환합니다.