Adjust Unity SDKを実装することで、アトリビューションやイベントなどのさまざまなデータをUnityアプリで記録できます。Adjust SDKをアプリに実装するには、以下の手順に従ってください。
1. Adjust SDKを取得する
Adjust SDKをインストールするには、次のいずれかのメソッドを選択します。
Unityのパッケージをインストールする
UnityアプリでAdjust SDKを使うには、プロジェクトに追加する必要があります。GitHubのリリースページから最新バージョンをダウンロードできます。
以下の手順に従って、Adjust SDKをUnityプロジェクトにインポートしてください。
- Unityエディター(Unity Editor)を開きます。
- Assets —> Import Package —> Custom Package を選択します。
- ダウンロードしたSDKパッケージを選択します。
UnityのPackage Managerを使用する
Unity Package Managerを使用してAdjust SDKをインストールするには、以下の手順に従ってください。
- Unity editorで、 Package Manager ウィンドウを選択します。
- Add package from git URLを 選択します。
- 次のURLを入力します:
https://github.com/adjust/unity_sdk.git?path=Assets/Adjust
。
2. iOSとAndroid SDKをインストールする
SDK v5は、iOSとAndroid SDKをバイナリ依存として使用しなくなりました。基盤となるiOSおよびAndroid SDKをインストールするには、External Dependency Manager for Unity (EDM4U)を使用して、CocoaPodsとMavenからパッケージをインストールする必要があります。
iOS向けにプライバシーマニフェストとフレームワークが正しく読み込まれるようにするには、静的リンクを無効にする必要があります。これを行うには、以下の手順に従ってください。
- Assets -> External Dependency Manager -> iOS Resolver -> Settings を選択します。
- Link frameworks statically オプションを見つけ、チェックを外します。
3. SDKを実装する
Adjust SDKには、ゲームオブジェクトのテンプレートとAdjustスクリプトを含むUnityプレハブ(Prefab)が格納されています。このスクリプトを使用してSDKを設定できます。Unityエディターでプレハブを開くには、以下の手順に従ってください。
Assets/Adjust/Adjust.prefab
のプレハブを1番目のシーンに追加します。- プレハブのInspector Menuを開きます。
- プレハブのメニューには、Adjust SDKの動作を制御する編集可能なフィールドが含まれています。
以下の情報を入力して、Adjust SDKを設定します。
-
アプリトークン 。アプリトークンの確認方法については、アプリ設定をご覧ください。
-
環境 :
- アプリをテスト中で、テストデータを送信する必要がある場合は、 サンドボックス を選択します。テストデータを表示するには、ダッシュボードでサンドボックスモードを有効にする必要があります。
- テストが完了し、アプリを公開する準備が整ったら、 本番用 を選択します。
-
ログレベル 。ログレベルは、受け取るログの内容を制御します。詳しくは、ログレベルの設定をご覧ください。
Adjust SDKは、アプリのAwakeイベントが発生したときにデフォルトで開始します。この動作をオーバーライドするには、 START SDK MANUALLY オプションをONにしてください。これにより、configインスタンスを引数としてAdjust.InitSdk
を呼び出すことで、Adjust SDKを初期化できます。
4. Androidデバイスを設定する
Google Play 開発者サービスを追加する
Google Playストアを対象とするアプリは、gps_adid(Google広告ID)を使用してデバイスを識別する必要があります。gps_adid
にアクセスするには、play-services-ads-identifier
AARをプロジェクトに追加する必要があります。
External Dependency Managerプラグインを使用している場合は、Dependencies.xml
ファイルに以下を追加します。
ARRAndroid Archiveを手動でインストールするには、Mavenからダウンロード して Assets/Plugins/Android
ディレクトリに追加してください。
アプリセットIDを収集する
アプリセットID は、ユーザーがデバイスにインストールしたアプリの情報を計測するための一意の識別子です。同じ開発者のアプリは全て同じアプリセットIDを共有しているため、全てのアプリのユーザーから有意義なインサイトを収集できます。
デバイスのApp Set IDを記録するには、以下のdependencyをDependencies.xml
ファイルに追加する必要があります。
ARRAndroid Archiveを手動でインストールするには、Mavenからダウンロード して Assets/Plugins/Android
ディレクトリに追加してください。
インストールリファラーを設定する
インストールリファラーは、アプリインストールをソースにアトリビュートするために使用できる一意の識別子です。Adjust SDKは、アトリビューションを実行するためにこの情報を必要とします。そこで、 Google Play Referrer APIを使用してこの情報を収集します。
Google Play Referrer APIをサポートするには、以下の2つの方法があります。
インストールリファラーライブラリをdependencyとしてカスタムbuild.gradle
ファイルに追加します。
Mavenからインストールリファラーライブラリをダウンロードし、ARR(Android Archive)ファイルをPlugins/Android
フォルダーに入れてください。
Metaとのリファラー連携
Adjust SDKはMetaインストールリファラーをサポートしています。この機能を有効化する方法:
- App DashboardでMetaアプリIDを検索します。詳しくはMetaのアプリダッシュボードのドキュメントをご覧ください。
- Metaアプリを
AndroidManifest.xml
ファイルに追加します。
-
AdjustConfig
インスタンスのFbAppId
プロパティをアプリIDに設定します。
5. SDKシグネチャーを設定する
SDK v5には、 SDKシグネチャーライブラリが含まれています。連携が正常に機能することを確認するためには、iOSとAndroidのためのガイドを参照してください。
シグネチャーの保護機能は、デフォルトで非アクティブになっています。これを有効化するには、以下の手順に従ってください
6. アプリをビルドする
アプリのビルドプロセスを完了し、アプリ内でAdjust SDKが動作することを確実にするため、Adjust Unityのパッケージはポストビルドを実行します。 このプロセスは、AdjustEditor.cs
のOnPostprocessBuild
メソッドによって実行されます。
ポストビルドオプションを設定して、アプリのビルドをカスタマイズできます。
iOSのポストビルドプロセスは、生成したXcodeプロジェクトを次のように変更します。
- Objective-C exceptionsを有効にします。
フレームワーク
iOS機能にアクセスするために、以下のフレームワークを有効にすることができます。
AdServices.framework
: Apple Search Adsの計測に必要。AdSupport.framework
: デバイスのIDFAの読み取りに必要。AppTrackingTransparency.framework
: ユーザーに計測への同意を求め、その同意ステータスを取得するために必要。StoreKit.framework
: SKAdNetworkフレームワークとの通信に必要。
AppTrackingTransparencyの同意ダイアログ
ATT(App Tracking Transparency)ラッパーを使用している場合は、 User Tracking Description メッセージを入力します。このメッセージは、ATT同意ダイアログをユーザーに示す場合に表示されます。
ディープリンク
ディープリンクを有効化するには、次の情報を追加します。
- iOSユニバーサルリンクドメイン :ユニバーサルリンクに使用されるAssociated Domain。
- iOS URL Identifier :アプリのバンドルID。
- iOS URLスキーム :アプリに関連するURLスキーム。
Androidのポストビルドプロセスは、 Assets/Plugins/Android/
内の AndroidManifest.xml
ファイルを確認します。このファイルが存在しない場合、AdjustAndroidManifest.xml
からコピーを作成します。
パーミッション
Android機能にアクセスするには、以下のパーミッションを有効にしてください。
android.permission.INTERNET
: インターネットに接続するために必要。android.permission.ACCESS_NETWORK_STATE
: デバイスが接続されているネットワークタイプの読み取りに必要。com.android.finsky.permission.BIND_GET_INSTALL_REFERRER_SERVICE
(廃止済み) :Google Play Storeインテント経由でインストールリファラー情報を取得するのに必要com.google.android.gms.permission.AD_ID
: 詳細は、GoogleのAdvertisingIdClient.info
ドキュメントを参照してください。
ディープリンク
ディープリンクを有効化するには、次の情報を追加します。
Android URIスキーム :ディープリンクの遷移先。
プロセスの出力は、Unity IDEコンソールウィンドウに表示されます。
7. 連携をテストする
Adjust SDKは、実装をテストとトラブルシューティングのためのツールを提供します。以下の手順に従って、実装をテストしてください。
- 環境を
AdjustEnvironment.Sandbox
に設定します。 - Adjustダッシュボードにサンドボックスフィルターを追加します。
- ログレベルを
AdjustLogLevel.Verbose
に設定します。
Google Play 開発者サービスの連携をテストする
Adjust SDKがデバイスのGoogle広告IDを受信できるかどうかテストするには、ログレベルをAdjustLogLevel.Verbose
に、環境をAdjustEnvironment.Sandbox
に設定します。アプリを起動してsession
またはイベントを計測します。SDKが広告IDを読み取った場合、SDKはgps_adid(Google Play 開発者サービス広告ID)パラメーターをログに記録します。
Google広告IDを取得する際に問題が発生した場合は、Githubリポジトリで質問を投稿するか、support@adjust.comまでお問い合わせください。