AASA 가이드

AASA 파일 설정 가이드

iOS 앱과 웹사이트를 안전하게 연결하는 apple-app-site-association 파일의 구성 요소와 설정 방법을 확인해보세요.

도입 효과

AASA 파일을 통해 유니버설 링크를 활성화하면, 사용자가 웹페이지 링크를 클릭했을 때 사파리가 아닌 앱이 즉시 실행됩니다. 이는 사용자 경험을 끊김 없이 유지하여 전환율과 체류 시간을 크게 향상시킵니다.

앱 진입 전환율
+40%
로그인 단계 단축
즉시

주요 기능 4가지

유니버설 링크 (applinks)

HTTP/HTTPS 링크를 클릭하면 브라우저 대신 앱을 직접 실행합니다. 가장 많이 사용되는 기능입니다.

  • 마케팅 이메일의 링크를 앱으로 연결
  • 비밀번호 재설정 페이지를 앱 내 화면으로 연결
  • 특정 상품 페이지로 딥링킹

AASA 시뮬레이터

v1.0.0

기본 정보 (App ID)

유니버설 링크 (Paths) 설정

추가 기능 활성화

apple-app-site-association

                    
💡

이 파일은 반드시 HTTPS 루트 경로 또는 .well-known 서브디렉토리에 위치해야 하며, 확장자(.json)가 없어야 합니다.

자주 발생하는 설정 오류

MIME Type 오류 (35%)

서버가 파일을 application/json 형식이 아닌 텍스트나 옥텟 스트림으로 전송하면 iOS가 파일을 무시합니다.

HTTPS 인증서 문제 (20%)

유효하지 않거나 만료된 SSL 인증서를 사용하면 연결이 거부됩니다.

JSON 문법 오류 (15%)

마지막 항목 뒤에 콤마(,)를 남기거나 따옴표를 잘못 사용하여 파싱에 실패하는 경우입니다.