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
セクションに追加してください。
implementation 'com.google.android.gms:play-services-ads-identifier:18.1.0'
パーミッションを追加する Adjust SDKには以下のパーミッションが必要です。まだ存在しない場合は、AndroidManifest.xml
ファイルに追加してください。
< uses-permission android:name = "android.permission.INTERNET" />
Adjust SDKには、デフォルトでcom.google.android.gms.AD_ID
パーミッションが含まれています。アプリを児童オンラインプライバシー保護法(COPPA)に準拠させる必要がある場合や、Google Play ストアをターゲットにしていない場合は、remove
ディレクティブを追加することでこれを削除することができます。
< uses-permission android:name = "com.google.android.gms.permission.AD_ID" tools:node = "remove" />
さらに見る このパーミッションに関する詳細は、GoogleのAdvertisingIdClient.Info documentation
をご参照ください。
インストールリファラーを設定する インストールリファラーは、アプリインストールをソースにアトリビュートするために使用できる一意の識別子です。Adjust SDKは、アトリビューションを実行するためにこの情報を必要とします。
Google Play Referrer API Google Play Referrer APIをサポートするには、build.gradle
ファイルに以下を追加します。
implementation 'com.android.installreferrer:installreferrer:2.2'
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シグネチャーを設定する Adjust SDKとAdjustのサーバー間の通信を保護するためにSDKシグネチャーライブラリを使用する場合は、AdjustヘルプセンターのSDKシグネチャーガイド の手順に従ってください。
5. Adjust SDKを初期化する Flutterアプリ内で、出来るだけ早くAdjust SDKを初期化するようにしてください。これを行うには、アプリトークンを使ってConfigオブジェクトとアプリを実行したい環境を初期化します。
AdjustConfig config = new AdjustConfig ( '{YourAppToken}' , AdjustEnvironment .sandbox);
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 までお問い合わせください。