Banner

Là 1 plugin dùng để quy chuẩn cách thức Load, Show, Hide Admob banner

1. Điều kiện bắt buộc

• Trong Project phải có GoogleMobileAds: Xem hướng dẫn tại đây

• Cần có MobileAds.RaiseAdEventsOnUnityMainThread = true; trước khi gọi MobileAds.Initialize(initStatus). Gọi lúc khi bắt đầu ứng dụng

• Cần thực hiện MobileAds.Initialize(initStatus) để khởi tạo MobileAds. Gọi lúc khi bắt đầu ứng dụng

• Lưu ý: Banner không che content là được.

2. Download Plugin

• Download: AdmobBanner_Collapsible_v0.0.0.1.unitypackage

3. Quick Start

3.1 Sử dụng Prefab AdmobBanner

• Vào Assets => CSCMobiPlugin => AdmobMediation => Banner => Prefabs => AdmobBanner

• Kéo AdmobBanner vào Scene đầu game. Thường là các Scene Splash

• Thiết lập các thông tin ở Inspector:

  • Auto Load: là cờ bật tắt chế độ tự load banner khi Script bắt đầu start.

    • Nếu không bật chế độ này thì game phải chủ động gọi: AdmobBanner.Instance.LoadAd()

  • AdPosition: Là vị trí hiển thị banner

    • Top: Là trên cùng màn hình

      • Bottom: Là vị trí dưới cùng màn hình

  • Ad Unit Id: là Id của Banner có dạng: ca-app-pub-xxxxxxxxxxxxxxxx/yyyyyyyyyy

• Mặc định ban đầu Banner sẽ bị ẩn khi start. Do đó muốn show lên thì cần gọi: AdmobBanner.nstance.ShowAd()

3.2 Các method

• LoadAd(): Dùng để request mới 1 quảng cáo

• HideAd(): Dùng để ẩn Banner

• ShowAd(): Dùng để hiển thị Banner

• Remove(): Dùng để Remove quảng cáo , thường dùng trong trường hợp user mua IAP để remove quảng cáo. Nếu user thuộc diện được remove quảng cáo thì cần call Remove ngay sau khi load dữ liệu của game. Sau khi call Remove thì sẽ không thể LoadAd, HideAd, ShowAd.

• Restore(): Dùng để cho restore quảng cáo sau khi bị Remove.

Code mẫu:

AdmobBanner.Instance.LoadAd();

AdmobBanner.Instance.HideAd();

AdmobBanner.Instance.ShowAd();

AdmobBanner.Instance.Remove();

AdmobBanner.Instance.Restore();

3.3 Các sự kiện lắng nghe

AdmobBanner.Instance.onBannerAdLoaded = () =>
{
    //Quảng cáo đã được tải về thành công
    SetMessage("onBannerAdLoaded");
};

AdmobBanner.Instance.onBannerAdLoadFailed = (error) =>
{
    //Lỗi không tải được quảng cáo
    SetMessage($"onBannerAdLoadFailed: {error.GetMessage()}");
};

AdmobBanner.Instance.onAdPaid = (adValue) =>
{
    //Quảng cáo được tính tiền
    //Dùng để LogImpression lên GSM, Firebase, Adjust
    SetMessage("onAdPaid");
};

AdmobBanner.Instance.onAdImpressionRecorded = () =>
{
    //Quảng cáo được tính 1 lượt Impression
    SetMessage("onAdImpressionRecorded");
};


AdmobBanner.Instance.onAdRemoved = () =>
{
    //Khi method Remove() được gọi
    SetMessage("onAdRemoved");
};

4. Customize

• Bạn có thể tùy biến kế thừa abstract class BaseBanner để thực hiện logic riêng

Code mẫu:

using CSCMobiPlugin.AdmobMediation;
using GoogleMobileAds.Api;
using UnityEngine;

public class BannerDemo : BaseBanner
{
    [SerializeField] private AdPosition adposition = AdPosition.Bottom;
    [SerializeField] private string adUnitId;
    static BannerDemo _instance;
    public static BannerDemo Instance => _instance;
    protected virtual void Awake()
    {
        if (_instance != null)
        {
            //there is already an instance:
            Destroy(gameObject);
            return;
        }
        DontDestroyOnLoad(gameObject);

        _instance = this;
    }
    public override AdPosition GetAdPosition()
    {
        return adposition;
    }

    public override string GetAdUnitId()
    {
        //Trả về AdUnitId của collapsiblebanner
        return adUnitId;
    }

    protected override void OnAdPaid(AdValue adValue)
    {
        // thực hiện LogImpression lên GSM, Firebase, Adjust ...
    }
}

4.2 Các method

• Tương tự phần 3.2 Các method

4.3 Các sự kiện lắng nghe

• Tương tự 3.3 Các sự kiện lắng nghe

5. Sample

• Bạn có thể xem ví dụ trong: Assets => CSCMobiPlugin => AdmobMediation => Banner => Samples