Mulai

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:

    • Versi SDK minimum 19 atau lebih tinggi
    • Kompilasi versi SDK 33 atau yang lebih tinggi

Mengonfigurasi aplikasi Anda

  1. Dalam file build.gradle level project, sertakan repositori Maven Google dan repositori pusat Maven di bagian buildscript dan allprojects:

    buildscript {
    repositories {
        google()
        mavenCentral()
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

  2. Tambahkan dependensi untuk Google Mobile Ads SDK ke file Gradle level aplikasi modul, biasanya app/build.gradle:

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

  3. Tambahkan Ad Manager ID aplikasi Anda, seperti yang diidentifikasi dalam antarmuka webAd Manager, 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 di Ad Manager antarmuka web. Untuk android:value, masukkan ID aplikasi Ad Manager Anda sendiri, yang diapit tanda kutip.

    <manifest>
  <application>
    <!-- Sample Ad Manager 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 ID aplikasi Ad Manager yang sebenarnya. Anda dapat menggunakan ID contoh jika hanya bereksperimen dengan SDK di aplikasi Hello World.

    Selain itu, perhatikan bahwa kegagalan menambahkan tag <meta-data> persis seperti yang ditampilkan akan menyebabkan error pada 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 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 file AndroidManifest.xml untuk Google Mobile Ads SDK agar 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, lakukan inisialisasi Google Mobile Ads SDK dengan memanggil MobileAds.initialize().

Metode ini menginisialisasi SDK dan memanggil pemroses penyelesaian setelah Google Mobile Ads SDK dan inisialisasi adaptor 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 inisialisasi. Jika Anda perlu mendapatkan izin dari pengguna di Wilayah Ekonomi Eropa (EEA), tetapkan tanda khusus permintaan, seperti setTagForChildDirectedTreatment() atau setTagForUnderAgeOfConsent(), atau lakukan tindakan sebelum memuat iklan, pastikan Anda melakukannya sebelum menginisialisasi Google Mobile Ads SDK.

Berikut adalah contoh cara memanggil metode initialize() 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);

    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) {}
  }
}

Pilih format iklan

Google Mobile Ads SDK kini telah diimpor dan Anda siap untuk menerapkan iklan. Ad Manager menawarkan sejumlah format iklan yang berbeda, sehingga Anda dapat memilih salah satu yang paling sesuai dengan pengalaman pengguna aplikasi Anda.

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

Menerapkan iklan banner

Interstisial

Unit iklan interstisial menampilkan iklan satu halaman penuh di aplikasi Anda. Tempatkan iklan pada jeda dan transisi yang wajar di antarmuka aplikasi, seperti setelah penyelesaian level di aplikasi game.

Menerapkan iklan interstisial

Native

Iklan native adalah iklan yang dapat Anda gunakan untuk menyesuaikan cara aset seperti judul dan pesan ajakan (CTA) ditampilkan dalam aplikasi Anda. Dengan menata gaya iklan sendiri, Anda dapat membuat tampilan iklan yang alami dan tidak mengganggu untuk memperkaya pengalaman pengguna.

Google Ad Manager menawarkan dua cara untuk menerapkan iklan native: gaya native dan iklan native standar melalui rendering kustom.

Gaya native telah didesain untuk menyederhanakan implementasi iklan native, dan merupakan pilihan yang tepat jika Anda baru mengenal format ini. Rendering kustom telah dirancang untuk memaksimalkan kebebasan yang Anda miliki dalam membuat presentasi.

Mengimplementasikan gaya native Menerapkan iklan native (rendering kustom)

Diberikan sebagai reward

Unit iklan reward memungkinkan pengguna untuk bermain game, mengikuti survei, atau menonton video untuk memperoleh reward dalam aplikasi, seperti koin, nyawa tambahan, atau poin. Anda dapat menetapkan reward yang berbeda untuk unit iklan yang berbeda, serta menentukan nilai reward dan item yang diterima pengguna.

Menerapkan iklan reward

Interstisial reward

Interstisial reward adalah jenis format iklan berinsentif baru 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 harus memilih untuk melihat interstisial reward.

Sebagai ganti permintaan keikutsertaan dalam iklan reward, interstisial reward memerlukan layar pengantar yang mengumumkan reward dan memberi pengguna kesempatan untuk memilih tidak ikut jika mereka ingin melakukannya.

Menerapkan iklan interstisial reward

Iklan di layar pembuka aplikasi

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

Menerapkan iklan di layar pembuka aplikasi

Referensi tambahan

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