开始

Mengintegrasikan SDK Iklan Seluler Google 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 kamu memulai

Untuk menyiapkan aplikasi Anda, selesaikan langkah-langkah di bagian berikut.

Prasyarat aplikasi

  • Gunakan Android Studio 3.2 atau lebih tinggi
  • Pastikan file build aplikasi Anda menggunakan nilai berikut:

    • Sebuah minSdkVersion dari 16 atau lebih tinggi
    • Sebuah compileSdkVersion dari 28 atau lebih tinggi

Siapkan aplikasi Anda di akun AdMob Anda

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

  1. Masuk ke atau mendaftar untuk akun AdMob.

  2. Daftarkan aplikasi Anda dengan AdMob . Langkah ini menciptakan sebuah aplikasi AdMob dengan unik AdMob App ID yang diperlukan dalam panduan ini.

Konfigurasikan aplikasi Anda

  1. Dalam proyek-tingkat build.gradle berkas, termasuk repositori Maven Google dan Maven repositori pusat di kedua Anda buildscript dan allprojects bagian:

    buildscript {
        repositories {
            google()
            mavenCentral()
        }
    }
    
    allprojects {
        repositories {
            google()
            mavenCentral()
        }
    }
    
  2. Tambahkan dependensi untuk Google Mobile Ads SDK untuk aplikasi-tingkat modul Anda Gradle berkas, biasanya app/build.gradle :

    dependencies {
      implementation 'com.google.android.gms:play-services-ads:20.5.0'
    }
    
  3. Tambah AdMob ID aplikasi ( diidentifikasi dalamAdMobUI ) untuk aplikasi Anda AndroidManifest.xml berkas. Untuk melakukannya, tambahkan <meta-data> tag dengan android:name="com.google.android.gms.ads.APPLICATION_ID" . Anda dapat menemukan ID aplikasi Anda di AdMob UI. Untuk android:value , masukkan Anda sendiri AdMob ID aplikasi, dikelilingi oleh tanda kutip.

    <manifest>
        <application>
            <!-- Sample AdMob 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 nyata, gunakan sebenarnya AdMob ID aplikasi, 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 <meta-data> tag seperti yang ditunjukkan di atas hasil dalam kecelakaan dengan pesan:

    The Google Mobile Ads SDK was initialized incorrectly.
    

    (Opsional) Declare AD_ID izin untuk versi sebelumnya bekerja dengan Android S.

    Jika aplikasi Anda menggunakan versi Iklan Google Mobile SDK 20.4.0 atau lebih tinggi, Anda dapat melewatkan langkah ini sejak SDK secara otomatis menyatakan com.google.android.gms.permission.AD_ID izin dan mampu mengakses Iklan ID setiap kali itu tersedia .

    Untuk aplikasi yang menggunakan Google Mobile Ads SDK versi 20.3.0 atau menurunkan dan menargetkan Android S, Anda harus menambahkan com.google.android.gms.permission.AD_ID izin di AndroidManifest.xml file untuk menargetkan Android S:

    <manifest>
        <application>
            <meta-data
                android:name="com.google.android.gms.ads.APPLICATION_ID"
                android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>
    
            <-- For Android S devices & 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 tentang com.google.android.gms.permission.AD_ID izin deklarasi, termasuk bagaimana untuk menonaktifkannya, silakan lihat ini Putar artikel Console .

Inisialisasi SDK Iklan Seluler Google

Sebelum iklan pemuatan, memiliki aplikasi Anda initialize Google Mobile Ads SDK dengan memanggil MobileAds.initialize() yang menginisialisasi SDK dan panggilan kembali pendengar selesai setelah inisialisasi selesai (atau setelah batas waktu 30 detik). Ini perlu dilakukan hanya sekali, idealnya saat peluncuran aplikasi.

Iklan dapat dimuat oleh Google Mobile Ads SDK atau SDK mitra mediasi atas memanggil MobileAds.initialize() . Jika Anda perlu mendapatkan persetujuan dari pengguna di Wilayah Ekonomi Eropa (EEA), mengatur setiap bendera permintaan khusus (seperti tagForChildDirectedTreatment atau tag_for_under_age_of_consent ), atau mengambil tindakan sebelum iklan pemuatan, pastikan Anda melakukannya sebelum inisialisasi Google Mobile Ads SDK .

Berikut ini adalah contoh bagaimana untuk memanggil initialize() metode dalam Activity:

Contoh MainActivity (kutipan)

Jawa

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 penangan penyelesaian dipanggil sebelum memuat iklan, karena ini akan memastikan bahwa semua adaptor mediasi diinisialisasi.

Pilih format iklan

SDK Iklan Seluler Google sekarang diimpor dan Anda siap menerapkan iklan.AdMob menawarkan sejumlah format iklan yang berbeda, sehingga Anda dapat memilih salah satu yang paling sesuai dengan pengalaman pengguna aplikasi Anda.

Iklan persegi panjang yang muncul di bagian atas atau bawah layar perangkat. Iklan spanduk tetap ditampilkan di layar saat pengguna berinteraksi dengan aplikasi, dan dapat disegarkan secara otomatis setelah jangka waktu tertentu. Jika Anda baru mengenal periklanan seluler, ini adalah tempat yang bagus untuk memulai.

Terapkan iklan spanduk

pengantara

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

Terapkan iklan pengantara

Warga asli

Iklan yang dapat disesuaikan yang cocok dengan tampilan dan nuansa aplikasi Anda. Anda yang memutuskan bagaimana dan di mana mereka ditempatkan, sehingga tata letaknya lebih konsisten dengan desain aplikasi Anda.

Terapkan iklan bawaan

dihargai

Iklan yang memberi penghargaan kepada pengguna karena menonton video pendek dan berinteraksi dengan iklan dan survei yang dapat diputar. Digunakan untuk memonetisasi aplikasi free-to-play.

Terapkan iklan berhadiah

Sumber daya tambahan

The Iklan Mobile Google repositori di GitHub menunjukkan bagaimana menggunakan format iklan yang berbeda yang API ini menawarkan.