Unity パッケージインテグレーション
LevelPlay Unity プラグインをダウンロードしてプロジェクトに統合し、広告メディエーションと Monetization の機能を有効にします。
読み終わるまでの所要時間 15 分最終更新 6日前
注
LevelPlay Unity パッケージは、Unity エディターがサポートする LTS バージョン、Android オペレーティングシステムのバージョン 4.4 (API レベル 19) 以上をサポートします。iOS バージョンサポートはネットワークごとに定義されます。LevelPlay メディエーションは、iOS バージョン 13 以降と Xcode バージョン 16 以降をサポートします。
ヒント
AI 支援インテグレーション (ベータ): Claude コードおよびその他の AI コーディング エージェント向けの LevelPlay Unity インテグレーション スキルでは、LevelPlay 設定のステップバイステップのガイダンスを提供します。まず、Unity スキル リポジトリからインストールし、エージェントでアクティベートします。このスキルは現在ベータ版であり、フィードバックによって形作られます。アンケートにお答えしてご意見をお聞かせください。
ステップ 1. Unity プロジェクトに LevelPlay を追加する
注
LevelPlay Unity パッケージの以前のバージョンからバージョン 9.0.0 以上にアップグレードする場合は、代わりに このガイド に従ってください。
LevelPlay パッケージは、次のようにインストールできます。
- **推奨:**Unity でウィンドウ> Package Manager を選択して、Ads Mediation パッケージをプロジェクトに追加します。外観が「Ads Mediation」の場合は、インストール ボタンを選択します。パッケージの名前 でも追加できます。
com.unity.services.levelplay - または、Unity プラグインバージョン 9.5.0 (.unitypackage) をダウンロードし、Unity プロジェクトにインポートします。
いったんインストールビルトインのサンプルで LevelPlay の実用的なインテグレーションを探るし、試すことができます。Package Manager のパッケージ詳細ビューで、Samples (サンプル) に移動し、LevelPlay サンプルをインポートして調査を開始します。
ステップ 2. SDK を初期化する
LevelPlay プラットフォームをまだ作成していない場合は、そのプラットフォームに移動し、新しいアプリケーションを作成します。完了したら、アプリケーション キー を使用して SDK を初期化します。
- **名前空間のインポート：**C# スクリプトの先頭に、名前空間 を含めます。
using Unity.Services.LevelPlay; - **SDK を初期化します。**開始（） メソッド内で、イベントリスナーを登録し、SDK を初期化します。
public void Start() { // Register OnInitFailed and OnInitSuccess listeners LevelPlay.OnInitSuccess += SdkInitializationCompletedEvent; LevelPlay.OnInitFailed += SdkInitializationFailedEvent; // SDK init LevelPlay.Init("ThisIsYourAppKey");}
LevelPlay を初期化する前に OnInitFailed と OnInitSuccess を登録することが重要です。これらは重要な知見を提供します。
OnInitSuccess – LevelPlay が正常に初期化されたときにトリガーされます。このコールバックバックを受け取った後、アプリケーションで広告の表示を開始できます。
OnInitFailed – LevelPlay が初期化に失敗したため広告が表示できない場合にトリガーされます。後で LevelPlay の初期化を試してみることをお勧めします (インターネット接続が利用可能なとき、または失敗の理由が解決されたとき)。
UserID の設定
LevelPlay の初期化時にユーザー ID を渡すことができます。これは、広告品質のユーザージャーニーを使用しようとしている場合や、サーバー間のコールバックを使用してユーザーに報酬を与える場合に便利です。
LevelPlay.Init("ThisIsYourAppKey", "UserId");
ステップ 3. LevelPlay ネットワークマネージャ
LevelPlay ネットワークマネージャウィンドウは、LevelPlay に関するすべての機能を停止できます。Unityの上部のナビゲーション バーのAds Mediationの下にあります。ここから、以下を行うことができます。
- LevelPlay SDK の更新。
- 希望する広告ネットワークをインストールおよび更新します。インストールしたら、各広告ネットワークを個別に設定する必要があります。詳細
- インストールされている広告ネットワークに応じて、アプリケーションのInfo.plistがSKAdNetwork IDで自動的に更新されます。
LevelPlay Unity パッケージ 8.8.1 から、Ironsource Ads に加えて Unity Ads アダプタがデフォルトでインストールされます。Unity Ads アカウントの設定の詳細については、『 Unity Ads インテグレーションガイド 』を参照してください。
Android
変更を適用し、関連する広告ネットワークアーティファクトをダウンロードするには、リゾルバを使用する必要があります。これには、以下を選択します。Assets (アセット) > Mobile Dependency Manager (モバイル依存関係マネージャー) > Android Resolver (Android リゾルバー) > Resolve (解決)
これは、LevelPlay ネットワーク マネージャで各変更後に行う必要があります。
Gradle を使用している場合は、ネットワークアーティファクトをプロジェクトにダウンロードすることを避けることができます。代わりに、アーティファクトはコンパイル中に Gradle ファイルに追加されます。
注
Unity パッケージ 8.10.0 以降でモバイル依存関係リゾルバをインポートした場合は、自動的に行われます。
このプロセスを有効にするには、以下の手順に従います。
- これには、以下を選択します。編集> プロジェクト設定> プレイヤー> Android> 公開設定
- カスタム Main Gradle テンプレートを有効にする
- これには、以下を選択します。Assets (アセット) > Mobile Dependency Manager (モバイル依存関係マネージャー) > Android Resolver (Android リゾルバー) > Settings (設定) の順に選択します。
- “パッチ mainTemplate.gradle” を選択します。
- 「OK」を押して変更を保存します
ステップ 4. 追加設定
iOS
SKAdNetworkサポート
注
Unity パッケージのバージョン 9.1.0 以上の新規インストールを実行した場合、LevelPlay は自動的にこれを管理します。バージョン 8.8.1-9.0.1 では、ステップ 3 で説明されているように、この特徴は ネットワーク Manager で有効にできます。8.10.0 以前のバージョンでは、Ads Mediation (広告メディエーション) > 開発者 Settings (開発者設定) > LevelPlay Mediation Settings (LevelPlay メディエーション設定) で LevelPlay SDK SKAN ID の自動化も有効にする必要があります。
SKAdNetwork ID の自動化が無効になっている場合は、SDK 7 以降の使用中に広告のディスプレイを有効にするには、アプリケーションのリスト(Info.plist) にインストール済みネットワークごとの SKAdNetwork ID を手動で含める必要があります。
<key>SKAdNetworkItems</key><array> <dict> <key>SKAdNetworkIdentifier</key> <string>su67r6k2v3.skadnetwork</string> </dict></array>
アプリケーション転送のセキュリティ設定
- 「NSAppTransportSecurity」というディクショナリを追加します。'Top Level キー' にこのディクショナリを必ず追加してください。
- このディクショナリ内に、「NSAllowsArbitraryLoads」というブーリアンを追加し、「YES」に設定します。
- 競合が発生する可能性があるため、info.plistに「NSAllowsArbitraryLoads」以外の例外が含まれていないことを確認してください。
- ATS の詳細については、こちらを参照してください。
重要
Appleのプライバシー要件に準拠するには、SKAdNetworkアトリビューション(Unityパッケージ9.1.0時点で自動マネージ)とiOSのプライバシーマニフェストを実装する必要があります。LevelPlay は両方をサポートしています。詳細は こちら を参照してください。
重要
アプリケーションに関連するプライバシーメソッドを実装する必要があります。詳細はこちらを参照してください。
Android
Android 13 以降 (API レベル 33 以降) を使用するアプリケーションは、マニフェストファイルで次のように Google 再生サービスの法線パーミッションを宣言する必要があります。
<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
Google Advertising ID の変更については、こちらを参照してください。
ステップ 5.インテグレーションの確認
LevelPlay パッケージは、インテグレーションテストスイートを使用してインテグレーションが正常に完了したことを簡単に検証する方法を提供します。アプリケーションのインテグレーションのテスト、プラットフォーム設定の確認、および設定されたネットワークに関連する広告のレビューを行います。
アプリケーションでテストスイートを有効にするには、SDK を初期化する前に以下の呼び出します。
LevelPlay.SetMetaData("is_test_suite", "enable");
LevelPlay が正常に初期化されたら、以下を呼び出してテストスイートを起動します。
LevelPlay.LaunchTestSuite();
LevelPlay インテグレーションテストスイートの詳細と実装例については、この記事を操作してください。
次のステップ
LevelPlay の設定が完了し、使用の準備ができました。インテグレーション ガイドに従って広告フォーマットを実装します。