Banner

Banners are small visual ads that appear inside your application covering a small portion of the screen. The ad is not closed by the user, but is instead dismissed programmatically.

Only one banner can be displayed at a time.

As of v5.7.2 will handle the refresh interval itself. Please make sure that the refresh interval in the ad network dashboard is disabled, otherwise you may experience unexpected behaviour

1. Load

There are two ways to load banners, with a type or a custom size. One banner per placement tag may be loaded/displayed. Make sure you add the Tapdaq namespace to the top of your script:

using Tapdaq;

Load With Type

The banner needs to be loaded for a specific size. You can see a full list of TDMBannerSizes here.

AdManager.RequestBanner(TDMBannerSize.TDMBannerStandard, "<INSERT_PLACEMENT_TAG>");

Load With Custom Size

Using a custom size, pass the width & height as parameters, the best fit banner type will be selected from the networks available.

AdManager.RequestBanner(320, 50, "<INSERT_PLACEMENT_TAG>");

The earliest any ad can be loaded is when TapdaqConfigLoaded callback occurs

2. Display

There are two methods to displaying banners as detailed below, in both instances it is highly advisable to check if the banner isReady before calling show. The AdAvailable callback could also be used as an event to display a banner when it has become ready.

Display at fixed position

private void OnAdAvailable (TDAdEvent e) {
	if (e.IsBannerEvent()) {
		if (AdManager.IsBannerReady("<INSERT_PLACEMENT_TAG>")) {
			AdManager.ShowBanner(TDBannerPosition.Bottom, "<INSERT_PLACEMENT_TAG>");
		}
	}
}

Display at custom position

private void OnAdAvailable (TDAdEvent e) {
	if (e.IsBannerEvent()) {
		if (AdManager.IsBannerReady("<INSERT_PLACEMENT_TAG>")) {
			AdManager.ShowBanner(20, 300, "<INSERT_PLACEMENT_TAG>");
		}
	}
}

3. Hide

Hiding a banner will changes is visibility, calling Show will then display the banner again. Banners will not refresh whilst they're not visible or the app is in the background. To hide the banner from the screen at any time, use the following statement:

AdManager.HideBanner("<INSERT_PLACEMENT_TAG>"); //Placement Tag is optional. "default" will be used if none provided

Export your application to iOS and Android, then run your application to test the ad displays correctly.

4. Destroy

To completely remove the banner, call DestroyBanner. To display the banner again after this, RequestBanner must be called

AdManager.DestroyBanner("<INSERT_PLACEMENT_TAG>"); //Placement Tag is optional. "default" will be used if none provided

Placement Tags

As of v7.5.0, Banners support placement tags, multiple banners can now be loaded & displayed at once - one per placement tag. All methods (Load, Show, Hide, Destroy) accept an optional placement tag, if none is provided then default will be used.

Refreshing

Banners will refresh after they have been displayed for a set interval time (30seconds), when they are not visible or the app is closed, this timer is paused and will continue when the banner becomes visible. The callback OnAdRefresh will be called when a banner has successfully refreshed, OnAdFailedToRefresh will be called if it fails - another refresh event will occur in the next interval.

See the [Callbacks] page for details on implementing callbacks.

Banner sizes

TDMBanner sizes

Banner Size AdColony AppLovin Facebook Audience Network Google Ad Mob InMobi Mintegral UnityAds
TDMBannerStandard 320x50 320x50 320x50 320x50 320x50 320x50 320x50
TDMBannerLarge N/A N/A 320x90 320x100 N/A 320x90 N/A
TDMBannerMedium 300x50 300x250 320x250 300x250 300x250 300x250 N/A
TDMBannerFull N/A N/A N/A 468x60 N/A N/A 468x60
TDMBannerLeaderboard 728x90 N/A N/A 728x90 N/A 728x90 728x90
TDMBannerSmart N/A N/A Various x 50 Various x 50 N/A N/A N/A

Need help?

If you are having any problems integrating, feel free to contact us on [email protected] and we will be more than happy to help.

What's next?

Now that you have successfully integrated a banner into your app, what would you like to do next?