단수 링크 전제 조건

문서

Singular 링크: 고급 딥링킹을 통한 간소화된 트래킹

싱귤러 링크는 트래킹 링크를 생성하고 관리하기 위한 강력하고 사용자 친화적인 솔루션을 제공합니다. 마케터와 모바일 앱 개발자에게 완벽한 플랫폼으로, 링크 동작을 쉽게 구성하고, 어트리뷰션 기본 설정을 지정하고, 맞춤 메타데이터를 추가할 수 있습니다.

고급 딥링킹 기술

  • iOS 유니버설 링크: Singular 링크는 iOS 유니버설 링크를 사용하여 앱 설치에 따라 사용자를 앱이나 웹사이트로 자동 연결함으로써 원활한 사용자 경험을 보장합니다. 이를 통해 리디렉션을 없애고 사용자를 앱 콘텐츠로 직접 안내합니다. 또한 기존 앱 체계 딥링킹을 대체 수단으로 지원합니다.

  • 안드로이드 앱 링크: Android에서 Singular 링크는 앱 링크가 설치되어 있으면 앱을 직접 열고, 설치되어 있지 않으면 사용자를 웹 페이지로 리디렉션하여 플랫폼 간에 원활하고 일관된 경험을 제공합니다. 또한 앱 링크를 사용할 수 없는 경우를 위해 안드로이드 스키마 링크도 지원합니다.

딥링킹 및 디퍼드 딥링킹을 활성화하여 iOS 및 Android 앱에 대해 Singular 링크를 구성하려면 아래의 필수 단계를 따르세요:

1. 하위 도메인 추가


싱귤러의 링크 관리 페이지에서 링크에 대한 하위 도메인을 하나 이상 구성합니다. 자세한 내용은 Singular 링크 FAQ를 참조하세요.

2. 플랫폼 필수 요구 사항 구현하기:


iOS 사전 요구 사항

iOS의 경우: Singular 링크는 딥링킹을 위해 iOS 유니버설 링크 및 앱 스키마를 사용합니다. 이러한 기능을 사용하려면 다음 단계를 따르세요:

  1. 유니버설 링크 설정하기:

    • Apple 개발자 포털에 로그인합니다.
    • 식별자로 이동하여 유니버설 링크를 사용하도록 설정할 앱을 선택합니다.

      identifiers.png

    • 기능 메뉴에서 연결된 도메인 확인란을 선택하고 저장을 클릭합니다.

      associateddomains.png

  2. 연결된 도메인 권한을 추가합니다:

    • Xcode를 열고 프로젝트 설정 > 기능 > 연관된 도메인으로 이동합니다.
    • 다음 형식을 사용하여 Singular 링크 도메인을 추가합니다: applinks:jhflasjfhlasfu

      associateddomains2.png

    • Apple 개발자 포털에서 앱 접두사 ( 팀 ID라고도 함)를 복사합니다.
    • Singular에서 앱 구성으로 이동하여 앱을 찾은 다음 iOS 앱 사이트의"고급 설정 표시" 옵션을 확장하고 해당 필드에 팀 ID를 붙여넣습니다. 이렇게 하면 싱귤러가 유니버설 링크용 애플 앱 사이트 연결 파일을 싱귤러 도메인에 호스팅할 수 있습니다.

      mceclip3.png

    참고: 유니버설 링크가 제대로 작동하지 않을 수 있는 시나리오의 경우 이 단계를 완료하는 것이 중요합니다. 유니버설 링크 제한에 대한 자세한 내용은 여기에서 확인하세요. 이 단계를 생략하면 모든 Singular 링크가 앱 스토어로 리디렉션되며 딥링크가 작동하지 않습니다.
  3. 선택 사항 - 유니버설 링크를 사용하지 않는 경우 앱 스키마를 구성합니다:

    • 팀 ID 필드 아래에 iOS 앱의 앱 스키마를 입력하여 유니버설 링크에 대한 대체 수단으로 기존 앱 스키마 딥링크를 사용하도록 설정합니다.
      mceclip4.png

    앱에서 iOS 앱 체계를 처음 지원하는 경우, 앱 체계를 Xcode 프로젝트에 URL 유형으로 등록하세요.
    Screenshot of Xcode showing the URL Types section with a URL that reads "com.example.myphotoapp."
    자세한 내용은 Apple의 개발자 도움말 문서를 참조하세요.

Android 사전 요구 사항


Android용: Singular 링크는 Android 앱 링크 및 스키마 링크를 사용하여 딥링킹을 활성화합니다. 이러한 기능을 설정하려면 다음 단계를 따르세요:

  1. SHA256 지문 생성 및 제공:

    프로덕션용:

    • Google Play 콘솔에 액세스합니다.
    • 설정 > 앱 서명으로 이동하여 공개 SHA256 지문을 찾습니다.
    • 아래 4단계의 적용을 위해 앱 마케터에게 SHA256 지문을 보냅니다.

      GooglePlayAppSigning.png

    개발용:

      • 앱의 키스토어 파일을 찾습니다. 일반적으로 debug.keystore 에 있습니다.

        Windows:

        C:\Users\USERNAME\.android\debug.keystore

        Linux/Mac:

        ~/.android/debug.keystore
      • 명령줄을 열고 키 저장소 폴더로 이동한 다음 실행합니다:
        keytool -list -v -keystore debug.keystore

    debug.keystore 의 기본 비밀번호는 "android"입니다. 아래 4단계의 적용을 위해 출력에서 찾은 SHA256 지문을 앱 마케터에게 보냅니다.

  2. 앱 링크를 구성합니다:

    참고: 이 예제에서 확인된 도메인은 다음과 같습니다: example.sng.link
    • 여러 도메인을 확인하려는 경우 각각 별도의 인텐트 필터 블록(도메인당 코드 블록 생성)을 가져옵니다.
    • 기존 링크가 있는 앱의 경우 링크를 현재 지원되는 Android 앱 링크 기술로 마이그레이션하거나 URL 스키마(변경되지 않음)로 유지하도록 할 수 있습니다.
    • 현재 지원되는 Android 앱 링크 기술로 마이그레이션하려면 다음과 같이 하세요:
      다음 경로 도메인을 허용합니다: "/E" 및 "/F" 및 "/A" 및 "/B"
    • 앱 링크를 처리하기 위해 AndroidManifest.xml 에 다음 인텐트 필터를 추가합니다:
      <intent-filter android:autoVerify="true">
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data android:scheme="http" />
      <data android:scheme="https" />
      <data android:host="example.sng.link" />
      <data android:pathPrefix="/A"/>
      <data android:pathPrefix="/B"/>
      <data android:pathPrefix="/E"/>
      <data android:pathPrefix="/F"/>
      </intent-filter>
      이 설정을 통해 앱에서 다음과 같은 링크를 열 수 있습니다: https://example.sng.link/Eabcd/1234
  3. 선택 사항 - 앱 링크를 사용하지 않는 경우 앱 스키마를 구성합니다:
    • AndroidManifest.xml 에 다음 인텐트 필터를 추가하여 앱 링크를 처리합니다:
      <intent-filter>
      <data android:scheme="https"/>
      <data android:host="example.sng.link" />
      <action android:name="android.intent.action.VIEW"/>
      <category android:name="android.intent.category.DEFAULT"/>
      <category android:name="android.intent.category.BROWSABLE"/>
      </intent-filter>
  4. Android 앱 구성표를 구성합니다:

    • Singular에서 설정 > 앱으로 이동하여 앱을 찾은 후 안드로이드 앱 사이트"고급 설정 표시" 옵션을 확장하고 앱 링크 SHA256 지문 필드에 안드로이드 앱 링크 SHA256 지문을 입력합니다.
    • 선택 사항으로, 앱 링크를 사용하지 않는 경우 AndroidManifest.xml 인텐트 필터에 입력한 scheme://host와 일치하도록 Android 스키마를 추가합니다.

      AndroidDeepLinkSettings.png

3. SDK 구성 추가


위의 전제 조건을 완료한 후 딥링킹 및 디퍼드 딥링킹을 구현합니다: 앱에서 딥링킹을 구현하려면 관련 SDK 연동 가이드를 따르세요:

자세한 내용은 싱귤러 링크 FAQ를 참조하세요.