bannerおよびMREC広告は、アプリのレイアウトの一部(画面の上部や下部、またはスクロール可能なコンテンツ内など)を占有する長方形の広告フォーマットです。 ユーザーがアプリを操作している間も表示され続けるため、ゲームプレイやアプリの使用を妨げることなく、一定時間経過後に自動的に更新(リフレッシュ)させることができます。
以下のセクションでは、bannerまたはMREC広告をロード、表示、および非表示にする方法について説明します。
コンテンツフィード内にMREC広告を表示する必要がある場合、AppLovinでは以下の手法を推奨しています。
loadAdを呼び出して手動でコンテンツを更新する(MAAdViewインスタンスを再利用する)。実装例は、AppLovinデモアプリ(Objective-C、Swift)で確認できます。
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
bannerをロードするには、広告ユニットに対応する MAAdView オブジェクトを作成し、その loadAd メソッドを呼び出します。
広告を表示するには、MAAdView オブジェクトをビュー階層のサブビューとして追加します。
広告の準備ができたときに通知を受け取れるよう、MAAdViewAdDelegate を実装してください。
これにより、その他の広告関連イベントの通知も受け取ることができます。
class ExampleViewController: UIViewController, MAAdViewAdDelegate
{
var adView: MAAdView!
func createBannerAd()
{
adView = MAAdView(adUnitIdentifier: "«ad-unit-ID»")
adView.delegate = self
// iPhoneとiPadでのbannerの高さは、それぞれ50と90です
let height = (UIDevice.current.userInterfaceIdiom == .pad) ? 90 : 50
// bannerが完全に機能するように画面の幅いっぱいに広げます
let width = UIScreen.main.bounds.width
adView.frame = CGRect(x: x, y: y, width: width, height: height)
// bannerが完全に機能するように背景色を設定します
adView.backgroundColor = «background-color»
view.addSubview(adView)
// 最初の広告をロードします
adView.loadAd()
}
// MARK: MAAdDelegate Protocol
func didLoad(_ ad: MAAd) {}
func didFailToLoadAd(forAdUnitIdentifier adUnitIdentifier: String, withError error: MAError) {}
func didClick(_ ad: MAAd) {}
func didFail(toDisplay ad: MAAd, withError error: MAError) {}
// MARK: MAAdViewAdDelegate Protocol
func didExpand(_ ad: MAAd) {}
func didCollapse(_ ad: MAAd) {}
// MARK: Deprecated Callbacks
func didDisplay(_ ad: MAAd) { /* 使用しないでください - これはフルスクリーン広告専用であり、将来のSDKリリースで削除される予定です */ }
func didHide(_ ad: MAAd) { /* 使用しないでください - これはフルスクリーン広告専用であり、将来のSDKリリースで削除される予定です */ }
}
bannerをロードするには、UIKit のビュータイプオブジェクトである MAAdView を SwiftUI のビュー階層に統合できるようにするラッパーである UIViewRepresentable オブジェクトを作成します。
また、ラッパーオブジェクト用に MAAdViewAdDelegate に準拠するカスタム Coordinator クラスを提供します。
これにより、広告の準備ができたときや、その他の広告関連イベントの通知を受け取ることができます。
ラッパーの makeUIView メソッド内で、広告ユニットに対応する MAAdView オブジェクトを作成します。
その loadAd メソッドを呼び出します。
広告を表示するには、SwiftUI のビュー階層内に UIViewRepresentable ラッパーオブジェクトを追加します。
実装例は、AppLovin-MAX_SDK_iOSのGitHubリポジトリで確認できます。
struct ExampleSwiftUIWrapper: UIViewRepresentable
{
func makeUIView(context: Context) -> MAAdView
{
let adView = MAAdView(adUnitIdentifier: "«ad-unit-ID»")
adView.delegate = context.coordinator
// bannerが完全に機能するように背景色を設定します
adView.backgroundColor = «background-color»
// 最初の広告をロードします
adView.loadAd()
return adView
}
func updateUIView(_ uiView: MAAdView, context: Context) {}
func makeCoordinator() -> Coordinator
{
Coordinator()
}
}
extension ExampleSwiftUIWrapper
{
class Coordinator: NSObject, MAAdViewAdDelegate
{
// MARK: MAAdDelegate Protocol
func didLoad(_ ad: MAAd) {}
func didFailToLoadAd(forAdUnitIdentifier adUnitIdentifier: String, withError error: MAError) {}
func didClick(_ ad: MAAd) {}
func didFail(toDisplay ad: MAAd, withError error: MAError) {}
// MARK: MAAdViewAdDelegate Protocol
func didExpand(_ ad: MAAd) {}
func didCollapse(_ ad: MAAd) {}
// MARK: Deprecated Callbacks
func didDisplay(_ ad: MAAd) { /* impressionトラッキングにこれを使用します */ }
func didHide(_ ad: MAAd) { /* 使用しないでください - これはフルスクリーン広告専用であり、将来のSDKリリースで削除される予定です */ }
}
}
// 広告を表示するSwiftUIビュー
struct ExampleSwiftUIBannerAdView: View
{
// iPhoneとiPadでのbannerの高さは、それぞれ50と90です
let height = (UIDevice.current.userInterfaceIdiom == .pad) ? 90 : 50
// bannerが完全に機能するように画面の幅いっぱいに広げます
let width = UIScreen.main.bounds.width
var body: some View {
ExampleSwiftUIWrapper()
.frame(width: width, height: height)
}
}
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
MREC広告をロードするには、広告ユニットに対応する MAAdView オブジェクトを作成し、その loadAd メソッドを呼び出します。
広告を表示するには、MAAdView オブジェクトをビュー階層のサブビューとして追加します。
広告の準備ができたときに通知を受け取れるよう、MAAdViewAdDelegate を実装してください。
これにより、その他の広告関連イベントの通知も受け取ることができます。
class ExampleViewController: UIViewController, MAAdViewAdDelegate
{
var adView: MAAdView!
func createMRecAd()
{
adView = MAAdView(adUnitIdentifier: "«ad-unit-ID»", adFormat: MAAdFormat.mrec)
adView.delegate = self
// iPhoneとiPadでのMRECの幅と高さは、それぞれ300と250です
let height = 250
let width = 300
adView.frame = CGRect(x: x, y: y, width: width, height: height)
// MRECを中央に配置します
adView.center.x = view.center.x
// MREC広告が完全に機能するように背景色を設定します
adView.backgroundColor = «background-color»
view.addSubview(adView)
// 最初の広告をロードします
adView.loadAd()
}
// MARK: MAAdDelegate Protocol
func didLoad(_ ad: MAAd) {}
func didFailToLoadAd(forAdUnitIdentifier adUnitIdentifier: String, withError error: MAError) {}
func didClick(_ ad: MAAd) {}
func didFail(toDisplay ad: MAAd, withError error: MAError) {}
// MARK: MAAdViewAdDelegate Protocol
func didExpand(_ ad: MAAd) {}
func didCollapse(_ ad: MAAd) {}
// MARK: Deprecated Callbacks
func didDisplay(_ ad: MAAd) { /* 使用しないでください - これはフルスクリーン広告専用であり、将来のSDKリリースで削除される予定です */ }
func didHide(_ ad: MAAd) { /* 使用しないでください - これはフルスクリーン広告専用であり、将来のSDKリリースで削除される予定です */ }
}
MREC広告をロードするには、まず UIKit のビュータイプオブジェクトである MAAdView を SwiftUI のビュー階層に統合できるようにするラッパーである UIViewRepresentable オブジェクトを作成します。
また、ラッパーオブジェクト用に MAAdViewAdDelegate に準拠するカスタム Coordinator クラスを提供します。
これにより、広告の準備ができたときや、その他の広告関連イベントの通知を受け取ることができます。
ラッパーの makeUIView メソッド内で、広告ユニットに対応する MAAdView オブジェクトを作成し、その loadAd メソッドを呼び出します。
広告を表示するには、SwiftUI のビュー階層内に UIViewRepresentable ラッパーオブジェクトを追加します。
実装例は、AppLovin-MAX_SDK_iOSのGitHubリポジトリで確認できます。
struct ExampleSwiftUIWrapper: UIViewRepresentable
{
func makeUIView(context: Context) -> MAAdView
{
let adView = MAAdView(adUnitIdentifier: "«ad-unit-ID»", adFormat: MAAdFormat.mrec)
adView.delegate = context.coordinator
// bannerが完全に機能するように背景色を設定します
adView.backgroundColor = «background-color»
// 最初の広告をロードします
adView.loadAd()
return adView
}
func updateUIView(_ uiView: MAAdView, context: Context) {}
func makeCoordinator() -> Coordinator
{
Coordinator()
}
}
extension ExampleSwiftUIWrapper
{
class Coordinator: NSObject, MAAdViewAdDelegate
{
// MARK: MAAdDelegate Protocol
func didLoad(_ ad: MAAd) {}
func didFailToLoadAd(forAdUnitIdentifier adUnitIdentifier: String, withError error: MAError) {}
func didClick(_ ad: MAAd) {}
func didFail(toDisplay ad: MAAd, withError error: MAError) {}
// MARK: MAAdViewAdDelegate Protocol
func didExpand(_ ad: MAAd) {}
func didCollapse(_ ad: MAAd) {}
// MARK: Deprecated Callbacks
func didDisplay(_ ad: MAAd) { /* impressionトラッキングにこれを使用します */ }
func didHide(_ ad: MAAd) { /* 使用しないでください - これはフルスクリーン広告専用であり、将来のSDKリリースで削除される予定です */ }
}
}
// 広告を表示するSwiftUIビュー
struct ExampleSwiftUIMRECAdView: View
{
// iPhoneとiPadでのMRECの幅と高さは、それぞれ300と250です
let height = 250
let width = 300
var body: some View {
ExampleSwiftUIWrapper()
.frame(width: width, height: height)
}
}
MAAdView インスタンスが不要になる場合があります。
これは、たとえばユーザーが広告非表示オプションを購入した場合などに発生します。
リソースを解放するために、そのような MAAdView インスタンスの割り当てを解除(破棄)してください。
同じ広告ユニットIDで複数のインスタンスを使用している場合は、MAAdView インスタンスの割り当てを解除しないでください。
[self.adView removeFromSuperview];
self.adView.delegate = nil;
self.adView = nil;
adView.removeFromSuperview()
adView.delegate = nil
adView = nil
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を統合できます。
以下のadapterが、特別なアダプティブbanner機能をサポートしています。
| network | adapterバージョン | 特別な機能 |
|---|---|---|
| Google Ad Manager | 11.7.0.1+ | インラインアダプティブbanner |
| 11.13.0.1+ | インラインアダプティブMREC | |
| 10.2.0.1+ | カスタム幅の設定 | |
| Google Bidding および Google AdMob | 11.7.0.1+ | インラインアダプティブbanner |
| 11.13.0.1+ | インラインアダプティブMREC | |
| 10.2.0.2+ | カスタム幅の設定 | |
| InMobi | 11.3.0.1+ | |
| Liftoff Monetize | 7.4.5.1+ | |
| Pangle | 7.1.0.8.0+ | |
| Yandex | 7.12.2.1+ |
アンカー型アダプティブ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];
}
func createAnchoredAdaptiveBannerAd()
{
// bannerが完全に機能するように画面の幅いっぱいに広げます
let width = UIScreen.main.bounds.width
// アンカー型アダプティブbannerの高さを取得します
let height = MAAdFormat.banner.adaptiveSize.height
let config = MAAdViewConfiguration { builder in
builder.adaptiveType = .anchored
}
adView = MAAdView(adUnitIdentifier: "«ad-unit-ID»", configuration: config)
adView.delegate = self
adView.frame = CGRect(x: x, y: y, width: width, height: height)
// bannerが完全に機能するように背景色を設定します
adView.backgroundColor = «background-color»
view.addSubview(adView)
// 最初の広告をロードします
adView.loadAd()
}
struct ExampleSwiftUIWrapper: UIViewRepresentable
{
func makeUIView(context: Context) -> MAAdView
{
let config = MAAdViewConfiguration { builder in
builder.adaptiveType = .anchored
}
let adView = MAAdView(adUnitIdentifier: "«ad-unit-ID»", configuration: config)
adView.delegate = context.coordinator
// bannerが完全に機能するように背景色を設定します
adView.backgroundColor = «background-color»
// 最初の広告をロードします
adView.loadAd()
return adView
}
⋮
}
// 広告を表示するSwiftUIビュー
struct ExampleSwiftUIAdaptiveBannerAdView: View
{
// bannerが完全に機能するように画面の幅いっぱいに広げます
let width = UIScreen.main.bounds.width
// アンカー型アダプティブbannerの高さを取得します
let height = MAAdFormat.banner.adaptiveSize.height
var body: some View {
ExampleSwiftUIWrapper()
.frame(width: width, height: height)
}
}
より具体的な実装を行う場合、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];
let width = 400
// アンカー型アダプティブbannerの高さを取得します
let height = adView.adFormat.adaptiveSize(forWidth: width).height
let config = MAAdViewConfiguration { builder in
builder.adaptiveType = .anchored
builder.adaptiveWidth = width
}
adView = MAAdView(adUnitIdentifier: "«ad-unit-ID»", configuration: config)
let width = 400
// アンカー型アダプティブbannerの高さを取得します
let height = adView.adFormat.adaptiveSize(forWidth: width).height
let config = MAAdViewConfiguration { builder in
builder.adaptiveType = .anchored
builder.adaptiveWidth = width
}
let adView = MAAdView(adUnitIdentifier: "«ad-unit-ID»", configuration: config)
⋮
アダプティブbannerはデフォルトでアンカー型になります。 スクロール可能なコンテンツ内に配置できるインライン型アダプティブbannerを有効にすることも可能です。 インライン型アダプティブbannerは、通常、アンカー型アダプティブbannerよりも大きくなります。 高さは可変で、デバイス画面の最大高さまで拡張できます。
インライン型アダプティブbannerを有効にするには、以下のコードに示すように、MAAdViewConfiguration のアダプティブタイプを MAAdViewAdaptiveTypeInline に設定します。
MAAdViewConfiguration *config = [MAAdViewConfiguration configurationWithBuilderBlock:^(MAAdViewConfigurationBuilder *builder) {
builder.adaptiveType = MAAdViewAdaptiveTypeInline;
⋮
}];
let config = MAAdViewConfiguration { builder in
builder.adaptiveType = .inline
⋮
}
let config = MAAdViewConfiguration { builder in
builder.adaptiveType = .inline
⋮
}
インライン型アダプティブ広告のデフォルトの最大高さは、デバイス画面の高さ全体です。
広告が MAAdView の高さに収まるように、インライン型アダプティブ広告の最大高さ(ポイント単位)を設定したい場合があります。
これは、最大高さを100ポイントとする以下の例のようなコードで行うことができます。
MAAdViewConfiguration *config = [MAAdViewConfiguration configurationWithBuilderBlock:^(MAAdViewConfigurationBuilder *builder) {
builder.adaptiveType = MAAdViewAdaptiveTypeInline;
builder.inlineMaximumHeight = 100;
⋮
}];
let config = MAAdViewConfiguration { builder in
builder.adaptiveType = .inline
builder.inlineMaximumHeight = 100
⋮
}
let config = MAAdViewConfiguration { builder in
builder.adaptiveType = .inline
builder.inlineMaximumHeight = 100
⋮
}
インライン型アダプティブ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];
}
func createInlineAdaptiveMRecAd()
{
// インライン型アダプティブMRECのカスタム幅(ポイント単位)を設定します。設定しない場合は、UIScreen.main.bounds.widthを使用して画面幅いっぱいに広げます
let width = 400
// インライン型アダプティブMRECの最大高さ(ポイント単位)を設定します。設定しない場合は、標準のMRECの高さである250ポイントが使用されます
// Googleは50ポイントを超える高さを推奨しており、最小値は32ポイント、最大値は画面の高さと同じです
// また、この値はMAAdViewの高さを超えてはなりません
let height = 300
let config = MAAdViewConfiguration { builder in
builder.adaptiveType = .inline
builder.adaptiveWidth = width // オプション:値を設定しない場合、アダプティブ広告はアプリケーションウィンドウの幅いっぱいに広がります
builder.inlineMaximumHeight = height // オプション:値を設定しない場合、最大高さは画面の高さになります
}
adView = MAAdView(adUnitIdentifier: "«ad-unit-ID»", adFormat: MAAdFormat.mrec, configuration: config)
adView.delegate = self
adView.frame = CGRect(x: x, y: y, width: width, height: height)
// アダプティブMRECが完全に機能するように背景色を設定します
adView.backgroundColor = «background-color»
view.addSubview(adView)
// 最初の広告をロードします
adView.loadAd()
}
struct ExampleSwiftUIWrapper: UIViewRepresentable
{
let width: CGFloat
let height: CGFloat
func makeUIView(context: Context) -> MAAdView
{
let config = MAAdViewConfiguration { builder in
builder.adaptiveType = .inline
builder.adaptiveWidth = width // オプション:値を設定しない場合、アダプティブ広告はアプリケーションウィンドウの幅いっぱいに広がります
builder.inlineMaximumHeight = height // オプション:値を設定しない場合、最大高さは画面の高さになります
}
let adView = MAAdView(adUnitIdentifier: "«ad-unit-ID»", adFormat: MAAdFormat.mrec, configuration: config)
adView.delegate = context.coordinator
// アダプティブMRECが完全に機能するように背景色を設定します
adView.backgroundColor = «background-color»
// 最初の広告をロードします
adView.loadAd()
return adView
}
⋮
}
struct ExampleSwiftUIInlineAdaptiveMRecAdView: View
{
// インライン型アダプティブMRECのカスタム幅(ポイント単位)を設定します。設定しない場合は、UIScreen.main.bounds.widthを使用して画面幅いっぱいに広げます
let width = 400
// インライン型アダプティブMRECの最大高さ(ポイント単位)を設定します。設定しない場合は、標準のMRECの高さである250ポイントが使用されます
// Googleは50ポイントを超える高さを推奨しており、最小値は32ポイント、最大値は画面の高さと同じです
// また、この値はMAAdViewの高さを超えてはなりません
let height = 300
var body: some View {
ExampleSwiftUIWrapper(width: width, height: height)
.frame(width: width, height: height)
}
}
ロードされたアダプティブ広告は、リクエストしたサイズよりも小さくなる場合があります。 配信されたアダプティブ広告 of サイズに基づいてUIを適応させたい場合があります。 その場合、以下のようなコードを使用して、ロードされた広告の幅と高さをポイント単位で取得できます。
- (void)didLoadAd:(MAAd *)ad
{
CGSize adViewSize = ad.size;
CGFloat width = adViewSize.width;
CGFloat height = adViewSize.height;
⋮
}
func didLoad(_ ad: MAAd)
{
let adViewSize = ad.size
let width = adViewSize.width
let height = adViewSize.height
⋮
}
func didLoad(_ ad: MAAd)
{
let adViewSize = ad.size
let width = adViewSize.width
let height = adViewSize.height
⋮
}
広告の自動更新(auto-refresh)を停止したい場合があります。 たとえば、banner広告を非表示にする場合や、手動で更新したい場合などです。 bannerまたはMREC広告の自動更新を停止するには、以下のコードを使用します。
// stopAutoRefresh()の呼び出しが無視されるSDKのバグを回避するため、このカスタムパラメータを設定します
[adView setExtraParameterForKey: @"allow_pause_auto_refresh_immediately" value: @"true"];
[adView stopAutoRefresh];
// stopAutoRefresh()の呼び出しが無視されるSDKのバグを回避するため、このカスタムパラメータを設定します
adView.setExtraParameterForKey("allow_pause_auto_refresh_immediately", value: "true")
adView.stopAutoRefresh()
// stopAutoRefresh()の呼び出しが無視されるSDKのバグを回避するため、このカスタムパラメータを設定します
adView.setExtraParameterForKey("allow_pause_auto_refresh_immediately", value: "true")
adView.stopAutoRefresh()
bannerまたはMREC広告の自動更新を開始するには、以下の呼び出しを行います。
[adView startAutoRefresh];
adView.startAutoRefresh()
adView.startAutoRefresh()
以下の呼び出しにより、手動でコンテンツを更新します。
loadAd() を呼び出す前に、自動更新を停止する必要があります。
[adView loadAd];
adView.loadAd()
adView.loadAd()