iOS용 URI 스키마 폴백

요약: iOS 기기 사용자가 원링크 커스텀 링크를 클릭하고 유니버설 링크가 앱을 열지 못하는 경우의 흐름을 이해합니다.

iOS용 URI 폴백 정보

  • iOS 기기에서 앱을 실행하는 가장 좋은 방법은 유니버설 링크를 사용하는 것입니다. 2016년 이후 iOS 유니버설 링크가 앱을 열지 못하면 내장 OS에서 URI 스킴을 폴백 메서드로 사용하는 데 상당한 제약이 있습니다. 이러한 제한은 앱스플라이어와 관련이 없으며 앱을 여는 데 사용할 수 있는 URI 스키마가 있는 다른 링크에도 영향을 미칩니다.
  • 기본적으로 URI 스키마(af_dp 파라미터의 값으로 전달됨)은 몇 가지 특정 브라우저/플랫폼에서 iOS의 앱을 열기 위한 폴백 방법으로만 사용됩니다.
  • Safari의 경우 원링크 URL에서 다음 파라미터를 설정하여 iOS에서 앱을 열기 위한 대체로 URI 스키마를 사용할 수 있습니다. 
    • af_dp (URI 스키마를 값으로 전달).
    • af_force_deeplink=true (af_dp URI 스키마를 사용하여 앱을 강제로 열림). 이 파라미터가 없으면 앱이 URI 스키마를 사용하여 열리지 않습니다.
  • 다른 브라우저의 경우 URI 스키마는 예측할 수 없으므로 기본적으로 지원되지 않습니다. 링크를 클릭하는 사용자는 앱 스토어(또는 설정된 경우 af_ios_url 파라미터에 설정된 URL)로 리디렉션될 수 있습니다.
  • 자세한 내용은 시나리오 순서도 및 사용 사례를 참조하십시오. 

시나리오 흐름도

Copy_of_Ios_fall_back_-_scenarios_flowchart__2_.png

활용 사례

기본적으로 URI 스키마를 사용할 수 있는 브라우저

앱이 없거나 링크에 유니버설 링크가 구성되어 있지 않기 때문에 유니버설 링크가 앱을 열지 못하는 경우가 있습니다. 이러한 경우 다음 브라우저/플랫폼은 기본적으로 앱을 여는 대체 방법으로 URI 스키마를 사용할 수 있습니다.

  • Chrome
  • X(이전의 트위터)
    참고: 앱이 인스톨되지 않은 경우 사용자에게 오류 메시지가 표시되고 메시지를 닫은 후 앱 스토어로 리디렉션됩니다(또는 af_ios_url 파라미터에 따라).
  • 카카오톡
  • 네이버
  • 네이버 블로그
  • Weibo

흐름도

Copy_of_Ios_fall_back_-_browsers_that_can_use_URI_schemes_by_default__2_.png

Safari

다음은 유니버설 링크가 앱을 여는 데 실패하고 링크에 af_dp (URI 스키마를 값으로 전달)가 포함된 경우 사용자의 흐름을 설명합니다.

앱이 인스톨되지 않은 경우:

  1. Safari 오류 메시지 대화 상자가 표시됩니다.

  2. 사용자는 확인을 클릭하여 화 상자를 닫고 백그라운드에서 랜딩 페이지 로드를 잠시 확인한 다음 1초 이내에 앱 스토어 또는 af_ios_url 파라미터에 따라 자동으로 리디렉션됩니다.

앱이 인스톨된 경우: 

  • 링크에 af_force_deeplink=true 가 포함되어 있지 않으면 사용자가 App Store로 리디렉션되거나 af_ios_url 파라미터에 따라 리디렉션됩니다.
  • 링크에 af_force_deeplink=true가 포함된 경우:
    1. Safari 대화 상자가 표시됩니다.

    2. 사용자가 열기를 클릭하면 앱이 열립니다.
    3. 사용자가 취소를 클릭하는 경우:
      • af_ios_url 파라미터가 설정되면 그에 따라 사용자가 리디렉션됩니다.
      • af_ios_url 파라미터가 설정되지 않은 경우 Safari 오류 메시지 대화상자가 백그라운드에서 랜딩 페이지 위에 표시됩니다.

    4. 사용자가 확인을 클릭하면 콜투액션(CTA)이 포함된 랜딩 페이지가 표시됩니다.
    5. 사용자가 CTA를 클릭하면 대화 상자가 표시됩니다.

    6. 사용자가 열기를 클릭하면 앱이 열립니다. 
    7. 사용자가 취소를 클릭하면 대화 상자가 표시됩니다.

    8. 사용자가 확인을 클릭하면 앱 스토어로 리디렉션됩니다. 
    9. 사용자가 취소를 클릭하면 방문 페이지에 남아 있습니다. 

흐름도

Copy_of_Ios_fall_back_-_safari.png

페이스북 게시물 -미지급

다음은 유니버설 링크가 앱을 여는 데 실패하고 링크에 af_dp (URI 스키마를 값으로 전달)가 포함된 경우 사용자의 흐름을 설명합니다.

앱이 인스톨된 경우: 

  • 앱이 열립니다.

앱이 인스톨되지 않은 경우: 

  1. 구성된 소셜 미디어 앱이 없거나 사용자가 SALP에서 CTA를 클릭하면 백그라운드에서 랜딩 페이지 위에 대화 상자가 표시됩니다.

  2. 앱 열기를 클릭합니다. 다음 결과 중 하나가 발생할 수 있습니다.
    • af_ios_url param이 설정되면 그에 따라 사용자가 리디렉션됩니다.
    • af_ios_url param이 설정되지 않고 af_force_deeplink=true 링크에 없으면 사용자가 그에 따라 리디렉션됩니다.
    • af_ios_url 매개변수가 설정되지 않은 경우 링크에 있는 경우 af_force_deeplink=true 백그라운드의 랜딩 페이지 위에 대화 상자가 다시 표시됩니다.

  3. 사용자가 열기를 클릭하면 앱 스토어로 전송됩니다.
  4. 사용자가 닫기를 클릭하면 백그라운드에서 랜딩 페이지가 표시됩니다.

  5. 사용자가 앱 스토어 배지를 클릭하면 앱 스토어로 리디렉션됩니다.

흐름도

diagram-X.png