Halaman ini diterjemahkan oleh Cloud Translation API.

Mulai

Mengintegrasikan Google Mobile Ads SDK ke dalam aplikasi adalah langkah pertama untuk menampilkan iklan dan memperoleh pendapatan. Setelah SDK mengintegrasikannya, 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:
- minSdkVersion dari 19 atau lebih tinggi
- compileSdkVersion dari 33 atau lebih tinggi

Mengonfigurasi aplikasi Anda

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

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:22.5.0'
}
```
Tambahkan Ad Manager ID aplikasi, 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, sisipkan ID aplikasi Ad Manager Anda sendiri, yang diapit oleh tanda kutip.
```
<manifest>
  <application>
    
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
  </application>
</manifest>
```
Di aplikasi yang sebenarnya, gunakan ID aplikasi Ad Manager yang sebenarnya, bukan yang tercantum di atas. Jika Anda hanya ingin bereksperimen dengan SDK di aplikasi Hello World, Anda dapat menggunakan contoh ID aplikasi yang ditunjukkan di atas.

Perhatikan juga bahwa kegagalan untuk menambahkan tag <meta-data> seperti yang ditunjukkan di atas akan mengakibatkan error pada pesan:
```
The Google Mobile Ads SDK was initialized incorrectly.
```
(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 secara 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"/>

   
   <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, aplikasi Anda harus melakukan inisialisasi Google Mobile Ads SDK dengan memanggil MobileAds.initialize() yang akan menginisialisasi SDK dan memanggil kembali pemroses penyelesaian setelah inisialisasi selesai, atau setelah waktu tunggu 30 detik. Hal ini hanya perlu dilakukan sekali, idealnya saat peluncuran aplikasi.

Iklan dapat dipramuat oleh Google Mobile Ads SDK atau SDK partner mediasi saat memanggil MobileAds.initialize(). Jika Anda perlu mendapatkan izin dari pengguna di Wilayah Ekonomi Eropa (EEA), tetapkan setiap tanda khusus permintaan, seperti tagForChildDirectedTreatment atau tag_for_under_age_of_consent, atau ambil tindakan sebelum memuat iklan, pastikan Anda melakukannya sebelum melakukan inisialisasi Google Mobile Ads SDK.

Berikut adalah contoh cara memanggil metode initialize() dalam Aktivitas:

Contoh MainActivity (kutipan)

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

Jika Anda menggunakan mediasi, tunggu hingga pengendali penyelesaian dipanggil sebelum memuat iklan, karena hal ini akan memastikan bahwa semua adaptor mediasi telah diinisialisasi.

Pilih 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.

Iklan kotak yang muncul di bagian atas atau bawah layar perangkat. Iklan banner tetap ditampilkan di layar saat pengguna berinteraksi dengan aplikasi, dan dapat diperbarui secara otomatis setelah jangka waktu tertentu. Jika periklanan seluler merupakan hal yang baru bagi Anda, iklan Banner adalah pilihan pertama yang baik.

Menerapkan iklan banner

Interstisial

Iklan layar penuh yang menutupi antarmuka aplikasi hingga pengguna menutupnya. Fitur ini paling baik digunakan pada jeda alami dalam alur eksekusi aplikasi, seperti di antara level game atau tepat setelah tugas selesai.

Menerapkan iklan interstisial

Native

Iklan yang dapat disesuaikan, yang cocok dengan tampilan dan nuansa aplikasi. Anda yang menentukan cara dan lokasi penempatan iklan, sehingga tata letaknya lebih konsisten dengan desain aplikasi.

Google Ad Manager menawarkan dua cara untuk menerapkan iklan native: Gaya Native dan Rendering Kustom.

Gaya Native telah didesain untuk membuat penerapan iklan native semudah mungkin, dan merupakan pilihan tepat jika Anda baru mengenal format ini. Rendering Kustom dirancang untuk memaksimalkan kebebasan yang Anda miliki dalam membuat presentasi.

Menerapkan iklan native

Menerapkan gaya native

Diberikan sebagai reward

Iklan yang memberikan reward kepada pengguna karena telah menonton video singkat serta berinteraksi dengan iklan dan survei yang dapat dimainkan. Digunakan untuk memonetisasi aplikasi yang gratis.

Menerapkan iklan reward

Referensi lainnya

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