Halaman ini diterjemahkan oleh Cloud Translation API.

Iklan banner

Iklan banner adalah iklan gambar atau teks persegi panjang yang menempati suatu tempat di layar. Iklan ini tetap berada di layar saat pengguna berinteraksi dengan aplikasi, dan 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. Studi kasus.

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

Prasyarat

Selesaikan Panduan memulai.

Selalu uji dengan iklan percobaan

Kode contoh di bawah berisi ID unit iklan yang dapat digunakan untuk meminta iklan pengujian. Ini telah dikonfigurasi secara khusus untuk menampilkan iklan pengujian, bukan iklan produksi, untuk setiap permintaan, sehingga aman untuk digunakan.

Namun, setelah mendaftarkan aplikasi di UI AdMob dan membuat ID unit iklan Anda sendiri untuk digunakan di aplikasi, Anda harus mengonfigurasi perangkat sebagai perangkat pengujian secara eksplisit selama pengembangan.

Android

ca-app-pub-3940256099942544/6300978111

iOS

ca-app-pub-3940256099942544/2934735716

Menginisialisasi Mobile Ads SDK

Sebelum memuat iklan, minta aplikasi Anda menginisialisasi Mobile Ads SDK dengan memanggil MobileAds.Initialize(). Hal ini hanya perlu dilakukan sekali, idealnya saat peluncuran aplikasi.

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 hal ini akan memastikan bahwa semua adaptor mediasi diinisialisasi.

Contoh BannerView

Kode contoh di bawah menjelaskan cara menggunakan tampilan banner. Pada contoh, Anda membuat instance tampilan banner, menggunakan AdRequest untuk memuat iklan ke tampilan banner, lalu memperluas fungsi dengan menangani peristiwa siklus proses.

Membuat tampilan banner

Langkah pertama dalam menggunakan tampilan banner adalah membuat instance tampilan banner di skrip C# yang dilampirkan ke GameObject.

  // These ad units are configured to always serve test ads.
#if UNITY_ANDROID
  private string _adUnitId = "ca-app-pub-3940256099942544/6300978111";
#elif UNITY_IPHONE
  private string _adUnitId = "ca-app-pub-3940256099942544/2934735716";
#else
  private string _adUnitId = "unused";
#endif

  BannerView _bannerView;

  /// <summary>
  /// Creates a 320x50 banner at top of the screen.
  /// </summary>
  public void CreateBannerView()
  {
      Debug.Log("Creating banner view");

      // If we already have a banner, destroy the old one.
      if (_bannerView != null)
      {
          DestroyAd();
      }

      // Create a 320x50 banner at top of the screen
      _bannerView = new BannerView(_adUnitId, AdSize.Banner, AdPosition.Top);
  }

Konstruktor untuk BannerView memiliki parameter berikut:

adUnitId: ID unit iklan AdMob tempat BannerView harus memuat iklan.
AdSize: Ukuran iklan AdMob yang ingin Anda gunakan (lihat Ukuran banner untuk mengetahui detailnya).
AdPosition: Posisi tempat iklan banner harus ditempatkan. Enum AdPosition mencantumkan nilai posisi iklan yang valid.

Perhatikan bagaimana berbagai unit iklan digunakan, tergantung platformnya. Anda perlu menggunakan unit iklan iOS untuk membuat permintaan iklan di iOS dan unit iklan Android untuk membuat permintaan di Android.

(Opsional) Buat tampilan banner dengan posisi kustom

Untuk kontrol yang lebih besar terhadap penempatan BannerView di layar daripada yang ditawarkan oleh nilai AdPosition, gunakan BannerViewconstructor yang memiliki koordinat x-y dan y sebagai parameter:

// Create a 320x50 banner ad at coordinate (0,50) on screen.
_bannerView = new BannerView(_adUnitId, AdSize.Banner, 0, 50);

Sudut kiri atas BannerView diposisikan pada nilai x dan y yang diteruskan ke konstruktor, dengan asalnya adalah kiri atas layar.

(Opsional) Buat tampilan banner dengan ukuran kustom

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

// Use the AdSize argument to set a custom size for the ad.
AdSize adSize = new AdSize(250, 250);
_bannerView = new BannerView(_adUnitId, adSize, AdPosition.Bottom);

Memuat iklan banner

Langkah kedua dalam menggunakan tampilan banner adalah membuat AdRequest dan meneruskannya ke metode LoadAd().

/// <summary>
/// Creates the banner view and loads a banner ad.
/// </summary>
public void LoadAd()
{
    // create an instance of a banner view first.
    if(_bannerView == null)
    {
        CreateBannerView();
    }
    // create our request used to load the ad.
    var adRequest = new AdRequest();
    adRequest.Keywords.Add("unity-admob-sample");

    // send the request to load the ad.
    Debug.Log("Loading banner ad.");
    _bannerView.LoadAd(adRequest);
}

Memproses peristiwa tampilan banner

Untuk menyesuaikan perilaku iklan, Anda dapat mengaitkan ke sejumlah peristiwa dalam siklus proses iklan: memuat, membuka, menutup, dan sebagainya. Untuk memproses peristiwa ini, daftarkan delegasi:

/// <summary>
/// listen to events the banner may raise.
/// </summary>
private void ListenToAdEvents()
{
    // Raised when an ad is loaded into the banner view.
    _bannerView.OnBannerAdLoaded += () =>
    {
        Debug.Log("Banner view loaded an ad with response : "
            + _bannerView.GetResponseInfo());
    };
    // Raised when an ad fails to load into the banner view.
    _bannerView.OnBannerAdLoadFailed += (LoadAdError error) =>
    {
        Debug.LogError("Banner view failed to load an ad with error : "
            + error);
    };
    // Raised when the ad is estimated to have earned money.
    _bannerView.OnAdPaid += (AdValue adValue) =>
    {
        Debug.Log(String.Format("Banner view paid {0} {1}.",
            adValue.Value,
            adValue.CurrencyCode));
    };
    // Raised when an impression is recorded for an ad.
    _bannerView.OnAdImpressionRecorded += () =>
    {
        Debug.Log("Banner view recorded an impression.");
    };
    // Raised when a click is recorded for an ad.
    _bannerView.OnAdClicked += () =>
    {
        Debug.Log("Banner view was clicked.");
    };
    // Raised when an ad opened full screen content.
    _bannerView.OnAdFullScreenContentOpened += () =>
    {
        Debug.Log("Banner view full screen content opened.");
    };
    // Raised when the ad closed full screen content.
    _bannerView.OnAdFullScreenContentClosed += () =>
    {
        Debug.Log("Banner view full screen content closed.");
    };
}

Menghancurkan tampilan banner

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

/// <summary>
/// Destroys the ad.
/// </summary>
public void DestroyAd()
{
    if (_bannerView != null)
    {
        Debug.Log("Destroying banner ad.");
        _bannerView.Destroy();
        _bannerView = null;
    }
}

Selesai. Aplikasi Anda kini siap menampilkan iklan banner dari AdMob.

Ukuran spanduk

Tabel di bawah mencantumkan ukuran banner standar.

Ukuran dalam dp (LxT)	Deskripsi	Ketersediaan	Konstanta AdSize
320x50	Spanduk Standar	Ponsel dan Tablet	`BANNER`
320x100	Banner Besar	Ponsel dan Tablet	`LARGE_BANNER`
300x250	Persegi Panjang IAB	Ponsel dan Tablet	`MEDIUM_RECTANGLE`
468x60	Banner Ukuran Penuh IAB	Tablet	`FULL_BANNER`
728x90	Papan Peringkat IAB	Tablet	`LEADERBOARD`
Lebar yang disediakan x Tinggi adaptif	Banner adaptif	Ponsel dan Tablet	T/A
Lebar layar x 32\|50\|90	Banner cerdas	Ponsel dan Tablet	`SMART_BANNER`
Pelajari Banner Adaptif lebih lanjut, yang dimaksudkan untuk menggantikan Smart Banner.