Mengintegrasikan Google Mobile Ads SDK ke dalam aplikasi adalah langkah pertama untuk menampilkan iklan dan memperoleh penghasilan. Setelah mengintegrasikan SDK, Anda dapat memilih format iklan (seperti video native atau reward) dan ikuti 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:
- Versi SDK minimum
21
atau yang lebih tinggi - Kompilasi versi SDK dari
33
atau yang lebih tinggi
- Versi SDK minimum
Siapkan aplikasi di akun AdMob Anda
Daftarkan aplikasi Anda sebagai aplikasi AdMob dengan menyelesaikan langkah-langkah berikut:
Login ke atau daftar untuk akun AdMob.
Daftarkan aplikasi ke AdMob. Langkah ini akan membuat aplikasi AdMob dengan Aplikasi AdMob ID yang diperlukan nanti dalam langkah ini kami.
Mengonfigurasi aplikasi Anda
Dalam file setelan Gradle Anda, sertakan Repositori Maven Google dan Repositori pusat Maven:
Kotlin
pluginManagement { repositories { google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } } rootProject.name = "My Application" include(":app")
Groovy
pluginManagement { repositories { google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } } rootProject.name = "My Application" include ':app'
Menambahkan dependensi untuk Google Mobile Ads SDK ke build level aplikasi file:
Kotlin
dependencies { implementation("com.google.android.gms:play-services-ads:23.3.0") }
Groovy
dependencies { implementation 'com.google.android.gms:play-services-ads:23.3.0' }
Tambahkan AdMob ID aplikasi Anda, seperti yang diidentifikasi di AdMob antarmuka web, ke antarmuka
AndroidManifest.xml
. Untuk melakukannya, tambahkan tag<meta-data>
denganandroid:name="com.google.android.gms.ads.APPLICATION_ID"
. Anda dapat menemukan ID aplikasi Anda di AdMob antarmuka web. Sebagaiandroid:value
, masukkan AdMob ID aplikasi Anda sendiri, dan diapit oleh tanda kutip.<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, ganti ID aplikasi contoh dengan yang sebenarnya AdMob ID aplikasi. Anda dapat menggunakan ID contoh jika Anda hanya bereksperimen dengan SDK dalam aplikasi Hello World.
Selain itu, perhatikan bahwa kegagalan untuk menambahkan tag
<meta-data>
persis seperti hasil yang ditampilkan terjadi error dengan pesan:Missing application ID.
(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 lebih tinggi, Anda dapat melewati langkah ini karena SDK secara otomatis mendeklarasikan
com.google.android.gms.permission.AD_ID
dan dapat untuk mengakses ID Iklan kapan pun tersedia.Untuk aplikasi yang menggunakan Google Mobile Ads SDK versi 20.3.0 atau dan menargetkan Android 13, Anda harus menambahkan
com.google.android.gms.permission.AD_ID
di FileAndroidManifest.xml
agar Google Mobile Ads SDK dapat 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 selengkapnya tentang pernyataan izin
com.google.android.gms.permission.AD_ID
, termasuk cara menonaktifkannya, lihat Play ini Artikel konsol.
Menginisialisasi Google Mobile Ads SDK
Sebelum memuat iklan, lakukan inisialisasi Google Mobile Ads SDK dengan memanggilMobileAds.initialize()
.
Metode ini menginisialisasi SDK dan memanggil pemroses penyelesaian setelah Inisialisasi Google Mobile Ads SDK dan adaptor telah 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
setelah inisialisasi. Jika Anda perlu mendapatkan izin dari pengguna di Eropa
Wilayah Ekonomi (EEA), tetapkan setiap tanda khusus permintaan, seperti
setTagForChildDirectedTreatment()
atau
setTagForUnderAgeOfConsent()
,
atau
jika tidak, ambil tindakan sebelum memuat iklan, pastikan Anda melakukannya sebelum menginisialisasi
Google Mobile Ads SDK.
Berikut adalah contoh cara memanggil metode initialize()
di latar belakang
thread dalam Aktivitas:
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);
new Thread(
() -> {
// Initialize the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(this, initializationStatus -> {});
})
.start();
}
}
Kotlin
import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
val backgroundScope = CoroutineScope(Dispatchers.IO)
backgroundScope.launch {
// Initialize the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(this@MainActivity) {}
}
}
}
Pilih format iklan
Google Mobile Ads SDK kini telah diimpor dan Anda siap menerapkan iklan. AdMob menawarkan sejumlah format iklan yang berbeda, sehingga Anda dapat memilih salah satu yang paling sesuai dengan pengalaman pengguna aplikasi Anda.
Banner
Unit iklan banner menampilkan iklan persegi panjang yang menempati sebagian iklan aplikasi tata letak. Iklan dapat dimuat ulang secara otomatis setelah jangka waktu tertentu. Artinya pengguna melihat iklan baru secara berkala, meskipun iklan tersebut tetap berdurasi sama di aplikasi Anda. Format iklan ini juga merupakan format iklan yang paling mudah diterapkan.
Interstisial
Unit iklan interstisial menampilkan iklan satu halaman penuh di aplikasi. Tempatkan mereka di posisi alami jeda dan transisi di antarmuka aplikasi Anda, seperti setelah penyelesaian level dalam aplikasi game.
Native
Iklan native adalah iklan yang memungkinkan Anda menyesuaikan cara aset seperti judul dan pesan ajakan yang ada di aplikasi Anda. Dengan menata gaya iklan sendiri, Anda dapat membuat tampilan iklan yang wajar dan tidak mengganggu yang dapat menambah detail pengalaman yang lancar bagi developer.
Reward
Unit iklan reward memungkinkan pengguna bermain game, mengikuti survei, atau menonton video untuk mendapatkan reward dalam aplikasi, seperti koin, nyawa tambahan, atau poin. Anda dapat mengatur reward berbeda untuk berbagai unit iklan, dan tentukan nilai reward dan item yang diterima pengguna.
Interstisial reward
Interstisial reward adalah jenis baru format iklan berinsentif yang memungkinkan Anda menawarkan reward, seperti koin atau nyawa tambahan, untuk iklan yang muncul secara otomatis selama transisi aplikasi yang alami.
Tidak seperti iklan reward, pengguna tidak diwajibkan memilih untuk melihat reward interstisial.
Sebagai ganti dialog keikutsertaan di iklan reward, interstisial reward memerlukan layar pengantar yang mengumumkan reward dan memberi pengguna kesempatan memilih tidak ikut jika mereka ingin melakukannya.
Menerapkan iklan interstisial reward
Iklan di layar pembuka aplikasi
Iklan di layar pembuka aplikasi adalah format iklan yang muncul saat pengguna membuka atau beralih kembali ke . Iklan ditempatkan di atas layar pemuatan.
Menerapkan iklan di layar pembuka aplikasi
Referensi lainnya
Repositori Iklan Seluler Google di GitHub menunjukkan cara menggunakan berbagai format iklan yang ditawarkan API ini.