MobileAds

class MobileAds

클래스에는 Google 모바일 광고 SDK 전체에 적용되는 로직이 포함되어 있습니다. 현재는 초기화에만 사용되는 메서드만 있습니다.

요약

상수
const String!
ERROR_DOMAIN = "com.google.android.gms.ads"

Google 모바일 광고 SDK의 기본 오류 도메인 이름입니다.

공개 함수
java-static Unit

initialize 또는 첫 번째 광고 요청 전에 호출하여 미디에이션 어댑터 초기화를 사용 중지합니다.
java-static InitializationStatus?

SDK 초기화 상태를 가져옵니다.
java-static RequestConfiguration

전역 RequestConfiguration를 가져옵니다.
java-static VersionInfo!

Google 모바일 광고 SDK의 외부 버전 (예: 20.6.0)을 가져옵니다.
java-static Unit
@RequiresPermission(value = Manifest.permission.INTERNET)
initialize(context: Context!)

Google 모바일 광고 SDK를 초기화합니다.
java-static Unit

Google 모바일 광고 SDK를 초기화합니다.
java-static Unit

광고 검사기 UI를 엽니다.
java-static Unit
openDebugMenu(context: Context!, adUnitId: String!)

디버그 메뉴를 엽니다.
java-static Boolean

Google 모바일 광고 SDK 게시자 퍼스트 파티 ID(이전 명칭: 동일 앱 키)를 사용 설정할지 여부를 제어합니다.
java-static CustomTabsSession?
registerCustomTabsSession(
    context: Context,
    client: CustomTabsClient,
    origin: String,
    callback: CustomTabsCallback?
)

Google 모바일 광고 SDK에 CustomTabsClient를 등록하여 이 CustomTabsSession 내에서 광고의 인앱 광고 수익 창출을 개선합니다.
java-static Unit

Google 모바일 광고 SDK에 WebView를 등록하여 이 WebView 내에서 광고의 인앱 광고 수익 창출을 개선합니다.
java-static Unit

애플리케이션의 오디오가 음소거되어 있는지 여부를 나타냅니다.
java-static Unit

애플리케이션의 오디오 볼륨을 설정합니다.
java-static Unit

앱 세션 중에 모든 AdRequest에 사용될 전역 RequestConfiguration를 설정합니다.
java-static Unit
startPreload(
    context: Context,
    preloadConfigurations: (Mutable)List<PreloadConfiguration!>,
    preloadCallback: PreloadCallback
)

지정된 구성의 광고 미리 로드를 시작합니다.

상수

ERROR_DOMAIN

const val ERROR_DOMAIN = "com.google.android.gms.ads": String!

Google 모바일 광고 SDK의 기본 오류 도메인 이름입니다.

공개 함수

disableMediationAdapterInitialization

java-static fun disableMediationAdapterInitialization(context: Context!): Unit

initialize 또는 첫 번째 광고 요청 전에 호출하여 미디에이션 어댑터 초기화를 사용 중지합니다. 이 메서드는 initialize 또는 첫 번째 광고 요청이 이루어지면 무시됩니다.

경고: 이 메서드를 호출하면 미디에이션 실적에 부정적인 영향을 미칠 수 있습니다. 이 메서드는 앱에 미디에이션 어댑터를 포함했지만 이 앱 세션 중에 Google 미디에이션을 사용할 계획이 없는 경우에만 호출해야 합니다 (예: A/B 테스트를 실행하는 경우).

getInitializationStatus

java-static fun getInitializationStatus(): InitializationStatus?

SDK 초기화 상태를 가져옵니다.

getRequestConfiguration

java-static fun getRequestConfiguration(): RequestConfiguration

전역 RequestConfiguration를 가져옵니다.

getVersion

java-static fun getVersion(): VersionInfo!

Google 모바일 광고 SDK의 외부 버전 (예: 20.6.0)을 가져옵니다.

이 함수 전에 initialize를 호출할 필요는 없습니다.

initialize

@RequiresPermission(value = Manifest.permission.INTERNET)
java-static fun initialize(context: Context!): Unit

Google 모바일 광고 SDK를 초기화합니다.

앱이 실행된 후 최대한 빨리 이 메서드를 호출하여 세션의 첫 번째 광고 요청 지연 시간을 줄입니다.

이 메서드가 호출되지 않으면 첫 번째 광고 요청이 Google 모바일 광고 SDK를 자동으로 초기화합니다.

매개변수
context: Context!

SDK가 실행 중인 Context입니다.

initialize

java-static fun initialize(context: Context!, listener: OnInitializationCompleteListener!): Unit

Google 모바일 광고 SDK를 초기화합니다.

앱이 실행된 후 최대한 빨리 이 메서드를 호출하여 세션의 첫 번째 광고 요청 지연 시간을 줄입니다.

이 메서드가 호출되지 않으면 첫 번째 광고 요청이 Google 모바일 광고 SDK를 자동으로 초기화합니다.

매개변수
context: Context!

SDK가 실행되는 활동 Context
listener: OnInitializationCompleteListener!

초기화가 완료되면 호출되는 콜백입니다.

openAdInspector

java-static fun openAdInspector(context: Context!, listener: OnAdInspectorClosedListener!): Unit

광고 검사기 UI를 엽니다.

openDebugMenu

java-static fun openDebugMenu(context: Context!, adUnitId: String!): Unit

디버그 메뉴를 엽니다. 이 함수 전에 initialize를 호출해야 합니다.

매개변수
context: Context!

SDK가 실행되는 활동 Context
adUnitId: String!

앱과 연결된 모든 Ad Manager 광고 단위 ID

putPublisherFirstPartyIdEnabled

java-static fun putPublisherFirstPartyIdEnabled(enabled: Boolean): Boolean

Google 모바일 광고 SDK 게시자 퍼스트 파티 ID(이전 명칭: 동일 앱 키)를 사용 설정할지 여부를 제어합니다.

이 ID는 기본적으로 사용 설정되어 있습니다. 사용 중지하면 설정이 앱 세션 전반에 유지되고 ID가 삭제됩니다.

이 함수 전에 initialize를 호출해야 합니다.

매개변수
enabled: Boolean

게시자 퍼스트 파티 ID가 사용 설정되어 있으면 true이고, 그렇지 않으면 false입니다.
반환 값
Boolean

결정이 성공적으로 유지되면 true입니다. 유지되지 않으면 false를 반환합니다.

registerCustomTabsSession

java-static fun registerCustomTabsSession(
    context: Context,
    client: CustomTabsClient,
    origin: String,
    callback: CustomTabsCallback?
): CustomTabsSession?

이 CustomTabsSession 내에서 광고의 인앱 광고 수익 창출을 개선하기 위해 Google 모바일 광고 SDK에 CustomTabsClient를 등록합니다. 이렇게 하면 CustomTabsSession 인스턴스가 하나만 생성되며 이 작업을 다시 실행하면 기존 세션이 재정의됩니다.

매개변수
context: Context

SDK가 실행 중인 Context입니다.
client: CustomTabsClient

CustomTabsSession 인스턴스를 만드는 데 사용된 CustomTabsClient입니다.
origin: String

디지털 애셋 링크에서 확인을 위해 출처로 사용되는 문자열입니다.
callback: CustomTabsCallback?

CustomTabsCallback(선택사항): 에서 콜백을 수신합니다 .
반환 값
CustomTabsSession?

맞춤 탭 페이지를 열 때 맞춤 탭 인텐트에 사용되는 CustomTabsSession 인스턴스입니다.

registerWebView

java-static fun registerWebView(webview: WebView): Unit

이 WebView 내에서 광고의 인앱 광고 수익 창출을 개선하기 위해 Google 모바일 광고 SDK에 WebView를 등록합니다.

setAppMuted

java-static fun setAppMuted(muted: Boolean): Unit

애플리케이션의 오디오가 음소거되어 있는지 여부를 나타냅니다. 모든 광고의 초기 음소거 상태에 영향을 줍니다.

경고: 애플리케이션을 음소거하면 동영상 광고 적합성이 저하되어 앱의 광고 수익이 감소할 수 있습니다. 앱이 사용자에게 맞춤 음소거 컨트롤을 제공하는 경우에만 이 API를 활용해야 하며, 이 API에 사용자의 음소거 결정을 반영해야 합니다.

매개변수
muted: Boolean

앱이 음소거된 경우 true이고, 그렇지 않으면 false입니다. 기본값은 false입니다.

setAppVolume

java-static fun setAppVolume(volume: Float): Unit

애플리케이션의 오디오 볼륨을 설정합니다. 다른 오디오 출력과 비교하여 모든 광고의 오디오 볼륨에 영향을 미칩니다.

경고: 앱의 오디오 볼륨을 낮추면 동영상 광고 적합성이 저하되어 앱의 광고 수익이 감소할 수 있습니다. 앱이 사용자에게 맞춤 볼륨 컨트롤을 제공하는 경우에만 이 API를 활용해야 하며, 이 API에 사용자의 볼륨 선택을 반영해야 합니다.

매개변수
volume: Float

볼륨(0(음소거)~1.0(미디어 볼륨 최대)) 기본값은 1.0입니다.
생성 값
java.lang.IllegalArgumentException

볼륨이 유효한 범위를 벗어난 경우

setRequestConfiguration

java-static fun setRequestConfiguration(requestConfiguration: RequestConfiguration): Unit

앱 세션 중에 모든 AdRequest에 사용될 전역 RequestConfiguration를 설정합니다.

startPreload

java-static fun startPreload(
    context: Context,
    preloadConfigurations: (Mutable)List<PreloadConfiguration!>,
    preloadCallback: PreloadCallback
): Unit

지정된 구성의 광고 미리 로드를 시작합니다.

광고 미리 로드 API는 제한된 알파 버전입니다. 자세한 내용은 계정 관리자에게 문의하세요.

매개변수
context: Context

SDK가 실행 중인 Context입니다.
preloadConfigurations: (Mutable)List<PreloadConfiguration!>

광고를 미리 로드하는 구성입니다.
preloadCallback: PreloadCallback

각 미리 로드 구성의 광고 가용성이 변경될 때 호출되는 콜백입니다.