Menyiapkan Google Mobile Ads SDK

Pilih platform: Android Baru Android iOS Unity Flutter

Mengintegrasikan Google Mobile Ads SDK ke aplikasi adalah langkah pertama untuk menayangkan iklan dan memperoleh pendapatan. Setelah mengintegrasikan SDK, Anda dapat memilih format iklan (seperti video reward atau native) 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:

    • Versi SDK minimum 23 atau yang lebih tinggi
    • Versi SDK kompilasi 35 atau yang lebih tinggi

Menyiapkan aplikasi di akun AdMob

Daftarkan aplikasi Anda sebagai aplikasi AdMob dengan menyelesaikan langkah-langkah berikut:

  1. Login atau daftar untuk membuka akun AdMob.

  2. Daftarkan aplikasi Anda ke AdMob. Langkah ini akan membuat aplikasi AdMob dengan ID Aplikasi AdMob unik yang diperlukan nanti dalam panduan ini.

Mengonfigurasi aplikasi Anda

  1. Di file setelan Gradle, 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'

  2. Tambahkan dependensi untuk Google Mobile Ads SDK ke file build tingkat aplikasi:

    Kotlin

    dependencies {
  implementation("com.google.android.gms:play-services-ads:25.2.0")
}

    Groovy

    dependencies {
  implementation 'com.google.android.gms:play-services-ads:25.2.0'
}

  3. Klik Sync Now. Untuk mengetahui detail tentang sinkronisasi, lihat Menyinkronkan project dengan file Gradle.

  4. Tambahkan ID aplikasi AdMob Anda, seperti yang diidentifikasi di antarmuka web AdMob, ke file AndroidManifest.xml aplikasi Anda. Untuk melakukannya, tambahkan tag <meta-data>dengan android:name="com.google.android.gms.ads.APPLICATION_ID". Anda dapat menemukan ID aplikasi Anda di antarmuka web AdMob. Untuk android:value, masukkan ID aplikasi AdMob Anda sendiri, yang diapit 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="SAMPLE_APP_ID"/>
  </application>
</manifest>

    Ganti SAMPLE_APP_ID dengan ID aplikasi AdMob Anda. Saat melakukan pengujian, gunakan ID aplikasi contoh yang ditampilkan dalam contoh sebelumnya.

    Selain itu, perhatikan bahwa kegagalan menambahkan tag <meta-data> persis seperti yang ditunjukkan akan mengakibatkan error dengan pesan:

    Missing application ID.

    (Opsional) Deklarasikan izin AD_ID untuk versi sebelumnya agar dapat 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 com.google.android.gms.permission.AD_ID izin dan dapat mengakses ID Iklan kapan pun 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 file AndroidManifest.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 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, inisialisasi Google Mobile Ads SDK dengan memanggil MobileAds.initialize().

Metode ini menginisialisasi SDK dan memanggil pemroses penyelesaian setelah inisialisasi Google Mobile Ads SDK dan adapter selesai, atau setelah waktu tunggu 30 detik. Langkah ini hanya perlu dilakukan sekali, idealnya saat aplikasi diluncurkan.

Jika Anda menggunakan Mediasi AdMob, tunggu hingga pemroses penyelesaian dipanggil sebelum memuat iklan. Hal ini memastikan semua adapter mediasi diinisialisasi.

Iklan dapat dipramuat oleh Google Mobile Ads SDK atau SDK partner mediasi saat inisialisasi. Jika Anda perlu mendapatkan persetujuan dari pengguna di Wilayah Ekonomi Eropa (EEA), mengatur setiap flag khusus permintaan, seperti setTagForChildDirectedTreatment() atau setTagForUnderAgeOfConsent(), atau mengambil tindakan sebelum memuat iklan, pastikan Anda melakukannya sebelum menginisialisasi Google Mobile Ads SDK.

Berikut adalah contoh cara memanggil metode initialize() di thread latar belakang dalam Aktivitas:

Java

new Thread(
        () -> {
          // Initialize the Google Mobile Ads SDK on a background thread.
          MobileAds.initialize(this, initializationStatus -> {});
        })
    .start();

Kotlin

CoroutineScope(Dispatchers.IO).launch {
  // Initialize the Google Mobile Ads SDK on a background thread.
  MobileAds.initialize(this@MainActivity) {}
}

Memilih format iklan

Google Mobile Ads SDK kini telah diimpor dan Anda siap menerapkan iklan. AdMob menawarkan berbagai format iklan yang berbeda, sehingga Anda dapat memilih format yang paling sesuai dengan pengalaman pengguna aplikasi Anda.

Unit iklan banner menampilkan iklan persegi panjang yang menempati sebagian tata letak aplikasi. Iklan ini dapat otomatis diperbarui setelah jangka waktu tertentu. Artinya, pengguna akan melihat iklan baru secara berkala, meskipun mereka tetap berada di layar yang sama di aplikasi Anda. Unit iklan banner juga merupakan format iklan yang paling mudah untuk diterapkan.

Menerapkan iklan banner

Interstisial

Unit iklan interstisial menampilkan iklan satu halaman penuh di aplikasi. Tempatkan iklan ini pada jeda dan transisi yang alami di antarmuka aplikasi Anda, misalnya setelah menyelesaikan level dalam aplikasi game.

Menerapkan iklan interstisial

Native

Iklan native adalah iklan yang memungkinkan Anda menyesuaikan cara aset seperti judul dan ajakan bertindak ditampilkan di aplikasi Anda. Dengan menata gaya iklan sendiri, Anda dapat membuat tampilan iklan yang tampak alami dan tidak mengganggu untuk memperkaya pengalaman pengguna.

Menerapkan iklan native

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 menetapkan reward yang berbeda untuk unit iklan yang berbeda, dan menentukan nilai reward dan item yang diterima pengguna.

Menerapkan iklan reward

Interstisial reward

Interstisial reward adalah jenis format iklan berinsentif yang baru yang memungkinkan Anda menawarkan reward, seperti koin atau nyawa tambahan, untuk iklan yang muncul otomatis selama transisi aplikasi secara alami.

Berbeda dengan iklan reward, pengguna tidak diwajibkan untuk memilih melihat interstisial reward.

Sebagai ganti dialog keikutsertaan pada iklan reward, interstisial reward memerlukan layar pengantar yang mengumumkan reward dan memberikan pengguna kesempatan untuk memilih tidak ikut jika mereka menginginkannya.

Menerapkan iklan interstisial reward

Layar pembuka aplikasi

Layar pembuka aplikasi adalah format iklan yang muncul saat pengguna membuka atau beralih kembali ke aplikasi Anda. Iklan akan ditempatkan di layar pemuatan.

Menerapkan iklan di layar pembuka aplikasi

Referensi lainnya

Repositori Google Mobile Ads di GitHub menunjukkan cara menggunakan berbagai format iklan yang ditawarkan API ini.