🔀 딥링크

iOS Universal Links, Android App Links를 통한 모바일 딥링크 설정 가이드입니다.

딥링크란?

딥링크(Deep Link)는 단축 URL을 클릭했을 때 앱이 설치된 경우 앱의 특정 화면을 직접 열어주는 기능입니다. 앱이 설치되지 않은 경우 앱스토어로 이동하거나 웹 페이지를 표시하는 등 유연한 처리가 가능합니다.

기술플랫폼설명
Universal LinksiOSApple이 제공하는 딥링크 표준. HTTPS 기반으로 동작
App LinksAndroidGoogle이 제공하는 딥링크 표준. 인텐트 필터 기반
URL SchemeiOS/Android커스텀 프로토콜 기반 (예: myapp://). 폴백용으로 사용

딥링크 동작 원리

사용자가 단축 URL 클릭
예: https://mydomain.fplink.net/myapp/abc123
플랫폼 감지
서버가 클릭한 디바이스의 OS(iOS/Android/PC)를 감지합니다.
앱 설치 여부에 따른 분기
앱 설치됨: Universal Links / App Links로 앱이 직접 열리고 딥링크 경로로 이동
앱 미설치: 폴백 전략에 따라 앱스토어, 원본 URL, 또는 중간 페이지로 이동

딥링크 설정 과정

🔐 필수 요구사항
딥링크(Universal Links / App Links)가 동작하려면 반드시 커스텀 도메인이 설정되어야 합니다. 기본 도메인(fplink.net)에서는 딥링크가 동작하지 않습니다.

1단계: 커스텀 도메인 등록

커스텀 도메인 페이지를 참고하여 도메인을 등록하고 인증합니다. 예: link.mycompany.com

2단계: 앱 등록

앱 관리에서 iOS/Android 앱을 등록합니다. 딥링크에 필요한 핵심 정보:

  • iOS: Bundle ID + Apple Team ID
  • Android: Package Name + SHA256 Certificate Fingerprints

3단계: URL/캠페인에 앱 연결

URL 또는 캠페인 생성 시 고급 설정 → 모바일 딥링크에서 등록한 앱을 선택합니다. 필요한 경우 딥링크 경로(예: /product/123)를 추가로 지정합니다.

폴백 전략

앱이 설치되지 않은 사용자가 클릭했을 때의 동작을 선택할 수 있습니다.

전략동작추천 상황
원본 URL 설정한 원본 URL로 리디렉션 웹에서도 동일 콘텐츠 제공 가능한 경우
중간 페이지 브랜딩된 중간 페이지 표시 (앱 열기/스토어 이동 버튼) 앱 설치를 유도하고 싶은 경우
앱스토어 해당 OS의 앱스토어로 직접 이동 앱 전용 서비스인 경우
앱 열기 버튼 (앱 설치됨)
📸

캡처 대상: 앱 설치 시 중간 페이지
"앱 열기" 버튼 1개만 표시되는 화면을 캡처해주세요.

/images/docs/console/deeplink-app-open.png
중간 페이지 (앱 미설치)
📸

캡처 대상: 앱 미설치 시 중간 페이지
"앱 열기" + "웹사이트 열기" 버튼 2개가 표시되는 화면을 캡처해주세요.

/images/docs/console/deeplink-intermediate.png

자동 실행 설정

URL/캠페인의 고급 설정에서 앱 자동 실행 옵션을 제어할 수 있습니다.

옵션ONOFF
앱 자동 실행 페이지 로드 시 즉시 앱 실행 시도 "앱 열기" 버튼 클릭으로만 실행 (iOS 브라우저 얼럿 최소화)
앱스토어 자동 이동 앱 미설치 시 자동으로 스토어 이동 중간 페이지에서 수동으로 선택
💡 iOS에서의 자동 실행
iOS Safari에서 앱 실행 시 브라우저가 확인 얼럿을 표시할 수 있습니다. 이를 피하고 싶다면 앱 자동 실행을 OFF로 설정하고, 사용자가 직접 "앱 열기" 버튼을 클릭하도록 하는 것이 UX 측면에서 좋습니다.

딥링크 검증

앱 목록에서 🔍 딥링크 검증 버튼을 클릭하면 Universal Links / App Links 설정이 올바르게 되어 있는지 테스트할 수 있습니다.

검증 항목:

  • /.well-known/apple-app-site-association 파일 확인 (iOS)
  • /.well-known/assetlinks.json 파일 확인 (Android)
  • 커스텀 도메인 연결 상태
  • 앱 설정 정보 유효성 (Team ID, Bundle ID, SHA256 등)
딥링크 검증 모달
📸

캡처 대상: 딥링크 검증 모달/팝업
검증 결과(성공/실패 항목)가 표시된 화면을 캡처해주세요. 가능하면 모든 항목이 통과(✅)된 상태가 이상적입니다.

/images/docs/console/deeplink-verify.png