유니버설 링크 및 앱 링크

이 문서에서는 Apple 유니버설 링크와 Android 앱 링크를 설정하는 방법을 설명합니다.

Apple 유니버설 링크와 Android 앱 링크는 웹 콘텐츠와 모바일 앱 간의 원활한 전환을 제공하기 위해 고안된 메커니즘입니다. 유니버설 링크는 iOS에 특화되어 있으며, Android 앱 링크는 Android 애플리케이션에서 동일한 목적을 수행합니다.

유니버설 링크 및 앱 링크의 작동 방식

유니버설 링크(iOS)와 앱 링크(Android)는 웹 페이지와 앱 내 콘텐츠 모두를 가리키는 표준 웹 링크(http://mydomain.com)입니다.

유니버설 링크 또는 앱 링크가 열리면 운영체제는 해당 도메인에 등록된 설치된 앱이 있는지 확인합니다. 앱이 발견되면 웹 페이지를 로드하지 않고 즉시 앱이 실행됩니다. 앱이 발견되지 않으면 사용자의 기본 웹 브라우저에서 웹 URL이 로드되며, 이 경우 각각 App Store 또는 Google Play Store로 리디렉션되도록 구성할 수도 있습니다.

간단히 말해, 유니버설 링크를 사용하면 웹사이트가 자체 웹 페이지를 특정 앱 화면과 연결할 수 있으므로, 사용자가 앱 화면에 해당하는 웹 페이지 링크를 클릭하면 앱이 직접 열릴 수 있습니다(앱이 현재 설치되어 있는 경우).

다음 표는 유니버설 링크와 기존 딥링크 간의 주요 차이점을 보여줍니다:

사용 사례

유니버설 링크와 앱 링크는 이메일 Campaign에서 가장 일반적으로 사용됩니다. 이메일은 데스크탑과 모바일 기기 모두에서 열고 클릭할 수 있기 때문입니다.

일부 채널은 이러한 링크와 잘 작동하지 않습니다. 예를 들어, 푸시 알림, 인앱 메시지, Content Cards는 스킴 기반 딥링크(mydomain://)를 사용해야 합니다.

필수 조건

유니버설 링크와 앱 링크를 사용하려면:

• 웹사이트가 HTTPS를 통해 접근 가능해야 합니다
• 앱이 App Store(iOS) 또는 Google Play Store(Android)에서 사용 가능해야 합니다

유니버설 링크 및 앱 링크 설정

앱이 유니버설 링크 또는 앱 링크를 지원하려면 iOS와 Android 모두 링크 도메인에 특별한 권한 파일이 호스팅되어야 합니다. 이 파일에는 해당 도메인의 링크를 열 수 있는 앱의 정의가 포함되어 있으며, iOS의 경우 해당 앱이 열 수 있는 경로도 포함됩니다:

• iOS: Apple App Site Association(AASA) 파일
• Android: Digital Asset Links 파일

이 권한 파일 외에도, 앱 내에 설정된 앱이 열 수 있는 링크 도메인에 대한 하드코딩된 정의가 있습니다:

• iOS: Xcode에서 “Associated Domains”로 설정
• Android: 앱의 AndroidManifest.xml 파일에 정의

이 두 부분으로 구성된 도메인-앱 연결은 유니버설 링크 또는 앱 링크가 작동하는 데 필수적이며, 어떤 앱이든 특정 도메인의 링크를 가로채거나 어떤 도메인이든 특정 앱을 여는 것을 방지합니다.

• ios
• android

1
2
3
4
5
6
7
8
9
10
11
12
13
{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "JHGFJHHYX.com.facebook.ios",
        "paths": [
          "*"
        ]
      }
    ]
  }
}

유니버설 링크, 앱 링크 및 클릭 추적

이메일 발송 파트너인 SendGrid와 SparkPost는 클릭 추적 도메인을 사용하여 모든 링크를 래핑하고 Braze 이메일의 클릭 추적을 위한 URL 매개변수를 포함합니다.

예를 들어, https://www.example.com과 같은 링크는 https://links.email.example.com/uni/wf/click?upn=abcdef123456…과 같은 형태가 됩니다.

클릭 추적이 포함된 이메일 링크가 유니버설 링크 또는 앱 링크로 작동하도록 하려면 추가 설정이 필요합니다. 클릭 추적 도메인(links.email.example.com)을 앱이 열 수 있는 도메인으로 추가해야 합니다. 또한 클릭 추적 도메인이 AASA(iOS) 또는 Digital Asset Links(Android) 파일을 제공해야 합니다. 이렇게 하면 클릭 추적이 포함된 이메일 링크가 원활하게 작동합니다.

모든 클릭 추적 링크를 유니버설 링크 또는 앱 링크로 만들고 싶지 않은 경우, 이메일 발송 파트너에 따라 어떤 링크를 유니버설 링크로 지정할지 선택할 수 있습니다. 자세한 내용은 다음 섹션을 참조하세요.

SendGrid

SendGrid 클릭 추적 링크를 유니버설 링크로 처리하려면:

1. URL 경로에 /uni/가 포함된 링크만 유니버설 링크로 처리하도록 AASA 또는 AndroidManifest pathPrefix 값을 설정합니다.
2. 링크의 앵커 태그(<a>)에 universal="true" 속성을 추가합니다. 이렇게 하면 래핑된 링크의 URL 경로에 /uni/가 포함됩니다.

예시:

1
<a href=”https://www.example.com” universal="true">

3. 앱이 래핑된 링크를 올바르게 처리하도록 설정되어 있는지 확인합니다. SendGrid의 SendGrid 클릭 추적 링크 해석 문서를 참조하고 운영체제에 맞는 단계를 따르세요. 이 문서에는 iOS 및 Android용 예시 코드가 포함되어 있습니다.

이 구성을 사용하면 URL 경로에 /uni/가 포함된 링크는 유니버설 링크로 작동하고, 다른 모든 링크는 웹 링크로 작동합니다.

SparkPost

SparkPost 클릭 추적 링크를 유니버설 링크로 처리하려면 이메일용 드래그 앤 드롭 편집기의 속성 섹션에 다음 속성을 추가하거나, 링크 HTML을 수동으로 편집하여 링크의 앵커 태그에 다음 속성을 포함합니다: data-msys-sublink="custom_path".

이 커스텀 경로를 사용하면 해당 값이 포함된 URL을 유니버설 링크로 선택적으로 처리할 수 있습니다.

예시:

1
<a href=”https://www.example.com” data-msys-sublink="open-in-app">

그런 다음 앱이 커스텀 경로를 올바르게 처리하도록 설정되어 있는지 확인합니다. SparkPost의 딥링크에서 SparkPost 클릭 추적 사용 문서를 참조하세요. 이 문서에는 iOS 및 Android용 예시 코드가 포함되어 있습니다.

링크별 클릭 추적 비활성화

HTML 편집기의 이메일 메시지에 HTML 코드를 추가하거나 드래그 앤 드롭 편집기의 HTML 블록에 추가하여 특정 링크의 클릭 추적을 비활성화할 수 있습니다.

SendGrid

이메일 서비스 공급자가 SendGrid인 경우 다음과 같이 clicktracking=off HTML 코드를 사용합니다:

<a clicktracking=off href="[INSERT https LINK HERE]">click here</a>

SparkPost

이메일 서비스 공급자가 SparkPost인 경우 다음과 같이 data-msys-clicktrack="0" HTML 코드를 사용합니다:

<a data-msys-clicktrack="0" href="[INSERT https LINK HERE]">click here</a>

Amazon SES

이메일 서비스 공급자가 Amazon SES인 경우 다음과 같이 ses:no-track HTML 코드를 사용합니다:

<a ses:no-track href="[INSERT https LINK HERE]">click here</a>

드래그 앤 드롭 편집기

드래그 앤 드롭 이메일 편집기를 사용할 때 링크가 텍스트, 버튼 또는 이미지에 연결된 경우 HTML 코드를 커스텀 속성으로 입력합니다.

텍스트 링크의 커스텀 속성

SendGrid

커스텀 속성에 다음을 선택합니다:

• Name: clicktracking
• Value: off

SparkPost

커스텀 속성에 다음을 선택합니다:

• Name: data-msys-clicktrack
• Value: 0

버튼 또는 이미지의 커스텀 속성

SendGrid

커스텀 속성에 다음을 선택합니다:

• Name: clicktracking
• Value: off
• Type: Link

SparkPost

커스텀 속성에 다음을 선택합니다:

• Name: data-msys-clicktrack
• Value: 0
• Type: Link

클릭 추적이 포함된 유니버설 링크 문제 해결

이메일에서 유니버설 링크가 예상대로 작동하지 않는 경우(예: 수신자가 이메일 앱에서 웹 브라우저로 이동한 후 최종적으로 앱으로 리디렉션되는 경우), 다음 팁을 참조하여 유니버설 링크 설정 문제를 해결하세요.

링크 파일 위치 확인

AASA 파일(iOS) 또는 Digital Asset Links 파일(Android)이 올바른 위치에 있는지 확인합니다:

• iOS: https://click.tracking.domain/.well-known/apple-app-site-association
• Android: https://click.tracking.domain/.well-known/assetlinks.json

이러한 파일이 항상 공개적으로 접근 가능한지 확인하는 것이 중요합니다. 접근할 수 없는 경우 이메일용 유니버설 링크 설정 단계를 놓쳤을 수 있습니다.

도메인 정의 확인

앱이 열 수 있는 도메인에 대한 올바른 정의가 있는지 확인합니다.

• iOS: Xcode에서 앱에 설정된 Associated Domains를 검토합니다(1c단계). 클릭 추적 도메인이 해당 목록에 포함되어 있는지 확인합니다.
• Android: 앱 정보 페이지를 엽니다(앱 아이콘을 길게 누르고 ⓘ를 클릭). 앱 정보 메뉴에서 기본으로 열기를 찾아 탭합니다. 앱이 열 수 있는 모든 확인된 링크가 표시되는 화면이 나타납니다. 클릭 추적 도메인이 해당 목록에 포함되어 있는지 확인합니다.