Unity 向けバナーインテグレーション
SDKの初期化、初期化後のバナー広告オブジェクトの作成、適切な広告サイズと位置の設定によって、Unityにバナー広告を統合します。
読み終わるまでの所要時間 13 分最終更新 6日前
バナーは、システムによって開始される長方形の広告で、静的またはアニメーションにすることができ、ライブアコンテンツ定されたエリアに配信されます。
注
このドキュメントは、SDK 8.4.0 以降（ベータ版の API）に関するものです。
前提条件
- LevelPlay SDK がアプリケーションに正しく統合されていることを確認します。インテグレーションの概要はこちらです。
- LevelPlay 初期化 API を使用して SDK を初期化していることを確認します。
- LevelPlay ダッシュボードで AdUnitID を見つけます。詳細については、こちらを参照してください。
バナー広告オブジェクトの作成、サイズと位置の設定
バナー広告オブジェクトの作成は、OnInitSuccess コールバックの受信後に行う必要があります。
// Create the banner object and set the ad unit id LevelPlayBannerAd bannerAd = new LevelPlayBannerAd(bannerAdUnitId);
注： コンストラクターは、任意の パラメーターもサポートしています。
LevelPlayBannerAdConfig// Use optional Config parameterLevelPlayBannerAd(string adUnitId, Config config = null)
特別な設定が必要ない場合は、パラメーターを省略してのみを渡すことができます。バナーはデフォルト属性で作成されます。
ConfigadUnitId属性 | デフォルト |
|---|---|
| サイズ | Banner |
| 位置 | BottomCenter |
| displayOnLoad | true |
| respectSafeArea | false (Android のみ) |
バナーパラメータをカスタマイズするには、 Builder を使用します。
Configvar configBuilder = new LevelPlayBannerAd.Config.Builder();configBuilder.SetSize(LevelPlayAdSize.LARGE);configBuilder.SetPosition(LevelPlayBannerPosition.TopCenter);configBuilder.SetDisplayOnLoad(true);configBuilder.SetRespectSafeArea(true); // Only relevant for AndroidconfigBuilder.SetPlacementName("bannerPlacement");configBuilder.SetBidFloor(1.0); // Minimum bid price in USDvar bannerConfig = configBuilder.Build();bannerAd = new LevelPlayBannerAd(bannerAdUnitId, bannerConfig);
バナーサイズ
LevelPlayAdSize | 説明 | 寸法 (dp) (幅 X 高さ) |
|---|---|---|
| バナー | 標準バナー | 320×50 |
| 大規模 | Large バナー | 320 x 90 |
| MEDIUM_RECTANGLE | 中矩形 (MREC) | 300 x 250 |
| 適応型 | 広告を自動的にレンダリングして、モバイルおよびタブレットのサイズと向きを調整 | デバイスの幅 X 推奨の高高さ |
広告サイズを作成するには、以下のいずれかのオプションに従います。
画面幅に合わせて調整できる適応型広告サイズ（推奨）：
このオプションは、デバイス タイプに応じてバナーまたは LeaderBOARD を返します。適応特徴をサポートするネットワーク (Google、Yandex) は、最適化ロジックに基づいて高ささを返します。
- LevelPlay SDK 8.8.0 以降では、バナーをロードする前に以下の使用して返される適応型バナーの幅と高ささを決定できます。
LevelPlayAdSize adSize = LevelPlayAdSize.CreateAdaptiveAdSize();int width = adSize.Width;int height = adSize.Height;
- 8.8.0 未満の LevelPlay SDK の場合:
LevelPlayAdSize adSize = LevelPlayAdSize.CreateAdaptiveAdSize();
**特定のバナーサイズ：**このオプションでは、特定のバナーサイズを設定できます。バナー、LARGE、MEDIUM＿矩形。
LevelPlayAdSize adSize = LevelPlayAdSize.BANNER;
バナー位置
画面にバナーを表示するデフォルト位置は BottomCenter です。以下は、サポートされているすべてのポジションの完全なリストです。
- TopLeft
- TopCenter
- TopRight
- CenterLeft
- 中央
- CenterRight
- BottomLeft
- BottomCenter
- BottomRight
LevelPlayBannerAd bannerAd = new LevelPlayBannerAd(adUnitId, LevelPlayAdSize.BANNER, LevelPlayBannerPosition.TopLeft);
また、dp で定義された x および y 値を持つ オブジェクトを作成して、画面上の特定の （x， y） 座標にバナーを配置することもできます。
LevelPlayBannerPositionLevelPlayBannerPosition position = new LevelPlayBannerPosition(new Vector2(x, y));LevelPlayBannerAd bannerAd = new LevelPlayBannerAd(adUnitId, adSize, position, placementName, displayOnLoad, respectSafeArea);
Placements
バナーのプレースメントは、レポートの目的でのみサポートされます。リロードされたすべての広告に影響を与えるように、の前に設定する必要があります。
LoadAd// Set the placement nameLevelPlayBannerAd bannerAd = new LevelPlayBannerAd("bannerAdUnitId", LevelPlayAdSize.BANNER, placementName:"placementName");
バナーイベントの実装
コード内の イベントをリッスンします。SDK は、以下にリストされているすべての可能なイベントを通知します。
LevelPlayBannerAd- バナー広告をロードする前にリスナーを設定することをお勧めします。
- バナー広告ごとに独自のリスナーを実装する必要があります。
- コールバックはメインスレッドで実行されます。
// 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 eventsvoid BannerOnAdLoadedEvent(LevelPlayAdInfo adInfo) {}void BannerOnAdLoadFailedEvent(LevelPlayAdError ironSourceError) {}void BannerOnAdClickedEvent(LevelPlayAdInfo adInfo) {}void BannerOnAdDisplayedEvent(LevelPlayAdInfo adInfo) {}void BannerOnAdDisplayFailedEvent(LevelPlayAdInfo adInfo, LevelPlayAdError error) {}void BannerOnAdCollapsedEvent(LevelPlayAdInfo adInfo) {}void BannerOnAdLeftApplicationEvent(LevelPlayAdInfo adInfo) {}void BannerOnAdExpandedEvent(LevelPlayAdInfo adInfo) {}
LevelPlay 広告情報
LevelPlayAdInfoロードバナー広告
バナー広告をロードするには、 を使用します。
LoadAdbannerAd.LoadAd();
バナー更新の一時停止と再開
プラットフォームで更新値が定義されている場合は、コードのバナー更新を一時停止できます。バナー広告の自動更新を停止するか、一時停止後に再度有効にするには、以下の方法を使用します。
注
バナーが再度表示されると、バナーが一時停止されてから更新までの時間が完了します。
// Pause refreshbannerAd.PauseAutoRefresh();// Resume refreshbannerAd.ResumeAutoRefresh();
bannerAd.HideAd();
バナーの非表示と表示
バナーコンストラクターの一部として、バナーを背景でロードし、必要な場合にのみ画面に表示することができます。ロード後の広告の可視性をコントロールするには、次の API を使用できます。
注
広告が非表示の場合、自動更新がオンになっている限り、背景グラウンドで更新が継続されます。
// Show ad bannerAd.ShowAd(); // Hide ad bannerAd.HideAd();
ディスプレイアウト (Android のみ)
Android デバイスのディスディスプレイアウトは、カメラ、センサー、スピーカーなどの必須コンポーネントのために予約済みされた領域です。一般的に、スマートフォンや端ィスプレイを備えたデバイスで使用されます。この切り抜きによってゲームビューが制限され、画面上のバナーの配置に影響が及ぶ可能性があります。バナー広告と表示されるカットアウトが重複しないようにするには、を作成し、を true に設定します。
LevelPlayBannerAdrespectSafeAreaGoogleのディスプレイカットアウトソリューションの詳細については、こちらを参照してください。
Android カットアウトをサポートするには、 を使用してバナーオブジェクトを作成し、 respectSafeArea の値を true に設定します （デフォルト値は false）。
Configvar configBuilder = new LevelPlayBannerAd.Config.Builder();configBuilder.SetRespectSafeArea(true); // Only relevant for Androidvar bannerConfig = configBuilder.Build();bannerAd = new LevelPlayBannerAd(bannerAdUnitId, bannerConfig);
バナー広告の破棄
バナーを破棄するには、 メソッドを呼び出します。
DestroyAd破棄されたバナーは再度表示できなくなります。さらに広告をディスプレイするには、新しい オブジェクトを作成します。
LevelPlayBannerAdbannerAd.DestroyAd();
バナー広告の完全な実装例
適応型バナーサイズを使用してバナー広告を作成およびロードする例を示します。
public class BannerAdSample { private LevelPlayBannerAd bannerAd; void CreateBannerAd() { // Create ad configuration - optional var adConfig = new LevelPlayBannerAd.Config.Builder() .SetSize(LevelPlayAdSize.BANNER) .SetPlacementName("placementName") .SetPosition(LevelPlayBannerPosition.BottomCenter) .SetDisplayOnLoad(true) .SetRespectSafeArea(true) .Build(); // Create banner instance bannerAd = new LevelPlayBannerAd("bannerAdUnitId", adConfig); // 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; } public void LoadBannerAd() { //Load the banner ad bannerAd.LoadAd(); } public 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(); } public void HideBannerAd() { //Hide banner bannerAd.HideAd(); } public void DestroyBannerAd() { //Destroy banner bannerAd.DestroyAd(); } //Implement BannerAd Events public void BannerOnAdLoadedEvent(LevelPlayAdInfo adInfo) {} public void BannerOnAdLoadFailedEvent(LevelPlayAdError ironSourceError) {} public void BannerOnAdClickedEvent(LevelPlayAdInfo adInfo) {} public void BannerOnAdDisplayedEvent(LevelPlayAdInfo adInfo) {} public void BannerOnAdDisplayFailedEvent(LevelPlayAdInfo adInfo, LevelPlayAdError error){} public void BannerOnAdCollapsedEvent(LevelPlayAdInfo adInfo) {} public void BannerOnAdLeftApplicationEvent(LevelPlayAdInfo adInfo) {} public void BannerOnAdExpandedEvent(LevelPlayAdInfo adInfo) {}}
LevelPlay Mediation デモアプリケーション
インテグレーション Demo (インテグレーションデモ) アプリケーションは、バナー広告単位 API をアプリケーションに統合する方法を示します。
これで、アプリケーションでバナーを使用できるようになりました。インテグレーションテストスイートとのインテグレーションを確認します。
エディター内でインテグレーションをテストできます。Unity エディターで模擬広告をプレビューする方法については、プレビュー模擬広告ガイドを参照してください。
次のステップとは?
インテグレーションガイドに従って、追加のバナー広告ネットワークのインテグレーションや追加の広告フォーマットの設定を行います。