Mulai

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

Mengonfigurasi aplikasi Anda

  1. 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'

  2. 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'
}

  3. Tambahkan Ad Manager ID aplikasi Anda, seperti yang diidentifikasi di Ad Manager antarmuka web, ke antarmuka AndroidManifest.xml. Untuk melakukannya, tambahkan tag <meta-data> dengan android:name="com.google.android.gms.ads.APPLICATION_ID". Anda dapat menemukan ID aplikasi Anda di Ad Manager antarmuka web. Sebagai android:value, masukkan Ad Manager ID aplikasi Anda sendiri, dan diapit oleh 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 yang sebenarnya Ad Manager 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 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 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 memanggil MobileAds.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. 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. 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.

Menerapkan iklan banner

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.

Menerapkan iklan interstisial

Native

Iklan native adalah iklan yang memungkinkan Anda menyesuaikan 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.

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 penerapan iklan native, dan ini adalah pilihan yang baik jika Anda baru mengenal format ini. Rendering kustom telah yang dirancang untuk memaksimalkan kebebasan yang Anda miliki dalam membuat presentasi.

Menerapkan gaya native Menerapkan iklan native (rendering kustom)

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.

Menerapkan iklan reward

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.