Dynamic Link を作成するには、次の形式の URL を手動で構築します。
https://your_subdomain.page.link/?link=your_deep_link&apn=package_name[&amv=minimum_version][&afl=fallback_link]
Dynamic Link パラメータ
| ディープリンク パラメータ（ペイロード パラメータ） | |
|---|---|
| リンク |
アプリで開くリンク。アプリで処理可能な URL を指定します。通常、この URL はアプリ固有のロジック（ユーザーへのクーポン付与や特定の開始画面の表示など）を起動するアプリのコンテンツやペイロードへのリンクです。このリンクは適切な形式の URL で、正しく URL エンコードされている必要があります。HTTP または HTTPS のいずれかを使用してください。他のダイナミック リンクは使用できません。 |
| Android 向けパラメータ | |
|---|---|
| apn | リンクを開くために使う Android アプリのパッケージ名。Firebase コンソールの [概要] ページで、アプリとプロジェクトが接続されている必要があります。Dynamic Link で Android アプリを開くために必須です。 |
| afl | アプリがインストールされていない場合に開くリンク。モバイルウェブ バージョンのコンテンツを開いたり、アプリの宣伝ページを開いたりするなど、アプリがインストールされていないときに Play ストアからアプリをインストールする以外の動作をさせる場合に指定します。 |
| amv | リンクを開くことができるアプリの最小バージョンの versionCode。インストールされているアプリのバージョンがそれよりも古い場合、ユーザーは Play ストアにリダイレクトされ、アプリのアップグレードを促されます。 |
| iOS 向けパラメータ | |
|---|---|
| ibi | リンクを開くために使う iOS アプリのバンドル ID。Firebase コンソールの [概要] ページで、アプリとプロジェクトが接続されている必要があります。Dynamic Link で iOS アプリを開くために必須です。 |
| ifl | アプリがインストールされていない場合に開くリンク。モバイルウェブ バージョンのコンテンツを開いたり、アプリの宣伝ページを開いたりするなど、アプリがインストールされていないときに App Store からアプリをインストールする以外の動作をさせる場合に指定します。 |
| ius | アプリのカスタム URL スキーム（アプリのバンドル ID とは異なるものを定義している場合）。 |
| ipfl | アプリがインストールされていない場合に iPad で開くリンク。ウェブ バージョンのコンテンツを開いたり、アプリの宣伝ページを開いたりするなど、アプリがインストールされていないときに App Store からアプリをインストールする以外の動作をさせる場合に指定します。 |
| ipbi | iPad でリンクを開くために使う iOS アプリのバンドル ID。Firebase コンソールの [概要] ページで、アプリとプロジェクトが接続されている必要があります。 |
| isi | アプリの App Store ID。アプリがインストールされていない場合にユーザーを App Store に転送するために使用します。 |
| imv | リンクを開くことができるアプリの最小バージョンのバージョン番号。このフラグは、リンクを開くとアプリに渡されますが、処理方法はアプリ側で決める必要があります。 |
| efr | 「1」に設定されている場合は、Dynamic Link が開かれたときにアプリのプレビュー ページをスキップし、代わりにアプリまたはストアにリダイレクトします。アプリのプレビュー ページ（デフォルトで有効）を使用すると、ユーザーがアプリで Dynamic Links を開いたときに、最適な宛先に確実に誘導できます。ただし、このページを使用せずに Dynamic Links を確実に開くことができるアプリでのみ Dynamic Link を開くようにする場合は、このパラメータを使用して無効にできます。このパラメータは、iOS の Dynamic Link の動作のみに影響します。 |
| その他のプラットフォームのパラメータ | |
|---|---|
| ofl | Android と iOS 以外のプラットフォームで開くリンクです。これは、デスクトップ上では異なる動作を指定する場合に役立ちます。たとえば、アプリをインストールするための別のダイナミック リンクが含まれる、アプリのコンテンツやペイロードの完全なウェブページを表示する場合などです（リンク パラメータで指定します）。 |
| ソーシャル メタタグのパラメータ | |
|---|---|
| st | ソーシャル投稿で Dynamic Link を共有するときに使用するタイトル。 |
| sd | ソーシャル投稿で Dynamic Link を共有するときに使用する説明。 |
| si | このリンクに関連する画像への URL。画像は 300x200 ピクセル以上、300 KB 未満である必要があります。 |
| 解析パラメータ | |
|---|---|
| utm_source utm_medium utm_campaign utm_term utm_content |
Google Play の解析パラメータ。 |
| at ct mt pt |
iTunes Connect の解析パラメータ。 |
URL のデバッグ
Dynamic Link をデバッグするには、長い形式または短い形式の URL にデバッグ パラメータを付加します。
https://example.page.link/?link=https://www.example.com&d=1 https://example.page.link/WXYZ?d=1
| デバッグ パラメータ | |
|---|---|
| d | Dynamic Link を読み込む代わりにフローチャートを生成します。このフローチャートを使用して、別のプラットフォームや構成での Dynamic Links の動作をプレビューできます。 |
次のステップ
Dynamic Link を作成したら、アプリが Dynamic Links を受け取るよう設定し、ユーザーがこれを開いたときにアプリ内の適切な場所に転送されるようにする必要があります。
アプリで Dynamic Links を受信する方法については、iOS、Android、C++、Unity のドキュメントをご覧ください。