文档

​
​

Development

User Acquisition

Monetization

工业

Unity Ads Monetization

SDK 4.20.0

受支持
​

Android API reference

Unity Ads Monetization

SDK 4.20.0

受支持
​

此页面不支持所选语言。
Android developer guides
​
​
Android developer guides
  • Android SDK integration guide
  • Unity Ads privacy guide
  • Unity Ads SDK troubleshooting guide
  • Android developer API references
  1. Unity Ads SDK Android developer monetization
  2. Unity Ads SDK integration guide for Android developers

Implement banner ads in Android

Implement banner ads in your Android app. Create banner view objects, display them in your layout, and use a listener to manage ad events.
阅读时间2 分钟
最后更新于 1 个月前

Banner ads require a specific type of dedicated banner placement.
You can place the banner view object into your view hierarchy, just like you would any other view. This allows you to customize the position of each banner instance, or display multiple banners.
注意
app-ads.txt is an IAB initiative to combat fraud and create transparency in the advertising ecosystem. Ensure that you set up the app-ads.txt file as described. Otherwise, banner demand might be significantly decreased.

Script implementation

The following script sample is an example implementation for displaying two banner ads on the screen, and buttons for testing them.
This example uses a single listener for multiple banner view objects. You can also have a different listener for each banner view object.

Implementing the MREC banner format

To display a medium rectangle (MREC) sized ad format in your app, ensure the proper dimensions are used, such as 300x250, 300x300, or 450x450. In the case of a 300x250 MREC banner ad specifically, replace this in the following example code:
new UnityBannerSize(320, 50)
With this adjusted dimension:
new UnityBannerSize(300, 250)

Banner ad example

Construct a
BannerShowListener
to handle impression, click, and show failure events, then pass it into
BannerConfiguration.Builder
along with the placement ID and a
BannerSize
, which supports fixed or adaptive dimensions for anchored and inline layouts. Optionally include mediation metadata and ad markup for bidding, then call
BannerAd.load()
with the built configuration and a
LoadListener
. On a successful load, retrieve the banner's
View
via
ad.getView()
to insert it into your layout.
BannerShowListener showListener = new BannerShowListener() { @Override public void onImpression(@NonNull BannerAd ad) { /* impression */ } @Override public void onClicked(@NonNull BannerAd ad) { /* clicked */ } @Override public void onFailedToShow(@NonNull BannerAd ad, @NonNull UnityAdsError error) { /* show failure */ } }; BannerConfiguration.Builder builder = new BannerConfiguration.Builder( placementId, new BannerSize( 320, 50 ), showListener ) .withMediationInfo( createMediationInfo() ); if ( AppLovinSdkUtils.isValidString( bidResponse ) ) { builder.withAdMarkup( bidResponse ); } BannerAd.load( builder.build(), new LoadListener<BannerAd>() { @Override public void onAdLoaded(@Nullable BannerAd ad, @Nullable UnityAdsError error) { if ( error == null ) { loadedBannerAd = ad; listener.onAdViewAdLoaded( ad.getView() ); // retrieve view via getView() } else { // failure } } } );
val showListener = object : BannerShowListener { override fun onImpression(ad: BannerAd) { /* impression */ } override fun onClicked(ad: BannerAd) { /* clicked */ } override fun onFailedToShow(ad: BannerAd, error: UnityAdsError) { /* show failure */ }}val builder = BannerConfiguration.Builder(placementId, BannerSize(320, 50), showListener) .withMediationInfo(createMediationInfo())if (AppLovinSdkUtils.isValidString(bidResponse)) { builder.withAdMarkup(bidResponse)}BannerAd.load(builder.build(), object : LoadListener<BannerAd> { override fun onAdLoaded(ad: BannerAd?, error: UnityAdsError?) { if (error == null) { loadedBannerAd = ad listener.onAdViewAdLoaded(ad.getView()) // retrieve view via getView() } else { // failure } }})
Next steps: Review the monetization strategy guide or test your implementation.

Copyright © 2026 Unity Technologies
法律信息隐私政策CookiesDocumentation Terms of Use请勿出售或分享我的个人信息您的隐私选择(Cookie 设置)

“Unity”、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属公司在美国和其他地方的商标或注册商标(此处查看更多信息)。其他名称或品牌是其各自所有者的商标。

为方便起见,一些页面是机器翻译的,可能包含不准确的内容。如有信息不一致的情况,以英文版本为准。

  • 在本页上
    • Script implementation

      • Implementing the MREC banner format

    • Banner ad example


报告此页面的问题