Banners
1. Create an Ad View
The first step toward displaying a banner is to create a Yodo1U3dBannerAdView object in a C# script attached to a GameObject.
private Yodo1U3dBannerAdView bannerAdView;
public void Start()
{
this.RequestBanner();
}
private void RequestBanner()
{
// Clean up banner before reusing
if (bannerAdView != null)
{
bannerAdView.Destroy();
}
// Create a 320x50 banner at top of the screen
bannerAdView = new Yodo1U3dBannerAdView(Yodo1U3dBannerAdSize.Banner, Yodo1U3dBannerAdPosition.BannerTop | Yodo1U3dBannerAdPosition.BannerHorizontalCenter);
}
The constructor for a Yodo1U3dBannerAdView
has the following parameters:
Yodo1U3dBannerAdSize
– The MAS ad size you’d like to use.
Note: Existing customers who want to use a banner other than 320×50, please contact your CSM.
Size in dp | Description | Availability | AdSize Constant |
---|---|---|---|
320×50 | 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 |
Yodo1U3dBannerAdPosition
– The position where the banner ad should be placed. TheYodo1U3dBannerAdPosition
enum lists the valid ad position values.
2. Customize the position
For greater control over where a Yodo1U3dBannerAdView
is placed on screen than what’s offered by Yodo1U3dBannerAdPosition
values, use the Yodo1U3dBannerAdView
constructor that has x- and y-coordinates as parameters:
// Create a 320x50 banner ad at coordinate (0,50) on screen.
bannerAdView = new Yodo1U3dBannerAdView(Yodo1U3dBannerAdSize.Banner, 0, 50);
The top-left corner of the Yodo1U3dBannerAdView
will be positioned at the x and y values passed to the constructor, where the origin is the top-left of the screen.
3. Load an ad
Once the BannerView is instantiated, the next step is to load an ad. That’s done with the loadAd() method in the BannerView class.
Here’s an example that shows how to load an ad:
private void RequestBanner()
{
// Clean up banner before reusing
if (bannerAdView != null)
{
bannerAdView.Destroy();
}
// Create a 320x50 banner at top of the screen
bannerAdView = new Yodo1U3dBannerAdView(Yodo1U3dBannerAdSize.Banner, Yodo1U3dBannerAdPosition.BannerTop | Yodo1U3dBannerAdPosition.BannerHorizontalCenter);
// Load banner ads, the banner ad will be displayed automatically after loaded
bannerAdView.LoadAd();
}
That’s it! Your app is now ready to display banner ads from MAS.
4. Configure the ad events
To further customize the behavior of your ad, you can hook into a number of events in the ad’s lifecycle: loading, opening, closing, and so on.
private Yodo1U3dBannerAdView bannerAdView;
public void Start()
{
this.RequestBanner();
}
private void RequestBanner()
{
// Clean up banner before reusing
if (bannerAdView != null)
{
bannerAdView.Destroy();
}
// Create a 320x50 banner at top of the screen
bannerAdView = new Yodo1U3dBannerAdView(Yodo1U3dBannerAdSize.Banner, Yodo1U3dBannerAdPosition.BannerTop | Yodo1U3dBannerAdPosition.BannerHorizontalCenter);
// Ad Events
bannerAdView.OnAdLoadedEvent += OnBannerAdLoadedEvent;
bannerAdView.OnAdFailedToLoadEvent += OnBannerAdFailedToLoadEvent;
bannerAdView.OnAdOpenedEvent += OnBannerAdOpenedEvent;
bannerAdView.OnAdFailedToOpenEvent += OnBannerAdFailedToOpenEvent;
bannerAdView.OnAdClosedEvent += OnBannerAdClosedEvent;
// Load banner ads, the banner ad will be displayed automatically after loaded
bannerAdView.LoadAd();
}
private void OnBannerAdLoadedEvent(Yodo1U3dBannerAdView adView)
{
// Banner ad is ready to be shown.
Debug.Log("[Yodo1 Mas] OnBannerAdLoadedEvent event received");
}
private void OnBannerAdFailedToLoadEvent(Yodo1U3dBannerAdView adView, Yodo1U3dAdError adError)
{
Debug.Log("[Yodo1 Mas] OnBannerAdFailedToLoadEvent event received with error: " + adError.ToString());
}
private void OnBannerAdOpenedEvent(Yodo1U3dBannerAdView adView)
{
Debug.Log("[Yodo1 Mas] OnBannerAdOpenedEvent event received");
}
private void OnBannerAdFailedToOpenEvent(Yodo1U3dBannerAdView adView, Yodo1U3dAdError adError)
{
Debug.Log("[Yodo1 Mas] OnBannerAdFailedToOpenEvent event received with error: " + adError.ToString());
}
private void OnBannerAdClosedEvent(Yodo1U3dBannerAdView adView)
{
Debug.Log("[Yodo1 Mas] OnBannerAdClosedEvent event received");
}
5. Clean up banner ads
When you are finished with a BannerView, make sure to call the Destroy() method before dropping your reference to it:
bannerAdView.Destroy();
bannerAdView = null;
6. Hide and Show Banner
You can use the following methods to hide and show the banner.
bannerAdView.Hide();
bannerAdView.Show();
7. Create an ad placement (optional)
You can use the ad placements to analyze the performance of your ads or run an A/B test to help you optimize your monetization strategy.
Simply add the placement name when you show the ad.
bannerAdView.SetAdPlacement("Placement_Name")