AppLovin Support

banner & MREC広告

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

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

bannerまたはMRECのロード

コンテンツフィード内にMREC広告を表示する必要がある場合、AppLovinでは以下の手法を推奨しています。

  1. インスタンスの作成数を最小限に抑える。
  2. 自動更新(auto-refresh)を停止する。
  3. loadAdを呼び出して手動でコンテンツを更新する(MAAdViewインスタンスを再利用する)。

実装例は、AppLovinデモアプリ(Objective-C、Swift)で確認できます。

banner

bannerをロードするには、広告ユニットに対応する MAAdView オブジェクトを作成し、その loadAd メソッドを呼び出します。 広告を表示するには、MAAdView オブジェクトをビュー階層のサブビューとして追加します。 広告の準備ができたときに通知を受け取れるよう、MAAdViewAdDelegate を実装してください。 これにより、その他の広告関連イベントの通知も受け取ることができます。

#import "ExampleViewController.h"
#import <AppLovinSDK/AppLovinSDK.h>

@interface ExampleViewController()<MAAdViewAdDelegate>
@property (nonatomic, strong) MAAdView *adView;
@end

@implementation ExampleViewController

- (void)createBannerAd
{
  self.adView = [[MAAdView alloc] initWithAdUnitIdentifier: @"«ad-unit-ID»"];
  self.adView.delegate = self;

  // iPhoneとiPadでのbannerの高さは、それぞれ50と90です
  CGFloat height = (UIDevice.currentDevice.userInterfaceIdiom == UIUserInterfaceIdiomPad) ? 90 : 50;

  // bannerが完全に機能するように画面の幅いっぱいに広げます
  CGFloat width = CGRectGetWidth(UIScreen.mainScreen.bounds);

  self.adView.frame = CGRectMake(x, y, width, height);

  // bannerが完全に機能するように背景色を設定します
  self.adView.backgroundColor = «background-color»;

  [self.view addSubview: self.adView];

  // 広告をロードします
  [self.adView loadAd];
}

#pragma mark - MAAdDelegate Protocol

- (void)didLoadAd:(MAAd *)ad {}

- (void)didFailToLoadAdForAdUnitIdentifier:(NSString *)adUnitIdentifier withError:(MAError *)error {}

- (void)didClickAd:(MAAd *)ad {}

- (void)didFailToDisplayAd:(MAAd *)ad withError:(MAError *)error {}

#pragma mark - MAAdViewAdDelegate Protocol

- (void)didExpandAd:(MAAd *)ad {}

- (void)didCollapseAd:(MAAd *)ad {}

#pragma mark - Deprecated Callbacks

- (void)didDisplayAd:(MAAd *)ad { /* 使用しないでください - これはフルスクリーン広告専用であり、将来のSDKリリースで削除される予定です */ }
- (void)didHideAd:(MAAd *)ad { /* 使用しないでください - これはフルスクリーン広告専用であり、将来のSDKリリースで削除される予定です */ }

@end

MRECs

MREC広告をロードするには、広告ユニットに対応する MAAdView オブジェクトを作成し、その loadAd メソッドを呼び出します。 広告を表示するには、MAAdView オブジェクトをビュー階層のサブビューとして追加します。 広告の準備ができたときに通知を受け取れるよう、MAAdViewAdDelegate を実装してください。 これにより、その他の広告関連イベントの通知も受け取ることができます。

#import "ExampleViewController.h"
#import <AppLovinSDK/AppLovinSDK.h>

@interface ExampleViewController()<MAAdViewAdDelegate>
@property (nonatomic, strong) MAAdView *adView;
@end

@implementation ExampleViewController

- (void)createMRecAd
{
  self.adView = [[MAAdView alloc] initWithAdUnitIdentifier: @"«ad-unit-ID»" adFormat: MAAdFormat.mrec];
  self.adView.delegate = self;

  // iPhoneとiPadでのMRECの幅と高さは、それぞれ300と250です
  CGFloat width = 300;
  CGFloat height = 250;

  // MRECを中央に配置します
  CGFloat x = self.view.center.x - 150;

  self.adView.frame = CGRectMake(x, y, width, height);

  // MREC広告が完全に機能するように背景色を設定します
  self.adView.backgroundColor = «background-color»;

  [self.view addSubview: self.adView];

  // 広告をロードします
  [self.adView loadAd];
}

#pragma mark - MAAdDelegate Protocol

- (void)didLoadAd:(MAAd *)ad {}

- (void)didFailToLoadAdForAdUnitIdentifier:(NSString *)adUnitIdentifier withError:(MAError *)error {}

- (void)didClickAd:(MAAd *)ad {}

- (void)didFailToDisplayAd:(MAAd *)ad withError:(MAError *)error {}

#pragma mark - MAAdViewAdDelegate Protocol

- (void)didExpandAd:(MAAd *)ad {}

- (void)didCollapseAd:(MAAd *)ad {}

#pragma mark - Deprecated Callbacks

- (void)didDisplayAd:(MAAd *)ad { /* 使用しないでください - これはフルスクリーン広告専用であり、将来のSDKリリースで削除される予定です */ }
- (void)didHideAd:(MAAd *)ad { /* 使用しないでください - これはフルスクリーン広告専用であり、将来のSDKリリースで削除される予定です */ }

@end

bannerおよびMREC広告の破棄

MAAdView インスタンスが不要になる場合があります。 これは、たとえばユーザーが広告非表示オプションを購入した場合などに発生します。 リソースを解放するために、そのような MAAdView インスタンスの割り当てを解除(破棄)してください。

同じ広告ユニットIDで複数のインスタンスを使用している場合は、MAAdView インスタンスの割り当てを解除しないでください。

[self.adView removeFromSuperview];
self.adView.delegate = nil;
self.adView = nil;

アダプティブbanner

Google bidding、Google AdMob、Google Ad Manager、Liftoff Monetize、Pangle、およびYandexがアダプティブbannerをサポートしています。 MAXは、その他のnetworkからのbannerについては非アダプティブな方法でサイズ調整を行います。

Googleは、bannerの配置場所とアプリのコンテンツとの間に50 pxのパディングを設けることを推奨しています。 これにより、ユーザーが誤ってbannerをクリックする可能性を低くすることができます。 詳細およびベストプラクティスについては、Googleの「確認済みのクリックについて」ポリシーを参照してください。

アダプティブbannerは、デバイスのタイプや利用可能な幅に基づいて動的にサイズを調整するレスポンシブ広告です。 アダプティブbannerにはアンカー型(anchored)とインライン型(inline)があり、それぞれ特定の実装ニーズに対応します。

MAX SDK バージョン 13.2.0 以降では、ビルド時に adaptiveType を設定した MAAdViewConfiguration オブジェクトを使用して MAAdView を初期化することで、アダプティブbannerを統合できます。

アダプティブbanner機能をサポートする広告network adapter

以下のadapterが、特別なアダプティブbanner機能をサポートしています。

networkadapterバージョン特別な機能
Google Ad Manager11.7.0.1+インラインアダプティブbanner
11.13.0.1+インラインアダプティブMREC
10.2.0.1+カスタム幅の設定
Google Bidding および Google AdMob11.7.0.1+インラインアダプティブbanner
11.13.0.1+インラインアダプティブMREC
10.2.0.2+カスタム幅の設定
InMobi11.3.0.1+
Liftoff Monetize7.4.5.1+
Pangle7.1.0.8.0+
Yandex7.12.2.1+

アンカー型アダプティブbanner

アンカー型アダプティブbannerは、画面の上部または下部に固定(アンカー)するbannerです。 デバイスのタイプとbannerの幅に基づいて、高さを動的に調整します。

MAAdView の高さには、50や90のような固定値を使用する代わりに、MAAdFormat.banner.adaptiveSize.height によって返される値を設定する必要があります。

- (void)createAnchoredAdaptiveBannerAd
{
  // bannerが完全に機能するように画面の幅いっぱいに広げます
  CGFloat width = CGRectGetWidth(UIScreen.mainScreen.bounds);

  // アンカー型アダプティブbannerの高さを取得します
  CGFloat height = MAAdFormat.banner.adaptiveSize.height;

  MAAdViewConfiguration *config = [MAAdViewConfiguration configurationWithBuilderBlock:^(MAAdViewConfigurationBuilder *builder) {
    builder.adaptiveType = MAAdViewAdaptiveTypeAnchored;
  }];

  self.adView = [[MAAdView alloc] initWithAdUnitIdentifier: @"«ad-unit-ID»" configuration: config];
  self.adView.delegate = self;

  self.adView.frame = CGRectMake(x, y, width, height);

  // bannerが完全に機能するように背景色を設定します
  self.adView.backgroundColor = «background-color»;

  [self.view addSubview: self.adView];

  // 広告をロードします
  [self.adView loadAd];
}

カスタム幅の設定

より具体的な実装を行う場合、MAAdViewConfiguration のビルダーオプションを設定することで、ポイント単位でカスタム幅を設定できます。 カスタムアンカー型アダプティブ広告に適した高さを取得するには、アダプティブサイズ API を呼び出します。

CGFloat width = 400;

// アンカー型アダプティブbannerの高さを取得します
CGFloat height = [self.adView.adFormat adapativeSizeForWidth: width].height;

MAAdViewConfiguration *config = [MAAdViewConfiguration configurationWithBuilderBlock:^(MAAdViewConfigurationBuilder *builder) {
  builder.adaptiveType = MAAdViewAdaptiveTypeAnchored;
  builder.adaptiveWidth = width;
}];
self.adView = [[MAAdView alloc] initWithAdUnitIdentifier: @"«ad-unit-ID»" configuration: config];

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

アダプティブbannerはデフォルトでアンカー型になります。 スクロール可能なコンテンツ内に配置できるインライン型アダプティブbannerを有効にすることも可能です。 インライン型アダプティブbannerは、通常、アンカー型アダプティブbannerよりも大きくなります。 高さは可変で、デバイス画面の最大高さまで拡張できます。

インライン型アダプティブbannerを有効にするには、以下のコードに示すように、MAAdViewConfiguration のアダプティブタイプを MAAdViewAdaptiveTypeInline に設定します。

MAAdViewConfiguration *config = [MAAdViewConfiguration configurationWithBuilderBlock:^(MAAdViewConfigurationBuilder *builder) {
  builder.adaptiveType = MAAdViewAdaptiveTypeInline;
  ⋮
}];

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

MAAdViewConfiguration *config = [MAAdViewConfiguration configurationWithBuilderBlock:^(MAAdViewConfigurationBuilder *builder) {
  builder.adaptiveType = MAAdViewAdaptiveTypeInline;
  builder.inlineMaximumHeight = 100;
  ⋮
}];

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

インライン型アダプティブMRECは、デフォルトでアプリケーションウィンドウの全幅に広がりますが、オプションでポイント単位のカスタム幅を指定することもできます。 高さは可変であり、最大高さを指定しない場合は、標準のMRECサイズを超えてデバイス画面の最大高さまで拡張できます。

インライン型アダプティブMRECを有効にするには、以下のコードに示すように、MAAdViewConfiguration のアダプティブタイプを MAAdViewAdaptiveTypeInline に設定します。

- (void)createInlineAdaptiveMRecAd
{
  // インライン型アダプティブMRECのカスタム幅(ポイント単位)を設定します。設定しない場合は、CGRectGetWidth(UIScreen.mainScreen.bounds)を使用して画面幅いっぱいに広げます
  CGFloat width = 400;

  // インライン型アダプティブMRECの最大高さ(ポイント単位)を設定します。設定しない場合は、標準のMRECの高さである250ポイントが使用されます
  // Googleは50ポイントを超える高さを推奨しており、最小値は32ポイント、最大値は画面の高さと同じです
  // また、この値はMAAdViewの高さを超えてはなりません
  CGFloat height = 300;

  MAAdViewConfiguration *config = [MAAdViewConfiguration configurationWithBuilderBlock:^(MAAdViewConfigurationBuilder *builder) {
    builder.adaptiveType = MAAdViewAdaptiveTypeInline;
    builder.adaptiveWidth = width; // オプション:値を設定しない場合、アダプティブ広告はアプリケーションウィンドウの幅いっぱいに広がります
    builder.inlineMaximumHeight = height; // オプション:値を設定しない場合、最大高さは画面の高さになります
  }];
  self.adView = [[MAAdView alloc] initWithAdUnitIdentifier: @"«ad-unit-ID»" adFormat: MAAdFormat.mrec configuration: config];
  self.adView.delegate = self;

  self.adView.frame = CGRectMake(x, y, width, height);

  // アダプティブMRECが完全に機能するように背景色を設定します
  self.adView.backgroundColor = «background-color»;

  [self.view addSubview: self.adView];

  // 広告をロードします
  [self.adView loadAd];
}

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

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

- (void)didLoadAd:(MAAd *)ad
{
  CGSize adViewSize = ad.size;
  CGFloat width = adViewSize.width;
  CGFloat height = adViewSize.height;
  ⋮
}

自動更新の停止と開始

広告の自動更新(auto-refresh)を停止したい場合があります。 たとえば、banner広告を非表示にする場合や、手動で更新したい場合などです。 bannerまたはMREC広告の自動更新を停止するには、以下のコードを使用します。

// stopAutoRefresh()の呼び出しが無視されるSDKのバグを回避するため、このカスタムパラメータを設定します
[adView setExtraParameterForKey: @"allow_pause_auto_refresh_immediately" value: @"true"];
[adView stopAutoRefresh];

bannerまたはMREC広告の自動更新を開始するには、以下の呼び出しを行います。

[adView startAutoRefresh];

以下の呼び出しにより、手動でコンテンツを更新します。 loadAd() を呼び出す前に、自動更新を停止する必要があります。

[adView loadAd];

search