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

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

Before you start

• ironSource SDK がアプリケーションに正しく実装されていることを確認してください。実装の概要はこちら。
• LevelPlay Initialization API を使用して SDK を初期化してください。
• AdUnitID は LevelPlay ダッシュボードで確認できます。詳細はこちら。
• このドキュメントは SDK 8.4.0+ (Beta API) に対応するものです。レガシーバナー API (SDK 8.4.0 以前) のドキュメントはこちら。

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

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

bannerAd = new LevelPlayBannerAd(bannerAdUnitId);
Light theme
Dark theme
Copy to clipboard

バナーサイズ

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

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

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

LevelPlayAdSize adSize = LevelPlayAdSize.CreateAdaptiveAdSize();
Light theme
Dark theme
Copy to clipboard

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

LevelPlayAdSize adSize =LevelPlayAdSize.BANNER;
Light theme
Dark theme
Copy to clipboard

Placement

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

// Set the placement name
LevelPlayBannerAd bannerAd = new LevelPlayBannerAd("bannerAdUnitId", LevelPlayAdSize.BANNER, placementName:"placementName");
Light theme
Dark theme
Copy to clipboard

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

次に、コード内の 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) {}
Light theme
Dark theme
Copy to clipboard

LevelPlay Ad Info

バナー広告をロードする

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

bannerAd.LoadAd();
Light theme
Dark theme
Copy to clipboard

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

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

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

// Pause refresh
bannerAd.PauseAutoRefresh();
// Resume refresh
bannerAd.ResumeAutoRefresh();
Light theme
Dark theme
Copy to clipboard

バナーの表示・非表示

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

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

// show ad 
bannerAd.ShowAd(); 
// hide ad 
bannerAd.HideAd();
Light theme
Dark theme
Copy to clipboard

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

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

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

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

bannerAd = new LevelPlayBannerAd(bannerAdUnitId, respectSafeArea:true);
Light theme
Dark theme
Copy to clipboard

バナー広告を破棄する

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

bannerAd.DestroyAd();
Light theme
Dark theme
Copy to clipboard

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

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

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) {}
}
Light theme
Dark theme
Copy to clipboard

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

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

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

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

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

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