リンクのresolution（解析と変換）

メール、SMS、QRコード、リンクを短縮するプラットフォームを介したディープリンクのリンク解析を設定する必要があります。そのようなケースのためにリンク解析を設定しない場合、ユニバーサルリンクからのリダイレクトでは、アプリをインストールしているユーザーを含めた全てのユーザーがApp Storeに誘導されます。リンク解析が有効な場合、ユニバーサルリンクへのリダイレクトはアプリ内で発生し、既存のユーザーはApp Storeに誘導されません。

計測の仕組み

リンク解析は、アプリをインストールしているユーザーがリダイレクトURLをクリックしたときにのみ実行されます。リダイレクトURL内のドメインを、アプリ内のユニバーサルリンクドメインとして設定する必要があります。

リンク解析は次のように機能します。

1. 既存のユーザーがリダイレクトリンクをクリックすると、iOSでアプリが開きます。
2. アプリがリダイレクトURLをAdjust SDKのresolveLinkWithUrlのリンク解析メソッドにパスします。
3. Adjust SDKのリンク解析メソッドで、リダイレクトURL内のドメインと開発者がAdjust SDKで設定したリンク解析ドメインが比較され、次のいずれかが実行されます。

• ドメインが一致しない - メソッドはディープリンクURLをそのまま返します。
• ドメインが一致する - メソッドはリンクを解析し、結果のディープリンクを返します。

URLの解析と変換が行われると、Adjust SDKは最大10のリダイレクトをフォローアップします。リダイレクトが10以上ある場合は、10番目のリダイレクトURLが返されます。

1. アプリは返されたURLを受け取り、ディープリンクコンテンツを開いてユーザーに表示します。またアプリは、返されたURLを使用してAdjust SDKのappWillOpenUrlメソッドを呼び出します。これにより、解析されたURLがトラッキングのためにAdjustバックエンドに送られます。

ユース ケース

リンク解析は、次の場合に実行されます。

• Eメールマーケティング
• URLを短縮するプラットフォーム

Eメールマーケティング

メールマーケターがキャンペーンを実施する際、メールマーケティングプラットフォームでは通常、独自のクリック計測用リダイレクトURLを使用してメール内の全てのリンクをラップします。これによりメールマーケターは、メールマーケティングプラットフォームでクリック（click-through）率を確認できます。ただし、メールにユニバーサルリンクが含まれている場合、リダイレクトURLが原因でiOSはユニバーサルリンクを正しく解析できません。

設定

1. 使用しているドメイン上に、メールトラッキング専用のドメインまたはサブドメインを作成します。メールトラッキング用のドメインまたはサブドメインがすでにある場合は、既存のキャンペーンを妨げることなくこの実装を完了できるよう、新たに作成することをお勧めします。この実装を完了してテストした後に、この実装を既存のメールリダイレクトドメインに切り替えることができます。

例​ ：email.example.com

1. Xcodeで、メールリダイレクトドメインをAssociated Domains設定に追加します。 例​ ：applinks:email.example.com

2. ユニバーサルリンクを設定します。

3. resolveLinkWithUrlリンク解析メソッドのresolveUrlSuffixArrayにメールリダイレクトドメインを追加したことを確認します。

4. メールマーケティングプラットフォーム/ESPを使用して、メールリダイレクトドメインをカスタムトラッキングドメインとして設定します。

5. メールリダイレクトドメインへの受信リクエストを処理するために、Amazon CloudFront、CloudFlare、Fastlyなどのコンテンツ配信ネットワーク（CDN）を設定します。CDNで、以下を設定してください。

   1. SSL証明書 - iOSでは、ユニバーサルリンクでHTTPSのみを使用する必要があります。そのため、メールリダイレクトドメインにはSSL証明書が必要です。
   2. AASA（Apple-App-Site-Association）ファイル - メールパートナーによっては、独自のAASAファイルをホストするか、AASAファイルをメールパートナーシステムにアップロードする必要があります。AASAファイルのホスティングについては、メールパートナーのドキュメントを参照してください。

   次のパスでホストされているユニバーサルリンクのAASAファイルをダウンロードすることができます。https://example.go.link/.well-known/apple-app-site-associationドメインはユニバーサルリンクドメインに置き換えてください。それから、AdjustユニバーサルリンクのAASAファイルをコピーし、メールリダイレクトドメインのAASAファイルに使用してください。 独自のAASAファイルをホストすることをメールパートナーが求めている場合、CDNではメールリダイレクトドメイン上の対応するパス（https://email.example.com/.well-known/apple-app-site-association）からそのファイルを提供する必要があります。 3. （該当する場合、AASAファイルを除いた）メールリダイレクトドメインへの全てのリクエストをメールパートナーのリダイレクトサーバーにポイントします。 例​ ：redirect.example.net

6. CDNをポイントするようにメールリダイレクトドメインのDNSを設定します。

上記の指示に対応するパートナー固有の指示については、ヘルプセンターのESP連携に関するセクションを参照してください。

メールパートナーのサポート​

リンク解析を使用するためには、リダイレクトドメイン（またはサブドメイン）をユニバーサルリンクドメインとして設定することをメールパートナーが許可している必要があります。許可されている場合、それらのリダイレクトサービスを独自のカスタムドメインにポイントできます。

例：​

• Braze - 割り当てられているESP Brazeに応じて、SendGridまたはSparkPostでリダイレクトドメインを設定し、独自のカスタムドメインをそれにポイントします。その後、カスタムドメインをユニバーサルリンクドメインとして設定できます。

• Iterable - Iterableでは、カスタムドメインをサポートするURLリダイレクトサービスが提供されています。

• Mailchimp - Mailchimpでは、リダイレクトドメインをユニバーサルリンクとして設定することが許可されていないため、リンク解析は利用できません。

URL短縮

マーケターが特定の種類のキャンペーンを実施する際、短いURLが必要になる場合があります。例えば、SMSには160文字の制限がありますが、リンクを短縮してSlackなどのチームコミュニケーションプラットフォームで共有することが望まれる場合があります。ただし、短縮URLがユニバーサルリンクにリダイレクトされる場合、iOSはユニバーサルリンクを正しく解析できません。

設定

1. 使用しているドメイン上に、URL短縮専用のドメインまたはサブドメインを作成します。 URL短縮用のドメインまたはサブドメインがすでにある場合は、既存のキャンペーンを妨げることなくこの実装を完了できるよう、新たに作成することをお勧めします。この実装を完了してテストした後に、この実装を既存のURL短縮ドメインに切り替えることができます。

2. XcodeでURL短縮ドメインをAssociated Domains設定に追加します。 例​ ：applinks:short.example.com

3. ユニバーサルリンクを設定します。

4. resolveLinkWithUrlリンク解析メソッドのresolveUrlSuffixArrayにメールリダイレクトドメインを追加したことを確認します。

5. ユニバーサルリンクをサポートするURL短縮サービスを設定します。AdjustではURL短縮サービスを提供していません。 例​ ： short.io

6. URL短縮サービスで、URL短縮ドメインをカスタムドメインとして設定します。URL短縮サービスのサーバーをポイントするように、URL短縮ドメインのDNSを設定してください（short.ioにカスタムドメインを追加する参照ドキュメント）。

7. URL短縮サービスでユニバーサルリンクを設定します（short.ioのユニバーサルリンクを設定する参照ドキュメント）。