Banner Ads

Banner ad units display rectangular ads that occupy a portion of an app's layout. They can refresh automatically after a set period. This means users will view a new ad regularly, even if they stay on the same screen in your app. They're also the simplest ad format to implement.

Benefits of Banner Ads

• Banner Ads are among the oldest advertisements and can make instant impressions at a relatively low cost.
• Banner Ads offer a quick, easy, and cost-effective way to generate immediate interest.
• Banner Ads can pique viewers' curiosity and help retain them by promoting brand awareness.

Supported size

SIZE	DESCRIPTION	AVAILABILITY	ADSIZE CONSTANT
320×50	Standard Banner	Phones and Tablets	Banner
320×100	Large Banner	Phones and Tablets	LargeBanner
300×250	IAB Medium Rectangle	Phones and Tablets	IABMediumRectangle
Full-screen width x Adaptive height	Adaptive banner	Phones and Tablets	AdaptiveBanner
Screen width x 32/50/90	Smart banner	Phones and Tablets	SmartBanner

caution

You should finish these steps before releasing.

• Configure the SDK
• Setup Legal Frameworks
• Setup App-Ads.txt

Load and Display the ad

You can show the ad using this code, but we recommend using the ad events as you’ll be able to show the ad once it’s loaded. You can check the full script provided below.

Unity

Yodo1U3dBannerAdView bannerAdView = new Yodo1U3dBannerAdView(Yodo1U3dBannerAdSize.Banner, Yodo1U3dBannerAdPosition.BannerBottom | Yodo1U3dBannerAdPosition.BannerHorizontalCenter);
bannerAdView.LoadAd();
bannerAdView.Show();

Java

// xml
<com.yodo1.mas.banner.Yodo1MasBannerAdView
  android:id="@+id/banner"
  android:layout_width="320dp"
  android:layout_height="50dp"
  masads:adSize="Banner" />

Yodo1MasBannerAdView bannerAdView = findViewById(R.id.banner);
bannerAdView.loadAd();

// code
Yodo1MasBannerAdView bannerAdView = new Yodo1MasBannerAdView(this);
bannerAdView.setAdSize(Yodo1MasBannerAdSize.Banner);
layout.addView(bannerAdView, new LayoutParams(320, 50));
bannerAdView.loadAd();

Kotlin

// xml
<com.yodo1.mas.banner.Yodo1MasBannerAdView
  android:id="@+id/banner"
  android:layout_width="320dp"
  android:layout_height="50dp"
  masads:adSize="Banner" />

val bannerAdView: Yodo1MasBannerAdView = findViewById(R.id.banner)
bannerAdView.loadAd()

// code
val bannerAdView = Yodo1MasBannerAdView(this)
bannerAdView.setAdSize(Yodo1MasBannerAdSize.Banner)
layout.addView(bannerAdView, LayoutParams(320, 50))
bannerAdView.loadAd()

Swift

Yodo1MasBannerAdView

// xib
// Drag a View onto your XIB file and set the Custom Class to Yodo1MasBannerAdView
@IBOutlet weak var bannerAdView: Yodo1MasBannerAdView!
bannerAdView.loadAd()

// code
let bannerAdView = Yodo1MasBannerAdView(frame: CGRect(x: 0, y: 0, width: 320, height: 50))
self.view.addSubview(bannerAdView)
bannerAdView.loadAd()

Objective-C

Yodo1MasBannerAdView

// xib
// Drag a View onto your XIB file and set the Custom Class to Yodo1MasBannerAdView
@property (weak, nonatomic) IBOutlet Yodo1MasBannerAdView *bannerAdView;
[_bannerAdView loadAd];

// code
Yodo1MasBannerAdView *bannerAdView = [[Yodo1MasBannerAdView alloc] initWithFrame:CGRectMake(0, 0, 320, 50)];
[self.view addSubview:bannerAdView];
[bannerAdView loadAd];

Godot

yodo1mas.load_banner_ad("Banner","RIGHT","TOP")

Flutter

Yodo1MASBannerAd(
size: BannerSize.Banner,
)

Cocos2d

Yodo1Ads.getInstance().loadBannerAds("Banner","RIGHT","TOP");
Yodo1Ads.getInstance().showBannerAds();

Configure the ad events

The MAS SDK fires several events to inform you of ad availability.

Unity

using Yodo1.MAS;

public class BannerAdLoader : MonoBehaviour
{
    Yodo1U3dBannerAdView bannerAdView = null;
    private void Start()
    {
        bannerAdView = new Yodo1U3dBannerAdView(Yodo1U3dBannerAdSize.Banner, Yodo1U3dBannerAdPosition.BannerBottom | Yodo1U3dBannerAdPosition.BannerHorizontalCenter);
        SetupEventCallbacks();
        LoadBannerAd();
    }

    private void SetupEventCallbacks()
    {
        bannerAdView.OnAdLoadedEvent += OnBannerAdLoadedEvent;
        bannerAdView.OnAdFailedToLoadEvent += OnBannerAdLoadFailedEvent;
        bannerAdView.OnAdOpenedEvent += OnBannerAdOpenedEvent;
        bannerAdView.OnAdFailedToOpenEvent += OnBannerAdOpenFailedEvent;
        bannerAdView.OnAdClosedEvent += OnBannerAdClosedEvent;
    }

    private void LoadBannerAd()
    {
        bannerAdView.SetAdPlacement("Your placement id");
        bannerAdView.LoadAd();
    }

    private void OnBannerAdLoadedEvent(Yodo1U3dBannerAdView ad)
    {
        // Code to be executed when an ad finishes loading.
    }

    private void OnBannerAdLoadFailedEvent(Yodo1U3dBannerAdView ad, Yodo1U3dAdError adError)
    {
        // Code to be executed when an ad request fails.
    }

    private void OnBannerAdOpenedEvent(Yodo1U3dBannerAdView ad)
    {
        // Code to be executed when an ad opened
    }

    private void OnBannerAdOpenFailedEvent(Yodo1U3dBannerAdView ad, Yodo1U3dAdError adError)
    {
        // Code to be executed when an ad open fails.
    }

    private void OnBannerAdClosedEvent(Yodo1U3dBannerAdView ad)
    {
        // Code to be executed when the ad closed
    }
}

Java

public class BannerActivity extends Activity implements Yodo1MasBannerAdListener {

    private Yodo1MasBannerAdView bannerAdView;

    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_banner);
        bannerAdView = this.findViewById(R.id.banner);
        bannerAdView.setAdListener(this);
        bannerAdView.loadAd();
    }

    public void onBannerAdLoaded(Yodo1MasBannerAdView bannerAdView) {
        // Code to be executed when an ad finishes loading.
    }

    @Override
    public void onBannerAdFailedToLoad(Yodo1MasBannerAdView bannerAdView, @NonNull Yodo1MasError error) {
        // Code to be executed when an ad request fails.
    }

    @Override
    public void onBannerAdOpened(Yodo1MasBannerAdView bannerAdView) {
        // Code to be executed when an ad opened
    }

    @Override
    public void onBannerAdFailedToOpen(Yodo1MasBannerAdView bannerAdView, @NonNull Yodo1MasError error) {
        // Code to be executed when an ad open fails.
    }

    @Override
    public void onBannerAdClosed(Yodo1MasBannerAdView bannerAdView) {
        // Code to be executed when the ad closed
    }
}

Kotlin

class BannerActivity: Activity(), Yodo1MasBannerAdListener {

    private lateinit var bannerAdView: Yodo1MasBannerAdView

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_banner)
        bannerAdView = this.findViewById(R.id.banner)
        bannerAdView.setAdListener(this)
        bannerAdView.loadAd()
    }

    override fun onBannerAdLoaded(bannerAdView: Yodo1MasBannerAdView) {
        // Code to be executed when an ad finishes loading.
    }

    override fun onBannerAdFailedToLoad(bannerAdView: Yodo1MasBannerAdView, error: Yodo1MasError) {
        // Code to be executed when an ad request fails.
    }

    override fun onBannerAdOpened(bannerAdView: Yodo1MasBannerAdView) {
        // Code to be executed when an ad opened
    }

    override fun onBannerAdFailedToOpen(bannerAdView: Yodo1MasBannerAdView, error: Yodo1MasError) {
        // Code to be executed when an ad open fails.
    }

    override fun onBannerAdClosed(bannerAdView: Yodo1MasBannerAdView) {
        // Code executed when getting rewards
    }
}

Swift

class BannerController: UIViewController {
    @IBOutlet weak var bannerAd: Yodo1MasBannerAdView!

    override func viewDidLoad() {
        super.viewDidLoad()
        // Show ad with placement name, like app_start, level_end
        bannerAd.setAdPlacement("Your placement id")
        bannerAd.adDelegate = self
        bannerAd.loadAd()
    }
}

extension BannerController: Yodo1MasBannerAdViewDelegate {
    func onBannerAdLoaded(_ adView: Yodo1MasBannerAdView) {
        // Code to be executed when an ad finishes loading.
    }
    
    func onBannerAdFailed(toLoad adView: Yodo1MasBannerAdView, withError error: Yodo1MasError) {
        // Code to be executed when an ad request fails.
    }

    func onBannerAdOpened(_ adView: Yodo1MasBannerAdView) {
        // Code to be executed when an ad opened
    }
    
    func onBannerAdFailed(toOpen adView: Yodo1MasBannerAdView, withError error: Yodo1MasError) {
        // Code to be executed when an ad open fails.
    }
    
    func onBannerAdClosed(_ adView: Yodo1MasBannerAdView) {
        // Code executed when getting rewards
    }
}

Objective-C

@interface BannerViewController ()<Yodo1MasBannerAdViewDelegate>

@property (weak, nonatomic) IBOutlet Yodo1MasBannerAdView *bannerAdView

@end

@implementation BannerViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    _bannerAdView.adDelegate = self;
    // Show ad with placement name, like app_start, level_end
    [_bannerAdView setAdPlacement:@"Your placement id"];
    [_bannerAdView setAdSize:Yodo1MasBannerAdSizeBanner];
    [_bannerAdView loadAd];
}

#pragma mark - Yodo1MasBannerAdViewDelegate
- (void)onBannerAdLoaded:(Yodo1MasBannerAdView *)adView {
    // Code to be executed when an ad finishes loading.
}

- (void)onBannerAdFailedToLoad:(Yodo1MasBannerAdView *)adView withError:(Yodo1MasError *)error {
    // Code to be executed when an ad request fails.
}

- (void)onBannerAdOpened:(Yodo1MasBannerAdView *)adView {
    // Code to be executed when an ad opened
}

- (void)onBannerAdFailedToOpen:(Yodo1MasBannerAdView *)adView withError:(Yodo1MasError *)error {
    // Code to be executed when an ad open fails.
}

- (void)onBannerAdClosed:(Yodo1MasBannerAdView *)adView {
    // Code to be executed when the ad closed
}

@end

Godot

func _on_Yodo1Mas_banner_ad_loaded():
func _on_Yodo1Mas_banner_failed_ad_loaded():
func _on_Yodo1Mas_banner_ad_opened():
func _on_Yodo1Mas_banner_ad_failed_opened():
func _on_Yodo1Mas_banner_ad_closed():

Flutter

Yodo1MASBannerAd(
 size: BannerSize.Banner,
 onLoad: () => print('Banner loaded:'),
 onOpen: () => print('Banner clicked:'),
 onClosed: () => print('Banner clicked:'),
 onLoadFailed: (message) =>
     print('Banner Ad $message'),
 onOpenFailed: (message) =>
     print('Banner Ad $message'),
),

Video Tutorial