딥링크 기능 구현 가이드

스윙투앱에서 제공하는 푸시전용 앱 사용자도 딥링크 기능을 통해 앱 실행 및 특정 페이지로 이동이 가능합니다. 이 문서에서는 딥링크를 구현하는 방법과 주의할 점, 그리고 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.com

• URL 인코딩은 웹사이트, 자바스크립트 함수(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 페이지 내에서 링크 호출 시 기능 제한이 있을 수 있습니다.

---

마무리

스윙투앱의 푸시전용 앱도 간편한 딥링크 기능을 통해 다양한 알림 마케팅을 구현할 수 있습니다. 웹페이지 연동, 특정 페이지 안내, 스토어 유도 등 다양한 용도로 활용해보세요.