adjust-icon

ディープリンクの設定

要件

  • Adjustダッシュボードでブランドドメインを設定するための、管理者アクセス権限
  • Adjustダッシュボードでアプリ設定を管理するための、編集者またはそれ以上のアクセス権限。

新規アプリを作成する

Adjustダッシュボードでアプリを作成します。

Adjustダッシュボードでは、各アプリに対して1つのバンドルID (com.example.app) とアプリスキーム (example://) をそれぞれ1つのみサポートしている点にご注意ください。リリース用とデバッグ用で異なるバンドルIDやアプリスキームを使用している場合は、デバッグ用に別のアプリを作成してください。

iOSプラットフォームを追加する

アプリのプラットフォーム設定（platform settings）でiOSを追加します。ここでは、バンドルIDを入力する必要があります。アプリビルドのバンドルIDが不明な場合は、一時的な値 (com.example.app) を入力してプラットフォーム設定を保存してください。このガイドの残りの部分に従って、必要なデータポイントを全て収集したら、ダッシュボードのプラットフォーム設定に戻って設定を完了してください。

ブランドドメインを設定する

Adjustダッシュボードで、Adjustのgo.linkドメイン（例：brandname.go.link ）を使用してブランドドメインを設定します。

iOSアプリとAndroidアプリがAdjustで別のアプリを使用している場合は、Adjustダッシュボードで両方のアプリに対して同じブランドドメイン (brandname.go.link) を選択するようにしてください。

本番ビルドとデバッグビルドで別々のアプリを使用している場合は、デバッグ用アプリ用に別のブランドドメイン（brandnamedebug.go.link）を作成してください。また、Adjust上でiOSとAndroidのデバッグアプリを別々に管理している場合は、Adjustダッシュボードで両方のデバッグアプリに対して同じブランドドメインを選択していることを確認してください。

次のセクションでXcodeで設定するブランドドメインをメモしておいてください。

Xcodeでディープリンクを設定する

  1. Xcodeプロジェクトを開きます。

  2. ナビゲーターで、プロジェクト名を選択し、プロジェクト設定にアクセスします。

  3. プロジェクト設定の ターゲット（Targets ) で、適切なターゲット（通常はアプリ名）を選択します。

  4. 署名と機能（Signing & Capabilities） タブを選択します。

  5. リリース（Release） と デバッグ（Debug） サブタブの両方で以下の手順を実行します。

    • バンドルID（Bundle Identifier） フィールドの値をメモします。これはアプリのバンドルID（「リリースバンドルID」または「デバッグバンドルID」）で、AdjustダッシュボードのiOSプラットフォーム設定で設定する必要があります。

    • 関連ドメイン（Associated Domains） セクションで、各ブランドドメインのエントリを追加します。サンプルドメイン brandname.go.link に必須の入力項目は、以下のとおりです。

      applinks:brandname.go.link

Associated Domains設定に問題がある場合は、こちらをご覧ください。

  • 関連ドメイン（Associated Domains） セクションが表示されない場合は、まずこれを有効にする必要があります。

    1. リリース（Release） または デバッグ（Debug） サブタブ（ない場合）にて、 + Capability（機能） をクリックします。
    2. 「Associated Domains」を検索し、選択します。

  • 関連ドメインを有効化しようとした際に「Provisioning Profile {profile_name} doesn’t support the Associated Domains capability」などのエラーメッセージが表示された場合、プロビジョニングプロファイルの更新が必要な可能性があります。

アプリスキームを取得または設定する

iOSがユニバーサルリンクをサポートしていない特定のユースケースでは、アプリスキームが必要です。Adjustディープリンクに既存のアプリスキームを再利用できます。

  1. Xcode navigatorで、プロジェクト名を選択し、プロジェクト設定にアクセスします。
  2. Targetsで、適切なターゲット（通常はアプリ名）を選択します。
  3. Info タブを選択します。
  4. URLタイプ（URL Types） セクションを展開します。

アプリにすでにアプリスキームがある場合は、URLタイプのエントリがあり、それぞれ URLスキーム は単一の値を持ちます。以下の表を参照して、URLタイプの設定に基づいてアプリスキームを決定してください。アプリスキームを記録しておき、後でAdjustダッシュボードで設定を行います。

URLスキーム フィールドApp Scheme
静的値、例： exampleexample:// 例：「リリースアプリスキーム」
静的値、例：別のURLタイプエントリの example、exampleDebug などexample:// 例：「リリースアプリスキーム」
exampleDebug://　例：「デバッグアプリスキーム」
ダイナミックビルド設定変数、例： $(APP_SCHEME)ビルド設定 タブに移動 -> 「APP_SCHEME」などの変数名を検索 -> リリースとデバッグの値は、それぞれ「Release App Scheme」と「Debug App Scheme」です。

アプリスキームを作成するには、以下の手順に従ってください。

  • + ボタンを選択して、新しいURLタイプを追加します。

  • 以下のフィールドに入力します。

    • 識別子 ： $(PRODUCT_BUNDLE_IDENTIFIER)
    • 権限（Role） ：編集者（Editor）
    • URLスキーム ：任意のアプリスキーム値を入力します（example://ではなくexampleと入力）。http、https、またはmailto、tel、sms、 facetimeなどの予約済みのiOSスキームは使用しないでください。ここで静的値を入力すると、リリースビルドとデバッグビルドの両方に使用される単一のアプリスキームが作成されます。

  • 作成したら、後でAdjustダッシュボードで設定するためにアプリスキームをメモしておいてください。

Apple DeveloperポータルからApp ID prefixを取得する

  1. Apple Developerポータルにログインします。
  2. 証明書, IDs、プロファイル（Certificates, IDs & Profiles） にて、 ID（Identifiers） を選択します。
  3. アプリを選択します。
  4. ページの上部にある App ID Prefix をメモし、Adjustダッシュボードの次のセクションで設定します。

iOSプラットフォーム設定の構成を終了する

Adjustダッシュボードでは、収集した以下のデータポイントを使用して、アプリのiOSプラットフォームの設定を完了します。

データポイント例要件
リリースバンドルIDcom.example.app必須
デバッグバンドルIDcom.example.debugデバッグバンドルIDがリリースバンドルIDと異なる場合に必要です。
リリースアプリスキームexample://iOSがユニバーサルリンクをサポートしていない場合に必要です。
デバッグアプリスキームexampleDebug://デバッグアプリスキームがリリースアプリスキームと異なる場合に必要です。
App ID prefixABCDE12345必須