はじめに
要件
Vungle Unity プラグインは Unity エディター バージョン 2017 以降をサポートし、次の Vungle SDK バージョンが含まれています。
iOS SDK v6.8.0
- iOS 9 以降
Android SDK v6.8.0
- Android 4.0 (Ice Cream Sandwich - API バージョン 14 以降)
- Amazon OS 5.4 以降
- Android には Java 1.7 以降が必要です
Windows SDK v6.8.0
- Windows 10 UWP および Universal 8.1
プラグインをダウンロードする
Unity 用 Vungle プラグインを、https://publisher.vungle.com/sdk/plugins/unity からダウンロードします。
参照: サンプル アプリ
統合の際には、以下で提供されているサンプル アプリを参照してください (https://github.com/Vungle/Unity-Plugin)
手順 1. Vungle Unity プラグインで Unity プロジェクトを設定する
Vungle Unity プラグインを Unity プロジェクトに追加する
Unity でプロジェクトを開いて、ダウンロードした VunglePlugin.unitypackage ファイルをダブルクリックして Vungle Unity プラグインをアプリケーションに追加します。[Import Unity Package] ウィンドウが開いたら、インポートする前に [All] をクリックしてすべての項目を選択します。
ビルド設定で正しいプラットフォームをターゲットにする
次の手順でコンパイル エラーが発生しないように、プロジェクトのビルド設定 (Cmd + Shift + B) で、iOS、Android、またはユニバーサル Windows プラットフォームがターゲットとして指定されていることを確認してください。
Amazon Appstore
Vungle Android SDK では Amazon OS 5.4 以降がサポートされます。Unity Amazon Appstore 構成を追加設定した後、Android APK を Amazon Appstore に送信できます。詳しくは、「Unity に関する説明」を参照してください。
Google Play Services
プロジェクトに Google Play Services を追加すると、さらにカスタマイズされた広告体験を Vungle からエンド ユーザーに提供できるようになります。ただし、必須ではありません。バージョン 16.0.0 以降の使用を推奨します。
Google Play 開発者サービスをプロジェクトに追加する際に、開発者ポータルで Google のセットアップ ガイドを参照することをお勧めします。お使いのアプリで、新しいバージョンの Google Play 開発者サービスがインストールされていることを確認してください。
Android の依存関係
Android 用 Vungle SDK では、ビルドに以下の依存関係のいずれかを含める必要があります。依存関係を手動で追加するか、Gradle を使用している場合は Gradle テンプレートに含めるようにします。
implementation 'androidx.appcompat:appcompat:1.2.0'
// When appcompat is not used, core and localbroadcastmanager can be used instead
// implementation "androidx.core:core:1.3.1"
// implementation "androidx.localbroadcastmanager:localbroadcastmanager:1.0.0"Android の場合 hardwareAccelerated を追加 (Unity 2018.1 以前のバージョン)
VungleSDK が MREC 広告を正しく表示するには hardwareAccelerated が必要です。Unity は、Unity プロジェクト内の AndroidManifest.xml で true に設定されている場合でも、このプロパティを強制的に false に設定します。Vungle プラグインは、2018.2 以降に利用可能な Gradle ポストプロセッサ スクリプトを使用するように true に設定します。2017 を含む 2018.1 以前を使用するパブリッシャーの場合、プロジェクトを Android Studio にエクスポートし、値が true の hardwareAccelerated 設定を追加する必要があります。
サンプル コード:
<application android:hardwareAccelerated="true" ...>ユニバーサル Windows プラットフォーム プロジェクトの設定
Windows SDK 向け Vungle Unity プラグインの記事の指示に従って、UWP プロジェクトを設定します。
手順 2: コードを追加する
この説明では、メインの Game Object に添付されたスクリプトで Vungle 関連のすべてのコードを初期化します。Vungle Unity プラグインは、適切と思われる任意のスクリプトから呼び出すことができます。
SDK を初期化する
広告をキャッシュするための十分な時間を SDK に与えられるよう、アプリケーションが起動したらすぐに SDK を初期化してください。SDK を初期化するには、サポートするプラットフォームで使用するアプリケーション ID が必要となります。これらの ID は Vungle ダッシュボードから取得できます (「広告配置の設定とレポート作成」を参照してください)。
デフォルトの広告配置はアプリケーションごとに自動的に作成されます。広告配置機能を利用するかどうかにかかわらず、広告配置 ID をこの初期化手順で指定する必要があります。複数の広告配置を作成する場合は、すべての広告配置 ID を指定してください。
サンプル コード:
public class VungleScript : MonoBehaviour {
string appID = "";
string iosAppID = "ios_app_id";
string androidAppID = "android_app_id";
string windowsAppID = "windows_app_id";
#if UNITY_IPHONE
appID = iosAppID;
#elif UNITY_ANDROID
appID = androidAppID;
#elif UNITY_WSA_10_0 || UNITY_WINRT_8_1 || UNITY_METRO
appID = windowsAppID;
#endif
Vungle.init(appID);
}SDK が正常に初期化されると、次のイベントが呼び出されます。
public static event Action onInitializeEvent;選択した広告フォーマットの記事の「イベント処理」セクションを参照してください。
キャッシュ パフォーマンスを最大化するキャッシュの最適化配置については、アカウント マネージャーにお問い合わせください。
広告が正常にキャッシュされると、広告配置と一致する広告配置参照 ID で adPlayableEvent イベントが呼び出されます。(詳細については、選択した広告フォーマットの記事を参照してください)。
広告フォーマットを統合する
アプリに表示する予定の各広告フォーマットのプラグイン統合を完了します。各広告フォーマットについては、以下の説明を参照してください。
広告を詳細にカスタマイズする
「詳細設定」の記事に記載されている手順に従い、GDPR、CCPA の実装、その他の多くの設定など、追加の構成オプションとのアプリの統合を詳細に設定します。