開始方法
Adjust Unity SDKを実装することで、アトリビューションやイベントなどのさまざまなデータをUnityアプリで計測できます。以下の手順に従って、Adjust SDKをアプリを実装してください。
1. Adjust SDKを取得する
UnityアプリでAdjust SDKを使うには、プロジェクトに追加する必要があります。GitHubのリリースページから最新バージョンをダウンロードできます。
以下の手順に従って、Adjust SDKをUnityプロジェクトにインポートしてください。
- Unityエディター(Unity Editor)を開きます。
- Assets -> Import Package -> Custom Package を選択します。
- ダウンロードしたSDKパッケージを選択します。
2. SDKを実装する
Adjust SDKには、ゲームオブジェクトのテンプレートと Adjust
スクリプトを含むUnity プレハブ が含まれています。このスクリプトを使用してSDKを設定できます。Unityエディターでプレハブを開くには、以下の手順に従ってください。
Assets/Adjust/Adjust.prefab
のプレハブを最初のシーンに追加します。- プレハブの Inspector Menu を開きます。
プレハブのメニューには、Adjust SDKの動作を制御する編集可能なフィールドが含まれています。
以下の情報を入力して、Adjust SDKを設定します。
アプリトークン 。アプリトークンの確認方法については、アプリ設定をご参照ください。
環境 :
- アプリをテスト中で、テストデータを送信する必要がある場合は、 サンドボックス を選択します。テストデータを表示するには、ダッシュボードでサンドボックスモードを有効にする必要があります。
- テストが完了し、アプリを公開する準備が整ったら、 本番用 を選択します。
ログレベル 。ログレベルは、受け取るログの内容を制御します。詳しくは、ログレベルの設定をご覧ください。
デフォルトでは、アプリの Awake
イベントがトリガーされると、Adjust SDKが起動します。この動作をオーバーライドするには、 START SDK MANUALLY オプションをONにしてください。これにより、configインスタンスを引数として Adjust.start()
を呼び出すことで、Adjust SDKを初期化できます。
3. Androidデバイスを設定する
Google Play 開発者サービスを追加する
Google Playストアを対象とするアプリは、Google広告ID (gps_adid
)を使用してデバイスを識別する必要があります。gps_adid
にアクセスするには、play-services-ads-identifier
AARをプロジェクトに追加する必要があります。
アプリセットIDの収集
アプリセットID は、ユーザーがデバイスにインストールしたアプリの情報を計測するための一意の識別子です。同じ開発者のアプリは全て同じアプリセットIDを共有しているため、全てのアプリのユーザーから有意義なインサイトを収集できます。
Proguardを設定する
ProGuardを使用している場合は、以下のルールをカスタムのProGuardファイルに追加してください。
-keep public class com.adjust.sdk.**{ *; }
-keep class com.google.android.gms.common.ConnectionResult {
int SUCCESS;
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient {
com.google.android.gms.ads.identifier.AdvertisingIdClient$Info getAdvertisingIdInfo(android.content.Context);
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient$Info {
java.lang.String getId();
boolean isLimitAdTrackingEnabled();
}
-keep public class com.android.installreferrer.**{ *; }
インストールリファラーを設定する
インストールリファラーは、アプリインストールをソースにアトリビュートするために使用できる一意の識別子です。Adjust SDKは、アトリビューションを実行するためにこの情報を必要とします。対象とするアプリストアによって異なる情報の収集方法が2つあります。
- Google Play Referrer APIを使用する
- Huawei Referrer APIを使用する
4. iOSプライバシーマニフェストを追加する
iOS 17は、アプリのプライバシー要件をApp Storeに通知するメカニズムであるプライバシーマニフェストを導入しました。Adjust Unity SDKはこのプライバシーマニフェストファイルをバンドルしていません。よって、iOS 17以降を搭載しているデバイスをアプリがターゲットにしている場合、Adjust iOS SDKのプライバシーマニフェストファイルの内容がアプリのプライバシーマニフェストに存在している必要があります。
Adjustプライバシーマニフェストを追加するには、以下の手順に従ってください。
- Adjust Unity SDKバージョン4.38.0以降が使用されていることを確認します。
- プライバシーマニフェストをまだ作成していない場合は、作成します。
- GitHubから
PrivacyInfo.xcprivacy
ファイルをダウンロードするか、内容をコピーします。 - Adjustの
PrivacyInfo.xcprivacy
ファイルの内容が独自のプライバシーマニフェストファイルに存在することを確認します。
アプリをApp Storeに提出すると、Adjustのプライバシー宣言がアプリに追加されます。
5. アプリをビルドする
アプリのビルドプロセスを完了し、アプリ内でAdjust SDKが正常に動作することを確実にするため、Adjust Unityのパッケージはポストビルドプロセスを実行します。
このプロセスは、 AdjustEditor.cs
の OnPostprocessBuild
メソッドによって実行されます。出力ログは、Unity IDEコンソールの出力ウィンドウに表示されます。
6. Adjust SDKシグネチャーを追加する
Adjust SDKシグネチャーを使用して、Adjust SDKによって送信される全ての通信に署名できます。これによりAdjustのサーバーは、シグネチャーがない不正インストールを検出し、拒否することができます。
Adjust SDKシグネチャーの使用を開始するには、担当のテクニカルアカウントマネージャーまたはsupport@adjust.comまでお問い合わせください。
7. 実装をテストする
Adjust SDKは、実装をテストとトラブルシューティングのためのツールを提供します。以下の手順に従って、実装をテストしてください。
- 環境を サンドボックス に設定します。
- Datascapeにサンドボックスフィルターを追加します。
- ログレベルを verbose に設定します。