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

要件

管理者権限：
- 新規アプリの作成
- ブランドドメインの設定
管理者、編集者およびカスタム編集者のアクセス権限：
- アプリ設定の管理

新規アプリを作成する

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

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

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

アプリのプラットフォーム設定でAndroidを追加します。アプリIDがまだ作成されていない場合、またはアプリIDが不明な場合は、 I don’t have an app ID yet のチェックボックスを選択します。このガイドの残りの部分に従って、必要なデータポイントを全て収集したら、ダッシュボードのプラットフォーム設定に戻って設定を完了してください。

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

Adjustダッシュボードで、Adjustのgo.linkドメイン（例：brandname.go.link）を使用してブランドドメインを設定します。組織でエンタープライズドメインを使用している場合は、その設定も行ってください。

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

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

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

アプリIDとアプリスキームを確認する

ディープリンクを設定するには、 アプリID と アプリスキーム を特定する必要があります。この設定は通常、以下のいずれかの設定と一致します。値を確認するには、以下の例を参考にしてください。

静的設定
動的設定

この設定では、アプリIDはビルドGradleファイルで定義され、アプリスキームはアプリレベルのAndroidManifest.xmlにハードコーディングされています。

1
android {
2
    defaultConfig {
3
        // Release App ID
4
        applicationId = "com.example.app"
5
    }
6
    // ...
7
}

これは、リリースビルドとdebug buildが異なるアプリに共通する設定です。アプリIDとアプリスキームはいずれも、ビルドGradleファイルで動的に定義されます。

1
android {
2
    defaultConfig {
3
        // Release App ID
4
        applicationId = "com.example.app"
5

6
        // Release App Scheme
7
        manifestPlaceholders["appScheme"] = "example"
8
    }
9

10
    buildTypes {
11
        getByName("debug") {
12
            // Debug App ID: com.example.app.debug
13
            applicationIdSuffix = ".debug"
14

15
            // Debug App Scheme
16
            manifestPlaceholders["appScheme"] = "exampleDebug"
17
        }
18
    }
19
    // ...
20
}

Adjustダッシュボードで設定を行うためにアプリIDとアプリスキームをメモしておきます。これらのファイルを確認した後にアプリスキームが見つからない場合は、次のセクションで作成します。

Androidアプリリンクとアプリスキームを設定する

アプリレベルのAndroidManifest.xmlファイルを開き、以下のそれぞれに対してインテントフィルターを追加します。

Android アプリリンク

リリースAdjustブランドドメイン（brandname.go.link）
エンタープライズドメイン（click.brandname.com）（該当する場合）
デバッグAdjustブランドリンク（brandnamedebug.go.link）（該当する場合）

アプリスキーム

アプリスキームがまだない場合は、これも追加します。これはhttpまたはhttps以外にする必要があります。

リリースアプリスキーム（example://）
デバッグアプリスキーム（exampleDebug://）（該当する場合）

以下に、既存のタスクが存在する場合に、ディープリンクが常にそのタスク内でアプリを開くようにするための2つの方法を示します。アプリの現在のメインアクティビティのローンチモード設定に対応するアプローチを選択してください。

メインアクティビティアプローチ
メインアクティビティがすでにsingleTaskまたはsingleInstanceの場合は、これを使用してください。
メインアクティビティはディープリンクを直接受け取ります。
専用ディープリンクアクティビティアプローチメインアクティビティが
singleTop、standard 、または起動モードを指定していない場合はこれを使用します。
別のsingleTaskアクティビティがディープリンクインテントを受け取り、メインのアクティビティに転送して完了します。

これらのオプションを使用することで、メインアクティビティの起動モードを変更することなく、ディープリンクが正しく動作するようになります。戦勝については、Androidの起動モードに関するドキュメントを参照してください。

メインアクティビティアプローチ
専用ディープリンクアクティビティアプローチ

1
<!-- Use this approach if MainActivity is already singleTask or singleInstance -->
2
<activity
3
    android:name=".MainActivity"
4
    android:launchMode="singleTask"
5
    android:exported="true"
6
    ...>
7

8
    <!-- Your existing LAUNCHER intent-filter -->
9
    <intent-filter>
10
        <action android:name="android.intent.action.MAIN" />
11
        <category android:name="android.intent.category.LAUNCHER" />
12
    </intent-filter>
13

14
    <!-- Add this intent filter for your Adjust branded domain -->
15
    <intent-filter android:autoVerify="true">
16
        <action android:name="android.intent.action.VIEW" />
17
        <category android:name="android.intent.category.DEFAULT" />
18
        <category android:name="android.intent.category.BROWSABLE" />
19
        <data
20
            android:scheme="https"
21
            android:host="brandname.go.link" />
22
    </intent-filter>
23

24
    <!-- Add this intent filter for your app scheme -->
25
    <intent-filter>
26
        <action android:name="android.intent.action.VIEW" />
27
        <category android:name="android.intent.category.DEFAULT" />
28
        <category android:name="android.intent.category.BROWSABLE" />
29
        <data android:scheme="example" />
30
    </intent-filter>
31

32
</activity>

1
<!-- Use this approach if MainActivity is singleTop, standard, or doesn't specify a launch mode -->
2
<activity
3
    android:name=".MainActivity"
4
    android:launchMode="singleTop"
5
    android:exported="true"
6
    ...>
7

8
    <!-- Your existing LAUNCHER intent-filter -->
9
    <intent-filter>
10
        <action android:name="android.intent.action.MAIN" />
11
        <category android:name="android.intent.category.LAUNCHER" />
12
    </intent-filter>
13
</activity>
14

15
<!-- Add this new activity to your manifest to receive deep links -->
16
<activity
17
    android:name=".DedicatedDeepLinkActivity"
18
    android:launchMode="singleTask"
19
    android:exported="true"
20
    android:noHistory="true"
21
    android:theme="@android:style/Theme.Translucent.NoTitleBar">
22

23
    <!-- Add this intent filter for your Adjust branded domain -->
24
    <intent-filter android:autoVerify="true">
25
        <action android:name="android.intent.action.VIEW" />
26
        <category android:name="android.intent.category.DEFAULT" />
27
        <category android:name="android.intent.category.BROWSABLE" />
28
        <data
29
            android:scheme="https"
30
            android:host="brandname.go.link" />
31
    </intent-filter>
32

33
    <!-- Add this intent filter for your app scheme -->
34
    <intent-filter>
35
        <action android:name="android.intent.action.VIEW" />
36
        <category android:name="android.intent.category.DEFAULT" />
37
        <category android:name="android.intent.category.BROWSABLE" />
38
        <data android:scheme="example" />
39
    </intent-filter>
40

41
</activity>

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

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

データポイント	例	要件
リリースアプリID	com.example.app	必須
デバッグアプリID	com.example.app.debug	デバッグアプリIDがリリースアプリIDと異なる場合に必要です。
リリースアプリスキーム	example://	Android アプリリンクがサポートされていないユースケースに必要です。
デバッグアプリスキーム	exampleDebug://	デバッグアプリスキームがリリースアプリスキームと異なる場合に必要です。

Android アプリリンクで ディープリンク を設定するには、リリースおよびdebug buildのSHA-256証明書のフィンガープリントも取得する必要があります。