MobileAds

class MobileAds

Class berisi logika yang berlaku untuk Google Mobile Ads SDK secara keseluruhan. Saat ini, hanya metode di dalamnya yang 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

Menginisialisasi Google Mobile Ads SDK.
java-static Unit

Menginisialisasi 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 di dalam CustomTabsSession ini.
java-static Unit

Mendaftarkan WebView dengan Google Mobile Ads SDK untuk meningkatkan monetisasi iklan dalam aplikasi di 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

Menginisialisasi 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

Menginisialisasi 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 SDK sedang 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 SDK sedang berjalan.
adUnitId: String!

ID unit iklan Ad Manager 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 benar jika ID pihak pertama penayang diaktifkan, salah jika tidak.
Hasil
Boolean

benar jika keputusan berhasil dipertahankan. Salah (false) 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 di 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 CustomTabsSession.
Hasil
CustomTabsSession?

CustomTabsSession yang akan digunakan untuk Maksud Tab Kustom saat membuka halaman Tab Kustom.

registerWebView

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

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

setAppMuted

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

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

Peringatan: Membisukan aplikasi Anda akan mengurangi kelayakan iklan video dan dapat mengurangi pendapatan iklan aplikasi Anda. Anda hanya boleh menggunakan API ini jika aplikasi Anda menyediakan kontrol senyap kustom kepada pengguna, dan Anda harus mencerminkan keputusan senyap pengguna dalam 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 Anda 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 (dimatikan suaranya) 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 mem-pramuat iklan untuk konfigurasi yang diberikan.

API pra-pemuatan 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 mem-pramuat iklan.
preloadCallback: PreloadCallback

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