ディープリンクが開かない時の確認方法｜原因を順番に切り分ける

1. 元のHTTPS URLが正しく開くか確認する

最初に、変換前のURLをSafariやChromeなど通常ブラウザで開きます。元URL自体が削除済み、非公開、ログイン必須、短縮URLの解決失敗などで開けない場合、ディープリンク側だけを直しても解決しません。

2. 対象アプリがインストールされているか確認する

カスタムURLスキームは、対象schemeを処理できるアプリが端末に存在することが前提です。アプリ未導入時に自動でストアへ送り、インストール後に目的位置まで復帰する仕組みはディファードディープリンクなど別の設計になります。

未導入時の行き先そのものを確認したい場合はアプリ未インストール時のfallbackを参照してください。

3. どこからタップしたかを確認する

同じURLでも、Safari/Chrome、メール、メッセージアプリ、InstagramやXなどのアプリ内ブラウザでは挙動が変わることがあります。LINE Developersも2026年5月の公式記事で、Facebook・Instagram・Xなどのアプリ内ブラウザでは、OS・ブラウザ・WebViewの仕様によって別アプリの起動が期待どおりにならない場合があると説明しています。

外部ブラウザで開けば必ず直るわけではありませんが、アプリ内ブラウザ固有の問題かどうかを切り分ける材料になります。詳しくはアプリ内ブラウザから別アプリを開く時の確認ポイントで整理しています。

4. リンク形式を確認する

「ディープリンク」と呼ばれるリンクには複数方式があります。方式を混同すると、期待する挙動と実際の挙動がずれます。

各方式の比較はディープリンクとは？、個別仕様はURLスキーム・Universal Links・Android App Linksへ分けています。

5. iPhoneだけ開かない場合

iPhoneではUniversal Linksの同一ドメインSafari挙動、アドレスバー直接入力、ユーザーの過去の選択、AASA/Associated Domainsなどを確認します。Safariに開いたことだけで設定ミスとは判断できません。

iOS固有の切り分けはiPhoneでディープリンクが開かない時へ進んでください。

6. Androidだけ開かない場合

AndroidではApp Linksの検証状態、assetlinks.json、対応リンク設定、Android 12以降のWebリンク処理、Intent URLの条件などを確認します。

Android固有の確認はAndroidでディープリンクが開かない時へ分けています。

7. そのURLタイプが製品対応範囲か確認する

同じサービスでも、プロフィール、投稿、動画、検索、プレイリストなどでURL構造が異なります。ジェネレーター側がそのURLを判定できても、保存APIや短縮リダイレクト側が同じレベルで対応しているとは限りません。

特に現在のYouTube保存経路には既知の未完成処理があります。直接生成の結果と保存したリンクの結果を同一視せず、対応URLと機能範囲を確認してください。

8. Web fallbackを確認する

アプリ起動に失敗しても、元のWebページが開けば利用者は目的の内容へ到達できます。リンク作成時はアプリ起動だけに依存せず、通常のHTTPS URLを残しておくことが重要です。

原因別の判断早見表