Mulai

Mengintegrasikan GMA Next Gen SDK ke 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 24 atau yang lebih tinggi
  • Kompilasi SDK versi 35 atau yang lebih tinggi

• Untuk aplikasi Kotlin, gunakan versi Kotlin minimum 1.9.

Menyiapkan aplikasi di akun AdMob

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

1. Login ke atau daftar untuk 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. 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 GMA Next Gen SDK ke file build tingkat aplikasi Anda:

   Kotlin

   dependencies {
     implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01")
   }

   Groovy

   dependencies {
     implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.21.0-beta01'
   }

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

Lakukan inisialisasi GMA Next Gen SDK

Poin Penting: Anda harus menginisialisasi GMA Next Gen SDK sebelum memuat iklan dan berinteraksi dengan metode MobileAds lainnya, kecuali jika dinyatakan secara eksplisit dalam dokumen referensi API (lihat getVersion()). Jika tidak, UninitializedPropertyAccessException dapat terjadi.

Panggil MobileAds.initialize() untuk melakukan inisialisasi GMA Next Gen SDK. Metode ini harus dipanggil di thread latar belakang. Jika tidak dilakukan, error "Aplikasi Tidak Merespons" (ANR) dapat terjadi.

Kotlin

import com.google.android.libraries.ads.mobile.sdk.MobileAds
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig
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 GMA Next Gen SDK on a background thread.
      MobileAds.initialize(
        this@MainActivity,
        // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
        InitializationConfig.Builder("SAMPLE_APP_ID").build()
      ) {
        // Adapter initialization is complete.
      }
      // Other methods on MobileAds can now be called.
    }
  }
}

Java

import com.google.android.libraries.ads.mobile.sdk.MobileAds;
import com.google.android.libraries.ads.mobile.sdk.initialization.InitializationConfig;

public class MainActivity extends AppCompatActivity {
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    new Thread(
            () -> {
              // Initialize GMA Next Gen SDK on a background thread.
              MobileAds.initialize(
                  this,
                  // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
                  new InitializationConfig.Builder("SAMPLE_APP_ID")
                      .build(),
                  initializationStatus -> {
                    // Adapter initialization is complete.
                  });
              // Other methods on MobileAds can now be called.
            })
        .start();
  }
}

Metode ini menginisialisasi SDK dan memanggil pemroses penyelesaian setelah inisialisasi SDK Generasi Berikutnya GMA dan adaptor selesai, atau setelah waktu tunggu 30 detik. Langkah ini hanya perlu dilakukan sekali, idealnya saat aplikasi diluncurkan.

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

Iklan dapat dipramuat oleh GMA Next Gen SDK atau SDK partner mediasi saat inisialisasi. Jika Anda perlu mendapatkan persetujuan dari pengguna di Wilayah Ekonomi Eropa (EEA), atur setiap flag khusus permintaan, seperti RequestConfiguration.TagForChildDirectedTreatment atau RequestConfiguration.TagForUnderAgeOfConsent, atau ambil tindakan sebelum memuat iklan, pastikan Anda melakukannya sebelum menginisialisasi GMA Next Gen SDK.

Pilih format iklan

GMA Next Gen SDK kini diimpor dan Anda siap menerapkan iklan. AdMob menawarkan sejumlah format iklan yang berbeda, sehingga Anda dapat memilih format yang paling sesuai dengan pengalaman pengguna aplikasi Anda.

Banner

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 Anda. Tempatkan iklan ini pada jeda dan transisi yang alami di antarmuka aplikasi Anda, misalnya setelah menyelesaikan level dalam aplikasi game.

Menerapkan iklan interstisial

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, 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 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

Pembukaan 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