MobileAds

public class MobileAds


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

요약

상수

static final String
ERROR_DOMAIN = "com.google.android.gms.ads"

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

공개 메서드

static void

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

static @Nullable InitializationStatus

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

static @NonNull RequestConfiguration

전역 RequestConfiguration를 가져옵니다.

static VersionInfo

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

static void
@RequiresPermission(value = Manifest.permission.INTERNET)
initialize(Context context)

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

static void

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

static void

광고 검사기 UI를 엽니다.

static void
openDebugMenu(Context context, String adUnitId)

디버그 메뉴를 엽니다.

static boolean

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

static @Nullable CustomTabsSession
registerCustomTabsSession(
    @NonNull Context context,
    @NonNull CustomTabsClient client,
    @NonNull String origin,
    @Nullable CustomTabsCallback callback
)

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

static void

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

static void
setAppMuted(boolean muted)

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

static void
setAppVolume(float volume)

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

static void
setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

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

static void
startPreload(
    @NonNull Context context,
    @NonNull List<PreloadConfiguration> preloadConfigurations,
    @NonNull PreloadCallback preloadCallback
)

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

상수

ERROR_DOMAIN

public static final String ERROR_DOMAIN = "com.google.android.gms.ads"

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

공개 메서드

disableMediationAdapterInitialization

public static void disableMediationAdapterInitialization(Context context)

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

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

getInitializationStatus

public static @Nullable InitializationStatus getInitializationStatus()

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

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

전역 RequestConfiguration를 가져옵니다.

getVersion

public static VersionInfo getVersion()

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

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

initialize

@RequiresPermission(value = Manifest.permission.INTERNET)
public static void initialize(Context context)

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

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

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

매개변수
Context context

SDK가 실행 중인 Context입니다.

initialize

public static void initialize(Context context, OnInitializationCompleteListener listener)

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

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

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

매개변수
Context context

SDK가 실행되는 활동 Context

OnInitializationCompleteListener listener

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

openAdInspector

public static void openAdInspector(Context context, OnAdInspectorClosedListener listener)

광고 검사기 UI를 엽니다.

openDebugMenu

public static void openDebugMenu(Context context, String adUnitId)

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

매개변수
Context context

SDK가 실행되는 활동 Context

String adUnitId

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

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

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

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

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

매개변수
boolean enabled

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

반환 값
boolean

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

registerCustomTabsSession

public static @Nullable CustomTabsSession registerCustomTabsSession(
    @NonNull Context context,
    @NonNull CustomTabsClient client,
    @NonNull String origin,
    @Nullable CustomTabsCallback callback
)

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

매개변수
@NonNull Context context

SDK가 실행 중인 Context입니다.

@NonNull CustomTabsClient client

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

@NonNull String origin

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

@Nullable CustomTabsCallback callback

CustomTabsCallback(선택사항): 에서 콜백을 수신합니다 .

반환 값
@Nullable CustomTabsSession

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

registerWebView

public static void registerWebView(@NonNull WebView webview)

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

setAppMuted

public static void setAppMuted(boolean muted)

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

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

매개변수
boolean muted

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

setAppVolume

public static void setAppVolume(float volume)

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

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

매개변수
float volume

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

생성 값
java.lang.IllegalArgumentException

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

setRequestConfiguration

public static void setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

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

startPreload

public static void startPreload(
    @NonNull Context context,
    @NonNull List<PreloadConfiguration> preloadConfigurations,
    @NonNull PreloadCallback preloadCallback
)

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

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

매개변수
@NonNull Context context

SDK가 실행 중인 Context입니다.

@NonNull List<PreloadConfiguration> preloadConfigurations

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

@NonNull PreloadCallback preloadCallback

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