MobileAds

public 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
static final String
ERROR_DOMAIN = "com.google.android.gms.ads"

Nama domain error default untuk Google Mobile Ads SDK.

Metode publik
static void

Panggil sebelum initialize atau permintaan iklan pertama untuk menonaktifkan inisialisasi adaptor mediasi.
static @Nullable InitializationStatus

Mendapatkan status inisialisasi SDK.
static @NonNull RequestConfiguration

Mendapatkan RequestConfiguration global.
static VersionInfo

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

Melakukan inisialisasi Google Mobile Ads SDK.
static void

Melakukan inisialisasi Google Mobile Ads SDK.
static void

Membuka UI pemeriksa iklan.
static void
openDebugMenu(Context context, String adUnitId)

Membuka menu debug.
static boolean

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

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

Mendaftarkan WebView dengan Google Mobile Ads SDK untuk meningkatkan monetisasi iklan dalam aplikasi dalam WebView ini.
static void
setAppMuted(boolean muted)

Menunjukkan apakah audio aplikasi dibisukan.
static void
setAppVolume(float volume)

Menetapkan volume audio aplikasi.
static void
setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

Menetapkan RequestConfiguration global yang akan digunakan untuk setiap AdRequest selama sesi aplikasi.
static void
startPreload(
    @NonNull Context context,
    @NonNull List<PreloadConfiguration> preloadConfigurations,
    @NonNull PreloadCallback preloadCallback
)

Mulai memuat iklan secara otomatis untuk konfigurasi yang diberikan.

Konstanta

ERROR_DOMAIN

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

Nama domain error default untuk Google Mobile Ads SDK.

Metode publik

disableMediationAdapterInitialization

public static void disableMediationAdapterInitialization(Context context)

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

public static @Nullable InitializationStatus getInitializationStatus()

Mendapatkan status inisialisasi SDK.

getRequestConfiguration

public static @NonNull RequestConfiguration getRequestConfiguration()

Mendapatkan RequestConfiguration global.

getVersion

public static VersionInfo getVersion()

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

initialize tidak perlu dipanggil sebelum fungsi ini.

initialize

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

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

public static void initialize(Context context, OnInitializationCompleteListener listener)

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.
OnInitializationCompleteListener listener

Callback yang akan dipanggil setelah inisialisasi selesai.

openAdInspector

public static void openAdInspector(Context context, OnAdInspectorClosedListener listener)

Membuka UI pemeriksa iklan.

openDebugMenu

public static void openDebugMenu(Context context, String adUnitId)

Membuka menu debug. initialize harus dipanggil sebelum fungsi ini.

Parameter
Context context

Aktivitas Context tempat SDK berjalan.
String adUnitId

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

putPublisherFirstPartyIdEnabled

public static boolean putPublisherFirstPartyIdEnabled(boolean enabled)

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
boolean enabled

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

benar jika keputusan berhasil dipertahankan. Salah jika gagal dipertahankan.

registerCustomTabsSession

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

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
@NonNull Context context

Context tempat SDK berjalan.
@NonNull CustomTabsClient client

CustomTabsClient yang digunakan untuk membuat instance CustomTabsSession.
@NonNull String origin

String yang digunakan sebagai origin di Digital Asset Link untuk verifikasi.
@Nullable CustomTabsCallback callback

CustomTabsCallback opsional untuk menerima callback dari .
Hasil
@Nullable CustomTabsSession

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

registerWebView

public static void registerWebView(@NonNull WebView webview)

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

setAppMuted

public static void setAppMuted(boolean muted)

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
boolean muted

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

setAppVolume

public static void setAppVolume(float volume)

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
float volume

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

public static void setRequestConfiguration(
    @NonNull RequestConfiguration requestConfiguration
)

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

startPreload

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

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
@NonNull Context context

Context tempat SDK berjalan.
@NonNull List<PreloadConfiguration> preloadConfigurations

Konfigurasi untuk memuat iklan secara otomatis.
@NonNull PreloadCallback preloadCallback

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