Iklan banner

Tampilan banner adalah iklan gambar atau teks persegi panjang yang menempati suatu tempat di layar. Iklan banner tetap muncul di layar saat pengguna berinteraksi dengan aplikasi, dan iklan dapat dimuat ulang secara otomatis setelah jangka waktu tertentu. Jika periklanan seluler merupakan hal yang baru bagi Anda, iklan Banner adalah pilihan pertama yang baik.

Panduan ini menunjukkan cara mengintegrasikan tampilan banner ke dalam aplikasi Unity. Selain cuplikan kode dan petunjuk, panduan ini juga menyertakan informasi tentang cara menentukan ukuran banner dengan benar dan link ke referensi tambahan.

Prasyarat

• Selesaikan Panduan memulai.

Selalu melakukan pengujian dengan iklan percobaan

Kode contoh berikut berisi ID unit iklan yang dapat Anda gunakan untuk meminta iklan percobaan. Unit iklan ini telah dikonfigurasi secara khusus untuk menampilkan iklan percobaan, bukan iklan produksi, untuk setiap permintaan, sehingga aman digunakan.

Namun, setelah Anda mendaftarkan aplikasi di antarmuka web Ad Manager dan membuat ID unit iklan sendiri untuk digunakan di aplikasi, konfigurasi perangkat Anda secara eksplisit sebagai perangkat pengujian selama pengembangan.

/21775744923/example/adaptive-banner

Menginisialisasi Mobile Ads SDK

Sebelum memuat iklan, aplikasi harus menginisialisasi Mobile Ads SDK dengan memanggil MobileAds.Initialize(). Langkah ini hanya perlu dilakukan sekali, idealnya saat aplikasi diluncurkan.

using GoogleMobileAds;
using GoogleMobileAds.Api;

public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize((InitializationStatus initStatus) =>
        {
            // This callback is called once the MobileAds SDK is initialized.
        });
    }
}

Jika Anda menggunakan mediasi, tunggu hingga callback terjadi sebelum memuat iklan karena tindakan ini akan memastikan semua adaptor mediasi diinisialisasi.

Contoh BannerView

Contoh kode berikut menjelaskan cara menggunakan tampilan banner. Dalam contoh, buat instance tampilan banner, gunakan AdManagerAdRequest untuk memuat iklan ke tampilan banner, lalu perluas kemampuannya dengan menangani peristiwa siklus proses.

Membuat tampilan banner

Langkah pertama dalam menggunakan tampilan banner adalah membuat instance tampilan banner.

// Create a 320x50 banner at top of the screen.
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", AdSize.Banner, AdPosition.Top);
AdManagerBannerViewSnippets.cs

Ganti AD_UNIT_ID dengan ID unit iklan Anda.

Konstruktor untuk AdManagerBannerView memiliki parameter berikut:

• adUnitId: ID unit iklan dari iklan banner yang akan dimuat.
• AdSize: Ukuran banner yang ingin Anda gunakan.
• AdPosition: Posisi tempat tampilan banner harus ditempatkan.

(Opsional) Membuat tampilan banner dengan posisi kustom

Untuk kontrol yang lebih besar atas penempatan tampilan banner di layar daripada yang ditawarkan oleh nilai AdPosition, gunakan konstruktor yang memiliki koordinat x dan y sebagai parameter:

// Create a 320x50 banner views at coordinate (0,50) on screen.
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", AdSize.Banner, 0, 50);
AdManagerBannerViewSnippets.cs

Sudut kiri atas tampilan banner diposisikan pada nilai x dan y yang diteruskan ke konstruktor, dengan asal adalah kiri atas layar.

(Opsional) Buat tampilan banner dengan ukuran kustom

Selain menggunakan konstanta AdSize, Anda juga dapat menentukan ukuran kustom untuk iklan:

// Create a 250x250 banner at the bottom of the screen.
AdSize adSize = new AdSize(250, 250);
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", adSize, AdPosition.Bottom);
AdManagerBannerViewSnippets.cs

(Opsional) Beberapa ukuran iklan

Ad Manager memungkinkan Anda menentukan beberapa ukuran iklan yang memenuhi syarat untuk ditayangkan di AdManagerBannerView. Sebelum menerapkan fitur ini di SDK, buat item baris yang menargetkan unit iklan yang sama yang terkait dengan materi iklan berukuran berbeda.

Di aplikasi Anda, teruskan beberapa parameter AdSize ke ValidAdSizes:

// Create a 250x250 banner at the bottom of the screen.
adManagerBannerView = new AdManagerBannerView("AD_UNIT_ID", AdSize.Banner, AdPosition.Top);

// Add multiple ad sizes.
adManagerBannerView.ValidAdSizes = new List<AdSize>
{
    AdSize.Banner,
    new AdSize(120, 20),
    new AdSize(250, 250),
};
AdManagerBannerViewSnippets.cs

Jika AdManagerAdView berubah ukuran saat waktu pembaruan, tata letak Anda harus dapat beradaptasi secara otomatis dengan ukuran baru. AdManagerAdView secara default adalah ukuran yang diteruskan dalam parameter pertama hingga iklan berikutnya ditampilkan.

Memuat iklan banner

Setelah AdManagerBannerView diterapkan, lanjutkan untuk memuat iklan dengan metode LoadAd() di class AdManagerBannerView. Parameter ini menggunakan parameter yang menyimpan informasi runtime, seperti info penargetan, label pengecualian, dan ID yang diberikan penayang.

Untuk memuat iklan, buat AdManagerAdRequest dan teruskan ke metode LoadAd().

// Send a request to load an ad into the banner view.
adManagerBannerView.LoadAd(new AdManagerAdRequest());
AdManagerBannerViewSnippets.cs

Memproses peristiwa tampilan banner

Untuk menyesuaikan perilaku iklan, Anda dapat menggunakan sejumlah peristiwa dalam siklus proses iklan, seperti pemuatan, pembukaan, atau penutupan. Untuk memproses peristiwa ini, daftarkan delegasi:

adManagerBannerView.OnBannerAdLoaded += () =>
{
    // Raised when an ad is loaded into the banner view.
};
adManagerBannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
{
    // Raised when an ad fails to load into the banner view.
};
adManagerBannerView.OnAdPaid += (AdValue adValue) =>
{
    // Raised when the ad is estimated to have earned money.
};
adManagerBannerView.OnAdImpressionRecorded += () =>
{
    // Raised when an impression is recorded for an ad.
};
adManagerBannerView.OnAdClicked += () =>
{
    // Raised when a click is recorded for an ad.
};
adManagerBannerView.OnAdFullScreenContentOpened += () =>
{
    // Raised when an ad opened full screen content.
};
adManagerBannerView.OnAdFullScreenContentClosed += () =>
{
    // Raised when the ad closed full screen content.
};
AdManagerBannerViewSnippets.cs

Menghancurkan tampilan banner

Setelah selesai menggunakan tampilan banner, pastikan untuk memanggil Destroy() untuk melepaskan resource.

if (adManagerBannerView != null)
{
    // Always destroy the banner view when no longer needed.
    adManagerBannerView.Destroy();
    adManagerBannerView = null;
}
AdManagerBannerViewSnippets.cs

Selesai. Aplikasi Anda kini siap menampilkan iklan banner.

Memperbarui iklan

Jika mengonfigurasi unit iklan untuk memuat ulang, Anda tidak perlu meminta iklan lain saat iklan gagal dimuat. Google Mobile Ads SDK mematuhi kecepatan refresh apa pun yang Anda tentukan di UI Ad Manager. Jika Anda belum mengaktifkan pengambilan data, kirim permintaan baru. Untuk mengetahui detail selengkapnya tentang refresh unit iklan, seperti menyetel kecepatan refresh, lihat Kecepatan refresh untuk iklan di aplikasi seluler.

Ukuran spanduk

Tabel berikut mencantumkan ukuran banner standar:

Peristiwa aplikasi

Peristiwa aplikasi memungkinkan Anda membuat iklan yang dapat mengirim pesan ke kode aplikasinya. Aplikasi kemudian dapat mengambil tindakan berdasarkan pesan ini.

Anda dapat memproses peristiwa aplikasi khusus Ad Manager menggunakan AppEvent. Peristiwa ini dapat terjadi kapan saja selama siklus proses iklan, bahkan sebelum pemuatan dipanggil.

OnAppEventReceived dipicu saat peristiwa aplikasi terjadi di iklan. Berikut adalah contoh cara menangani peristiwa ini dalam kode Anda:

adManagerBannerView.OnAppEventReceived += (AppEvent args) =>
{
    Debug.Log($"Received app event from the ad: {args.Name}, {args.Data}.");
};
AdManagerBannerViewSnippets.cs

Berikut adalah contoh yang menunjukkan cara mengubah warna latar belakang aplikasi Anda, bergantung pada peristiwa aplikasi dengan nama warna:

adManagerBannerView.OnAppEventReceived += (AppEvent args) =>
{
    if (args.Name == "color")
    {
        Color color;
        if (ColorUtility.TryParseHtmlString(args.Data, out color))
        {
            renderer.material.color = color;
        }
    }
};
AdManagerBannerViewSnippets.cs

Berikut adalah materi iklan terkait yang mengirim peristiwa aplikasi warna:

<html>
<head>
  <script src="//www.gstatic.com/afma/api/v1/google_mobile_app_ads.js"></script>
  <script>
    document.addEventListener("DOMContentLoaded", function() {
      // Send a color=green event when ad loads.
      admob.events.dispatchAppEvent("color", "green");

      document.getElementById("ad").addEventListener("click", function() {
        // Send a color=blue event when ad is clicked.
        admob.events.dispatchAppEvent("color", "blue");
      });
    });
  </script>
  <style>
    #ad {
      width: 320px;
      height: 50px;
      top: 0;
      left: 0;
      font-size: 24pt;
      font-weight: bold;
      position: absolute;
      background: black;
      color: white;
      text-align: center;
    }
  </style>
</head>
<body>
  <div id="ad">Carpe diem!</div>
</body>
</html>
AppEventSnippets.html

Referensi lainnya

• Contoh HelloWorld: Implementasi minimal dari semua format iklan.