Unity Ads 実装ガイド
このガイドでは、Unity LevelPlay で Unity Ads をアドネットワークとして配信するための設定方法を説明します。
Unity Ads ネットワークでは、ステップ 1 を完了すると自動セットアップツールを使用できるようになります。自動セットアップツールはアプリケーションと Bidder プレースメントを作成し、Unity Ads からプレースメントの詳細を取得します。LevelPlay と Unity Ads の管理画面を行ったり来たりする必要はありません。あるいは、セットアップ全体を手動で行うこともできます。
- Unity Ads は Android OS バージョン 4.4 (API レベル 19) 以降をサポートします。
- Unity Ads SDK 4.7.1 以降ではコンパイル SDK バージョン 33 以降、Kotlin バージョン 1.7.0 以降の設定が必要です。
ステップ 1. Unity Ads を設定する
Unity Ads を設定する前に、次の手順を完了してください:
- Unity ID の作成
- Unity Gaming Services に登録します。 「 Get started for free 」を選択します。
ステップ 2. Unity Ads でプロジェクトを作成する
Unity Ads でアプリを作成するには、次の手順に従ってください:
アプリの作成
- Unity Monetization ダッシュボードで、「 Projects 」を選択します。ダッシュボードの操作の詳細については、「 Introduction to the Unity Dashboard 」を参照してください。
- 「 Organization 」と「 Projects 」を選択します。
- 「 Create project 」をクリックします。
- プロジェクト名と COPPA 指定を入力します。
- 「 Create project 」をクリックします。
プロジェクトをマネタイズするには、ダッシュボードで Unity Ads を有効にする必要があります。 Monetization ダッシュボード > セカンダリナビゲーションメニューから「 Get started 」を選択します。
プロジェクト用に Unity Ads を初期化するときは、メディエーションプロバイダーを選択する必要があります。 まず「 I plan to use Mediation 」を選択します。次に、「 Choose your Mediation Partner 」で、「 Unity LevelPlay 」を選択します。
広告ユニットの作成
広告ユニットを使用して、広告コンテンツをトリガーするイベントをゲーム内に表示します:
- 左のナビメニューから Monetization > Ad Units を選択します。
- 「 Add Ad Unit 」をクリックし、モーダルを表示します。
- 広告ユニット名を入力し、プラットフォーム (iOS または Android) と広告フォーマット (Rewarded、Interstitial、またはBanner) を選択します。
- 「 Create 」をクリックして広告ユニットを保存します。
プレースメントを追加する
プロジェクトが作成されたら、Monetization > Placements に移動し、両方のプラットフォームの Game ID をメモします。
新しいプレースメントを作成するには、「 Add Placement 」ボタンをクリックします。
Note:Unity Ads はプロジェクトを作成するときに「デフォルト」プレースメントを自動作成しますが、メディエーション設定ごとに固有のプレースメントを新しく作成することをお勧めします。
ステップ 3. 設定情報を取得する
LevelPlay でのセットアップを完了するには、Unity Ads プラットフォームから以下を取得する必要があります:
- API Key
- Organization core ID
- Key ID
- Secret key
Set up > API Management へ移動し、「 API Key 」をメモします。
次に、「 Organization Settings 」に移動し、「 Organization core ID 」をメモします。
Key ID と Secret Key を取得するには、Monetization > API Management へ移動します。 「 Create LevelPlay Service Account 」ボタンをクリックすると、Key ID と Secret Key を含むモーダルが表示されます。このモーダルを閉じると Secret Key を再度取得できなくなるため、必ず Secret Key を保存してください。
ステップ 4. LevelPlay 上で Unity Ads を設定する
これらのパラメータをすべて取得したら、LevelPlay アカウントにログインします。
- Mediation ➣ Setup ➣ SDK Networks へ移動します。
- Available Networks から Unity Ads を選択します。
- Unity Ads の API Key と Organizational Core ID をそれぞれ入力します。
- 自動セットアップ機能を有効にするには、Unity Ads 自動セットアップツールをオンに切り替えます。これにより、Unity Ads プラットフォーム上でアプリケーションと Bidder プレースメントを自動的に作成し、LevelPlay が Unity Ads からプレースメントの詳細を取得できるようになります。
- 自動セットアップツールを有効に切り替えたら、ステップ 3 で取得した Key ID と Secret Key を入力し、「 Save 」をクリックします。
ステップ 5. アプリレベルで Unity Ads をセットアップする
Non-Bidder セットアップ
- SDK Networks ページ左側のリストから実装したいアプリを選択します。
- 広告ユニットの行で、「 Setup 」をクリックし、関連する広告ユニット設定の下に Game ID と Placement ID を入力します。
Bidder 設定
LevelPlay で Unity Ads Bidder を設定するには 2 つの方法があります:
- 自動セットアップ – 新しいアプリケーションと bidder プレースメントが自動的に作成され、必要なすべての設定情報が Unity Monetize から取得されます。
- 手動 – LevelPlay プラットフォームと Unity Monetize プラットフォームの両方の管理画面を行き来して必要な情報を取得し、入力します。
自動セットアップ
- Unity Ads からのインタースティシャル、動画リワード、またはバナーを配信するアプリを選択します。次に、Unity Ads 行の「 Setup 」ボタンまたは「編集」アイコンをクリックします。
- 「 Add bidder 」 ボタンをクリックすると、Unity Ads プラットフォーム上に新しいアプリと Bidding プレースメントが自動的に作成され、Game ID、Placement ID がインポートされます。アプリに既に Game ID がアタッチされている場合でも、Placement ID が設定されていないプレースメントが少なくとも 1 つあれば、自動セットアップツールを使用できます。この場合、新しい Bidding プレースメントが作成されます ( Game ID 挿入用)。
「 Save 」をクリックしてすべての設定を承認します。保存せずにモジュールを閉じると、アセットは Unity Adsプラットフォーム上に作成されますが、データは LevelPlay プラットフォームにインポートされません。
Important: Unity Ads bidder インスタンスのステータスは、広告ユニットごとに ironSource Ads bidder のステータスと同じになります。たとえば、動画リワードに ironSource Ads bidder を使用していない場合、Unity Ads bidder は有効になりません。動画リワードの Unity Ads bidder インスタンスを有効にするには、「 Unity Ads 」行をクリックし広告ユニットごとのトグルスイッチを有効にします。
手動セットアップ
- Unity Ads からのインタースティシャル、動画リワード、またはバナーを配信するアプリを選択します。
- Unity Ads 行の「 Setup 」ボタンまたは「編集」アイコンをクリックし、Game ID と Placement ID をそれぞれ入力します。
- 「 Save 」をクリックします。
これで、アカウント内で選択した広告ユニットに対して Unity Ads が有効になっていることが確認できます。
ステップ 6. Unity Ads アダプターをビルドに追加する
Unity Network Manager(推奨)
SDK の実装が完了すると、Unity Network Manager を使用して Mintegral アダプターをダウンロードできます。
Unity 開発プラットフォームで、Ads Mediation > Network Manager へ移動します。
すでに最新バージョンのアダプターが実装されている場合は、アクションボタンが「 Updated 」に変更され、無効になります。
Android (Manual Resolve)
変更を適用するには、必ず「 Resolve 」プロセスを使用してください。これにより、選択されたネットワークに関連するすべてのアーティファクトがダウンロードされます。詳細については、こちらの手順を参照してください。
ProGuard ユーザーのみ (Android)
Mintegral アダプターで ProGuard を使用している場合は、次のコードを ProGuard 設定ファイルに追加する必要があります:
# Keep filenames and line numbers for stack traces
-keepattributes SourceFile,LineNumberTable
# Keep JavascriptInterface for WebView bridge
-keepattributes JavascriptInterface
# Sometimes keepattributes is not enough to keep annotations
-keep class android.webkit.JavascriptInterface {
*;
}
# Keep all classes in Unity Ads package
-keep class com.unity3d.ads.** {
*;
}
# Keep all classes in Unity Services package
-keep class com.unity3d.services.** {
*;
}
-dontwarn com.google.ar.core.**
-dontwarn com.unity3d.services.**
-dontwarn com.ironsource.adapters.unityads.**
iOS Property List ファイル (Info.plist) を更新
Unity Ads SDK 3.4.8 以降では、アプリの Property List ファイル (Info.plist) に Unity Ads 広告ネットワーク ID を含める必要があります。Unity Ads SKAdNetwork ID についての詳細はこちら。
Android プラグイン手動実装
- Unity Ads アダプターをダウンロード:
こちらからアダプターと SDK をダウンロードします。 - Unity Ads ファイルを Unity プロジェクトに追加:
アダプターファイルを Assets/Plugins/Android にインポートします。
Unity バージョン 5.5 の変更に対応するために、ironSource プラグイン バージョン 6.7.1 では、プラグインとメディエーションアダプター用に Android マニフェストを個別に追加する必要があります。プラグインを更新している場合、または現在 6.7.1 で実行している場合は、Android ドキュメントに記載されているマニフェストアクティビティを必ず追加してください。
iOS プラグイン手動実装
- Unity Ads iOS アダプターと SDK をダウンロード:
こちらからアダプターと SDK をダウンロードします。 - Unity Ads アダプターファイルを Unity プロジェクトに追加:
アダプターと SDK ファイルを Assets/Plugins/Android にインポートします。
必要なフレームワークは Unity プラグインによって Xcode プロジェクトに自動的に追加されます。
ステップ 7. Unity Ads の追加設定
ユーザーレベルの COPPA
Unity LevelPlay を使用すると、パブリッシャーは Unity Ads ユーザーレベルの COPPA 設定を Unity Ads ネットワークに直接通信できます。この機能は、ironSource SDK 7.1.12 以降、Unity Ads Adapter 4.3.15 以降でサポートされます。
次の構文を使用して、Unity Ads user.nonBehavioral フラグに値「 true 」を設定します:
IronSource.Agent.setMetaData("UnityAds_coppa","true");
次の構文を使用して、Unity Ads user.nonBehavioral フラグに値「 false 」を設定します:
IronSource.Agent.setMetaData("UnityAds_coppa","false");
- Integration Helper を使用して広告ネットワークの実装を確認できます。 ironSource SDK は、SDK とネットワークアダプターを正しく実装するためのツールを提供しています。
- この関数のブール値を使用して、実装されたメディエーションアドネットワークのデバッグログを管理します。
IronSource.Agent.setAdaptersDebug(true);
「 TRUE 」に設定するとデバッグログが有効になり、デバッグ機能を許可しているすべてのメディエーションアドネットワークのトラブルシューティングに役立ちます。広告を実装したアプリを公開する前に、必ずこのコードを削除してください。この機能は、SDK バージョン 6.5.2 以降でサポートされています。
完了!
これで、アプリで Unity Ads 広告を配信する準備が完了しました。
Unity LevelPlay でさらに他のアドネットワークを活用するには、アダプターを実装し、ガイドに従って設定してください。