iOS 用バナーインテグレーション
iOS アプリケーションにバナー広告を実装するには、バナー広告オブジェクトを作成し、そのサイズを設定し、アプリケーションのビュー階層内に表示します。
読み終わるまでの所要時間 13 分最終更新 7日前
バナーはシステムによって開始される長方形の広告で、静的またはアニメーションにすることができ、ライブアコンテンツ定されたエリアで配信されます。
注
このドキュメントは SDK 8.4.0 以降に関連するものです。
前提条件
- LevelPlay SDK がアプリケーションに正しく統合されていることを確認します。インテグレーションの概要はこちらです。
- LevelPlay 初期化 API を使用して SDK を初期化してください。
- LevelPlay ダッシュボードで AdUnitID を見つけます。
バナー広告オブジェクトの作成とサイズの設定
バナー広告オブジェクトの作成は、onInitSuccess コールバックの受信後に行う必要があります。
// 広告設定の作成 - 任意LPMBannerAdViewConfigBuilder *adConfigBuilder = [LPMBannerAdViewConfigBuilder new];[adConfigBuilder setWithAdSize:bannerSize];[adConfigBuilder setWithPlacementName:@"placementName"];LPMBannerAdViewConfig *adConfig = [adConfigBuilder build];// バナービューの作成と広告単位 ID の設定self.bannerAd = [[LPMBannerAdView alloc] initWithAdUnitId:@"adUnitId" config: adConfig];
バナーサイズ
LPMAdSize | 説明 | 寸法 (dp) (幅 X 高さ) |
|---|---|---|
| bannerSize | 標準バナー | 320×50 |
| largeSize | Large バナー | 320 x 90 |
| mediumRectangleSize | 中矩形 (MREC) | 300 x 250 |
| 適応型 | 広告を自動的にレンダリングして、モバイルおよびタブレットのサイズと向きを調整 | デバイスの幅 X 推奨の高高さ |
広告サイズを作成するには、以下のいずれかのオプションに従います。
画面幅に合わせて調整できる適応型広告サイズ（推奨）
このオプションは、デバイス タイプに応じてバナーまたは LeaderBOARD を返します。適応特徴をサポートするネットワーク (Google、Yandex) は、最適化ロジックに基づいて高ささを返します。
LPMAdSize *bannerSize = [LPMAdSize createAdaptiveAdSize];[self.bannerAdView setAdSize: bannerSize];
特定のバナーサイズ
このオプションでは、バナーサイズを明確に設定できます。バナー、LARGE、MEDIUM＿矩形。
LPMAdSize *bannerSize = [LPMAdSize createAdaptiveAdSize];[self.bannerAdView setAdSize: bannerSize];
Placements
バナーのプレースメントは、レポートの目的でのみサポートされます。プレースメントは**、loadAd** の前に設定して、リロードされたすべての広告に影響を与える必要があります。
// 配置名を設定します[self.bannerAdView setPlacementName:@"PlacementName"];
バナーデリゲートの設定
コードに LPMBannerAdViewDelegate を実装して、広告の配信を通知します。
- バナー広告をロードする前にデリゲートを設定することをお勧めします。
- バナー広告ビューごとに、独自のデリゲート実装が必要です。
- コールバックはメインスレッドで実行されます。
- コールバックがすべてのネットワークでサポートされていない場合は、任意としてマークされます。
// デリゲート実装の設定 [self.bannerAdView setDelegate:self];#pragma mark - LPMBannerAdViewDelegate- (void)didLoadAdWithAdInfo:(nonnull LPMAdInfo *)adInfo {//広告が正常にロードされました}- (void)didFailToLoadAdWithAdUnitId:(nonnull NSString *)adUnitId error:(nonnull NSError *)error { // 広告ロード失敗}- (void)didClickAdWithAdInfo:(LPMAdInfo *)adInfo {// 広告がクリックされました}- (void)didDisplayAdWithAdInfo:(LPMAdInfo *)adInfo {// 広告が画面に表示されました}- (void)didFailToDisplayAdWithAdInfo:(LPMAdInfo *)adInfo error:(NSError *)error {// Optional.Ad failed to be displayed on screen(画面に広告を表示できませんでした)}- (void)didLeaveAppWithAdInfo:(LPMAdInfo *)adInfo {// Optional.ユーザーが広告をクリックし、アプリケーション外に移動した }- (void)didExpandAdWithAdInfo:(LPMAdInfo *)adInfo {// Optional.広告が全画面で開かれる}- (void)didCollapseAdWithAdInfo:(LPMAdInfo *)adInfo {// Optional.広告が元のサイズに復元される}
LevelPlay 広告情報
LPMAdInfo パラメーターには、ロードされた広告に関する情報が含まれます。実装と使用可能なフィールドの詳細については、こちらを参照してください。
ロードバナー広告
バナー広告をロードするには、loadAd を使用します。
// バナー広告のロード[self.bannerAdView loadAdWithViewController:self]
バナー更新の一時停止と再開
プラットフォームで更新値が定義されている場合は、コードのバナー更新を一時停止できます。バナー広告の自動更新を停止するか、一時停止後に再度有効にするには、以下の方法を使用します。
注
バナーが再度表示されると、バナーが一時停止されてから更新までの時間が完了します。
- pauseAutoRefresh - バナー広告の自動更新を一時停止します。
- resumeAutoRefresh - バナー広告が一時停止された後、自動更新を再開します。
// 更新一時停止[self.bannerAdView pauseAutoRefresh]; // 更新を再開[self.bannerAdView resumeAutoRefresh];
バナー広告の破棄
バナーを破棄するには、 destroy メソッドを呼び出します。
破棄されたバナーは再度表示できなくなります。さらに広告を表示するには、新しい LPMBannerAdView オブジェクトを作成します。
[self.bannerAdView destroy];
バナー広告の完全な実装例
適応型バナーサイズを使用してバナー広告を作成およびロードする例を示します。
NS_ASSUME_NONNULL_BEGIN@interface BannerAdViewController () <LPMBannerAdViewDelegate>@property(nonatomic, strong) LPMBannerAdView *bannerAd;@end@implementation BannerAdViewController- (void)dealloc {[self.bannerAd destroy];}- (void)createBannerAd {LPMAdSize *bannerSize = [self getBannerSize] ?: [LPMAdSize mediumRectangleSize];// 広告設定の作成 - 任意LPMBannerAdViewConfigBuilder *adConfigBuilder = [LPMBannerAdViewConfigBuilder new];[adConfigBuilder setWithAdSize:bannerSize];[adConfigBuilder setWithPlacementName:@"placementName"];LPMBannerAdViewConfig *adConfig = [adConfigBuilder build];// バナービューの作成と広告単位 ID の設定self.bannerAd = [[LPMBannerAdView alloc] initWithAdUnitId:@"adUnitId" config: adConfig];// Set the delegate implementation[self.bannerAd setDelegate:self];// Add the banner view to the view hierarchy with the proper constraints[self addBannerViewWithSize:bannerSize];}- (LPMAdSize *)getBannerSize {// 1.推奨 - 画面幅に合わせて調整する適応型広告サイズLPMAdSize *bannerSize = [LPMAdSize createAdaptiveAdSize];// 2.固定幅広告サイズを使用した適応型広告サイズ// self.bannerSize = [LPMAdSize createAdaptiveAdSizeWithWidth:400];// 3.特定のバナーサイズ - BANNER、LARGE、MEDIUM_RECTangle// self.bannerSize = [LPMAdSize mediumRectangleSize];return bannerSize;}- (void)loadBannerAd {[self.bannerAd loadAdWithViewController:self];}- (void)addBannerViewWithSize:(LPMAdSize *)bannerSize {self.bannerAd.translatesAutoresizingMaskIntoConstraints = NO;// Add the banner view to the view hierarchy[self.view addSubview:self.bannerAd];[NSLayoutConstraint activateConstraints:@[ [self.bannerAd.bottomAnchor constraintEqualToAnchor:self.view.safeAreaLayoutGuide.bottomAnchor], [self.bannerAd.centerXAnchor constraintEqualToAnchor:self.view.centerXAnchor], [self.bannerAd.widthAnchor constraintEqualToConstant:bannerSize.width], [self.bannerAd.heightAnchor constraintEqualToConstant:bannerSize.height]]];}#pragma mark - LPMBannerAdViewDelegate- (void)didLoadAdWithAdInfo:(nonnull LPMAdInfo *)adInfo {}- (void)didFailToLoadAdWithAdUnitId:(nonnull NSString *)adUnitId error:(nonnull NSError *)error {}- (void)didClickAdWithAdInfo:(LPMAdInfo *)adInfo {}- (void)didDisplayAdWithAdInfo:(LPMAdInfo *)adInfo {}- (void)didFailToDisplayAdWithAdInfo:(LPMAdInfo *)adInfo error:(NSError *)error {}- (void)didLeaveAppWithAdInfo:(LPMAdInfo *)adInfo {}- (void)didExpandAdWithAdInfo:(LPMAdInfo *)adInfo {}- (void)didCollapseAdWithAdInfo:(LPMAdInfo *)adInfo {}@endNS_ASSUME_NONNULL_END
LevelPlay Mediation デモアプリケーション
インテグレーション Demo (インテグレーションデモ) アプリケーションは、バナー広告単位 API をアプリケーションに統合する方法を示します。
インテグレーションテストスイートとのインテグレーションを確認します。
次のステップ
インテグレーションガイドに従って、追加のバナー広告ネットワークのインテグレーションや追加の広告フォーマットの設定を行います。