Iklan Spanduk

Iklan spanduk menempati tempat dalam tata letak aplikasi, baik di bagian atas atau bawah layar perangkat. Mereka tetap di layar saat pengguna berinteraksi dengan aplikasi, dan dapat menyegarkan secara otomatis setelah jangka waktu tertentu. Jika Anda baru mengenal periklanan seluler, itu adalah tempat yang bagus untuk memulai.Studi kasus .

Panduan ini menunjukkan Anda bagaimana untuk mengintegrasikan iklan banner dariAdMob menjadi sebuah aplikasi Android. Selain cuplikan kode dan instruksi, ini juga mencakup informasi tentang ukuran spanduk dengan benar dan tautan ke sumber daya tambahan.

Prasyarat

Menambahkan AdView untuk tata letak

Langkah pertama menuju menampilkan banner adalah untuk menempatkan AdView dalam layout untuk Activity atau Fragment di mana Anda ingin menampilkannya. Cara termudah untuk melakukannya adalah dengan menambahkannya ke file layout XML yang sesuai. Berikut ini adalah contoh yang menunjukkan kegiatan ini AdView :

# main_activity.xml
...
  <com.google.android.gms.ads.AdView
      xmlns:ads="http://schemas.android.com/apk/res-auto"
      android:id="@+id/adView"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:layout_centerHorizontal="true"
      android:layout_alignParentBottom="true"
      ads:adSize="BANNER"
      ads:adUnitId="ca-app-pub-3940256099942544/6300978111">
  </com.google.android.gms.ads.AdView>
...

Perhatikan atribut yang diperlukan berikut ini:

  • ads:adSize - Set ini untuk ukuran iklan yang ingin Anda gunakan. Jika Anda tidak ingin menggunakan ukuran standar yang ditentukan oleh konstanta, Anda dapat mengatur ukuran khusus sebagai gantinya. Lihat bagian ukuran banner di bawah ini untuk rincian.
  • ads:adUnitId - Set ini ke pengenal unik yang diberikan kepada unit iklan di aplikasi mana iklan yang akan ditampilkan. Jika Anda menampilkan iklan spanduk dalam aktivitas yang berbeda, masing-masing akan memerlukan unit iklan.

Anda alternatif dapat membuat AdView pemrograman:

Jawa

AdView adView = new AdView(this);

adView.setAdSize(AdSize.BANNER);

adView.setAdUnitId("ca-app-pub-3940256099942544/6300978111");
// TODO: Add adView to your view hierarchy.

Kotlin

val adView = AdView(this)

adView.adSize = AdSize.BANNER

adView.adUnitId = "ca-app-pub-3940256099942544/6300978111"
// TODO: Add adView to your view hierarchy.

Selalu uji dengan iklan uji

Saat membuat dan menguji aplikasi Anda, pastikan Anda menggunakan iklan percobaan daripada iklan produksi langsung. Kegagalan untuk melakukannya dapat menyebabkan penangguhan akun Anda.

Cara termudah untuk memuat iklan percobaan adalah dengan menggunakan ID unit iklan percobaan khusus kami untuk spanduk Android:

ca-app-pub-3940256099942544/6300978111

Ini telah dikonfigurasi secara khusus untuk menampilkan iklan percobaan untuk setiap permintaan, dan Anda bebas menggunakannya di aplikasi Anda sendiri saat mengkode, menguji, dan men-debug. Pastikan Anda menggantinya dengan ID unit iklan Anda sendiri sebelum memublikasikan aplikasi Anda.

Untuk informasi lebih lanjut tentang bagaimana iklan tes SDK Iklan Seluler ini bekerja, lihat Iklan Uji .

Muat iklan

Setelah AdView di tempat, langkah berikutnya adalah untuk memuat iklan. Itu dilakukan dengan loadAd() metode dalam AdView kelas. Dibutuhkan AdRequest parameter, yang memegang informasi runtime (seperti menargetkan Info) tentang satu permintaan iklan.

Berikut ini adalah contoh yang menunjukkan bagaimana untuk memuat iklan di onCreate() metode dari Activity :

Aktivitas Utama (kutipan)

Jawa

package ...

import ...
import com.google.android.gms.ads.AdRequest;
import com.google.android.gms.ads.AdView;

public class MainActivity extends AppCompatActivity {
    private AdView mAdView;

    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        MobileAds.initialize(this, new OnInitializationCompleteListener() {
            @Override
            public void onInitializationComplete(InitializationStatus initializationStatus) {
            }
        });

        mAdView = findViewById(R.id.adView);
        AdRequest adRequest = new AdRequest.Builder().build();
        mAdView.loadAd(adRequest);
    }
}

Kotlin

package ...

import ...
import com.google.android.gms.ads.AdRequest
import com.google.android.gms.ads.AdView

class MainActivity : AppCompatActivity() {

    lateinit var mAdView : AdView

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        MobileAds.initialize(this) {}

        mAdView = findViewById(R.id.adView)
        val adRequest = AdRequest.Builder().build()
        mAdView.loadAd(adRequest)
    }
}

Itu dia! Aplikasi Anda sekarang siap menampilkan iklan spanduk.

Acara iklan

Untuk lebih menyesuaikan perilaku iklan Anda, Anda dapat menghubungkan ke sejumlah peristiwa dalam siklus hidup iklan: memuat, membuka, menutup, dan seterusnya. Anda dapat mendengarkan peristiwa ini melalui AdListener kelas.

Untuk menggunakan AdListener dengan AdView , memanggil setAdListener() metode:

Jawa

mAdView.setAdListener(new AdListener() {
    @Override
    public void onAdLoaded() {
        // Code to be executed when an ad finishes loading.
    }

    @Override
    public void onAdFailedToLoad(LoadAdError adError) {
        // Code to be executed when an ad request fails.
    }

    @Override
    public void onAdOpened() {
        // Code to be executed when an ad opens an overlay that
        // covers the screen.
    }

    @Override
    public void onAdClicked() {
        // Code to be executed when the user clicks on an ad.
    }

    @Override
    public void onAdClosed() {
        // Code to be executed when the user is about to return
        // to the app after tapping on an ad.
    }
});

Kotlin

mAdView.adListener = object: AdListener() {
    override fun onAdLoaded() {
        // Code to be executed when an ad finishes loading.
    }

    override fun onAdFailedToLoad(adError : LoadAdError) {
        // Code to be executed when an ad request fails.
    }

    override fun onAdOpened() {
        // Code to be executed when an ad opens an overlay that
        // covers the screen.
    }

    override fun onAdClicked() {
        // Code to be executed when the user clicks on an ad.
    }

    override fun onAdClosed() {
        // Code to be executed when the user is about to return
        // to the app after tapping on an ad.
    }
}

Setiap metode overridable di AdListener sesuai dengan sebuah acara di siklus hidup sebuah iklan.

Metode yang dapat ditimpa
onAdLoaded() The onAdLoaded() metode dijalankan ketika iklan memiliki pemuatan selesai. Jika Anda ingin menunda menambahkan AdView ke aktivitas Anda atau fragmen sampai Anda yakin iklan akan dimuat, misalnya, Anda dapat melakukannya di sini.
onAdFailedToLoad() The onAdFailedToLoad() metode adalah satu-satunya yang mencakup parameter. Parameter kesalahan tipe LoadAdError menjelaskan apa yang terjadi kesalahan. Untuk informasi lebih lanjut, lihat Debugging Iklan Beban Kesalahan dokumentasi .
onAdOpened() Metode ini dipanggil saat pengguna mengetuk iklan.
onAdClosed() Saat pengguna kembali ke aplikasi setelah melihat URL tujuan iklan, metode ini akan dipanggil. Aplikasi Anda dapat menggunakannya untuk melanjutkan aktivitas yang ditangguhkan atau melakukan pekerjaan lain yang diperlukan untuk membuatnya siap berinteraksi.Rujuk ke AdMob AdListener contoh untuk penerapan metode pendengar iklan di aplikasi Android API Demo.

Tabel di bawah mencantumkan ukuran spanduk standar.

Ukuran dalam dp (PxT) Keterangan Ketersediaan Konstanta Ukuran Iklan
320x50 Spanduk Ponsel dan Tablet BANNER
320x100 Spanduk Besar Ponsel dan Tablet LARGE_BANNER
300x250 Persegi Panjang Sedang IAB Ponsel dan Tablet MEDIUM_RECTANGLE
468x60 Spanduk Ukuran Penuh IAB Tablet FULL_BANNER
728x90 Papan Peringkat IAB Tablet LEADERBOARD
Asalkan lebar x tinggi Adaptive Spanduk adaptif Ponsel dan Tablet T/A
Lebar layar x 32 | 50 | 90 Spanduk pintar Ponsel dan Tablet SMART_BANNER
Pelajari lebih lanjut tentang Adaptive Banner , dimaksudkan untuk menggantikan Spanduk Cerdas .

Untuk menentukan ukuran banner kustom, mengatur Anda inginkan AdSize , seperti yang ditunjukkan di sini:

Jawa

AdSize adSize = new AdSize(300, 50);

Kotlin

val adSize = AdSize(300, 50)

Akselerasi perangkat keras untuk iklan video

Agar iklan video untuk menunjukkan sukses dalam tampilan iklan banner, akselerasi hardware harus diaktifkan.

Akselerasi perangkat keras diaktifkan secara default, tetapi beberapa aplikasi mungkin memilih untuk menonaktifkannya. Jika ini berlaku untuk aplikasi Anda, sebaiknya aktifkan akselerasi perangkat keras untuk kelas Aktivitas yang menggunakan iklan.

Mengaktifkan akselerasi perangkat keras

Jika aplikasi Anda tidak berperilaku baik dengan akselerasi perangkat keras yang diaktifkan secara global, Anda juga dapat mengontrolnya untuk aktivitas individual. Untuk mengaktifkan atau menonaktifkan akselerasi hardware, Anda dapat menggunakan android:hardwareAccelerated atribut untuk <application> dan <activity> elemen dalam Anda AndroidManifest.xml . Contoh berikut mengaktifkan akselerasi perangkat keras untuk seluruh aplikasi tetapi menonaktifkannya untuk satu aktivitas:

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>

Lihat panduan percepatan HW untuk informasi lebih lanjut tentang opsi untuk mengendalikan akselerasi hardware. Perhatikan bahwa tampilan iklan individual tidak dapat diaktifkan untuk akselerasi perangkat keras jika Aktivitas dinonaktifkan, jadi Aktivitas itu sendiri harus mengaktifkan akselerasi perangkat keras.

Sumber daya tambahan

Contoh di GitHub

Tutorial video Garasi Iklan Seluler

Cerita-cerita sukses