MobileAds

class MobileAds

Class berisi logika yang berlaku untuk Google Mobile Ads SDK secara keseluruhan. Saat ini, satu-satunya metode di dalamnya digunakan untuk inisialisasi.

Ringkasan

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

Nama domain error default untuk Google Mobile Ads SDK.

Fungsi publik
java-static Unit

Panggil sebelum initialize atau permintaan iklan pertama untuk menonaktifkan inisialisasi adaptor mediasi.
java-static InitializationStatus?

Mendapatkan status inisialisasi SDK.
java-static RequestConfiguration

Mendapatkan RequestConfiguration global.
java-static VersionInfo!

Mendapatkan versi eksternal (misalnya, 20.6.0) Google Mobile Ads SDK.
java-static Unit
@RequiresPermission(value = Manifest.permission.INTERNET)
initialize(context: Context!)

Melakukan inisialisasi Google Mobile Ads SDK.
java-static Unit

Melakukan inisialisasi Google Mobile Ads SDK.
java-static Unit

Membuka UI pemeriksa iklan.
java-static Unit
openDebugMenu(context: Context!, adUnitId: String!)

Membuka menu debug.
java-static Boolean

Mengontrol apakah ID pihak pertama penayang Google Mobile Ads SDK, yang sebelumnya dikenal sebagai kunci aplikasi sama, diaktifkan.
java-static CustomTabsSession?
registerCustomTabsSession(
    context: Context,
    client: CustomTabsClient,
    origin: String,
    callback: CustomTabsCallback?
)

Mendaftarkan CustomTabsClient dengan Google Mobile Ads SDK untuk meningkatkan monetisasi iklan dalam aplikasi dalam CustomTabsSession ini.
java-static Unit

Mendaftarkan WebView dengan Google Mobile Ads SDK untuk meningkatkan monetisasi iklan dalam aplikasi dalam WebView ini.
java-static Unit

Menunjukkan apakah audio aplikasi dibisukan.
java-static Unit

Menetapkan volume audio aplikasi.
java-static Unit

Menetapkan RequestConfiguration global yang akan digunakan untuk setiap AdRequest selama sesi aplikasi.
java-static Unit
startPreload(
    context: Context,
    preloadConfigurations: (Mutable)List<PreloadConfiguration!>,
    preloadCallback: PreloadCallback
)

Fungsi ini tidak digunakan lagi.

Sebagai gantinya, gunakan start atau start.

Konstanta

ERROR_DOMAIN

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

Nama domain error default untuk Google Mobile Ads SDK.

Fungsi publik

disableMediationAdapterInitialization

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

Panggil sebelum initialize atau permintaan iklan pertama untuk menonaktifkan inisialisasi adaptor mediasi. Metode ini adalah noop setelah initialize atau permintaan iklan pertama dibuat.

Peringatan: Memanggil metode ini dapat berdampak negatif pada performa mediasi Anda. Metode ini hanya boleh dipanggil jika Anda menyertakan adaptor mediasi di aplikasi, tetapi Anda tidak berencana menggunakan mediasi Google selama sesi aplikasi ini (misalnya, Anda menjalankan pengujian A/B).

getInitializationStatus

java-static fun getInitializationStatus(): InitializationStatus?

Mendapatkan status inisialisasi SDK.

getRequestConfiguration

java-static fun getRequestConfiguration(): RequestConfiguration

Mendapatkan RequestConfiguration global.

getVersion

java-static fun getVersion(): VersionInfo!

Mendapatkan versi eksternal (misalnya, 20.6.0) Google Mobile Ads SDK.

initialize tidak perlu dipanggil sebelum fungsi ini.

initialize

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

Melakukan inisialisasi Google Mobile Ads SDK.

Panggil metode ini sedini mungkin setelah aplikasi diluncurkan untuk mengurangi latensi pada permintaan iklan pertama sesi.

Jika metode ini tidak dipanggil, permintaan iklan pertama akan otomatis menginisialisasi Google Mobile Ads SDK.

Parameter
context: Context!

Context tempat SDK berjalan.

initialize

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

Melakukan inisialisasi Google Mobile Ads SDK.

Panggil metode ini sedini mungkin setelah aplikasi diluncurkan untuk mengurangi latensi pada permintaan iklan pertama sesi.

Jika metode ini tidak dipanggil, permintaan iklan pertama akan otomatis menginisialisasi Google Mobile Ads SDK.

Parameter
context: Context!

Aktivitas Context tempat SDK berjalan.
listener: OnInitializationCompleteListener!

Callback yang akan dipanggil setelah inisialisasi selesai.

openAdInspector

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

Membuka UI pemeriksa iklan.

openDebugMenu

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

Membuka menu debug. initialize harus dipanggil sebelum fungsi ini.

Parameter
context: Context!

Aktivitas Context tempat SDK berjalan.
adUnitId: String!

ID unit iklan Ad Manager apa pun yang terkait dengan aplikasi Anda.

putPublisherFirstPartyIdEnabled

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

Mengontrol apakah ID pihak pertama penayang Google Mobile Ads SDK, yang sebelumnya dikenal sebagai kunci aplikasi sama, diaktifkan.

ID diaktifkan secara default. Jika dinonaktifkan, setelan akan dipertahankan di seluruh sesi aplikasi dan ID akan dihapus.

initialize harus dipanggil sebelum fungsi ini.

Parameter
enabled: Boolean

boolean true jika ID pihak pertama penayang diaktifkan, false jika tidak.
Hasil
Boolean

benar jika keputusan berhasil dipertahankan. Salah jika gagal dipertahankan.

registerCustomTabsSession

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

Mendaftarkan CustomTabsClient dengan Google Mobile Ads SDK untuk meningkatkan monetisasi iklan dalam aplikasi dalam CustomTabsSession ini. Tindakan ini hanya akan membuat satu instance CustomTabsSession dan menjalankan ulang ini akan menggantikan sesi yang ada.

Parameter
context: Context

Context tempat SDK berjalan.
client: CustomTabsClient

CustomTabsClient yang digunakan untuk membuat instance CustomTabsSession.
origin: String

String yang digunakan sebagai asal di Digital Asset Link untuk verifikasi.
callback: CustomTabsCallback?

CustomTabsCallback opsional untuk menerima callback dari .
Hasil
CustomTabsSession?

Instance CustomTabsSession yang akan digunakan untuk Intent Custom Tabs saat membuka halaman Custom Tabs.

registerWebView

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

Mendaftarkan WebView dengan Google Mobile Ads SDK untuk meningkatkan monetisasi iklan dalam aplikasi dalam WebView ini.

setAppMuted

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

Menunjukkan apakah audio aplikasi dibisukan. Memengaruhi status bisukan awal untuk semua iklan.

Peringatan: Membisukan aplikasi akan mengurangi kelayakan iklan video dan dapat mengurangi pendapatan iklan aplikasi Anda. Anda hanya boleh menggunakan API ini jika aplikasi Anda menyediakan kontrol bisukan kustom kepada pengguna, dan Anda harus mencerminkan keputusan bisukan pengguna di API ini.

Parameter
muted: Boolean

benar jika aplikasi dibisukan, salah jika tidak. Nilai defaultnya adalah false (salah).

setAppVolume

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

Menetapkan volume audio aplikasi. Memengaruhi volume audio semua iklan dibandingkan dengan output audio lainnya.

Peringatan: Menurunkan volume audio aplikasi akan mengurangi kelayakan iklan video dan dapat mengurangi pendapatan iklan aplikasi Anda. Anda hanya boleh menggunakan API ini jika aplikasi Anda menyediakan kontrol volume kustom kepada pengguna, dan Anda harus mencerminkan pilihan volume pengguna di API ini.

Parameter
volume: Float

volume sebagai float dari 0 (dinonaktifkan) hingga 1,0 (volume media penuh). Default-nya adalah 1,0
Menampilkan
java.lang.IllegalArgumentException

jika volume berada di luar rentang yang valid

setRequestConfiguration

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

Menetapkan RequestConfiguration global yang akan digunakan untuk setiap AdRequest selama sesi aplikasi.

startPreload

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

Mulai memuat iklan secara otomatis untuk konfigurasi yang diberikan.

API pramuat iklan tersedia dalam versi alfa terbatas. Hubungi Account Manager Anda untuk mendapatkan informasi selengkapnya.

Parameter
context: Context

Context tempat SDK berjalan.
preloadConfigurations: (Mutable)List<PreloadConfiguration!>

Konfigurasi untuk memuat iklan secara otomatis.
preloadCallback: PreloadCallback

Callback yang akan dipanggil saat ketersediaan iklan berubah untuk setiap konfigurasi pramuat.