ユニバーサルリンクとApp Links

この記事では、Apple ユニバーサルリンクと Android App Links の設定方法について説明します。

Apple ユニバーサルリンクと Android App Links は、Web コンテンツとモバイルアプリ間のシームレスな遷移を提供するために考案されたメカニズムです。ユニバーサルリンクは iOS 固有のものですが、Android App Links は Android アプリケーションで同じ目的を果たします。

ユニバーサルリンクと App Links の仕組み

ユニバーサルリンク（iOS）と App Links（Android）は、Web ページとアプリ内のコンテンツの両方を指す標準的な Web リンク（http://mydomain.com）です。

ユニバーサルリンクまたは App Link が開かれると、オペレーティングシステムはそのドメインに登録されたインストール済みアプリがあるかどうかを確認します。アプリが見つかった場合、Web ページを読み込むことなく即座にアプリが起動されます。アプリが見つからない場合、Web URL がユーザーのデフォルト Web ブラウザーで読み込まれ、それぞれ App Store または Google Play Store にリダイレクトするように設定することもできます。

簡単に言えば、ユニバーサルリンクにより、Web サイトはその Web ページを特定のアプリ画面に関連付けることができます。そのため、ユーザーがアプリ画面に対応する Web ページへのリンクをクリックすると、アプリを直接開くことができます（アプリが現在インストールされている場合）。

次の表は、ユニバーサルリンクと従来のディープリンクの主な違いをまとめたものです。

ユースケース

ユニバーサルリンクと App Links は、メール Campaign で最も一般的に使用されます。メールはデスクトップとモバイルデバイスの両方から開いてクリックできるためです。

一部のチャネルはこれらのリンクとうまく連携しません。たとえば、プッシュ通知、アプリ内メッセージ、Content Cards では、スキームベースのディープリンク（mydomain://）を使用する必要があります。

前提条件

ユニバーサルリンクと App Links を使用するには、以下が必要です。

• Web サイトが HTTPS 経由でアクセス可能であること
• アプリが App Store（iOS）または Google Play Store（Android）で利用可能であること

ユニバーサルリンクと App Links の設定

アプリがユニバーサルリンクまたは App Links をサポートするには、iOS と Android の両方で、リンクドメインに特別な権限ファイルをホストする必要があります。このファイルには、そのドメインからのリンクを開くことができるアプリの定義と、iOS の場合はそれらのアプリが開くことを許可されるパスが含まれています。

• iOS: Apple App Site Association（AASA）ファイル
• Android: Digital Asset Links ファイル

この権限ファイルに加えて、アプリが開くことを許可されるリンクドメインのハードコードされた定義がアプリ内に設定されます。

• iOS: Xcode で「Associated Domains」として設定
• Android: アプリの AndroidManifest.xml ファイルで定義

この2つのパートからなるドメインとアプリの関連付けは、ユニバーサルリンクまたは App Link が機能するために必要であり、任意のアプリが特定のドメインからのリンクを乗っ取ったり、任意のドメインが特定のアプリを開いたりすることを防ぎます。

• ios
• android

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "JHGFJHHYX.com.facebook.ios",
        "paths": [
          "*"
        ]
      }
    ]
  }
}

ユニバーサルリンク、App Links、およびクリックトラッキング

メール送信パートナーである SendGrid と SparkPost は、クリックトラッキングドメインを使用してすべてのリンクをラップし、Braze メールのクリックトラッキング用の URL パラメーターを含めます。

たとえば、https://www.example.com のようなリンクは https://links.email.example.com/uni/wf/click?upn=abcdef123456… のようになります。

クリックトラッキング付きのメールリンクをユニバーサルリンクまたは App Links として機能させるには、追加の設定が必要です。クリックトラッキングドメイン（links.email.example.com）を、アプリが開くことを許可されるドメインとして追加してください。さらに、クリックトラッキングドメインは AASA（iOS）または Digital Asset Links（Android）ファイルを提供する必要があります。これにより、クリックトラッキング付きのメールリンクがシームレスに機能するようになります。

すべてのクリックトラッキングリンクをユニバーサルリンクまたは App Link にしたくない場合は、メール送信パートナーに基づいてどのリンクをユニバーサルリンクにするかを指定できます。詳細については、以下のセクションを参照してください。

SendGrid

SendGrid のクリックトラッキングリンクをユニバーサルリンクとして扱うには、以下を行います。

1. AASA または AndroidManifest の pathPrefix 値を設定して、URL パスに /uni/ を含むリンクのみをユニバーサルリンクとして扱うようにします。
2. リンクのアンカータグ（<a>）に属性 universal="true" を追加します。これにより、ラップされたリンクの URL パスに /uni/ が含まれるようになります。

例：

1
<a href=”https://www.example.com” universal="true">

3. アプリがラップされたリンクを適切に処理するように設定されていることを確認します。SendGrid の記事 Resolving SendGrid Click Tracking Links を参照し、お使いのオペレーティングシステムの手順に従ってください。この記事には iOS と Android のサンプルコードが含まれています。

この設定により、URL パスに /uni/ を含むリンクはユニバーサルリンクとして機能し、その他のすべてのリンクは Web リンクとして機能します。

SparkPost

SparkPost のクリックトラッキングリンクをユニバーサルリンクとして扱うには、メールのドラッグ＆ドロップエディターの属性セクションに以下の属性を追加するか、リンクの HTML を手動で編集してリンクのアンカータグに以下の属性を含めます：data-msys-sublink="custom_path"。

このカスタムパスにより、その値を持つ URL を選択的にユニバーサルリンクとして扱うことができます。

例：

1
<a href=”https://www.example.com” data-msys-sublink="open-in-app">

次に、アプリがカスタムパスを適切に処理するように設定されていることを確認します。SparkPost の記事 Using SparkPost click tracking on deep links を参照してください。この記事には iOS と Android のサンプルコードが含まれています。

リンクごとのクリックトラッキングの無効化

特定のリンクのクリックトラッキングを無効にするには、HTML エディターのメールメッセージに HTML コードを追加するか、ドラッグ＆ドロップエディターの HTML ブロックに追加します。

SendGrid

メールサービスプロバイダー (ESP) が SendGrid の場合、次のように HTML コード clicktracking=off を使用します。

<a clicktracking=off href="[INSERT https LINK HERE]">click here</a>

SparkPost

メールサービスプロバイダー (ESP) が SparkPost の場合、次のように HTML コード data-msys-clicktrack="0" を使用します。

<a data-msys-clicktrack="0" href="[INSERT https LINK HERE]">click here</a>

Amazon SES

メールサービスプロバイダー (ESP) が Amazon SES の場合、次のように HTML コード ses:no-track を使用します。

<a ses:no-track href="[INSERT https LINK HERE]">click here</a>

ドラッグ＆ドロップエディター

ドラッグ＆ドロップメールエディターを使用する場合、リンクがテキスト、ボタン、または画像に添付されている場合は、HTML コードをカスタム属性として入力します。

テキストリンクのカスタム属性

SendGrid

カスタム属性に以下を選択します。

• Name: clicktracking
• Value: off

SparkPost

カスタム属性に以下を選択します。

• Name: data-msys-clicktrack
• Value: 0

ボタンまたは画像のカスタム属性

SendGrid

カスタム属性に以下を選択します。

• Name: clicktracking
• Value: off
• Type: Link

SparkPost

カスタム属性に以下を選択します。

• Name: data-msys-clicktrack
• Value: 0
• Type: Link

クリックトラッキング付きユニバーサルリンクのトラブルシューティング

メール内のユニバーサルリンクが期待どおりに機能しない場合（受信者がメールアプリから Web ブラウザーに移動し、最終的にアプリにリダイレクトされるなど）、以下のヒントを参照してユニバーサルリンクの設定をトラブルシューティングしてください。

リンクファイルの場所を確認する

AASA ファイル（iOS）または Digital Asset Links ファイル（Android）が正しい場所にあることを確認します。

• iOS: https://click.tracking.domain/.well-known/apple-app-site-association
• Android: https://click.tracking.domain/.well-known/assetlinks.json

これらのファイルが常に公開アクセス可能であることを確認することが重要です。アクセスできない場合は、メール用のユニバーサルリンクの設定手順を見落としている可能性があります。

ドメイン定義を確認する

アプリが開くことを許可されるドメインの定義が正しいことを確認します。

• iOS: Xcode でアプリに設定された Associated Domains を確認します（ステップ 1c）。クリックトラッキングドメインがそのリストに含まれていることを確認します。
• Android: アプリ情報ページを開きます（アプリアイコンを長押しして ⓘ をクリック）。アプリ情報メニュー内で Open by default を見つけてタップします。アプリが開くことを許可されているすべての検証済みリンクが表示される画面が表示されます。クリックトラッキングドメインがそのリストに含まれていることを確認します。