Mulai

Langkah pertama untuk menayangkan iklan dan memperoleh pendapatan adalah dengan mengintegrasikan Google Mobile Ads SDK ke dalam aplikasi. Setelah mengintegrasikan SDK, Anda dapat memilih format iklan (seperti video native atau reward) dan mengikuti langkah-langkah untuk menerapkan format tersebut.

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 34 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 ke file build level aplikasi Anda:

   Kotlin

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

   Groovy

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

3. 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="
   /<network_code>~<application_id>"/>
     </application>
   </manifest>
   

   Dalam aplikasi yang sebenarnya, ganti contoh ID aplikasi 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 untuk menambahkan tag <meta-data> persis seperti yang ditunjukkan akan mengakibatkan error dengan pesan:

   Missing application ID.
   

   (Opsional) Deklarasikan izin AD_ID agar versi sebelumnya berfungsi dengan Android 13.

   Jika aplikasi Anda menggunakan Google Mobile Ads SDK versi 20.4.0 atau yang lebih baru, Anda dapat melewati langkah ini karena SDK secara otomatis mendeklarasikan izin com.google.android.gms.permission.AD_ID dan dapat mengakses ID Iklan kapan pun tersedia.

   Untuk aplikasi yang menggunakan Google Mobile Ads SDK versi 20.3.0 atau yang lebih lama dan menargetkan Android 13, Anda harus menambahkan izin com.google.android.gms.permission.AD_ID dalam 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 pernyataan izin com.google.android.gms.permission.AD_ID lebih lanjut, termasuk cara menonaktifkannya, lihat artikel Konsol Play ini.

Menginisialisasi Google Mobile Ads SDK

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

Iklan dapat dipramuat oleh Google Mobile Ads SDK atau SDK partner mediasi setelah inisialisasi. Jika Anda perlu mendapatkan izin dari pengguna di Wilayah Ekonomi Eropa (EEA), tetapkan flag khusus permintaan, seperti setTagForChildDirectedTreatment() atau setTagForUnderAgeOfConsent(), atau ambil tindakan sebelum memuat iklan, pastikan Anda melakukannya sebelum melakukan inisialisasi Google Mobile Ads SDK.

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

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();
  }
}

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

Memilih format iklan

Google Mobile Ads SDK kini telah diimpor dan Anda siap untuk menerapkan iklan. Ad Manager menawarkan berbagai 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 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, seperti setelah menyelesaikan level di aplikasi game.

Menerapkan iklan interstisial

Native

Iklan native adalah iklan yang memungkinkan Anda menyesuaikan cara aset seperti judul dan panggilan untuk 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.

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

Gaya native telah dirancang untuk menyederhanakan penerapan iklan native, dan merupakan pilihan yang tepat jika Anda baru menggunakan format ini. Rendering kustom telah 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 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 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 permintaan 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 layar pembuka aplikasi

Referensi lainnya

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