MobileAds
public class MobileAds
클래스에는 Google 모바일 광고 SDK 전체에 적용되는 로직이 포함되어 있습니다. 현재는 초기화에만 사용되는 메서드만 있습니다.
요약
상수 |
|
|---|---|
static final String |
ERROR_DOMAIN = "com.google.android.gms.ads"Google 모바일 광고 SDK의 기본 오류 도메인 이름입니다. |
공개 메서드 |
|
|---|---|
static void |
|
static @Nullable InitializationStatus |
SDK 초기화 상태를 가져옵니다. |
static @NonNull RequestConfiguration |
전역 |
static VersionInfo |
Google 모바일 광고 SDK의 외부 버전 (예: 20.6.0)을 가져옵니다. |
static void |
@RequiresPermission(value = Manifest.permission.INTERNET)Google 모바일 광고 SDK를 초기화합니다. |
static void |
initialize(Context context, OnInitializationCompleteListener listener)Google 모바일 광고 SDK를 초기화합니다. |
static void |
openAdInspector(Context context, OnAdInspectorClosedListener listener)광고 검사기 UI를 엽니다. |
static void |
openDebugMenu(Context context, String adUnitId)디버그 메뉴를 엽니다. |
static boolean |
putPublisherFirstPartyIdEnabled(boolean enabled)Google 모바일 광고 SDK 게시자 퍼스트 파티 ID(이전 명칭: 동일 앱 키)를 사용 설정할지 여부를 제어합니다. |
static @Nullable CustomTabsSession |
registerCustomTabsSession(이 |
static void |
registerWebView(@NonNull WebView webview)이 |
static void |
setAppMuted(boolean muted)애플리케이션의 오디오가 음소거되어 있는지 여부를 나타냅니다. |
static void |
setAppVolume(float volume)애플리케이션의 오디오 볼륨을 설정합니다. |
static void |
setRequestConfiguration(앱 세션 중에 모든 |
static void |
startPreload(지정된 구성의 광고 미리 로드를 시작합니다. |
상수
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를 자동으로 초기화합니다.
initialize
public static void initialize(Context context, OnInitializationCompleteListener listener)
Google 모바일 광고 SDK를 초기화합니다.
앱이 실행된 후 최대한 빨리 이 메서드를 호출하여 세션의 첫 번째 광고 요청 지연 시간을 줄입니다.
이 메서드가 호출되지 않으면 첫 번째 광고 요청이 Google 모바일 광고 SDK를 자동으로 초기화합니다.
| 매개변수 | |
|---|---|
Context context |
SDK가 실행되는 활동 |
OnInitializationCompleteListener listener |
초기화가 완료되면 호출되는 콜백입니다. |
openAdInspector
public static void openAdInspector(Context context, OnAdInspectorClosedListener listener)
광고 검사기 UI를 엽니다.
openDebugMenu
public static void openDebugMenu(Context context, String adUnitId)
디버그 메뉴를 엽니다. 이 함수 전에 initialize를 호출해야 합니다.
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가 실행 중인 |
@NonNull CustomTabsClient client |
|
@NonNull String origin |
디지털 애셋 링크에서 확인을 위해 출처로 사용되는 문자열입니다. |
@Nullable CustomTabsCallback callback |
|
| 반환 값 | |
|---|---|
@Nullable 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가 실행 중인 |
@NonNull List<PreloadConfiguration> preloadConfigurations |
광고를 미리 로드하는 구성입니다. |
@NonNull PreloadCallback preloadCallback |
각 미리 로드 구성의 광고 가용성이 변경될 때 호출되는 콜백입니다. |