Unity での SDK の初期化
Unity Ads SDK をゲーム ID で初期化して、収益化を有効にし、Unity プロジェクトで Unity Ads パブリック API にアクセスします。
読み終わるまでの所要時間 2 分最終更新 23日前
重要
SDK の初期化の前または中に、ユーザー同意を設定する必要があります。同意設定なしで広告を配信すると、一部の地域ではプライバシー規制に違反する可能性があります。
SDK を初期化するには、該当するプラットフォーム用のプロジェクトのゲーム ID を参照する必要があります。ゲーム ID を確認するには、Unity Ads の Monetization (収益化) ダッシュボード で Monetization (収益化) スイートを選択し、現在のプロジェクトに移動した後、セカンダリナビゲーションバーで Settings (設定) を選択して、Game IDs (ゲーム ID) セクションまでスクロールします。
注
2026 年 4 月 1 日より、Advertisement Legacy パッケージを介した直接インテグレーションによって Unity Ads で収益化するアプリケーションでは、広告のパフォーマンスが低下する可能性があります。パフォーマンスの削減を回避するには、Unity Adsを入札者として統合する方式に切り替えます。
Unity Ads ネットワークは、直接インテグレーションを使用するすべてのアプリケーションのサポートと提供を継続します。ただし、収益とパフォーマンスを最大化するために推奨されるベストプラクティスは、Unityの広告メディエーションプラットフォームであるLevelPlay用のAds Mediationパッケージをインストールすることです。
ゲームスクリプトのヘッダーに 名前空間を含めます。ゲームのランタイムライフサイクルの初期、できればローンチ時に、 関数を使用してSDKを初期化します。SDK バージョン 3.7.0 以降では、 コールバックを使用して初期化完了時の通知を受け取ったり、エラー発生時に詳細を受け取ったりできます。
UnityEngine.AdvertisementsInitializeIUnityAdsInitializationListenerSDK 初期化の例
using UnityEngine;using UnityEngine.Advertisements;public class AdsInitializer : MonoBehaviour, IUnityAdsInitializationListener{ [SerializeField] string _androidGameId; [SerializeField] string _iOSGameId; [SerializeField] bool _testMode = true; private string _gameId; void Awake() { InitializeAds(); } public void InitializeAds() { #if UNITY_IOS _gameId = _iOSGameId; #elif UNITY_ANDROID _gameId = _androidGameId; #elif UNITY_EDITOR _gameId = _androidGameId; //Only for testing the functionality in the Editor #endif if (!Advertisement.isInitialized && Advertisement.isSupported) { Advertisement.Initialize(_gameId, _testMode, this); } } public void OnInitializationComplete() { Debug.Log("Unity Ads initialization complete."); } public void OnInitializationFailed(UnityAdsInitializationError error, string message) { Debug.Log($"Unity Ads Initialization Failed: {error.ToString()} - {message}"); }}
次のステップ: インテグレーションを継続するには、Unity でのインタースティシャル広告の実装 に関するドキュメントを参照してください。