どのようにお手伝いできますか?

iOSでのURIスキームによる代替起動

  • 更新

概要:iOSデバイスのユーザーがOneLinkカスタムリンクをクリックしても、Universal Linksでアプリが開かない場合の動作を説明します。

iOSでのURIスキームによる代替起動について

  • iOSデバイスでアプリを開く方法として、最も広くサポートされているのはUniversal Linksです。 2016年以降、iOSのUniversal Linksでアプリが開かない場合に、URIスキームで代わりに起動する方法には、OS自体による大きな制限があります。これらはAppsFlyerに起因する制限ではなく、URIスキームでアプリを開く他のリンクにも影響します。
  • デフォルトでは、URIスキーム(af_dpパラメータの値として指定)は、一部のブラウザやプラットフォームでのみ、iOSアプリの代替起動に使用されます。
  • Safariでは、OneLink URLに次のパラメータを設定することで、URIスキームによるiOSアプリの代替起動を試すことができます。 
    • af_dp:値としてURIスキームを指定します。
    • af_force_deeplink=true:af_dpに指定したURIスキームでアプリを強制的に開きます。このパラメータがない場合、URIスキームでアプリは開きません。
  • その他のブラウザでは、URIスキームの動作が安定しないため、デフォルトではサポートされていません。リンクをクリックしたユーザーは、App Storeにリダイレクトされる可能性が高くなります(af_ios_urlパラメータが設定されている場合は、そのURLにリダイレクトされます)。
  • 詳しくは、以下のシナリオ別のフローチャートとケース別の動作を参照してください。 

注意

X(Twitter)はURIスキームをサポートしていません。アプリが起動しない問題を避けるため、Universal Linksを設定したソーシャルアプリ向けランディングページ(SALP)の使用を推奨します。 

シナリオ別のフローチャート

flowchartdoctored.png

ケース別の動作

デフォルトでURIスキームを使用できるブラウザ

アプリがインストールされていない場合や、リンクにUniversal Linksが設定されていない場合など、Universal Linksでアプリが開かないことがあります。このような場合、次のブラウザやプラットフォームでは、デフォルトでURIスキームを使用してアプリを代わりに起動できます。

  • Chrome
  • Kakaotalk
  • Naver
  • Naver-Blog
  • Weibo

フローチャート

use case flowchart.png

Safari

Universal Linksでアプリが開かず、リンクにaf_dp(値としてURIスキームを指定)が含まれている場合の動作は、次のとおりです。

アプリがインストールされていない場合:

  1. Safariに「アドレスが無効なため、Safariはページを開けません」というエラーメッセージのダイアログが表示されます。
  2. ユーザーが[OK]をクリックしてダイアログを閉じると、背後でランディングページが読み込まれる様子が一瞬表示されます。その後、1秒以内にApp Store、またはaf_ios_urlパラメータで指定したURLに自動的にリダイレクトされます。
     

アプリがインストールされている場合: 

  • リンクにaf_force_deeplink=trueが含まれていない場合、ユーザーはApp Store、またはaf_ios_urlパラメータで指定したURLにリダイレクトされます。
  • リンクにaf_force_deeplink=trueが含まれている場合:
    1. Safariのダイアログが表示されます。
    2. ユーザーが[開く]をクリックすると、アプリが開きます。
    3. ユーザーが[キャンセル]をクリックした場合:
      • af_ios_urlパラメータが設定されている場合、ユーザーは指定したURLにリダイレクトされます。
      • af_ios_urlパラメータが設定されていない場合、ランディングページの上にSafariのエラーメッセージのダイアログが表示され、「アドレスが無効なため、Safariはページを開けません」と表示されます。
    4. ユーザーが[OK]をクリックすると、操作を促すボタン(CTA)があるランディングページが表示されます。
    5. ユーザーがCTAボタンをクリックすると、ダイアログが表示されます。
    6. ユーザーが[開く]をクリックすると、アプリが開きます。 
    7. ユーザーが[キャンセル]をクリックすると、ダイアログが表示されます。
    8. ユーザーが[OK]をクリックすると、App Storeにリダイレクトされます。 
    9. ユーザーが[キャンセル]をクリックすると、ランディングページにとどまります。 

フローチャート

Copy_of_Ios_fall_back_-_safari.png

Facebookの通常投稿(広告以外)

Universal Linksでアプリが開かず、リンクにaf_dp(値としてURIスキームを指定)が含まれている場合の動作は、次のとおりです。

アプリがインストールされている場合: 

  • アプリが開きます。

アプリがインストールされていない場合: 

  1. ソーシャルメディアアプリが設定されていない場合、またはユーザーがSALP上のCTAボタンをクリックした後、ランディングページの上にダイアログが表示されます。
  2. [アプリを開く]をクリックします。次のいずれかの動作になります。
    • af_ios_urlパラメータが設定されている場合、ユーザーは指定したURLにリダイレクトされます。
    • af_ios_urlパラメータが設定されておらず、リンクにaf_force_deeplink=trueも含まれていない場合、ユーザーは設定に応じてリダイレクトされます。
    • af_ios_urlパラメータが設定されておらず、リンクにaf_force_deeplink=trueが含まれている場合、ランディングページの上に再びダイアログが表示されます。
  3. ユーザーが[開く]をクリックすると、App Storeに移動します。
  4. ユーザーが[閉じる]をクリックすると、背後にあったランディングページが表示されます。
  5. ユーザーがApp Storeのバッジをクリックすると、App Storeにリダイレクトされます。

フローチャート

diagram-X.png