Adjust Cordova SDKを実装することで、アトリビューションやイベントなどのさまざまなデータをCordovaアプリで計測できます。以下の手順に従って、Adjust SDKをアプリに実装してください。また、GitHubのサンプルアプリもご覧ください。
1. プロジェクトにSDKを追加する
Adjust Cordova SDKは、npmのプラグインとして提供されています。これをプロジェクトに追加するには、
Cordovaプラグイン
Adjust Cordova SDKをCordovaプラグインに追加するには、以下のコマンドを実行します。
Ionic
Ionicを使用してアプリを開発する場合は、以下のコマンドを実行して、awesome-cordova-plugins
リポジトリからSDKとそのTypeScriptの型定義を追加してください。
2. Androidデバイスを設定する
パーミッションを追加する
Adjust SDKには、デフォルトでcom.google.android.gms.AD_ID
とandroid.permission.INTERNET
パーミッションが含まれています。アプリをCOPPA準拠にする必要がある場合や、Google Playストアをターゲットにしない場合は、remove
ディレクティブを追加することでAD_ID
パーミッションを削除できます。
インストールリファラーを設定する
Adjust SDKはデフォルトでGoogle Play Referrer APIをサポートしています。Huawei Referrer APIおよびMeta Install Referrerは、Android向けのプラグインとして利用可能です。お使いのAndroidアプリにプラグインを設定するには、関連ドキュメントに従ってください。
Metaとのリファラー連携
Meta Install Referrerを有効にするには、AdjustConfig
インスタンスにMeta App IDを設定する必要があります。これを行うには、以下の手順に従ってください。
-
App DashboardでMetaアプリIDを検索します。詳しくはMetaのアプリダッシュボードのドキュメントをご覧ください。
-
AdjustConfig
インスタンスのsetFbAppId
メソッドにApp IDをパスしてください。
3. iOS frameworksを追加する
Adjust SDKは、iOSデバイスで以下のフレームワークを自動的にリンクします。
Framework | 説明 | 注意 |
---|---|---|
AdSupport.framework | デバイスのIDFAにアクセスできるようにします。また、iOS 14以前のデバイスでLAT情報にアクセスできるようになります。 | アプリが「子供向け」カテゴリーをターゲットにしている場合、このフレームワークは追加しないでください。 |
AdServices.framework | Apple Search Adsのアトリビューションを処理します。 | |
StoreKit.framework | SKAdNetworkフレームワークにアクセスできるようにします。 | iOS14以降のデバイスでAdjust SDKがSKAdNetworkとのコミュニケーションを行うために必要です。 |
AppTrackingTransparency.framework | Adjust SDKがユーザーのトラッキング同意ダイアログをラップし、iOS 14以降のデバイスで同意レスポンスにアクセスできるようにするために必要です。 | アプリが「子供向け」カテゴリーをターゲットにしている場合、このフレームワークは追加しないでください。 |
4. SDKシグネチャーを設定する
SDK v5には、 SDKシグネチャーライブラリが含まれています。連携が正常に機能することを確認するためには、iOSとAndroidのためのガイドを参照してください。
シグネチャーの保護機能は、デフォルトで非アクティブになっています。これを有効化するには、以下の手順に従ってください
5. Adjust SDKを初期化する
Cordovaアプリ内で、即座にAdjust SDKを初期化するようにしてください。これを行うには、以下の手順に従ってください。
-
次の情報を使用して
AdjustConfig
オブジェクトをインスタンス化します。appToken
: お客様のAdjustアプリトークン。environment
: アプリの実行環境。アプリをローカルでテストするには、これをAdjustConfig.EnvironmentSandbox
に設定します。
-
SDKを初期化するには、
AdjustConfig
インスタンスをAdjust.initSdk
メソッドにパスします。
6. アプリをビルドする
これで、Cordovaアプリをビルドして実行できるようになります。ログを有効化して、問題がないか確認してください。また、ログのInstall tracked
メッセージもご覧ください。
Adjust SDKを使用してユーザーをアトリビューションできるようになりました。
7. 連携をテストする
Adjust SDKは、実装をテストとトラブルシューティングのためのツールを提供します。以下の手順に従って、実装をテストしてください。
- 環境を
AdjustConfig.EnvironmentSandbox
に設定します。 - Adjustダッシュボードにサンドボックスフィルターを追加します。
- ログレベルを
AdjustConfig.LogLevelVerbose
に設定します。
問題が発生した場合は、全ての詳細情報とログを添付し、support@adjust.comまでメールをお送りください。
Google Play 開発者サービスの連携をテストする
Adjust SDKがデバイスのGoogle広告IDを受信できるかどうかテストするには、ログレベルを verbose に、環境を Sandbox に設定します。アプリを起動してセッションまたはイベントを計測します。SDKが広告IDを読み取った場合、SDKはgps_adid
(Google Play開発者サービス広告ID)パラメーターをログに記録します。
Google広告IDを取得する際に問題が発生した場合は、SDK Githubリポジトリで質問を投稿するか、support@adjust.comまでお問い合わせください。