Menyiapkan Google Mobile Ads SDK (Legacy)

Mengintegrasikan Google Mobile Ads SDK (Legacy) ke dalam aplikasi adalah langkah pertama untuk menampilkan iklan dan memperoleh pendapatan. Setelah mengintegrasikan SDK, Anda dapat memilih format iklan (seperti video native atau video 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 23 atau yang lebih tinggi
  • Kompilasi SDK versi 35 atau yang lebih tinggi

Mengonfigurasi aplikasi Anda

1. Dalam 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 (Legacy) ke file build level aplikasi Anda:

   Kotlin

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

   Groovy

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

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

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

   <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="SAMPLE_APP_ID"/>
     </application>
   </manifest>
   

   Ganti SAMPLE_APP_ID dengan ID aplikasi Ad Manager Anda. Saat menguji, gunakan ID aplikasi contoh yang ditampilkan dalam contoh sebelumnya.

   Selain itu, perhatikan bahwa jika gagal menambahkan tag <meta-data> persis seperti yang ditunjukkan, akan terjadi 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 (Legacy) versi 20.4.0 atau yang lebih tinggi, Anda dapat melewati langkah ini karena SDK otomatis menyatakan izin com.google.android.gms.permission.AD_ID dan dapat mengakses ID Iklan setiap kali tersedia.

   Untuk aplikasi yang menggunakan Google Mobile Ads SDK (Legacy) 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 (Legacy) 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 lebih lanjut pernyataan izin com.google.android.gms.permission.AD_ID, termasuk cara menonaktifkannya, lihat artikel Konsol Play ini.

Lakukan inisialisasi Google Mobile Ads SDK (Legacy)

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

Jika Anda menggunakan mediasi, tunggu hingga handler penyelesaian dipanggil sebelum memuat iklan. Hal ini memastikan bahwa semua adapter mediasi diinisialisasi.

Iklan dapat dipramuat oleh Google Mobile Ads SDK (Legacy) atau SDK partner mediasi saat inisialisasi. Jika Anda perlu mendapatkan izin dari pengguna di Wilayah Ekonomi Eropa (EEA), Inggris Raya (UK), atau Swiss, tetapkan setiap tanda khusus permintaan, seperti setTagForChildDirectedTreatment() atau setTagForUnderAgeOfConsent(), atau ambil tindakan sebelum memuat iklan, pastikan Anda melakukannya sebelum menginisialisasi Google Mobile Ads SDK (Legacy).

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

new Thread(
        () -> {