ドキュメント

LevelPlay SDK - iOS

Unity SDK

Android SDK

iOS SDK

Adobe AIR SDK

Flutter SDK

React Native SDK

LevelPlay SDK - iOS

iOS 用バナーインテグレーション

iOS アプリケーションにバナー広告を実装するには、バナー広告オブジェクトを作成し、そのサイズを設定し、アプリケーションのビュー階層内に表示します。
読み終わるまでの所要時間 13 分最終更新 1ヶ月前
バナーはシステムによって開始される長方形の広告で、静的またはアニメーションにすることができ、ライブアコンテンツ定されたエリアで配信されます。
注
このドキュメントは 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
largeSizeLarge バナー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 をアプリケーションに統合する方法を示します。
iOSデモアプリケーションのダウンロード
インテグレーションテストスイートとのインテグレーションを確認します。

次のステップ

インテグレーションガイドに従って、追加のバナー広告ネットワークのインテグレーションや追加の広告フォーマットの設定を行います。