Mengintegrasikan Google Mobile Ads SDK ke dalam aplikasi adalah langkah pertama untuk menampilkan iklan dan memperoleh pendapatan. Setelah mengintegrasikan SDK, Anda dapat memilih format iklan (seperti video native atau reward) dan mengikuti langkah-langkah untuk menerapkannya.
Sebelum memulai
Untuk mempersiapkan aplikasi Anda, selesaikan langkah-langkah di bagian berikut ini.
Prasyarat aplikasi
Pastikan bahwa file build aplikasi Anda menggunakan nilai berikut:
minSdkVersion
dari19
atau lebih tinggicompileSdkVersion
dari33
atau lebih tinggi
Menyiapkan aplikasi di akun AdMob
Daftarkan aplikasi Anda sebagai aplikasi AdMob dengan menyelesaikan langkah-langkah berikut:
Daftarkan aplikasi ke AdMob. Langkah ini akan membuat aplikasi AdMob dengan ID Aplikasi AdMob unik yang nantinya diperlukan dalam panduan ini.
Mengonfigurasi aplikasi Anda
Di file
build.gradle
level project, sertakan repositori Maven Google dan repositori pusat Maven di bagianbuildscript
danallprojects
:buildscript { repositories { google() mavenCentral() } } allprojects { repositories { google() mavenCentral() } }
Tambahkan dependensi untuk Google Mobile Ads SDK ke file Gradle tingkat aplikasi modul Anda, biasanya
app/build.gradle
:dependencies { implementation 'com.google.android.gms:play-services-ads:22.5.0' }
Tambahkan ID aplikasi AdMob Anda, seperti yang diidentifikasi dalam antarmuka webAdMob, ke file
AndroidManifest.xml
aplikasi Anda. Untuk melakukannya, tambahkan tag<meta-data>
denganandroid:name="com.google.android.gms.ads.APPLICATION_ID"
. Anda dapat menemukan ID aplikasi di AdMob antarmuka web. Untukandroid:value
, masukkan ID aplikasi AdMob Anda sendiri, yang diapit dengan tanda petik.<manifest> <application> <!-- Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713 --> <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/> </application> </manifest>
Dalam aplikasi yang sebenarnya, gunakan ID aplikasi AdMob sebenarnya, bukan yang tercantum di atas. Jika Anda hanya ingin bereksperimen dengan SDK di aplikasi Halo Dunia, Anda dapat menggunakan contoh ID aplikasi yang ditunjukkan di atas.
Perhatikan juga bahwa kegagalan untuk menambahkan tag
<meta-data>
seperti yang ditunjukkan di atas akan mengakibatkan error pada pesan:The Google Mobile Ads SDK was initialized incorrectly.
(Opsional) Deklarasikan izin
AD_ID
untuk versi sebelumnya agar berfungsi dengan Android 13.Jika aplikasi Anda menggunakan Google Mobile Ads SDK versi 20.4.0 atau yang lebih tinggi, Anda dapat melewati langkah ini karena SDK otomatis mendeklarasikan izin
com.google.android.gms.permission.AD_ID
dan dapat mengakses ID Iklan setiap kali tersedia.Untuk aplikasi yang menggunakan Google Mobile Ads SDK versi 20.3.0 atau yang lebih rendah dan menargetkan Android 13, Anda harus menambahkan izin
com.google.android.gms.permission.AD_ID
di fileAndroidManifest.xml
untuk Google Mobile Ads SDK guna mengakses ID Iklan:<manifest> <application> <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/> <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower --> <uses-permission android:name="com.google.android.gms.permission.AD_ID"/> </application> </manifest>
Untuk mempelajari deklarasi izin
com.google.android.gms.permission.AD_ID
lebih lanjut, termasuk cara menonaktifkannya, lihat artikel Konsol Play ini.
Menginisialisasi Google Mobile Ads SDK
Sebelum memuat iklan, minta aplikasi Anda melakukan inisialisasi Google Mobile Ads SDK dengan memanggil MobileAds.initialize()
yang akan melakukan inisialisasi SDK dan memanggil kembali pemroses penyelesaian setelah inisialisasi selesai, atau setelah waktu tunggu 30 detik. Hal ini
hanya perlu dilakukan sekali, idealnya pada saat peluncuran aplikasi.
Iklan dapat dipramuat oleh Google Mobile Ads SDK atau SDK partner mediasi saat memanggil MobileAds.initialize()
. Jika Anda perlu mendapatkan izin dari pengguna di Wilayah Ekonomi Eropa (EEA), menetapkan tanda khusus permintaan, seperti tagForChildDirectedTreatment
atau tag_for_under_age_of_consent
, atau mengambil tindakan sebelum memuat iklan, pastikan Anda melakukannya sebelum melakukan inisialisasi Google Mobile Ads SDK.
Berikut adalah contoh cara memanggil metode initialize()
dalam Aktivitas:
Contoh MainActivity (kutipan)
Java
import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;
public class MainActivity extends AppCompatActivity {
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
MobileAds.initialize(this, new OnInitializationCompleteListener() {
@Override
public void onInitializationComplete(InitializationStatus initializationStatus) {
}
});
}
}
Kotlin
import com.google.android.gms.ads.MobileAds
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
MobileAds.initialize(this) {}
}
}
Jika Anda menggunakan mediasi, tunggu hingga pengendali penyelesaian dipanggil sebelum memuat iklan. Tindakan ini akan memastikan bahwa semua adaptor mediasi telah diinisialisasi.
Pilih format iklan
Google Mobile Ads SDK kini telah diimpor dan Anda siap untuk menerapkan iklan. AdMob menawarkan sejumlah format iklan yang berbeda, sehingga Anda dapat memilih salah satu yang paling sesuai dengan pengalaman pengguna aplikasi Anda.
Banner
Iklan kotak yang muncul di bagian atas atau bawah layar perangkat. Iklan Banner tetap ditampilkan di layar saat pengguna berinteraksi dengan aplikasi, dan dapat diperbarui secara otomatis setelah jangka waktu tertentu. Jika periklanan seluler merupakan hal yang baru bagi Anda, iklan Banner adalah pilihan pertama yang baik.
Interstisial
Iklan layar penuh yang menutupi antarmuka aplikasi hingga pengguna menutupnya. Alat ini paling baik digunakan saat jeda alami dalam alur eksekusi aplikasi, misalnya di antara level game atau segera setelah tugas selesai.
Native
Iklan yang dapat disesuaikan, yang cocok dengan tampilan dan nuansa aplikasi. Anda menentukan cara dan lokasi penempatannya, sehingga tata letaknya lebih konsisten dengan desain aplikasi Anda.
Diberikan sebagai reward
Iklan yang memberikan reward kepada pengguna karena telah menonton video singkat serta berinteraksi dengan survei dan iklan yang dapat dimainkan. Digunakan untuk memonetisasi aplikasi gratis untuk dimainkan.
Referensi lainnya
Repositori Google Mobile Adsdi GitHub menunjukkan cara menggunakan berbagai format iklan yang ditawarkan API ini.