앱 MVP Android App Links: URL 매핑·도메인 검증·앱 이동을 나누는 5가지 기준

앱 MVP Android App Links: URL 매핑·도메인 검증·앱 이동을 나누는 5가지 기준

직접 답변: Android 앱 MVP에서 App Links는 “URL을 선언했다”, “내 도메인과 앱의 연결이 검증됐다”, “사용자가 탭한 URL이 원하는 화면으로 이동했다”를 각각 확인할 때 안전하게 운영할 수 있습니다. manifest 한 줄, assetlinks.json 업로드, 한 번의 앱 실행을 같은 완료 증거로 섞지 마세요.

웹 페이지·메시지·광고의 URL을 앱 화면으로 연결하려는 팀은 링크를 넣는 일부터 시작하기 쉽습니다. Android 공식 문서는 App Links를 자체 웹사이트 URL과 앱을 검증된 방식으로 연결하는 기능으로 설명합니다. 앱이 설치되지 않은 사용자는 웹으로 가고, 연결 검증과 URL 처리 조건이 맞을 때 설치된 앱은 해당 콘텐츠를 직접 열 수 있습니다. 이 글은 특정 앱의 구현·심사 통과·유입 성과를 보장하지 않습니다. MVP 팀이 연결 상태를 나누어 확인하는 운영 기준입니다.

먼저 일반 딥링크와 검증된 App Links를 구별합니다

일반 딥링크는 앱의 intent-filter가 URL과 맞을 때 시스템이 처리 후보 앱을 찾는 방식입니다. Android는 여러 앱이 같은 URL을 처리할 수 있고 사용자의 기본 앱 설정도 경로에 영향을 준다고 설명합니다. 특히 Android 12 이상에서는 승인되지 않은 일반 웹 링크가 보통 브라우저로 열릴 수 있습니다. 따라서 “앱이 URL을 처리하도록 선언했다”는 사실만으로 앱이 항상 기본 목적지가 된다고 볼 수 없습니다.

App Links는 여기서 한 단계 더 나아가 웹사이트와 앱의 연결을 검증합니다. 공식 문서에 따르면 앱 manifest의 URL 선언과 웹사이트의 Digital Asset Links 문장이 함께 필요합니다. 이 문장을 확인한 시스템이 연결을 검증해야 해당 도메인의 링크를 앱으로 직접 보낼 수 있습니다. 링크를 하나 열어 본 관찰과 도메인 검증 성공은 별도 기록으로 남기는 편이 좋습니다.

기준 1: URL 설계와 화면 매핑을 먼저 기록합니다

첫 표는 “어떤 URL이 어느 화면으로 가야 하는가”입니다. 도메인, 경로, 쿼리 파라미터를 적고 각 URL을 처리할 Activity 또는 화면 전환 규칙을 연결합니다. Android Studio의 App Links Assistant도 host와 path·pathPrefix·pathPattern을 바탕으로 URL을 Activity에 매핑하는 흐름을 안내합니다.

이 단계의 완료 증거는 URL 목록과 앱 안의 목적지 규칙입니다. 연결 검증 파일을 올렸다는 사실이나 사용자가 앱을 설치했다는 사실은 URL 매핑의 대체 증거가 아닙니다. 존재하지 않는 경로, 로그인 전후에 다른 화면으로 가는 URL, 앱 미설치 시 웹에서 보여 줄 페이지도 함께 적어 두면 릴리스 뒤의 추측을 줄일 수 있습니다.

기준 2: 앱 선언과 도메인 목록을 같은 단위로 대조합니다

Android의 검증 안내는 VIEW action, BROWSABLE·DEFAULT category, HTTP 또는 HTTPS scheme, host가 있는 intent-filter를 검증 대상으로 설명합니다. App Links를 요청할 때는 android:autoVerify="true"를 명시합니다. 팀은 manifest에 적힌 host를 전부 목록화하고, 웹 운영자가 실제로 관리하는 host와 한 줄씩 대조해야 합니다.

www 유무나 별도 서브도메인은 이름이 비슷해도 같은 host가 아닐 수 있습니다. Android 문서는 호스트별 연결을 확인하므로, 한 도메인만 점검하고 나머지를 추정하면 안 됩니다. 이 표에는 릴리스 빌드의 application ID, 대상 host, URL 범위, 담당자, 마지막 검증 시점만 남기고 서명 키나 고객 데이터를 공개 문서에 넣지 않습니다.

기준 3: assetlinks.json은 위치·내용·서명을 분리해 봅니다

Android는 각 host에 대해 https://<hostname>/.well-known/assetlinks.json에서 Digital Asset Links 파일을 조회한다고 안내합니다. 파일이 존재한다는 관찰만으로는 충분하지 않습니다. 앱과 웹사이트 연결을 선언하는 relation, 해당 앱의 package name, 배포 앱과 일치하는 SHA-256 서명 지문이 같은 릴리스 맥락에서 맞는지 확인해야 합니다.

Play App Signing을 쓰는 팀은 특히 로컬 keystore로 만든 지문과 실제 사용자에게 배포되는 앱의 서명 정보를 혼동하지 않도록 주의합니다. Android Studio 문서는 이 경우 Play Console에서 배포용 JSON 조각과 서명 정보를 확인할 수 있다고 설명합니다. 그러나 이 글은 어떤 파일을 공개 도메인에 적용하라고 지시하는 배포 절차가 아닙니다. 현재 앱 서명 경로와 웹 운영 권한을 가진 담당자가 원문과 배포 환경을 대조해야 합니다.

우리 앱 MVP의 웹 URL·앱 화면·검수 기준을 함께 정리하기

기준 4: 기기 검증 상태와 실제 링크 이동을 함께 테스트합니다

공식 테스트 문서는 검증 대상 host를 먼저 목록화한 뒤, 기기에서 도메인 연결 상태를 확인하고 실제 URL을 열어 보라고 안내합니다. Android 12 이상에서는 재검증을 수동으로 실행해 현재 구성을 시험할 수도 있습니다. 이때 테스트 기기의 패키지명, 앱 버전, OS 버전, 확인한 host, 실행한 URL, 표시된 상태를 한 세트로 남깁니다.

기기 상태가 검증 성공처럼 보여도 사용자가 링크 처리 설정을 바꾼 경우에는 프로그램 검증과 다른 결과가 나타날 수 있습니다. 반대로 앱이 열린 사실도 URL 처리 로직의 우연한 결과일 수 있습니다. 그래서 팀은 검증 상태 확인, 대표 URL 탭, 의도하지 않은 경로 탭, 앱 미설치 또는 웹 대안 확인을 분리합니다. 이 네 결과를 하나의 “링크 완료” 체크박스로 합치지 않습니다.

기준 5: 릴리스 뒤에는 바뀐 범위만 다시 검수합니다

새 URL 경로, 새 host, 앱 서명·application ID 변경, 웹 서버 경로 변경은 모두 연결 점검이 필요한 변화입니다. Android 15 이상의 Dynamic App Links는 서버 측 규칙을 추가로 다룰 수 있지만, 공식 FAQ는 동적 규칙이 manifest가 선언한 정적 범위를 넓힐 수 없다고 설명합니다. 따라서 서버 파일을 수정했다는 사실과 새 URL 범위가 앱 선언 안에 있는지 확인하는 일은 분리해야 합니다.

배포 뒤에는 클릭 수나 앱 실행 수를 검증 성공으로 읽지 않습니다. 그 수치는 유입·설치·사용자 설정·측정 구성의 영향을 받을 수 있습니다. 링크 검수 기록에는 기술 상태를, 성과 보고에는 별도 분석 기간과 분모를 남깁니다. 브라우저와 앱의 역할을 어떻게 나눌지 고민 중이라면 앱 MVP Android Custom Tabs: 브라우저·WebView·앱 복귀를 나누는 5가지 기준도 함께 볼 수 있습니다.

출시 전 5분 체크리스트

• 대표 URL·예외 URL·앱 미설치 시 웹 대안을 나누어 적었는가?

• 릴리스 manifest의 scheme·host·경로와 운영 도메인 목록을 대조했는가?

• 각 host에서 assetlinks.json 위치·package name·서명 지문을 확인했는가?

• 테스트 기기의 앱 버전·OS·검증 상태·실행 URL을 함께 기록했는가?

• 검증 상태, 앱 화면 이동, 성과 지표를 각각 다른 증거로 남겼는가?

이 체크리스트는 모든 기기에서 같은 이동이 일어나거나 유입이 늘어난다는 보장이 아닙니다. 앱의 실제 URL 처리, 현재 도메인 설정, 사용자 링크 기본값과 배포 빌드를 담당자와 함께 다시 확인하세요.

자주 묻는 질문

intent-filter가 있으면 App Links가 자동으로 열리나요?

아닙니다. URL을 처리할 intent-filter가 있다는 사실과 도메인 연결이 검증돼 해당 URL이 앱으로 직접 라우팅되는 상태는 구별해야 합니다. 테스트 기기에서 도메인 검증 상태와 실제 URL 이동을 함께 확인하세요.

assetlinks.json을 올렸는데도 앱이 열리지 않는 이유는 무엇인가요?

호스트·경로·서명 지문·파일 위치·HTTPS 응답·사용자 설정처럼 분리해 볼 항목이 있습니다. 한 원인을 추정해 파일을 반복 수정하기보다, 앱 선언과 서버 파일, 기기 상태를 같은 릴리스 기준으로 대조하세요.

Play App Signing을 쓰면 로컬 서명 지문을 넣어도 되나요?

공식 Android Studio 문서는 Play App Signing을 사용하는 경우 사용자 기기에 배포되는 앱과 일치하는 서명 정보를 Play Console에서 확인하라고 안내합니다. 어떤 지문을 쓸지는 현재 배포·테스트 경로를 기준으로 팀이 확인해야 합니다.

검증 상태가 보이면 모든 URL이 원하는 화면으로 이동하나요?

아닙니다. 도메인 연결 상태와 URL 패턴 매칭, 들어온 Intent를 해석해 실제 화면으로 보내는 앱 로직은 서로 다른 확인 대상입니다. 대표 URL과 예외 URL을 나누어 실기기에서 점검하세요.

웹에서 앱으로 이어지는 MVP 링크 검수 흐름을 설계하기

출처

• Android Developers — About App Links

• Android Developers — Verify App Links

• Android Developers — Test App Links