BannerおよびMREC広告は、アプリのレイアウトの一部(多くの場合、画面の上部または下部、あるいはスクロール可能なコンテンツ内)を占める長方形の広告フォーマットです。 ユーザーがアプリを操作している間も表示され続けるため、ゲームプレイやアプリの使用を妨げることなく、設定された期間の経過後に自動的にリフレッシュすることができます。
以下のセクションでは、bannerまたはMREC広告をロード、表示、および非表示にする方法について説明します。
AppLovinブログの「動画とプレイアブルが主流の世界でモバイルbanner広告が存続し続ける理由」(英語)。
bannerまたはMRECをロードするには、広告ユニットに対応する MaxAdView オブジェクトを作成します。
次に、そのオブジェクトの loadAd() メソッドを呼び出します。
広告を表示するには、MaxAdView オブジェクトをビュー階層のサブビューとして追加します。
広告の準備ができたときに通知を受け取る(およびその他の広告関連イベントの通知を受け取る)ために、MaxAdViewAdListener を実装します。
コンテンツフィード内にMREC広告を表示する実装が必要な場合、AppLovinは以下を推奨します:
loadAd() を呼び出してコンテンツを手動でリフレッシュする(MaxAdView インスタンスを再利用する)。実装例は、AppLovinデモアプリ(Java、Kotlin)で確認できます。
public class ExampleActivity extends Activity
implements MaxAdViewAdListener
{
private MaxAdView adView;
void createBannerAd()
{
adView = new MaxAdView( "«ad-unit-ID»", this );
adView.setListener( this );
// Stretch to the width of the screen for banners to be fully functional
int width = ViewGroup.LayoutParams.MATCH_PARENT;
// Banner height on phones and tablets is 50 and 90, respectively
int heightPx = getResources().getDimensionPixelSize( R.dimen.banner_height );
adView.setLayoutParams( new FrameLayout.LayoutParams( width, heightPx ) );
// Set background color for banners to be fully functional
adView.setBackgroundColor( «background-color» );
ViewGroup rootView = findViewById( android.R.id.content );
rootView.addView( adView );
// Load the ad
adView.loadAd();
}
// MAX Ad Listener
@Override
public void onAdLoaded(final MaxAd maxAd) {}
@Override
public void onAdLoadFailed(final String adUnitId, final MaxError error) {}
@Override
public void onAdDisplayFailed(final MaxAd maxAd, final MaxError error) {}
@Override
public void onAdClicked(final MaxAd maxAd) {}
@Override
public void onAdExpanded(final MaxAd maxAd) {}
@Override
public void onAdCollapsed(final MaxAd maxAd) {}
@Override
public void onAdDisplayed(final MaxAd maxAd) { /* DO NOT USE - THIS IS RESERVED FOR FULLSCREEN ADS ONLY AND WILL BE REMOVED IN A FUTURE SDK RELEASE */ }
@Override
public void onAdHidden(final MaxAd maxAd) { /* DO NOT USE - THIS IS RESERVED FOR FULLSCREEN ADS ONLY AND WILL BE REMOVED IN A FUTURE SDK RELEASE */ }
}
class ExampleActivity : Activity(), MaxAdViewAdListener
{
private var adView: MaxAdView? = null
fun createBannerAd()
{
adView = MaxAdView("«ad-unit-ID»", this)
adView?.setListener(this)
// Stretch to the width of the screen for banners to be fully functional
val widthPx = ViewGroup.LayoutParams.MATCH_PARENT
// Banner height on phones and tablets is 50 and 90, respectively
val heightPx = resources.getDimensionPixelSize(R.dimen.banner_height)
adView?.layoutParams = FrameLayout.LayoutParams(widthPx, heightPx)
// Set background color for banners to be fully functional
adView?.setBackgroundColor(«background-color»)
val rootView = findViewById(android.R.id.content)
rootView.addView(adView)
// Load the ad
adView?.loadAd()
}
// MAX Ad Listener
override fun onAdLoaded(maxAd: MaxAd) {}
override fun onAdLoadFailed(adUnitId: String?, error: MaxError?) {}
override fun onAdDisplayFailed(ad: MaxAd?, error: MaxError?) {}
override fun onAdClicked(maxAd: MaxAd) {}
override fun onAdExpanded(maxAd: MaxAd) {}
override fun onAdCollapsed(maxAd: MaxAd) {}
override fun onAdDisplayed(maxAd: MaxAd) { /* DO NOT USE - THIS IS RESERVED FOR FULLSCREEN ADS ONLY AND WILL BE REMOVED IN A FUTURE SDK RELEASE */ }
override fun onAdHidden(maxAd: MaxAd) { /* DO NOT USE - THIS IS RESERVED FOR FULLSCREEN ADS ONLY AND WILL BE REMOVED IN A FUTURE SDK RELEASE */ }
}
public class ExampleActivity extends Activity
implements MaxAdViewAdListener
{
private MaxAdView adView;
void createMRecAd()
{
adView = new MaxAdView( "«ad-unit-ID»", MaxAdFormat.MREC, this );
adView.setListener( this );
// MREC width and height are 300 and 250 respectively, on phones and tablets
int widthPx = AppLovinSdkUtils.dpToPx( this, 300 );
int heightPx = AppLovinSdkUtils.dpToPx( this, 250 );
adView.setLayoutParams( new FrameLayout.LayoutParams( widthPx, heightPx ) );
// Set background color for MRECs to be fully functional
adView.setBackgroundColor( «background-color» );
ViewGroup rootView = findViewById( android.R.id.content );
rootView.addView( adView );
// Load the ad
adView.loadAd();
}
// MAX Ad Listener
@Override
public void onAdLoaded(final MaxAd maxAd) {}
@Override
public void onAdLoadFailed(final String adUnitId, final MaxError error) {}
@Override
public void onAdDisplayFailed(final MaxAd maxAd, final MaxError error) {}
@Override
public void onAdClicked(final MaxAd maxAd) {}
@Override
public void onAdExpanded(final MaxAd maxAd) {}
@Override
public void onAdCollapsed(final MaxAd maxAd) {}
@Override
public void onAdDisplayed(final MaxAd maxAd) { /* DO NOT USE - THIS IS RESERVED FOR FULLSCREEN ADS ONLY AND WILL BE REMOVED IN A FUTURE SDK RELEASE */ }
@Override
public void onAdHidden(final MaxAd maxAd) { /* DO NOT USE - THIS IS RESERVED FOR FULLSCREEN ADS ONLY AND WILL BE REMOVED IN A FUTURE SDK RELEASE */ }
}
class ExampleActivity : Activity(), MaxAdViewAdListener
{
private var adView: MaxAdView? = null
fun createMRecAd()
{
adView = MaxAdView("«ad-unit-ID»", MaxAdFormat.MREC, this)
adView?.setListener(this)
// MREC width and height are 300 and 250 respectively, on phones and tablets
val widthPx = AppLovinSdkUtils.dpToPx(this, 300)
val heightPx = AppLovinSdkUtils.dpToPx(this, 250)
adView?.layoutParams = FrameLayout.LayoutParams(widthPx, heightPx)
// Set background color for MRECs to be fully functional
adView?.setBackgroundColor(«background-color»)
val rootView = findViewById(android.R.id.content)
rootView.addView(adView)
// Load the ad
adView?.loadAd()
}
// MAX Ad Listener
override fun onAdLoaded(maxAd: MaxAd) {}
override fun onAdLoadFailed(adUnitId: String?, error: MaxError?) {}
override fun onAdDisplayFailed(ad: MaxAd?, error: MaxError?) {}
override fun onAdClicked(maxAd: MaxAd) {}
override fun onAdExpanded(maxAd: MaxAd) {}
override fun onAdCollapsed(maxAd: MaxAd) {}
override fun onAdDisplayed(maxAd: MaxAd) { /* DO NOT USE - THIS IS RESERVED FOR FULLSCREEN ADS ONLY AND WILL BE REMOVED IN A FUTURE SDK RELEASE */ }
override fun onAdHidden(maxAd: MaxAd) { /* DO NOT USE - THIS IS RESERVED FOR FULLSCREEN ADS ONLY AND WILL BE REMOVED IN A FUTURE SDK RELEASE */ }
}
MAXのbannersまたはMRECsをビューレイアウトのXMLに追加することもできます。
背景または背景色(android:background)を設定して、広告が完全に機能するようにしてください。
bannersの場合は、幅(android:layout_width)を画面の幅いっぱいに引き伸ばします。
MRECsの場合は、それに応じて android:adFormat を設定します:
<com.applovin.mediation.ads.MaxAdView
xmlns:maxads="http://schemas.applovin.com/android/1.0"
maxads:adUnitId="«ad-unit-ID»"
android:background="@color/banner_background_color"
android:layout_width="match_parent"
android:layout_height="@dimen/banner_height" />
res/values/attrs.xml でベースとなる 50 dp の banner の高さを宣言します:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<dimen name="banner_height">50dp</dimen>
</resources>
res/values-sw600dp/attrs.xml でタブレット用の 90 dp の banner の高さを宣言します:
<?xml version="1.0" encoding="utf-8"?>
<resources>
<dimen name="banner_height">90dp</dimen>
</resources>
<com.applovin.mediation.ads.MaxAdView
xmlns:maxads="http://schemas.applovin.com/android/1.0"
maxads:adUnitId="«ad-unit-ID»"
maxads:adFormat="MREC"
android:background="@color/mrec_background_color"
android:layout_width="300dp"
android:layout_height="250dp" />
この方法で作成した MaxAdView に対しても、引き続き loadAd() を呼び出す必要があります。
MaxAdView adView = findViewById( R.id.ad_view );
adView.loadAd();
var adView: MaxAdView = findViewById(R.id.ad_view)
adView.loadAd()
MaxAdView インスタンスが不要になった場合は、その destroy() メソッドを呼び出してリソースを解放します。
これは、たとえばユーザーが広告非表示オプションを購入した場合などに該当します。
同じ広告ユニットIDで複数のインスタンスを使用している場合は、destroy() メソッドを呼び出さないでください。
adView.destroy();
adView.destroy()
Google bidding、Google AdMob、Google Ad Manager、Liftoff Monetize、Pangle、およびYandexはadaptive bannersをサポートしています。 MAXは、その他のネットワークのbannerサイズを非アダプティブ方式で調整します。
Googleは、bannerの配置場所とアプリのコンテンツの間に50 pxのパディングを挿入することを推奨しています。 これにより、ユーザーが誤ってbannerをクリックする可能性を低くすることができます。 詳細およびベストプラクティスについては、Googleの「確認済みのクリックについて」ポリシーを参照してください。
Adaptive bannersは、デバイスのタイプや利用可能な幅に基づいて動的にサイズを調整するレスポンシブ広告です。 Adaptive bannersにはアンカー型とインライン型があり、それぞれ特定の統合ニーズに対応します。
MAX SDKバージョン13.2.0以降では、ビルド時にアダプティブタイプを設定した MaxAdViewConfiguration オブジェクトを使用して MaxAdView を初期化することで、adaptive bannersを統合できます。
以下のアダプターは、特別なadaptive banner機能をサポートしています:
| ネットワーク | アダプターバージョン | 特別な機能 |
|---|---|---|
| Google Ad Manager | 23.2.0.1+ | インライン adaptive banners |
| 23.6.0.3+ | インライン adaptive MRECs | |
| 21.5.0.2+ | カスタム幅の設定 | |
| Google BiddingおよびGoogle AdMob | 23.2.0.1+ | インライン adaptive banners |
| 23.6.0.3+ | インライン adaptive MRECs | |
| 21.5.0.3+ | カスタム幅の設定 | |
| InMobi | 11.3.0.1+ | |
| Liftoff Monetize | 7.4.3.2+ | |
| Pangle | 7.1.0.4.0+ | |
| Yandex | 7.12.2.1+ |
アンカー型 adaptive bannersは、画面の上部または下部に固定するbannerです。 デバイスのタイプとbannerの幅に基づいて、高さを動的に調整します。
50や90のような固定値を使用する代わりに、MaxAdFormat.BANNER.getAdaptiveSize( Context ).getHeight() によって返される値に MaxAdView の高さを設定する必要があります。
void createAnchoredAdaptiveBannerAd()
{
// Stretch to the width of the screen for banners to be fully functional
int widthPx = ViewGroup.LayoutParams.MATCH_PARENT;
// Get the anchored adaptive banner height
int heightDp = MaxAdFormat.BANNER.getAdaptiveSize( this ).getHeight();
int heightPx = AppLovinSdkUtils.dpToPx( this, heightDp );
MaxAdViewConfiguration config = MaxAdViewConfiguration.builder()
.setAdaptiveType( MaxAdViewConfiguration.AdaptiveType.ANCHORED )
.build();
adView = new MaxAdView( "«ad-unit-ID»", config );
adView.setListener( this );
adView.setLayoutParams( new FrameLayout.LayoutParams( widthPx, heightPx ) );
// Set background color for banners to be fully functional
adView.setBackgroundColor( «background-color» );
ViewGroup rootView = findViewById( android.R.id.content );
rootView.addView( adView );
// Load the ad
adView.loadAd();
}
fun createAnchoredAdaptiveBannerAd()
{
// Stretch to the width of the screen for banners to be fully functional
val widthPx = ViewGroup.LayoutParams.MATCH_PARENT
// Get the anchored adaptive banner height
val heightDp = MaxAdFormat.BANNER.getAdaptiveSize(this).height
val heightPx = AppLovinSdkUtils.dpToPx(this, heightDp)
val config = MaxAdViewConfiguration.builder()
.setAdaptiveType( MaxAdViewConfiguration.AdaptiveType.ANCHORED )
.build();
adView = MaxAdView("«ad-unit-ID»", config)
adView?.setListener(this)
adView?.layoutParams = FrameLayout.LayoutParams(widthPx, heightPx)
// Set background color for banners to be fully functional
adView?.setBackgroundColor(«background-color»)
val rootView = findViewById<ViewGroup>(android.R.id.content)
rootView.addView(adView)
// Load the ad
adView?.loadAd()
}
より具体的な統合を行うために、MaxAdViewConfiguration のビルダーメソッドを呼び出して、dp単位でカスタム幅を設定できます。
カスタムアンカー型アダプティブ広告に適した高さを取得するには、アダプティブサイズAPIを呼び出します。
int widthDp = 400;
// Get the anchored adaptive banner height
int heightDp = MaxAdFormat.BANNER.getAdaptiveSize( widthDp, context ).getHeight();
MaxAdViewConfiguration config = MaxAdViewConfiguration.builder()
.setAdaptiveType( MaxAdViewConfiguration.AdaptiveType.ANCHORED )
.setAdaptiveWidth( widthDp )
.build();
adView = new MaxAdView( "«ad-unit-ID»", config );
val widthDp = 400
// Get the anchored adaptive banner height
val heightDp = adView.adFormat.getAdaptiveSize(widthDp, context).height
val config = MaxAdViewConfiguration.builder()
.setAdaptiveType(MaxAdViewConfiguration.AdaptiveType.ANCHORED)
.setAdaptiveWidth(widthDp)
.build()
adView = MaxAdView("«ad-unit-ID»", config)
Adaptive bannersはデフォルトでアンカー型になります。 スクロール可能なコンテンツ内に配置できるインライン型 adaptive bannersを有効にすることもできます。 インライン型 adaptive bannersは、通常、アンカー型 adaptive bannersよりも大きくなります。 これらは可変の高さを持ち、デバイス画面の高さ全体まで拡張できます。
インライン型 adaptive bannersを有効にするには、以下のコードに示すように、MaxAdViewConfiguration のアダプティブタイプを MaxAdViewConfiguration.AdaptiveType.INLINE に設定します:
MaxAdViewConfiguration config = MaxAdViewConfiguration.builder()
.setAdaptiveType( MaxAdViewConfiguration.AdaptiveType.INLINE )
⋮
.build();
val config = MaxAdViewConfiguration.builder()
.setAdaptiveType(MaxAdViewConfiguration.AdaptiveType.INLINE)
⋮
.build()
インライン型アダプティブ広告のデフォルトの最大高さは、デバイス画面の高さ全体です。
広告が MaxAdView の高さに収まるように、インライン型アダプティブ広告の最大高さをdp単位で設定したい場合があります。
これは、最大高さを100 dpとする以下の例のようなコードで行うことができます:
MaxAdViewConfiguration config = MaxAdViewConfiguration.builder()
.setAdaptiveType( MaxAdViewConfiguration.AdaptiveType.INLINE )
.setInlineMaximumHeight( 100 )
⋮
.build();
val config = MaxAdViewConfiguration.builder()
.setAdaptiveType(MaxAdViewConfiguration.AdaptiveType.INLINE)
.setInlineMaximumHeight( 100 )
⋮
.build()
インライン型アダプティブMRECは、デフォルトでアプリケーションウィンドウの全幅に広がりますが、オプションでdp単位のカスタム幅を指定することもできます。 最大高さを指定しない場合、高さは可変となり、標準のMRECサイズを超えてデバイス画面の高さ全体まで拡張される可能性があります。
次の例に示すように、アダプティブタイプを MaxAdViewConfiguration.AdaptiveType.INLINE に設定して、インライン型アダプティブMRECを設定します:
void createInlineAdaptiveMRecAd()
{
// Set a custom width, in dp, for the inline adaptive MREC. Otherwise stretch to screen width by using ViewGroup.LayoutParams.MATCH_PARENT
int widthDp = 400;
int widthPx = AppLovinSdkUtils.dpToPx( this, widthDp );
// Set a maximum height, in dp, for the inline adaptive MREC. Otherwise use standard MREC height of 250 dp
// Google recommends a height greater than 50 dp, with a minimum of 32 dp and a maximum equal to the screen height
// The value must also not exceed the height of the MaxAdView
int heightDp = 300;
int heightPx = AppLovinSdkUtils.dpToPx( this, heightDp );
MaxAdViewConfiguration config = MaxAdViewConfiguration.builder()
.setAdaptiveType( MaxAdViewConfiguration.AdaptiveType.INLINE )
.setAdaptiveWidth( widthDp ) // Optional: The adaptive ad spans the width of the application window if you do not set a value
.setInlineMaximumHeight( heightDp ) // Optional: The maximum height is the screen height if you do not set a value
.build();
adView = new MaxAdView( "«ad-unit-ID»", MaxAdFormat.MREC, config );
adView.setListener( this );
adView.setLayoutParams( new FrameLayout.LayoutParams( widthPx, heightPx ) );
// Set background color for adaptive MRECs to be fully functional
adView.setBackgroundColor( «background-color» );
ViewGroup rootView = findViewById( android.R.id.content );
rootView.addView( adView );
// Load the ad
adView.loadAd();
}
fun createInlineAdaptiveMRecAd()
{
// Set a custom width, in dp, for the inline adaptive MREC. Otherwise stretch to screen width by using ViewGroup.LayoutParams.MATCH_PARENT
val widthDp = 400
val widthPx = AppLovinSdkUtils.dpToPx(this, widthDp)
// Set a maximum height, in dp, for the inline adaptive MREC. Otherwise use standard MREC height of 250 dp
// Google recommends a height greater than 50 dp, with a minimum of 32 dp and a maximum equal to the screen height
// The value must also not exceed the height of the MaxAdView
val heightDp = 300
val heightPx = AppLovinSdkUtils.dpToPx( this, heightDp )
val config = MaxAdViewConfiguration.builder()
.setAdaptiveType(MaxAdViewConfiguration.AdaptiveType.INLINE)
.setAdaptiveWidth(widthDp) // Optional: The adaptive ad spans the width of the application window if a value is not specified
.setInlineMaximumHeight(heightDp) // Optional: The maximum height is the screen height if a value is not specified
.build()
adView = MaxAdView("«ad-unit-ID»", MaxAdFormat.MREC, config)
adView?.setListener(this)
adView?.layoutParams = FrameLayout.LayoutParams(widthPx, heightPx)
// Set background color for adaptive MRECs to be fully functional
adView?.setBackgroundColor(«background-color»)
val rootView = findViewById(android.R.id.content)
rootView.addView(adView)
// Load the ad
adView?.loadAd()
}
ロードされるアダプティブ広告は、リクエストしたサイズよりも小さくなる場合があります。 配信されるアダプティブ広告のサイズに基づいてUIを適応させたい場合があります。 その場合は、以下のようなコードを使用して、ロードされた広告の幅と高さをdp単位で取得できます:
@Override
public void onAdLoaded(final MaxAd maxAd)
{
AppLovinSdkUtils.Size adViewSize = maxAd.getSize();
int widthDp = adViewSize.getWidth();
int heightDp = adViewSize.getHeight();
⋮
}
override fun onAdLoaded(ad: MaxAd?)
{
val adViewSize = ad?.size!!
val widthDp = adViewSize.width
val heightDp = adViewSize.height
⋮
}
広告の自動リフレッシュを停止したい場合があります。 これは、広告を非表示にする場合や、手動でリフレッシュしたい場合などに該当します。 次のコードを使用して自動リフレッシュを停止します:
// Set this extra parameter to work around SDK bug that ignores calls to stopAutoRefresh()
adView.setExtraParameter( "allow_pause_auto_refresh_immediately", "true" );
adView.stopAutoRefresh();
// Set this extra parameter to work around SDK bug that ignores calls to stopAutoRefresh()
adView.setExtraParameter( "allow_pause_auto_refresh_immediately", "true" )
adView.stopAutoRefresh()
次のコードを使用して、広告の自動リフレッシュを開始します:
adView.startAutoRefresh();
adView.startAutoRefresh()
loadAd() を呼び出して、広告コンテンツを手動でリフレッシュします。
これを行うには、まず自動リフレッシュを停止する必要があります。
adView.loadAd();
adView.loadAd()