Adjust Unity SDKを実装することで、アトリビューションやイベントなどのさまざまなデータをUnityアプリで計測できます。Adjust SDKをアプリに実装するには、以下の手順に従ってください。また、GitHubでサンプルアプリも確認できます。
1. プロジェクトにSDKを追加する
FlutterアプリでAdjust Flutter SDKを使用するには、それをプロジェクトに追加する必要があります。
Adjust SDKをFlutterプロジェクトに連携させるには、次のステップに従ってください。
- 以下を
pubspec.yaml
ファイルに追加します:
- プロジェクトに移動して、次のコマンドを実行します。Visual Studioは、
pubspec.yaml
ファイルが編集された後に、このコマンドを自動的に実行します。
2. Androidデバイスを設定する
Google Play 開発者サービスを追加する
Google Playストアを対象とするアプリは、Google広告ID(gps_adid
)を使用してデバイスを識別する必要があります。これを行うには、以下のdependencyをbuild.gradle
ファイルの dependencies
セクションに追加してください。
パーミッションを追加する
Adjust SDKには以下のパーミッションが必要です。まだ存在しない場合は、AndroidManifest.xml
ファイルに追加してください。
Adjust SDKには、デフォルトでcom.google.android.gms.AD_ID
パーミッションが含まれています。アプリを児童オンラインプライバシー保護法(COPPA)に準拠させる必要がある場合や、Google Play ストアをターゲットにしていない場合は、remove
ディレクティブを追加することでこれを削除することができます。
インストールリファラーを設定する
インストールリファラーは、アプリインストールをソースにアトリビュートするために使用できる一意の識別子です。Adjust SDKは、アトリビューションを実行するためにこの情報を必要とします。
Google Play Referrer API
Google Play Referrer APIをサポートするには、build.gradle
ファイルに以下を追加します。
Metaとのリファラー連携
Adjust SDKは、Adjust Metaインストールリファラープラグインを使用してMetaインストールリファラーをサポートしています。連携の詳細については、Flutter Meta インストール リファラープラグインをご覧ください。
3. iOS frameworksを追加する
特定のiOS frameworksをアプリに実装すると、Adjust SDKは追加の情報を取得できます。これらのframeworksによって特定のSDK機能を有効にできますが、SDKが正常に動作するために必須というわけではありません。 フレームワークを追加し、その後、 Project Settings —> Build Phases —> Link Binary With Libraries で Optional としてマークすることができます。
Framework | 説明 | 注意 |
---|---|---|
AdSupport.framework | デバイスのIDFAにアクセスできるようにします。また、iOS 14以前のデバイスでLAT情報にアクセスできるようになります。 | アプリが「子供向け」カテゴリーをターゲットにしている場合、このフレームワークは追加しないでください。 |
AdServices.framework | Apple Search Adsのアトリビューションを処理します。 | |
StoreKit.framework | SKAdNetworkフレームワークにアクセスできるようにします。 | iOS14以降のデバイスでAdjust SDKがSKAdNetworkとのコミュニケーションを行うために必要です。 |
AppTrackingTransparency.framework | Adjust SDKがユーザーのATT同意ダイアログをラップし、iOS 14以降のデバイスで同意レスポンスにアクセスできるようにするために必要です。 | アプリが「子供向け」カテゴリーをターゲットにしている場合、このフレームワークは追加しないでください。 |
4. SDKシグネチャーを設定する
SDK v5には、 SDKシグネチャーライブラリが含まれています。連携が正常に機能することを確認するためには、iOSとAndroidのためのガイドを参照してください。
シグネチャーの保護機能は、デフォルトで非アクティブになっています。これを有効化するには、以下の手順に従ってください
5. Adjust SDKを初期化する
Flutterアプリ内で、出来るだけ早くAdjust SDKを初期化するようにしてください。これを行うには、アプリトークンを使ってConfigオブジェクトとアプリを実行したい環境を初期化します。
6. アプリをビルドする
設定が完了しました。これでFlutterアプリのビルドと実行が可能になります。ログを有効化して、問題がないか確認してください。ログに、Install tracked
メッセージがあるか確認してください。
Adjust SDKを使用してユーザーをアトリビューションできるようになりました。
7. 連携をテストする
Adjust SDKは、実装をテストとトラブルシューティングのためのツールを提供します。以下の手順に従って、実装をテストしてください。
- 環境を
AdjustEnvironment.sandbox
に設定します。 - Adjustダッシュボードにサンドボックスフィルターを追加します。
- ログレベルを
AdjustLogLevel.verbose
に設定します。
Google Play 開発者サービスの連携をテストする
Adjust SDKがデバイスのGoogle広告IDを受信できるかどうかテストするには、ログレベルをAdjustLogLevel.verbose
に、環境をAdjustEnvironment.sandbox
に設定します。アプリを起動してセッションまたはイベントを計測します。SDKが広告IDを読み取った場合、SDKはgps_adid
(Google Play開発者サービス広告ID)パラメーターをログに記録します。
Google広告IDを取得する際に問題が発生した場合は、SDK Githubリポジトリで質問を投稿するか、support@adjust.comまでお問い合わせください。