adjust-icon

SDKシグネチャーライブラリの実装

AdjustのSDKシグネチャーライブラリは、Adjust SDKのスタンドアローンプラグインとして設計されています。つまり、コードを変更したり、アプリでAdjust SDKを使用する方法を変更したりする必要はありません。プラグインをインストールすると、Adjust SDKによって作成された全てのリクエストが引き続き正常に機能します。

Before you begin

AdjustシグネチャーライブラリをiOSアプリに実装する前に、以下を確認してください。

  • お使いのAdjust SDKバージョンが 4.35.2以降 であること。この要件は、Adjust SDKが間接的に使用されている場合でも適用されます。
  • iOSまたはtvOSのバージョン 12以降 に対応していること。

Migrating from Signature v1 or v2 library

以前にシグネチャーv1またはシグネチャーv2を使用していた場合は、シグネチャーライブラリを連携する前に以前のバージョンを削除する必要があります。これを行うには、以下の手順に従ってください。

  • 以前シグネチャーv1を実装したことがある場合は、プロジェクト内のシグネチャー機能を呼び出すコードを削除してください。
  • 以前シグネチャーv2を実施したことがある場合は、シグネチャーv2のライブラリをプロジェクトから削除してください。

Updating the Signature Library

Adjustシグネチャーライブラリを更新するには、既存のシグネチャーライブラリを新しいバージョンに置き換え、テストを再度実行してください。Adjustでアプリのロジックや設定をすぐに変更する必要はありません。シークレットIDが以下の基準を満たす場合は、必ず無効化してください。

  • インストールレポートに役立たなくなった。
  • アプリの新バージョンを（全てのアプリのプラットフォームとストアで）リリースした。

Integrate the signature library (SDK v4 only)

iOSプロジェクトにシグネチャーライブラリを実装するには、以下の手順に従ってください。

  1. GitHubからAdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zipアーカイブをダウンロードします。
  2. アーカイブを解凍し、 AdjustSigSdk.xcframeworkをプロジェクトのディレクトリにコピーします。
  3. Xcodeの プロジェクトナビゲーター でプロジェクトを選択します。
  4. 左側のターゲットを選択します。
  5. General タブを選択し、 Frameworks, Libraries and Embedded Content グループを開きます。
  6. グループの下部にある + ボタンを選択します。

XcodeのFrameworksページのスクリーンショット

  1. Add Other —> Add Files を選択し、プロジェクトディレクトリからAdjustSigSdk.xcframeworkファイルを選択します。

Xcodeのフレームワークセレクターのスクリーンショット

  1. AdjustSigSdk.xcframeworkの Embed & Sign オプションを選択します。

XcodeのEmbed & Signオプションのスクリーンショット

これで、シグネチャーライブラリがプロジェクトに実装されました。

Test your app

Adjustテストコンソールを使用して、アプリにシグネチャーライブラリが実装されていることを確認できます。

シグネチャーライブラリの実装をテストするには、以下の手順に従ってください。

  1. インストール情報が送信されるようにするには、テストデバイスからアプリを完全に削除します。

  2. デバイスに関する全ての情報を消去するには、テストコンソールを使用してデバイスに関する情報を削除します。Adjust Insightsアプリで取得したアプリのアルゴリズムと広告IDをパスすることで、forget_deviceエンドポイントを使用することも可能です。次の広告IDはいずれも使用できます：adid、idfa、idfv、imei、oaid。

    コールは以下のようになります。

    Terminal window
    $ curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}'

  3. テストコンソールからデバイスのデータを削除したら、テストデバイスにアプリをインストールして起動し、インストール情報をAdjustに送信します。

  4. テストデバイスの広告IDをテストコンソールに入力し、インストールイベント情報を取得します。以下の点を確認してください。

    1. SignatureVerificationResultフィールドに次の値が表示されている： Valid Signature
    2. SignatureVersionフィールドに次の値が表示されている： 3

これらのフィールドが存在し、正しい情報が含まれている場合、シグネチャーライブラリは正常に実装されています。これらのフィールドに他の値が表示されている場合は、実装手順を再度確認するか、support@adjust.comまでお問い合わせください。

これで、シグネチャーライブラリがアプリに連携されました。 2回のアトリビューション期間が経過したら、 SDKシグネチャーの検証を有効化して、署名されたリクエストのみがAdjustで受理されるようにしてください。