유니버설 링크 및 앱 링크

Apple 유니버설 링크와 Android 앱 링크는 웹 콘텐츠와 모바일 앱 간의 원활한 전환을 제공하기 위해 고안된 메커니즘입니다. 유니버설 링크는 iOS에만 해당되는 반면, Android 앱 링크는 Android 애플리케이션에도 동일한 용도로 사용됩니다.

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

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

유니버설 링크 또는 앱 링크가 열리면 운영 체제는 해당 도메인에 설치된 앱이 등록되어 있는지 확인합니다. 앱이 발견되면 웹 페이지를 로드할 필요 없이 바로 실행됩니다. 앱을 찾을 수 없는 경우 사용자의 기본값 웹 브라우저에 웹 URL이 로드되며, 이 웹 브라우저는 각각 앱 스토어 또는 구글 플레이 스토어로 리디렉션되도록 구성할 수도 있습니다.

유니버설 링크를 사용하면 웹 사이트에서 웹 페이지를 특정 앱 화면과 연결할 수 있으므로 사용자가 앱 화면에 해당하는 웹 페이지의 링크를 클릭하면 앱이 바로 열립니다(현재 앱이 설치되어 있는 경우).

이 표에는 유니버설 링크와 기존 딥링크의 주요 차이점이 요약되어 있습니다:

사용 사례

유니버설 링크와 앱 링크는 데스크톱과 모바일 기기 모두에서 이메일을 열고 클릭할 수 있으므로 이메일 캠페인에 가장 일반적으로 사용됩니다.

일부 채널은 이러한 링크가 제대로 작동하지 않습니다. 예를 들어 푸시 알림, 인앱 메시지, 콘텐츠 카드는 스키마 기반 딥링크를 사용해야 합니다(mydomain://).

전제 조건

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

• 웹사이트는 HTTPS를 통해 액세스할 수 있어야 합니다.
• 앱은 앱 스토어(iOS) 또는 구글 플레이 스토어(Android)에서 사용할 수 있어야 합니다.

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

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

• iOS: 애플 앱 사이트 협회(AASA) 파일
• Android: 디지털 자산 링크 파일

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

• iOS: Xcode에서 “연결된 도메인”으로 설정
• 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) 또는 디지털 자산 링크(Android) 파일을 제공해야 합니다. 이렇게 하면 클릭 추적 기능이 있는 이메일 링크가 원활하게 작동하는 데 도움이 됩니다.

모든 클릭 추적 링크를 유니버설 링크 또는 앱 링크가 아닌 경우 이메일 전송 파트너에 따라 유니버설 링크가 될 링크를 지정할 수 있습니다. 자세한 내용은 다음 섹션을 참조하세요.

SendGrid

SendGrid 클릭 추적 링크를 범용 링크로 취급하려면:

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

예를 들어

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

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

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

SparkPost

스팍포스트 클릭 추적 링크를 유니버설 링크로 취급하려면 이메일용 드래그 앤 드롭 편집기의 속성 섹션에 다음 속성을 추가하거나 링크의 앵커 태그에 다음 속성을 포함하도록 링크 HTML을 수동으로 편집하세요: data-msys-sublink="custom_path".

이 커스텀 경로를 사용하면 해당 값을 가진 URL을 선택적으로 유니버설 링크로 취급할 수 있습니다.

예를 들어

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

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

링크 대 링크 기준으로 클릭 추적 끄기

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

SendGrid

이메일 서비스 제공업체가 SendGrid인 경우 HTML 코드 clicktracking=off 를 다음과 같이 사용하세요:

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

SparkPost

이메일 서비스 제공업체가 SparkPost인 경우 다음과 같이 HTML 코드 data-msys-clicktrack="0" 를 사용하세요:

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

Amazon SES

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

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

드래그 앤 드롭 편집기

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

텍스트 링크의 커스텀 속성

SendGrid

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

• 이름: clicktracking
• 가치: off

SparkPost

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

• 이름: data-msys-clicktrack
• 가치: 0

텍스트 링크에 대한 커스텀 속성입니다.](/docs/ko/assets/img/text_click_tracking_off.png?ac966d5623b5d9c7b3a6b0dd40da1f19){: style=”max-width:60%;”}

버튼 또는 이미지에 대한 커스텀 속성

SendGrid

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

• 이름: clicktracking
• 가치: off
• 유형: 링크

SparkPost

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

• 이름: data-msys-clicktrack
• 가치: 0
• 유형: 링크

버튼에 대한 커스텀 속성입니다.](/docs/ko/assets/img/button_click_tracking_off.png?6e392e9a5a9a753557cfdde888581948){: style=”max-width:60%;”}

클릭 추적을 통한 유니버설 링크 문제 해결

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

링크 파일 위치 확인

AASA 파일(iOS) 또는 디지털 자산 링크 파일(Android)이 올바른 위치에 있는지 확인합니다:

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

이러한 파일은 항상 공개적으로 액세스할 수 있도록 하는 것이 중요합니다. 액세스할 수 없는 경우 이메일용 유니버설 링크 설정 단계를 놓친 것일 수 있습니다.

도메인 정의 확인

앱이 열 수 있는 도메인에 대한 정의가 올바른지 확인하세요.

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