Quảng cáo biểu ngữ

Khung hiển thị biểu ngữ là quảng cáo dạng văn bản hoặc quảng cáo dạng hình ảnh hình chữ nhật xuất hiện trên một phần của màn hình. Những quảng cáo này lưu lại trên màn hình trong khi người dùng tương tác với ứng dụng và có thể tự động làm mới sau một khoảng thời gian nhất định. Nếu bạn mới sử dụng quảng cáo trên thiết bị di động, thì đây là loại quảng cáo rất phù hợp để bắt đầu. Nghiên cứu điển hình.

Tài liệu hướng dẫn này trình bày cách tích hợp thành phần hiển thị biểu ngữ vào ứng dụng Unity. Ngoài các đoạn mã và thông tin hướng dẫn, bài viết này còn cung cấp thông tin về cách xác định kích thước biểu ngữ cho phù hợp và đường liên kết đến các tài nguyên khác.

Điều kiện tiên quyết

• Xem hết hướng dẫn Bắt đầu sử dụng.

Luôn thử nghiệm bằng quảng cáo thử nghiệm

Mã mẫu sau đây chứa một mã đơn vị quảng cáo mà bạn có thể dùng để yêu cầu hiển thị quảng cáo thử nghiệm. Mã này được định cấu hình đặc biệt để trả về quảng cáo thử nghiệm thay vì quảng cáo thực tế cho mọi yêu cầu, vì vậy, mã này rất an toàn để sử dụng.

Tuy nhiên, sau khi bạn đăng ký một ứng dụng trong giao diện web AdMob và tạo mã đơn vị quảng cáo của riêng mình để sử dụng trong ứng dụng, hãy định cấu hình thiết bị của bạn làm thiết bị thử nghiệm một cách rõ ràng trong quá trình phát triển.

Chạy SDK quảng cáo trên thiết bị di động

Trước khi tải quảng cáo, hãy để ứng dụng của bạn khởi chạy SDK quảng cáo trên thiết bị di động bằng cách gọi MobileAds.Initialize(). Bạn chỉ cần thực hiện việc này một lần, tốt nhất là khi khởi chạy ứng dụng.

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.
        });
    }
}

Nếu bạn đang sử dụng tính năng dàn xếp, hãy đợi cho đến khi lệnh gọi lại xảy ra trước khi tải quảng cáo, vì điều này sẽ đảm bảo rằng tất cả các bộ chuyển đổi dàn xếp đều khởi động.

Ví dụ về BannerView

Mã mẫu bên dưới nêu chi tiết cách sử dụng chế độ xem biểu ngữ. Trong ví dụ này, bạn tạo một phiên bản của chế độ xem biểu ngữ, sử dụng AdRequest để tải quảng cáo vào chế độ xem biểu ngữ, sau đó mở rộng khả năng của quảng cáo bằng cách xử lý các sự kiện trong vòng đời.

Tạo chế độ xem biểu ngữ

Bước đầu tiên để sử dụng chế độ xem biểu ngữ là tạo một bản sao cho chế độ xem biểu ngữ trong tập lệnh C# được đính kèm vào 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 view 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);
  }

Hàm khởi tạo cho BannerView có các thông số sau:

• adUnitId: Mã đơn vị quảng cáo mà từ đó BannerView sẽ tải quảng cáo.
• AdSize: Kích thước quảng cáo mà bạn muốn sử dụng. Hãy tham khảo phần Kích thước biểu ngữ để biết thông tin chi tiết.
• AdPosition: Vị trí mà bạn nên đặt thành phần hiển thị biểu ngữ. AdPosition enum liệt kê các giá trị vị trí quảng cáo hợp lệ.

Hãy lưu ý cách sử dụng các đơn vị quảng cáo khác nhau, tuỳ thuộc vào nền tảng. Bạn cần sử dụng đơn vị quảng cáo dành cho iOS để tạo các yêu cầu quảng cáo trên iOS và sử dụng đơn vị quảng cáo dành cho Android để đưa ra yêu cầu trên Android.

(Không bắt buộc) Tạo chế độ xem biểu ngữ có vị trí tuỳ chỉnh

Để kiểm soát tốt hơn vị trí đặt BannerView trên màn hình so với khả năng kiểm soát do giá trị AdPosition cung cấp, hãy sử dụng hàm khởi tạo có toạ độ x và y làm tham số:

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

Góc trên cùng bên trái của BannerView được định vị theo các giá trị x và y được truyền đến hàm khởi tạo, còn gốc toạ độ sẽ nằm ở phía trên cùng bên trái của màn hình.

(Không bắt buộc) Tạo chế độ xem biểu ngữ có kích thước tuỳ chỉnh

Ngoài việc sử dụng hằng số AdSize, bạn cũng có thể chỉ định một kích thước tuỳ chỉnh cho quảng cáo của mình:

// 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);

Tải quảng cáo biểu ngữ

Để tải quảng cáo, hãy tạo một AdRequest và truyền quảng cáo đó vào phương thức 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();

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

Theo dõi các sự kiện về lượt xem biểu ngữ

Để tuỳ chỉnh hoạt động của quảng cáo, bạn có thể dựa vào một số sự kiện trong vòng đời của quảng cáo, chẳng hạn như tải, mở hoặc đóng. Để theo dõi các sự kiện này, hãy đăng ký một thực thể đại diện:

/// <summary>
/// listen to events the banner view 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.");
    };
}

Huỷ chế độ xem biểu ngữ

Khi sử dụng xong chế độ xem biểu ngữ, hãy nhớ gọi Destroy() để giải phóng tài nguyên.

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

Vậy là xong! Bây giờ, ứng dụng của bạn đã sẵn sàng hiển thị quảng cáo biểu ngữ.

Kích thước biểu ngữ

Bảng bên dưới liệt kê các kích thước biểu ngữ chuẩn.

Tài nguyên khác

• Ví dụ về HelloWorld: Cách triển khai tối giản cho tất cả định dạng quảng cáo.

• Trường hợp sử dụng mẫu