딥링크 기능 구현 가이드
스윙투앱에서 제공하는 푸시전용 앱 사용자도 딥링크 기능을 통해 앱 실행 및 특정 페이지로 이동이 가능합니다. 이 문서에서는 딥링크를 구현하는 방법과 주의할 점, 그리고 appId 확인 방법까지 자세히 안내드립니다.
딥링크 기본 구조
스윙투앱의 딥링크는 아래의 URL 포맷을 사용합니다.
https://www.swing2app.co.kr/swapi/openAppWithUrl?appId={app_id}{app_id}는 해당 앱의 고유 ID입니다. (뒤에서 확인 방법 안내)위 URL은 앱을 실행하지만 별도 실행 주소(URL)는 전달하지 않습니다.
앱이 설치되어 있지 않은 경우, 사용자의 디바이스에 따라 Google Play스토어 또는 App Store로 자동 연결됩니다.
딥링크로 실행 주소(URL) 함께 전달하기
앱을 실행하면서 특정 웹페이지로 이동시키고자 할 경우 url 파라미터를 함께 전달하면 됩니다.
https://www.swing2app.co.kr/swapi/openAppWithUrl?appId={app_id}&url=https://m.naver.com참고
url파라미터는 URL 인코딩(URL Encoding) 이 필요합니다.예시: 실제 적용 시에는 아래와 같이 인코딩된 형태로 전달해야 합니다.
인코딩 전:
https://m.naver.com
인코딩 후:
https%3A%2F%2Fm.naver.comURL 인코딩은 웹사이트, 자바스크립트 함수(
encodeURIComponent()), 서버 코드 등에서 쉽게 처리할 수 있습니다.
POST 방식도 지원합니다
딥링크 요청은 GET 방식 뿐만 아니라 POST 방식으로도 호출이 가능합니다. 예를 들어, 보안 또는 URL 길이 제한 등의 이유로 POST로 호출하고자 하는 경우에도 대응할 수 있습니다.
appId 확인 방법
앱의 appId는 스윙투앱 푸시전용 앱을 유료 결제한 사용자만 확인할 수 있습니다.
확인 경로:
앱운영 > 서비스 관리 > 앱운영관리 > 앱고급관리 > API-KEY 관리해당 페이지에서
appId와 함께 API KEY 등의 정보를 확인하실 수 있습니다.무료 사용자 또는 미결제 앱은
appId가 제공되지 않으며, 딥링크 기능을 사용할 수 없습니다.
딥링크 예제
아래는 실제 딥링크 사용 예제입니다.
앱 실행만 하는 경우 (설치 안 되어 있으면 앱스토어 이동)
https://www.swing2app.co.kr/swapi/openAppWithUrl?appId=275a02bc-9a02-4f9e-b54c-077d056e2cb1앱 실행과 동시에 특정 페이지로 이동
https://www.swing2app.co.kr/swapi/openAppWithUrl?appId=275a02bc-9a02-4f9e-b54c-077d056e2cb1&url=https%3A%2F%2Fm.naver.com유의사항
앱이 설치되지 않은 경우, 사용자의 기기 환경에 따라 스토어로 자동 이동합니다.
반드시 스윙투앱 최신 버전(2025년 7월 14일 이후)으로 앱이 업데이트되어 있어야 딥링크 기능이 정상 작동합니다.
푸시전용앱은 최소한의 기능만 지원되므로, WebView 페이지 내에서 링크 호출 시 기능 제한이 있을 수 있습니다.
마무리
스윙투앱의 푸시전용 앱도 간편한 딥링크 기능을 통해 다양한 알림 마케팅을 구현할 수 있습니다. 웹페이지 연동, 특정 페이지 안내, 스토어 유도 등 다양한 용도로 활용해보세요.
Last updated