Singular 링크 필수 조건

딥링크를 포함한 새로운 Singular 링크를 완벽하게 구현하도록 iOS 및 Android 앱을 설정하는 방법에 대해 알아봅니다. 필수 조건을 설정한 후 Singular SDK 연동에서 딥링크 연동을 진행해야 합니다.

더 자세한 내용은 Singular 링크 FAQ딥링크 FAQ를 참고하세요.

 

 

iOS 필수 조건

Singular는 iOS Universal Linksapp scheme을 사용하여 iOS에서 딥링크를 구현합니다. 앱에서 Singular 링크와 함께 Universal Link를 사용할 수 있게 하려면 다음 단계를 따릅니다.

  1. Singular의 링크 관리 페이지에서 사용자의 링크에 하나 이상의 서브 도메인을 구성합니다. 자세한 내용은 Singular 링크 FAQ를 참고하세요.
  2. Universal Link를 설정하는 방법(iOS에서 딥링크 구현):
    • Apple 개발자 포털에 로그인합니다.
    • Identifiers 메뉴로 이동하여 지원할 Universal Link에 추가하려는 앱을 선택합니다.

      identifiers.png

    • Capability 메뉴에서 Associated Domains 확인란을 선택하고 저장을 클릭합니다.

      associateddomains.png

  3. 앱에 "Associated Domains" 자격을 추가하는 방법:
    •  XCode에서 Project setting > Capabilities > Associated Domains로 이동합니다.
    • Singular 링크 도메인을 추가합니다.

      associateddomains2.png

  4. Apple 개발자 포털에서 "App Prefix("Team ID")를 복사합니다.

  5. Singular에서 앱 설정으로 이동하여 앱을 찾은 다음 iOS 앱 사이트 설정을 확장하여 해당 값을 Team ID 필드에 붙여 넣습니다. 이 작업으로 Singular가 Universal Link를 위한 고객사의 Singular 도메인에 apple-app-site-association 파일을 호스트할 수 있게 됩니다.mceclip3.png

  6.  주의: 이 단계는 Universal Link로 딥링크할 수 없는 경우에만 진행합니다. Universal Link의 제약 사항은 이 문서를 참조하세요.

    추가적으로 "Team ID" 아래에 iOS 앱의 "App Scheme"를 넣어서 전통적인 앱 스킴 방식의 딥링크를 Universal Link 딥링크의 폴백으로 사용할 수 있습니다.mceclip4.png

    iOS 앱 스킴으로 처음 딥링킹을 지원하는 경우, Xcode 프로젝트 내에 앱 스킴이 "URL Type"으로 등록되었는지 확인하세요.

    iOS 앱의 앱 스킴 지원에 대한 자세한 내용은 Apple의 관련 개발자 문서를 참조하세요.

  7. 플랫폼에 맞는 SDK 연동 가이드를 참조하여 앱 내의 딥링크를 구현합니다.

Android 필수 조건

  1. Singular의 링크 관리 페이지에서 사용자의 링크에 하나 이상의 서브 도메인을 구성합니다. 자세한 내용은 Singular 링크 FAQ를 참고하세요.

  2. Android 앱에서 URI 스킴 딥링크를 처리하도록 구성하려면 AndroidManifest.xml에 적절한 intent 필터를 추가합니다.

    <intent-filter>
    <data android:scheme="singular-example" />
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    </intent-filter>

    위 설정을 적용하면 앱에서 다음과 같은 링크를 열 수 있습니다.

    singular-example://your-sub-domain1.sng.link/Aabcd/1234
  3. Singular에서 앱 설정으로 이동하여 앱을 찾은 다음 Android 앱 사이트 설정을 확장하여 Android 앱 스킴 필드에 Android 스킴 이름을 입력합니다(위 예에서 스킴 이름은 “singular-example”).

    androidscheme.png

  4. 플랫폼에 맞는 SDK 연동 가이드를 참조하여 앱 내의 딥링크를 구현합니다.

도움이 되었습니까?