ドキュメント

​
​

Development

User Acquisition

Monetization

産業

LevelPlay SDK - Unity

Unity SDK

Android SDK

iOS SDK

Adobe AIR SDK

Flutter SDK

React Native SDK

LevelPlay SDK - Unity

Unity LevelPlay
​
​
Unity SDK
  • 使用の準備
    • Unity の使用の準備
    • Unity パッケージインテグレーション
      • Migrate to 9.0.0+
      • Migrate to LevelPlay Init API
      • Maven Central migration guide
      • Migrate from Unity Ads to LevelPlay
    • Unity 開発者ツール
    • Unity向け広告品質SDKの統合
    • カスタムアダプター
    • LevelPlay SDK 変更履歴
  • 規制と設定
  • Ad formats (広告フォーマット)
  • メディエーションネットワーク
  • インテグレーションのテスト
  1. ゲームの成長
  3. Unity LevelPlay
  5. LevelPlay SDK
  7. Unity 開発者向け LevelPlay SDK

Unity Ads から LevelPlay への移行

Advertisement Legacyパッケージを使用したUnity Ads SDKの直接インテグレーションから、Ads Mediationパッケージを使用したLevelPlayインテグレーションに移行します。
読み終わるまでの所要時間 19 分
最終更新 6日前
注
2026 年 4 月 1 日より、Advertisement Legacy パッケージを介した直接インテグレーションによって Unity Ads で収益化するアプリケーションでは、広告のパフォーマンスが低下する可能性があります。パフォーマンスの削減を回避するには、Unity Adsを入札者として統合する方式に切り替えます。
Unity Ads ネットワークは、直接インテグレーションを使用するすべてのアプリケーションのサポートと提供を継続します。ただし、収益とパフォーマンスを最大化するために推奨されるベストプラクティスは、Unityの広告メディエーションプラットフォームであるLevelPlay用のAds Mediationパッケージをインストールすることです。
このガイドでは、Unity Ads SDK の直接インテグレーションから LevelPlay SDK インテグレーションにプロジェクトを遷移する方法を、一般的なユースケースの API マッピングを含めて説明します。詳細については、LevelPlay インテグレーションガイドを参照してください。LevelPlay に移行する主な手順については、以下の表を参照してください。

トピック

説明

広告メディエーションへの移行古い機能の Unity Ads から LevelPlay にプロジェクトを遷移します。
マップ API と更新コード古い機能初期化、バナー、インタースティシャル、およびリワード型広告呼び出しを、LevelPlay と同等の機能に置き換えます。
テストと検証オプションで、LevelPlay Test Suite とビルトインインテグレーション検証ツールを使用して新しいインテグレーションを検証します。
API と特徴マッピング リファレンス古い機能の Unity Ads 関数とパラメータが対応する LevelPlay オプションにどのようにマップされるかを確認します。
古い機能パッケージの削除Advertisement Legacy パッケージをアンインストールし、プロジェクトに残っている依存関係を解決します。
重要
LevelPlay を Advertisement Legacy パッケージを使用しているプロジェクトにインストールすると、そのプロジェクトが正しく機能しない場合があります。API を LevelPlay にマッピングした後に古い機能パッケージを削除する必要があります。
注
移行プロセスは、Unity Package Manager (UPM) を通じて Advertisement Legacy パッケージがインストールされた Unity プロジェクトにのみ関連します。

前提条件

LevelPlay ダッシュボードにアクセスできることを確認します。

Ads Mediation に移行

古い機能の Unity Ads インテグレーションを LevelPlay に置き換えるには、次の手順に従います。

LevelPlay パッケージをインストールする

Unity Package Manager を使用して LevelPlay パッケージをインストールするには、次の手順に従います。
  1. Unity エディターで、Window (ウィンドウ) > Package Manager (パッケージマネージャー) に移動します。
  2. Packages (パッケージ):Unity Registry (パッケージ: Unity Registry) を選択します。
  3. Ads Mediation を検索します。
  4. 最新バージョンの Install (インストール) を選択します。

依存関係の設定

LevelPlay では、Android および iOS ライブラリを管理するために、モバイル依存関係リゾルバや Unity 外部依存関係マネージャー (EDM4U) などの依存関係解決ツールが必要です。
依存関係解決ツールがプロジェクトにインストールされていることを確認します。プロジェクトに依存関係解決ツールがすでに含まれている場合は、それを維持します。LevelPlay のインストール後にモバイル依存関係リゾルバのインストールを求めるプロンプトが表示されたら、Yes を選択します。

LevelPlay ダッシュボードの設定

LevelPlay ダッシュボード を設定して、アプリケーションを登録してメディエーションに必要な広告ユニットを作成します。
  1. LevelPlay ダッシュボードにログインします。
  2. Add App (アプリケーションの追加) を選択し、プロンプトに従ってアプリケーションを登録します。
  3. 広告ユニットに移動し、管理するアプリケーションを選択します。
  4. 広告ユニット（バナー、インタースティシャル、またはリワード）を作成します。広告ユニットの詳細については、広告ユニットの管理 のドキュメントを参照してください。
注
広告単位を作成すると、ダッシュボードに各広告の状態、名前、広告単位ID、広告形式が表示されます。広告単位情報には、広告単位にリンクされているネットワークとメディエーショングループの数も表示されます。インスタンス設定とメディエーション管理ページにアクセスするネットワークまたはグループの数を選択できます。
  1. LevelPlay ダッシュボードの Apps (アプリ) ページで、アプリケーションキーと広告単位 ID を見つけて保存します。これらは、API をマップするために必要です。

マップ API と更新コード

既存の 
Advertisement
クラス呼び出しを対応する 
LevelPlay
メソッドに置き換えます。古い機能の Unity Ads SDK とは異なり、LevelPlay では広告ユニットのインスタンスを作成する必要があります。広告ユニットは、任意の設定パラメーターを持つ再利用可能なインスタンスです。以下のサンプルを参照してSDKを初期化し、バナー広告、インタースティシャル広告、およびリワード広告を実装します。

LevelPlay SDK の初期化

LevelPlay SDK は、ゲーム ID の代わりに アプリケーション キー を使用します。イベントリスナーを登録し、SDK を初期化するには、以下のサンプルを参照してください。
注
広告オブジェクトを作成する前に
OnInitSuccess
コールバックを受信します。
LevelPlay.OnInitSuccess += SdkInitializationCompletedEvent;LevelPlay.OnInitFailed += SdkInitializationFailedEvent;LevelPlay.Init("YOUR_APPKEY");void SdkInitializationCompletedEvent(LevelPlayConfiguration config){    Debug.Log($"[LevelPlaySample] Received SdkInitializationCompletedEvent with Config: {config}");}void SdkInitializationFailedEvent(LevelPlayInitError error){    Debug.Log($"[LevelPlaySample] Received SdkInitializationFailedEvent with Error: {error}");	}

バナー広告の実装

バナー広告を実装するには、以下のサンプルを参照してください。
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("YOUR_BANNER_AD_UNIT_ID", 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) {}}

インタースティシャル広告の実装

インタースティシャル広告を実装するには、以下のサンプルを参照してください。
public class InterstitialAdSample {    private LevelPlayInterstitialAd interstitialAd;        void CreateInterstitialAd() {        // Create InterstitialAd instance        interstitialAd = new LevelPlayInterstitialAd("YOUR_INTERSTITIAL_AD_UNIT_ID");        // Subscribe InterstitialAd events        interstitialAd.OnAdLoaded += InterstitialOnAdLoadedEvent;        interstitialAd.OnAdLoadFailed += InterstitialOnAdLoadFailedEvent;        interstitialAd.OnAdDisplayed += InterstitialOnAdDisplayedEvent;        interstitialAd.OnAdDisplayFailed += InterstitialOnAdDisplayFailedEvent;        interstitialAd.OnAdClicked += InterstitialOnAdClickedEvent;        interstitialAd.OnAdClosed += InterstitialOnAdClosedEvent;        interstitialAd.OnAdInfoChanged += InterstitialOnAdInfoChangedEvent;    }        void LoadInterstitialAd() {        // Load or reload InterstitialAd        interstitialAd.LoadAd();    }        void ShowInterstitialAd() {        // Show InterstitialAd, check if the ad is ready before showing        if (interstitialAd.IsAdReady()) {            interstitialAd.ShowAd();        }    }        void DestroyInterstitialAd() {        // Destroy InterstitialAd        interstitialAd.DestroyAd();    }        // Implement InterstitialAd events    void InterstitialOnAdLoadedEvent(LevelPlayAdInfo adInfo) { }    void InterstitialOnAdLoadFailedEvent(LevelPlayAdError error) { }    void InterstitialOnAdClickedEvent(LevelPlayAdInfo adInfo) { }    void InterstitialOnAdDisplayedEvent(LevelPlayAdInfo adInfo) { }    void InterstitialOnAdDisplayFailedEvent(LevelPlayAdInfo adInfo, LevelPlayAdError error) { }    void InterstitialOnAdClosedEvent(LevelPlayAdInfo adInfo) { }    void InterstitialOnAdInfoChangedEvent(LevelPlayAdInfo adInfo) { }}

リワード広告

リワード広告を実装するには、以下のサンプルを参照してください。
public class LevelPlaySample : MonoBehaviour{    private LevelPlayRewardedAd rewardedAd;        void CreateRewardedAd()    {        rewardedAd = new LevelPlayRewardedAd("YOUR_REWARDED_AD_UNIT_ID");        rewardedAd.OnAdLoaded += OnAdLoaded;        rewardedAd.OnAdLoadFailed += OnAdLoadFailed;        rewardedAd.OnAdDisplayed += OnAdDisplayed;        rewardedAd.OnAdDisplayFailed += OnAdDisplayFailed;        rewardedAd.OnAdRewarded += OnAdRewarded;        rewardedAd.OnAdClicked += OnAdClicked;        rewardedAd.OnAdClosed += OnAdClosed;        rewardedAd.OnAdInfoChanged += OnAdInfoChanged;    }        void LoadRewardedAd()    {        rewardedAd.LoadAd();    }        void ShowRewardedAd(string placementName = null)    {        if (rewardedAd.IsAdReady() && !LevelPlayRewardedAd.IsPlacementCapped(placementName))        {            rewardedAd.ShowAd(placementName);        }    }        bool CheckIfRewardedAdIsReady()    {        return rewardedAd.IsAdReady();    }        bool CheckIfPlacementIsCapped(string placementName)    {        return LevelPlayRewardedAd.IsPlacementCapped(placementName);    }        void OnAdLoaded(LevelPlayAdInfo adInfo)    {        Debug.Log($"Rewarded ad loaded with ad info {adInfo}");    }        void OnAdLoadFailed(LevelPlayAdError adError)    {        Debug.Log($"Rewarded ad failed to load with ad error {adError}");    }       void OnAdDisplayed(LevelPlayAdInfo adInfo)    {        Debug.Log($"Rewarded ad displayed with ad info {adInfo}");    }           void OnAdDisplayFailed(LevelPlayAdDisplayInfoError adInfoError)    {        Debug.Log($"Rewarded ad failed to display with ad info and error {adInfoError}");    }        void OnAdRewarded(LevelPlayAdInfo adInfo, LevelPlayReward adReward)    {        Debug.Log($"Rewarded ad gained reward with adInfo {adInfo} and reward {adReward}");    }        void OnAdClicked(LevelPlayAdInfo adInfo)    {        Debug.Log($"Rewarded ad clicked with ad info {adInfo}");    }        void OnAdClosed(LevelPlayAdInfo adInfo)    {        Debug.Log($"Rewarded ad closed with ad info {adInfo}");    }        void OnAdInfoChanged(LevelPlayAdInfo adInfo)    {        Debug.Log($"Rewarded ad info changed with ad info {adInfo}");    }    }

テストと検証

インテグレーションを検証するには、アプリケーションをビルドし、検証テストを実行します。

ビルドとテスト

Android または iOS 用のアプリケーションをビルドしてインテグレーションをテストします。LevelPlay ダッシュボードで無効にするまで、アプリケーションはテストモードのままです。

テストスイートの起動 (任意)

LevelPlay インテグレーションテストスイートを使用して、各広告ネットワークが正しく設定されていることを確認します。
アプリケーションでテストスイートを有効にするには、初期化を設定する前に 
setMetaData
API を呼び出します。
LevelPlay.SetMetaData("is_test_suite", "enable");
コールコールバックが成功したら、テストスイートを起動します。
LevelPlayEvents.onSdkInitializationCompletedEvent += SdkInitializationCompletedEvent;private void SdkInitializationCompletedEvent(){    ...    //Launch test suite    LevelPlay.LaunchTestSuite();}

インテグレーションの検証

以下の API を呼び出して、パッケージと依存関係の内部チェックを実行します。
LevelPlay.ValidateIntegration();

古い機能パッケージの削除

すべての広告が正しく機能し、プロジェクトに古い機能の広告 API がないことを確認したら、次のステップに従って Advertisement Legacy パッケージを削除します。
  1. Unity エディターで、Window (ウィンドウ) > Package Manager (パッケージマネージャー) に移動します。
  2. Packages (パッケージ):プロジェクト内。
  3. Advertisement Legacy を見つけて選択します。
  4. Remove (削除) を選択します。

API と特徴マッピング リファレンス

以下の表に、古い機能の Unity Ads SDK API パラメータを LevelPlay API パラメータにマップします。

ユースケース

Unity Ads APIパラメーター

LevelPlay パラメーター

ノート

初期化 ID
gameId
appKey
Android と iOS の両方に適用可能
SDK の初期化
Advertisement.Initialize(_gameId, _testMode, this);
LevelPlay.Init(appKey);
LevelPlay はテストモードをサポートしていません
初期化成功イベント
IUnityAdsInitializationListener.OnInitializationComplete()
LevelPlay.OnInitSuccess
Init failed イベント
IUnityAdsInitializationListener.OnInitializationFailed(error, message)
LevelPlay.OnInitFailed
初期化されています
Advertisement.isInitialized
サポートされていませんLevelPlay ではサポートされていません
メタデータの設定
Advertisement.SetMetaData(metaData)
LevelPlay.SetMetaData(key, value)
ロードバナー
Advertisement.Banner.Load(adUnitId, BannerLoadOptions)
bannerAd.LoadAd();
インスタンスを作成する必要がある
バナーのディスプレイ
Advertisement.Banner.Show(adUnitId, BannerOptions)
bannerAd.ShowAd()
インスタンスを作成する必要がある
バナー位置の設定
Advertisement.Banner.SetPosition(BannerPosition.BOTTOM_CENTER)
LevelPlayBannerAd bannerAd = new LevelPlayBannerAd(adUnitId, LevelPlayAdSize.BANNER, LevelPlayBannerPosition.TopLeft);
コンストラクターまたはビルダーで渡されるユースケース
バナーのロードオプション
BannerLoadOptions { loadCallback, errorCallback }
bannerAd.OnAdLoaded

および
bannerAd.OnAdLoadFailed
バナーオプション
BannerOptions { clickCallback, hideCallback, showCallback }
bannerAd.OnAdDisplayed

および
bannerAd.OnAdDisplayFailed

および
bannerAd.OnAdClicked

および
bannerAd.OnAdCollapsed

および
bannerAd.OnAdLeftApplication

および
bannerAd.OnAdExpanded
オプションを表示
Advertisement.Show(...)
の
ShowOptions { resultCallback }
bannerAd.OnAdDisplayed

および
bannerAd.OnAdDisplayFailed

および
bannerAd.OnAdClicked

および
bannerAd.OnAdCollapsed

および
bannerAd.OnAdLeftApplication

および
bannerAd.OnAdExpanded
非表示バナー
Advertisement.Banner.Hide()
bannerAd.HideAd()
インスタンスを作成する必要がある
バナークリック
BannerOptions.clickCallback
bannerAd.OnAdClicked
インスタンスのイベントコールバック
バナー表示
BannerOptions.showCallback
bannerAd.OnAdDisplayed
インスタンスのイベントコールバック
バナー非表示
BannerOptions.hideCallback
サポートされていません
リワード型広告のロード
Advertisement.Load(adUnitId, IUnityAdsLoadListener)
rewardedAd.LoadAd();
インスタンスを作成する必要があります
リワード広告の表示
Advertisement.Show(adUnitId, IUnityAdsShowListener)
rewardedAd.ShowAd();
インスタンスを作成する必要があります
ロード インタースティシャル
Advertisement.Load(adUnitId, IUnityAdsLoadListener)
interstitialAd.LoadAd();
インスタンスを作成する必要がある
インタースティシャルを表示
Advertisement.Show(adUnitId, IUnityAdsShowListener)
interstitialAd.ShowAd();
インスタンスを作成する必要がある
Ad loaded (ロードされた広告)
IUnityAdsLoadListener.OnUnityAdsAdLoaded(adUnitId)
interstitialAd.OnAdLoaded

または
rewardedAd.OnAdLoaded
インスタンスのイベントコールバック
広告のロードに失敗しました
IUnityAdsLoadListener.OnUnityAdsFailedToLoad(adUnitId, error, message)
interstitialAd.OnAdLoaded

または
rewardedAd.OnAdLoaded
インスタンスのイベントコールバック
広告の表示に失敗しました
IUnityAdsShowListener.OnUnityAdsShowFailure(adUnitId, error, message)
interstitialAd.OnAdDisplayFailed

または
rewardedAd.OnAdDisplayFailed
インスタンスのイベントコールバック
広告表示開始
IUnityAdsShowListener.OnUnityAdsShowStart(adUnitId)
interstitialAd.OnAdDisplayed

または
rewardedAd.OnAdDisplayFailed
インスタンスのイベントコールバック
広告表示のクリック
IUnityAdsShowListener.OnUnityAdsShowClick(adUnitId)
interstitialAd.OnAdClicked

または
rewardedAd.OnAdDisplayFailed
インスタンスのイベントコールバック
広告表示が完了しました
IUnityAdsShowListener.OnUnityAdsShowComplete(adUnitId, completionState)
interstitialAd.OnAdClosed

または
rewardedAd.OnAdDisplayFailed
インスタンスのイベントコールバック
サポートされている
Advertisement.isSupported
サポートされていませんLevelPlay ではサポートされていません
デバッグモード
Advertisement.debugMode = true
サポートされていませんLevelPlay ではサポートされていません
パッケージバージョン
Advertisement.version
LevelPlay.PluginVersion
表示中
Advertisement.isShowing
サポートされていませんLevelPlay ではサポートされていません
Copyright © 2026 Unity Technologies
法規事項プライバシーポリシークッキーDocumentation Terms of Use私の個人情報を販売または共有しないプライバシーに関する選択 (クッキー設定)

"Unity" の名称、Unity のロゴ、およびその他の Unity の商標は、米国およびその他の国における Unity Technologies またはその関係会社の商標または登録商標です (詳しくはこちら)。その他の名称またはブランドは該当する所有者の商標です。

一部のページは利便性向上のため機械翻訳を使用しており、内容に不正確な表現が含まれる場合があります。内容に齟齬または不一致が生じた場合は、英語版を正本とします。

  • このページ

    • 前提条件

    • Ads Mediation に移行

      • LevelPlay パッケージをインストールする

      • 依存関係の設定

      • LevelPlay ダッシュボードの設定

    • マップ API と更新コード

      • LevelPlay SDK の初期化

      • バナー広告の実装

      • インタースティシャル広告の実装

      • リワード広告

    • テストと検証

      • ビルドとテスト

      • テストスイートの起動 (任意)

      • インテグレーションの検証

    • 古い機能パッケージの削除

    • API と特徴マッピング リファレンス

このページの問題を報告する