Help CenterFAQContact UsBuild an app

Deep Link Integration Guide

Swing2App offers deep link functionality for Push-Only Apps, allowing you to launch the app or redirect users to specific URLs. This guide explains how to implement deep links, encode URLs, and locate your app ID for integration.

✅ Basic Deep Link Structure

The basic format for using Swing2App’s deep link is as follows:

https://www.swing2app.com/swapi/openAppWithUrl?appId={app_id}

  • {app_id} should be replaced with your app’s unique ID (how to find it is explained below).

  • This URL launches the app without directing to a specific page.

  • If the app is not installed, the user will be redirected to either the Google Play Store or Apple App Store depending on their device.

✅ Adding a Target URL to the Deep Link

To launch the app and open a specific page, you can append the url parameter.

https://www.swing2app.com/swapi/openAppWithUrl?appId={app_id}&url=https://m.naver.com

ℹ️ Note:

  • The url parameter must be URL-encoded.

  • Example: Here is how the URL should look after encoding:

✅ Before encoding:
https://google.com

✅ After encoding:
https%3A%2F%2Fgoogle.com

  • You can encode the URL using tools like encodeURIComponent() in JavaScript or any online URL encoder.

✅ POST Method Support

Deep links can be invoked via both GET and POST methods. This is useful when you want to avoid exposing parameters in the URL or need more secure communication.

✅ How to Find Your App ID (appId)

Only users who have purchased a subscription (paid apps) can access the appId.

Navigation Path:

App Management > Service Management > App Operations > Advanced App Management > API-KEY Management

  • On this page, you’ll find the appId and other API credentials.

  • Free users or unpaid apps will not have access to the appId and cannot use the deep link feature.

✅ Example Deep Links

App Launch Only (Redirects to store if not installed)

https://www.swing2app.com/swapi/openAppWithUrl?appId=275a02bc-9a02-4f9e-b54c-077d056e2cb1

App Launch + Open Specific Page

https://www.swing2app.com/swapi/openAppWithUrl?appId=275a02bc-9a02-4f9e-b54c-077d056e2cb1&url=https%3A%2F%2Fm.naver.com

✅ Important Notes

  • If the app is not installed, users will be redirected to the appropriate app store.

  • Make sure the app is updated to the latest version to ensure the deep link functions properly.

  • Push-only apps support limited features and may not fully support in-app navigation using WebViews.

📌 Conclusion

With Swing2App’s deep link support, even Push-Only Apps can implement powerful marketing features such as app launches, in-app redirection, and app store navigation.

Last updated