Vị trí đặt quảng cáo

Hướng dẫn này trình bày cách sử dụng tính năng Vị trí đặt quảng cáo của trình bổ trợ Google Mobile Ads cho Unity để tạo và hiển thị quảng cáo cho ứng dụng của bạn.

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

Khởi động Google Mobile Ads Unity Plugin

Trước khi tải quảng cáo, hãy khởi chạy Google Mobile Ads Unity Plugin bằng cách gọi MobileAds.Initialize(), kèm theo lệnh gọi lại Action<InitializationStatus>. Bạn chỉ cần thực hiện việc này một lần, tốt nhất là khi bắt đầu chạy ứng dụng.

using GoogleMobileAds.Api;
using System.Collections.Generic;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    ...
    public void Start()
    {
        // Initialize Google Mobile Ads Unity Plugin.
        MobileAds.Initialize((initStatus) =>
        {
            // SDK initialization is complete
        });
        ...
    }
}

Tạo vị trí đặt quảng cáo

Bước đầu tiên để hiển thị biểu ngữ bằng Google Mobile Ads là tạo và định cấu hình vị trí đặt quảng cáo. Bạn có thể chọn một vị trí đặt quảng cáo có định dạng Biểu ngữ, Quảng cáo xen kẽ hoặc Quảng cáo có tặng thưởng trong phần Assets > Google Mobile Ads > Ad Placements (Thành phần > Quảng cáo trên thiết bị di động của Google > Vị trí đặt quảng cáo) trong Trình chỉnh sửa Unity. Sau đó, 3 vị trí đặt quảng cáo minh hoạ sẽ được thiết lập và sẵn sàng để sử dụng.

Để thêm một Vị trí đặt quảng cáo mới, hãy nhấp vào nút Thêm vị trí mới ở cuối danh sách. Bạn có thể định cấu hình vị trí đặt quảng cáo trong chế độ xem Trình kiểm tra.

Cấu hình vị trí đặt quảng cáo

Mỗi vị trí đặt quảng cáo có các thuộc tính sau:

Tên Vị trí
Tên của vị trí. Dùng để xác định vị trí khi thiết lập quảng cáo trong một cảnh.
Định dạng quảng cáo
Quảng cáo biểu ngữ, quảng cáo có tặng thưởng, quảng cáo xen kẽ. Loại quảng cáo.
Mã đơn vị quảng cáo
Cung cấp mã đơn vị quảng cáo biểu ngữ cho Android và iOS. Bạn cần cung cấp ít nhất một mã đơn vị quảng cáo.
Duy trì trên các cảnh
Khi được đánh dấu, biểu ngữ sẽ vẫn xuất hiện trên màn hình bất kể thay đổi về cảnh (hành vi tương tự như DontDestroyOnLoad).
Đã bật tính năng tự động nạp tiền
Khi được đánh dấu, quảng cáo sẽ tự động được tải khi cảnh liên kết với vị trí đặt quảng cáo được tải.

Ảnh chụp màn hình sau đây cho thấy ví dụ về một Vị trí đặt quảng cáo có tên là Biểu ngữ tuyệt vời của tôi.

Thêm AdGameObject vào cảnh

Bạn có thể thêm AdGameObject cho các định dạng Biểu ngữ, Quảng cáo xen kẽ hoặc Quảng cáo có tặng thưởng vào cảnh của mình bằng cách sử dụng GameObject > Google Mobile Ads trong Trình chỉnh sửa Unity. Chọn định dạng để thêm vị trí vào cảnh đang hoạt động.

Sau khi thêm AdGameObject vào cảnh, bạn sẽ thấy một GameObject đại diện cho quảng cáo trong chế độ xem Hệ phân cấp của Trình chỉnh sửa Unity.

Bạn có thể thay đổi tên của vị trí bằng cách thay đổi tên của chính GameObject. Ảnh chụp màn hình sau đây cho thấy ví dụ về một AdGameObject có tên là Banner Ad (Quảng cáo biểu ngữ).

Chế độ cài đặt cho AdGameObject

Bạn có thể định cấu hình AdGameObject trong cảnh của mình từ chế độ xem Trình kiểm tra trong phần cài đặt cho thành phần Ad Game Object (Script) (Đối tượng trò chơi quảng cáo (Tập lệnh)).

Vị trí đặt Quảng cáo

Chọn vị trí đặt quảng cáo trong danh sách thả xuống gồm các vị trí đã định cấu hình. Danh sách này sẽ chỉ có các đơn vị quảng cáo cho định dạng phù hợp. Ví dụ: đối với đối tượng trò chơi quảng cáo biểu ngữ, trình đơn thả xuống sẽ chỉ hiển thị các vị trí đặt quảng cáo biểu ngữ đã định cấu hình.

Cấu hình BannerAdGameObject (chỉ biểu ngữ)

  • Kích thước – Chọn kích thước biểu ngữ mà bạn muốn sử dụng.
    • Biểu ngữ neo thích ứng cung cấp thêm một số lựa chọn:
      • Hướng – Chọn hướng thiết bị dùng để tính chiều cao quảng cáo.
      • Sử dụng chiều rộng toàn màn hình – Khi được đánh dấu, biểu ngữ sẽ chiếm toàn bộ chiều rộng màn hình. Bạn có thể điều chỉnh % chiều rộng của màn hình (50~99%) nếu bỏ đánh dấu lựa chọn Sử dụng chiều rộng toàn màn hình.
    • Tuỳ chỉnh cho phép bạn cung cấp chiều rộng và chiều cao của biểu ngữ.
  • Vị trí quảng cáo – Chọn vị trí mà bạn nên đặt biểu ngữ.

Lệnh gọi lại

Bạn có thể triển khai các hàm tương ứng với lệnh gọi lại quảng cáo. Ví dụ: nếu bạn muốn xử lý trường hợp không tải được quảng cáo biểu ngữ, hãy làm như sau:

  1. Tạo một hàm tương thích với lệnh gọi lại quảng cáo.

    public void OnBannerAdFailedToLoad(string reason) {
        Debug.Log("Banner ad failed to load: " + reason);
    }
    
  2. Đính kèm tập lệnh chứa hàm trên vào bất kỳ GameObject nào trong cảnh.

  3. Nhấp vào nút +, sau đó kéo và thả GameObject mà bạn đã đính kèm tập lệnh.

  4. Chọn hàm mà bạn muốn liên kết với lệnh gọi lại quảng cáo. Đối với lệnh gọi lại quảng cáo có tham số, hãy chọn hàm để chấp nhận biến động để bạn có thể lấy giá trị tham số từ SDK.

Sử dụng AdGameObject từ tập lệnh

Lấy thực thể AdGameObject từ tập lệnh

Tất cả đối tượng AdGameObject đều có phương thức tiện lợi LoadAd(). Thao tác này sẽ tải một quảng cáo có AdRequest đơn giản, không được nhắm mục tiêu. Để áp dụng tiêu chí nhắm mục tiêu, bạn nên sử dụng LoadAd(AdRequest adRequest) bằng cách sử dụng yêu cầu quảng cáo đã định cấu hình của riêng bạn.

Để lấy thực thể của một AdGameObject, hãy sử dụng phương thức sau cho mỗi định dạng:

MobileAds.Instance.GetAd<BannerAdGameObject>("AD_GAMEOBJECT_NAME");

Đối tượng BannerAdGameObject được trả về cũng có các phương thức tiện lợi Hide() và Show().

Quảng cáo xen kẽ

MobileAds.Instance.GetAd<InterstitialAdGameObject>("AD_GAMEOBJECT_NAME");

Đối tượng InterstitialAdGameObject được trả về có một phương thức tiện lợi là ShowIfLoaded().

Được thưởng

MobileAds.Instance.GetAd<RewardedAdGameObject>("AD_GAMEOBJECT_NAME");

Đối tượng RewardedAdGameObject được trả về có một phương thức tiện lợi là ShowIfLoaded().

Ví dụ: bạn có thể lấy một thực thể của BannerAdGameObject và tải thực thể đó như sau:

using UnityEngine;

using GoogleMobileAds.Api;
using GoogleMobileAds.Placement;

public class BannerTestScript : MonoBehaviour
{
    BannerAdGameObject bannerAd;

    void Start()
    {
        bannerAd = MobileAds.Instance
            .GetAd<BannerAdGameObject>("AD_GAMEOBJECT_NAME");

        bannerAd.LoadAd();
        ...
    }
    ...
}

Nếu có một BannerAdGameObject tên là BannerAd, bạn có thể lấy một thực thể của nó như sau:

MobileAds.Instance.GetAd<BannerAdGameObject>("BannerAd");

Truy cập vào đối tượng quảng cáo cơ bản trong AdGameObject

Các đoạn mã này minh hoạ cách truy cập vào đối tượng quảng cáo cơ bản được liên kết với AdGameObject.

BannerAdGameObject bannerAd = MobileAds.Instance
    .GetAd<BannerAdGameObject>("AD_GAMEOBJECT_NAME");

// Access BannerView object
BannerView bannerView = bannerAd.BannerView;

Quảng cáo xen kẽ

InterstitialAdGameObject interstitialAdGameObject = MobileAds.Instance
    .GetAd<InterstitialAdGameObject>("AD_GAMEOBJECT_NAME");

// Access InterstitialAd object
InterstitialAd interstitialAd = interstitialAdGameObject.InterstitialAd;

Được thưởng

RewardedAdGameObject rewardedAdGameObject = MobileAds.Instance
    .Get<RewardedAdGameObject>("AD_GAMEOBJECT_NAME");

// Access RewardedAd object
RewardedAd rewardedAd = rewardedAdGameObject.RewardedAd;

Ví dụ

Hiển thị quảng cáo xen kẽ

Dưới đây là ví dụ về cách định cấu hình trò chơi để tải và hiển thị quảng cáo xen kẽ bằng AdGameObject.

Thêm InterstitialAdGameObject vào cảnh và bật tính năng Bật tính năng tự động tải để quảng cáo tự động tải khi cảnh tải.

Tiếp theo, hãy đảm bảo bạn đã khởi chạy SDK như sau. Xin lưu ý rằng tính năng Tự động tải trong AdGameObject sẽ không hoạt động nếu bạn quên khởi chạy SDK.

Sau đó, hãy hiển thị quảng cáo xen kẽ giữa một quá trình chuyển đổi màn hình bằng cách gọi hàm InterstitialAdGameObject.ShowIfLoaded(). Đoạn mã sau đây cho thấy một ví dụ về cách hiển thị quảng cáo xen kẽ giữa quá trình chuyển đổi cảnh.

using UnityEngine;
using UnityEngine.SceneManagement;

using GoogleMobileAds.Api;
using GoogleMobileAds.Placement;

public class MainScene : MonoBehaviour
{
    InterstitialAdGameObject interstitialAd;

    void Start()
    {
        interstitialAd = MobileAds.Instance
            .GetAd<InterstitialAdGameObject>("interstitial");

        MobileAds.Initialize((initStatus) => {
            Debug.Log("Initialized MobileAds");
        });
    }

    public void OnClickShowGameSceneButton()
    {
        // Display an interstitial ad
        interstitialAd.ShowIfLoaded();

        // Load a scene named "GameScene"
        SceneManager.LoadScene("GameScene");
    }
}

Vì đã bật tính năng Tự động tải trong vị trí đặt quảng cáo, nên bạn không cần phải yêu cầu quảng cáo một cách rõ ràng. Khi cảnh thay đổi, quảng cáo xen kẽ sẽ xuất hiện nếu có sẵn.

Nếu bạn muốn yêu cầu quảng cáo theo cách thủ công, hãy tắt tính năng Tự động tải trong trình kiểm tra vị trí đặt quảng cáo rồi gọi hàm InterstitialAdGameObject.LoadAd(). Đoạn mã sau đây cho biết cách yêu cầu quảng cáo theo cách thủ công.

public class MainScene : MonoBehaviour
{
    InterstitialAdGameObject interstitialAd;

    void Start()
    {
        interstitialAd = MobileAds.Instance
            .GetAdGameObject<InterstitialAdGameObject>("interstitial");

        MobileAds.Initialize((initStatus) => {
            Debug.Log("MobileAds initialized");

            // Load an interstitial ad after the SDK initialization is complete
            interstitialAd.LoadAd();
        });
    }
    ...
}

Xử lý trạng thái nút "xem quảng cáo có tặng thưởng"

Sau đây là ví dụ về cách bật nút "xem quảng cáo có tặng thưởng" bằng cách sử dụng vị trí đặt quảng cáo.

Thêm một GameObject Nút (có tên là Button trong ví dụ này) vào cảnh. Nút này sẽ được dùng để hiển thị quảng cáo có tặng thưởng. Chúng tôi sẽ chỉ cung cấp nút này khi có quảng cáo có tặng thưởng.

Trong phương thức Start(), hãy thay đổi trạng thái hoạt động của Nút thành false. Thao tác này sẽ làm cho nút biến mất khỏi cảnh.

public class MainScene : MonoBehaviour
{
    ...
    void Start()
    {
        GameObject.Find("Button").SetActive(false);
        ...
    }
}

Thêm RewardedAdGameObject vào cảnh rồi chọn Vị trí đặt quảng cáo Quảng cáo có tặng thưởng minh hoạ của AdMob trong trình đơn thả xuống.

Trong mục Callbacks (Lệnh gọi lại) của trình kiểm tra RewardedAdGameObject, hãy nhấp vào nút + trong On Ad Loaded() (Khi quảng cáo được tải) để bật hàm được gọi khi quảng cáo có tặng thưởng được tải.

Kéo và thả GameObject của nút mà bạn đã thêm ở bước trước vào trường None (Object) (Không có (Đối tượng)). Chọn một hàm để gọi trong trình đơn thả xuống. Nhấp vào No Function > GameObject > SetActive(bool), rồi đánh dấu vào hộp để gửi true dưới dạng một thông số (gọi SetActive(true)).

Trong phần Lệnh gọi lại này, bạn cũng có thể liên kết một sự kiện sẽ được gọi khi sự kiện RewardedAd.OnUserEarnedReward được kích hoạt. Để biết thêm thông tin, hãy tham khảo phần này.

Tiếp theo, hãy tạo nút để hiển thị quảng cáo có tặng thưởng khi người dùng nhấp vào. Trong phần On Click() Callbacks (Lệnh gọi lại khi nhấp chuột) trong trình kiểm tra nút, hãy nhấp vào nút + rồi kéo và thả GameObject của Vị trí đặt quảng cáo có tặng thưởng (có tên là Rewarded Ad (Quảng cáo có tặng thưởng) trong ví dụ này) vào trường None (Object) (Không có (Đối tượng)).

Sau đó, đính kèm hàm RewardedAdGameObject.ShowIfLoaded() vào lệnh gọi lại On Click() của nút.

Cuối cùng, đừng quên khởi chạy SDK. Đoạn mã sau đây là mã hoàn chỉnh cho cảnh được dùng trong ví dụ này:

using UnityEngine;

using GoogleMobileAds.Api;

public class MainScene : MonoBehaviour
{
    void Start()
    {
        GameObject.Find("Button").SetActive(false);

        MobileAds.Initialize((initStatus) => {
            Debug.Log("Initialized MobileAds");
        });
    }
}

Sau khi chạy dự án, bạn sẽ thấy nút hiển thị trên cảnh khi quảng cáo có tặng thưởng được tải và sẵn sàng hiển thị.

Định cấu hình lệnh gọi lại dành cho quảng cáo có tặng thưởng cho RewardedAdGameObject

Dưới đây là ví dụ về cách định cấu hình lệnh gọi lại có tặng thưởng cho một vị trí đặt quảng cáo có tặng thưởng, nhờ đó, bạn có thể tặng thưởng cho người dùng khi một hàm callback được gọi.

Tạo một tập lệnh mới và xác định một hàm chấp nhận Reward làm tham số như sau.

using UnityEngine;
using GoogleMobileAds.Api;

class RewardedTestScript : MonoBehaviour {
    ...
    public void OnUserEarnedReward(Reward reward) {
        Debug.Log("OnUserEarnedReward: reward=" +
            reward.Type + ", amount=" + reward.Amount);
    }
    ...
}

Đính kèm tập lệnh RewardedTestScript vào bất kỳ GameObject nào (ngoại trừ GameObject Vị trí đặt quảng cáo) trong cảnh. Trong ví dụ này, tập lệnh được đính kèm vào GameObject của Camera chính.

Thêm RewardedAdGameObject vào cảnh. Sau đó, trong phần Lệnh gọi lại trong trình kiểm tra RewardedAdGameObject, hãy nhấp vào nút + trên On User Earned Reward (Reward) (Phần thưởng mà người dùng nhận được) để bật hàm được gọi khi người dùng được tặng phần thưởng.

Kéo và thả GameObject của Camera chính mà bạn đã thêm ở bước trước vào trường None (Object) (Không có (Đối tượng)). Chọn một hàm để gọi từ trình đơn thả xuống. Nhấp vào No Function > RewardedTestScript > OnUserEarnedReward (Không có hàm > RewardedTestScript > OnUserEarnedReward).

Sau khi bạn chạy dự án và xem quảng cáo có tặng thưởng, RewardedTestScript.OnUserEarnedReward() sẽ được gọi khi bạn được thưởng vì đã tương tác với quảng cáo.