AppLovin Support

Banner & MREC広告

BannerおよびMREC広告は、アプリのレイアウトの一部(多くの場合、画面の上部または下部、あるいはスクロール可能なコンテンツ内)を占める長方形の広告フォーマットです。 ユーザーがアプリを操作している間も表示され続けるため、ゲームプレイやアプリの使用を妨げることなく、設定された期間の経過後に自動的にリフレッシュすることができます。

以下のセクションでは、bannerまたはMREC広告をロード、表示、および非表示にする方法について説明します。

bannerまたはMRECのロード

bannerまたはMRECをロードするには、広告ユニットに対応する MaxAdView オブジェクトを作成します。 次に、そのオブジェクトの loadAd() メソッドを呼び出します。 広告を表示するには、MaxAdView オブジェクトをビュー階層のサブビューとして追加します。 広告の準備ができたときに通知を受け取る(およびその他の広告関連イベントの通知を受け取る)ために、MaxAdViewAdListener を実装します。

コンテンツフィード内にMREC広告を表示する実装が必要な場合、AppLovinは以下を推奨します:

  • インスタンスの作成数を最小限に抑える。
  • 自動リフレッシュを停止する。
  • loadAd() を呼び出してコンテンツを手動でリフレッシュする(MaxAdView インスタンスを再利用する)。

実装例は、AppLovinデモアプリ(Java、Kotlin)で確認できます。

Banners

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 */ }
}

MRECs

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 */ }
}

レイアウトエディタでのbannerまたはMRECのロードと表示

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>

この方法で作成した MaxAdView に対しても、引き続き loadAd() を呼び出す必要があります。

MaxAdView adView = findViewById( R.id.ad_view );
adView.loadAd();

bannersとMRECsの破棄

MaxAdView インスタンスが不要になった場合は、その destroy() メソッドを呼び出してリソースを解放します。 これは、たとえばユーザーが広告非表示オプションを購入した場合などに該当します。 同じ広告ユニットIDで複数のインスタンスを使用している場合は、destroy() メソッドを呼び出さないでください。

adView.destroy();

Adaptive banners

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機能の広告ネットワークアダプターサポート

以下のアダプターは、特別なadaptive banner機能をサポートしています:

ネットワークアダプターバージョン特別な機能
Google Ad Manager23.2.0.1+インライン adaptive banners
23.6.0.3+インライン adaptive MRECs
21.5.0.2+カスタム幅の設定
Google BiddingおよびGoogle AdMob23.2.0.1+インライン adaptive banners
23.6.0.3+インライン adaptive MRECs
21.5.0.3+カスタム幅の設定
InMobi11.3.0.1+
Liftoff Monetize7.4.3.2+
Pangle7.1.0.4.0+
Yandex7.12.2.1+

アンカー型 adaptive banners

アンカー型 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();
}

カスタム幅の設定

より具体的な統合を行うために、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 );

インライン型 adaptive banners

Adaptive bannersはデフォルトでアンカー型になります。 スクロール可能なコンテンツ内に配置できるインライン型 adaptive bannersを有効にすることもできます。 インライン型 adaptive bannersは、通常、アンカー型 adaptive bannersよりも大きくなります。 これらは可変の高さを持ち、デバイス画面の高さ全体まで拡張できます。

インライン型 adaptive bannersを有効にするには、以下のコードに示すように、MaxAdViewConfiguration のアダプティブタイプを MaxAdViewConfiguration.AdaptiveType.INLINE に設定します:

MaxAdViewConfiguration config = MaxAdViewConfiguration.builder()
                                .setAdaptiveType( MaxAdViewConfiguration.AdaptiveType.INLINE )
                                ⋮
                                .build();

インライン型アダプティブ広告のデフォルトの最大高さは、デバイス画面の高さ全体です。 広告が MaxAdView の高さに収まるように、インライン型アダプティブ広告の最大高さをdp単位で設定したい場合があります。 これは、最大高さを100 dpとする以下の例のようなコードで行うことができます:

MaxAdViewConfiguration config = MaxAdViewConfiguration.builder()
                                .setAdaptiveType( MaxAdViewConfiguration.AdaptiveType.INLINE )
                                .setInlineMaximumHeight( 100 )
                                ⋮
                                .build();

インライン型アダプティブMREC

インライン型アダプティブ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();
}

アダプティブ広告サイズの処理

ロードされるアダプティブ広告は、リクエストしたサイズよりも小さくなる場合があります。 配信されるアダプティブ広告のサイズに基づいてUIを適応させたい場合があります。 その場合は、以下のようなコードを使用して、ロードされた広告の幅と高さをdp単位で取得できます:

@Override
public void onAdLoaded(final MaxAd maxAd)
{
  AppLovinSdkUtils.Size adViewSize = maxAd.getSize();
  int widthDp = adViewSize.getWidth();
  int heightDp = adViewSize.getHeight();
  ⋮
}

自動リフレッシュの停止と開始

広告の自動リフレッシュを停止したい場合があります。 これは、広告を非表示にする場合や、手動でリフレッシュしたい場合などに該当します。 次のコードを使用して自動リフレッシュを停止します:

// 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();

loadAd() を呼び出して、広告コンテンツを手動でリフレッシュします。 これを行うには、まず自動リフレッシュを停止する必要があります。

adView.loadAd();

search