adjust-icon

iOS SDK連携ガイド

Adjust iOS SDKを実装することで、アトリビューションやイベントなどのさまざまなデータをWebアプリで記録できます。このガイドでは、Adjust SDKをアプリに実装する方法を紹介します。

1. プロジェクトにSDKを追加する

iOSアプリでAdjust SDKを使うには、Xcodeプロジェクトに追加する必要があります。

Swift Package Managerを使ってSDKを追加するには、以下の手順に従ってください。

  1. File —> Swift Packages —> Add Package Dependency を選択します。
  2. 表示されたボックスに、SDKのGitHubのアドレスを入力します。 https://github.com/adjust/ios_sdk
  3. Version ドロップダウンで、使用したいAdjust SDKのバージョンを選択します。最新のパージョンはリリースページからご確認ください。

その他のインストール方法

2. Adjust SDKを実装する

Adjust SDKをXcodeプロジェクトに追加したら、それをアプリで実装する必要があります。

3. iOS frameworksを追加する

Adjust SDKは、特定のデバイス情報にアクセスするためにフレームワークに依存しています。この情報を読み取れるようにするには、フレームワークを追加してそれらを オプション として表示します。

Framework説明注意
AdSupport.frameworkデバイスのIDFAにアクセスできるようにします。また、iOS 14以前のデバイスでLAT情報にアクセスできるようになります。アプリが「子供向け」カテゴリーをターゲットにしている場合、このフレームワークは追加しないでください。
AdServices.frameworkASAアトリビューションを処理します。
StoreKit.frameworkSKAdNetworkフレームワークにアクセスできるようにします。iOS14以降のデバイスでAdjust SDKがSKAdNetworkとの通信を処理するために必要です。
AppTrackingTransparency.frameworkAdjust SDKがユーザーのATT同意ダイアログをラップし、iOS 14以降のデバイスで同意レスポンスにアクセスできるようにするために必要です。アプリが「子供向け」カテゴリーをターゲットにしている場合、このフレームワークは追加しないでください。
WebKit.frameworkアプリでWeb viewを使用できるようにします。アプリがWeb viewを使用している場合にのみ必要です。

4. Adjust SDKを初期化する

Adjust SDKを初期化するには、configオブジェクトを作成する必要があります。このオブジェクトには、Adjust SDKの動作をコントロールする設定オプションが含まれています。最小限の設定を行うために、以下の引数をパスします。

  • appToken: アプリトークン
  • environment: SDKを実行したい環境。ADJEnvironmentSandboxに設定します。

ConfigオブジェクトでAdjust SDKを初期化:

  1. アプリデリゲートのdidFinishLaunchingまたはdidFinishLaunchingWithOptionsメソッド内のconfigオブジェクトを宣言します。
  2. ConfigオブジェクトのlogLevelプロパティをADJLogLevelVerbose(verbose)に設定します。デバイス情報を取得するには、verboseロギングを有効化する必要があります。
  3. Configオブジェクトを引数としてappDidLaunchメソッドにパスします。

iMessageアプリを設定する

アプリがiMessageをターゲティングしている場合、いくつか追加の設定を行う必要があります。

  • ソースからAdjust SDKを追加した場合、ADJUST_IM=1プリプロセッサマクロをiMessageプロジェクトの設定に追加してください。
  • Adjust SDKをフレームワークとして追加した場合、 ビルドフェーズ プロジェクト設定で 新規コピーファイルフェーズ(New Copy Files Phases) を追加します。AdjustSdkIm.frameworkをフレームワークフォルダーにコピーするように設定してください。

セッションを記録する

Adjust SDKはiMessageアプリのiOSシステム通知を受け取りません。アプリがフォアグラウンドに入った、またはフォアグラウンドから離れたことをAdjust SDKに通知するには、trackSubsessionStarttrackSubsessionEndメソッドを呼び出す必要があります。

didBecomeActiveWithConversation:メソッド内でtrackSubsessionStartへのコールを追加します。

willResignActiveWithConversation:メソッド内でtrackSubsessionEndへのコールを追加します。

Adjust Web Bridgeを設定する

アプリがWeb viewを使用している場合、Adjust Web Bridgeを設定してWeb view内のアクティビティを記録する必要があります。

AdjustBridgeをアプリに実装する

プロジェクトナビゲータにて:

  1. View Controllerのソースファイルを開きます。
  2. ファイルの最上部にimportステートメントを追加します。
  3. Web View DelegateのviewDidLoadまたはviewWillAppearメソッドのAdjustBridgeに以下のコールを追加します。

これに含まれるWebViewJavascriptBridgeも利用できます。これを使用するには、AdjustBridgeインスタンスのbridgeRegisterプロパティを設定してください。使用方法については、ライブラリのドキュメントを参照してください。

AdjustBridgeをWeb viewに実装する

Web viewでJavascriptを使用するには、bridgeを設定する必要があります。Adjust iOSのWeb bridgeを初期化するには、以下のJavascriptコードを追加してください。

5. Adjust SDKを設定する

Configオブジェクトと初期化ロジックを追加したら、Adjust SDKを設定してアプリの様々な部分に関する情報を記録することができます。SDKの設定機能と記録機能のガイドを確認し、記録したいデータを正確に設定してください。

6. Adjust SDKをテストする

アプリの情報を記録するようにAdjust SDKを設定したら、次はテストを行います。Adjustは、アプリのテストに役立つテストコンソールデバイスAPIを提供しています。

テストガイドに従って、Adjustがアプリから想定どおりの値を受け取ることを確認してください。

7. 本番用にアプリをビルドする

テストが終わったら、本番用にアプリをビルドできます。そのためには、configオブジェクトを更新する必要があります。

以下の値を更新します。

  • environment: ADJEnvironmentProductionに設定します。
  • logLevel: ログレベルを選択するか、configプロジェクトにallowSuppressLogLevel引数をパスしてログを完全に無効化します。

Xcodeのビルドフラグを使用して、debug buildと本番ビルドのどちらを作成するかに応じて、動的に設定を更新することができます。