Unity のバナーインテグレーション

バナーは、静止画またはアニメーションを表示できる長方形のシステム主導広告であり、ライブアプリコンテンツの周囲の指定された領域に配信されます。

バナー広告オブジェクトを作成し、サイズとポジションを設定する

バナー広告ユニットを作成し、バナーサイズを設定します。バナーオブジェクトの作成は、OnInitSuccess コールバックを正常に受信した後に行う必要があります。

bannerAd = new LevelPlayBannerAd(bannerAdUnitId);

バナーサイズ

次のいずれかのオプションに従って広告サイズを作成します：

画面の幅に合わせて調整されるアダプティブ広告サイズ (推奨):

このオプションは、デバイスタイプに応じて BANNER または LEADERBOARD を返します。
アダプティブ機能をサポートするネットワーク (Google、Yandex) は、最適化ロジックに基づいて高さを返します。

• LevelPlay SDK 8.8.0 以降では、バナーを読み込む前に、次のようにして返されるアダプティブバナーの幅と高さを決定できます。

LevelPlayAdSize adSize = LevelPlayAdSize.CreateAdaptiveAdSize();
int width = adSize.Width;
int height = adSize.Height;

• LevelPlay SDK 8.8.0 以前:

LevelPlayAdSize adSize = LevelPlayAdSize.CreateAdaptiveAdSize();

特定のバナーサイズ：
このオプションを使用すると、バナーサイズ (BANNER、LARGE、MEDIUM_RECTANGLE) を指定できます。

LevelPlayAdSize adSize =LevelPlayAdSize.BANNER;

バナーポジション

スクリーンに表示されるバナーのデフォルトポジションは BottomCenter です。以下はサポートされるポジションのリストです：

• TopLeft
• TopCenter
• TopRight
• CenterLeft
• Center
• CenterRight
• BottomLeft
• BottomCenter
• BottomRight

bannerAd = new LevelPlayBannerAd(adUnitId, LevelPlayAdSize.BANNER
, LevelPlayBannerPosition.TopLeft);

また、x 値と y 値を dp で定義して LevelPlayBannerPosition オブジェクトを作成することにより、画面上の特定の (x, y) 座標にバナーを配置することもできます。

LevelPlayBannerPosition position = New LevelPlayBannerPosition(new Vector2(x, y));
bannerAd = new LevelPlayBannerAd(adUnitId, adSize, position, placementName, displayOnLoad, respectSafeArea);

Placement

プレースメントはレポートに使用されるオプションです。すべてのリロードに設定を反映させるには、ロード前に設定する必要があります。

// Set the placement name
LevelPlayBannerAd bannerAd = new LevelPlayBannerAd("bannerAdUnitId", LevelPlayAdSize.BANNER, placementName:"placementName");

バナーイベントを実装する

次に、コード内の LevelPlayBannerAd イベントをリッスンします。 SDK は、以下にリストされているイベントを通知します。

• バナー広告のロード前にリスナーを設定することをお勧めします。
• 各バナー広告にリスナー実装が必要であることに注意してください。
• LevelPlayAdInfo がバナーコールバックの一部として返されます。詳細はこちら。

// Register to the events 
bannerAd.OnAdLoaded += BannerOnAdLoadedEvent;
bannerAd.OnAdLoadFailed += BannerOnAdLoadFailedEvent;
bannerAd.OnAdDisplayed += BannerOnAdDisplayedEvent;
bannerAd.OnAdDisplayFailed += BannerOnAdDisplayFailedEvent;
bannerAd.OnAdClicked += BannerOnAdClickedEvent;
bannerAd.OnAdCollapsed += BannerOnAdCollapsedEvent;
bannerAd.OnAdLeftApplication += BannerOnAdLeftApplicationEvent;
bannerAd.OnAdExpanded += BannerOnAdExpandedEvent;

// Implement the events
void BannerOnAdLoadedEvent(LevelPlayAdInfo adInfo) {}
void BannerOnAdLoadFailedEvent(LevelPlayAdError ironSourceError) {}
void BannerOnAdClickedEvent(LevelPlayAdInfo adInfo) {}
void BannerOnAdDisplayedEvent(LevelPlayAdInfo adInfo) {}
void BannerOnAdDisplayFailedEvent(LevelPlayAdDisplayInfoError adInfoError) {}
void BannerOnAdCollapsedEvent(LevelPlayAdInfo adInfo) {}
void BannerOnAdLeftApplicationEvent(LevelPlayAdInfo adInfo) {}
void BannerOnAdExpandedEvent(LevelPlayAdInfo adInfo) {}

LevelPlay Ad Info

バナー広告をロードする

バナー広告をロードするには、LoadAd を呼びます。

bannerAd.LoadAd();

バナーの更新を一時停止および再開する

プラットフォームでリフレッシュレートが定義されている場合は、コードでバナーのリフレッシュを一時停止できます。バナー広告の自動リフレッシュを一時停止・再開するには、次の方法を使用します。

• pauseAutoRefresh – バナーの自動リフレッシュを一時停止
• resumeAutoRefresh – 一時停止されたバナーの自動リフレッシュを再開

// Pause refresh
bannerAd.PauseAutoRefresh();
// Resume refresh
bannerAd.ResumeAutoRefresh();

バナーの表示・非表示

バナーコンストラクタの一部として、バナーをバックグラウンドでロードし、任意の画面上で表示することが可能です。ロード後の広告の表示を制御するには、次の API を使用します。

• ShowAd – バナー表示
• HideAd – バナー非表示

// show ad 
bannerAd.ShowAd(); 
// hide ad 
bannerAd.HideAd();

ディスプレイのカットアウトをサポート（ Android のみ）

Android デバイスのディスプレイカットアウトは、カメラ、センサー、スピーカーなどの必須コンポーネント用に確保された指定領域で、スマートフォンやエッジトゥエッジディスプレイを備えたデバイスで一般的に使用されます。このカットアウトによりゲームのビューが制限される可能性があり、画面上のバナーの配置に影響を与える可能性があります。LevelPlayBannerAd を作成し、respectSafeArea を設定することで、バナー広告とカットアウトの重なりを避けることができます。
ディスプレイカットアウトに関する Google のソリューションの詳細については、こちらをご覧ください。

Android カットアウトをサポートするには：

1. デフォルトバナーサイズを設定
2. LevelPlayBannerAd オブジェクトを作成し、respectSafeArea を true で呼び出し（デフォルト値は false ）

bannerAd = new LevelPlayBannerAd(bannerAdUnitId, respectSafeArea:true);

バナー広告を破棄する

バナーを破棄するには、destroy() メソッドを呼びます。破棄されたバナーはロードできなくなります。もう一度提供したい場合は、新しい LevelPlayBannerAd オブジェクトを作成する必要があります。

bannerAd.DestroyAd();

広告の作成とロードの実装例

以下に、アダプティブバナーサイズを使用してバナー広告を作成してロードする例を紹介します。

public class BannerAdSample {
    private LevelPlayBannerAd bannerAd;
    void CreateBannerAd() {
        // Create banner instance
        bannerAd = new LevelPlayBannerAd("bannerAdUnitId");
        // Subscribe BannerAd events
        bannerAd.OnAdLoaded += BannerOnAdLoadedEvent;
        bannerAd.OnAdLoadFailed += BannerOnAdLoadFailedEvent;
        bannerAd.OnAdDisplayed += BannerOnAdDisplayedEvent;
        bannerAd.OnAdDisplayFailed += BannerOnAdDisplayFailedEvent;
        bannerAd.OnAdClicked += BannerOnAdClickedEvent;
        bannerAd.OnAdCollapsed += BannerOnAdCollapsedEvent;
        bannerAd.OnAdLeftApplication += BannerOnAdLeftApplicationEvent;
        bannerAd.OnAdExpanded += BannerOnAdExpandedEvent;
    }
    void LoadBannerAd() {
        // Load the banner ad 
        bannerAd.LoadAd();
    }
    void ShowBannerAd() {
        // Show the banner ad, call this method only if you turned off the auto show when you created this banner instance.
        bannerAd.ShowAd();
    }
    void HideBannerAd() {
        // Hide banner
        bannerAd.HideAd();
    }
    void DestroyBannerAd() {
        // Destroy banner
        bannerAd.DestroyAd();
    }
    // Implement BannerAd Events
    void BannerOnAdLoadedEvent(LevelPlayAdInfo adInfo) {}
    void BannerOnAdLoadFailedEvent(LevelPlayAdError ironSourceError) {}
    void BannerOnAdClickedEvent(LevelPlayAdInfo adInfo) {}
    void BannerOnAdDisplayedEvent(LevelPlayAdInfo adInfo) {}
    void BannerOnAdDisplayFailedEvent(LevelPlayAdDisplayInfoError adInfoError) {}
    void BannerOnAdCollapsedEvent(LevelPlayAdInfo adInfo) {}
    void BannerOnAdLeftApplicationEvent(LevelPlayAdInfo adInfo) {}
    void BannerOnAdExpandedEvent(LevelPlayAdInfo adInfo) {}
}

LevelPlay メディエーションデモアプリ

実装デモアプリでは、バナー広告ユニット API をアプリに実装する方法を確認できます。

Unity デモアプリダウンロード

完了！
これで、アプリケーションでバナーを配信するように設定されました。Test Suite を使用してインテグレーションを確認します。

次のステップは？
インテグレーションガイドに従って、追加の広告ユニットを実装します。

• メディエーションネットワークの追加
• 動画リワード
• インタースティシャル