모바일 딥링크 구현 — 앱으로 정확히 보내기 | 기술노트

핵심 요약

딥링크는 ① 커스텀 스킴(myapp://) — 간단하지만 미설치 시 동작 안 함, ② 유니버설 링크(iOS)·앱 링크(Android) — 일반 https URL로 앱을 열고, 미설치면 웹으로 폴백. 운영엔 후자가 권장이며, 도메인에 검증 파일을 올려야 동작한다.

1. 방식 비교

	커스텀 스킴	유니버설/앱 링크
형태	myapp://path	https://도메인/path
미설치 폴백	안 됨(에러)	웹으로 자연 폴백
검증 파일	불필요	필요

2. 검증 파일

iOS: /.well-known/apple-app-site-association(AASA)
Android: /.well-known/assetlinks.json
HTTPS·정확한 경로·앱 설정과 일치해야 한다

3. 함정

AASA는 Content-Type/리다이렉트 없이 정확히 서빙해야 인식된다
설치 직후 첫 클릭은 OS 캐시로 동작이 다를 수 있다
미설치 사용자를 위한 스토어/웹 폴백 흐름을 꼭 설계

자주 묻는 질문

커스텀 스킴이면 충분하지 않나요?

앱이 설치돼 있을 때만 동작하고 미설치 시 에러가 납니다. 일반 사용자에게 보낼 링크라면 미설치 폴백이 되는 유니버설/앱 링크가 안전합니다.

검증 파일을 올렸는데 앱이 안 열려요.

경로·HTTPS·Content-Type·리다이렉트 여부를 확인하세요. AASA/assetlinks는 정확한 위치에서 리다이렉트 없이 서빙돼야 하며, 반영에 시간이 걸리기도 합니다.