# 유니버설 링크 / 앱 링크 설정 가이드 (Universal Link/ App Link Configuration)

{% hint style="info" %}

## 중요 (IMPORTANT)

Adjust에서 유니버설 링크 및 앱 링크를 활성화하려면 마케터와 개발자 모두의 작업이 필요합니다.

* 유니버설 링크나 앱 링크를 사용하는 기존 리타겟팅 캠페인이 있는 고객의 경우 - [여기](https://docs.adcloud.appier.com/app-campaign/adjust-integration/adjust-app-reengagement-aictivate-campaign)로 건너뛰십시오.
* 유니버설 링크를 처음 사용하는 고객의 경우 - 이 가이드 전체를 확인해 주시기 바랍니다. 
  {% endhint %}

### iOS 유니버설 링크 / Android 앱 링크 활성화

#### **마케터 작업 사항 (Marketers Actions)**

1. 마케터는 App Information 클릭 > Branded domain > Create a new domain > Save를 선택합니다.
2. 생성된 브랜드 도메인(Branded domain)을 개발자에게 전달합니다.<br>

   <figure><img src="https://2169208401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyVXUZrslHG2PDHHcdyk%2Fuploads%2FvoqBjV4bxPEyU6WUYeFu%2Fimage.png?alt=media&#x26;token=f501eaae-ffd6-472b-928c-d98fbcbeb363" alt=""><figcaption></figcaption></figure>

   <figure><img src="https://2169208401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyVXUZrslHG2PDHHcdyk%2Fuploads%2FFSaEzS9wXPYHkA1ardhk%2Fimage.png?alt=media&#x26;token=92d62d77-5220-40fd-b696-a06819a0ff64" alt=""><figcaption></figcaption></figure>
3. iOS 유니버설 링크 및 Android 앱 링크 활성화
   1. iOS 유니버설 링크:
      1. 플랫폼(Platforms) > 유니버셜 링크(Universal linking)으로 이동하여 **토글을 활성화**합니다.<br>

         <figure><img src="https://2169208401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyVXUZrslHG2PDHHcdyk%2Fuploads%2F7Q5yl8QoeyEdtiOSeFdH%2FScreenshot%202026-03-27%20at%2011.34.58%E2%80%AFAM.png?alt=media&#x26;token=3c9843fa-aca5-4aec-9e04-40330dfd8618" alt=""><figcaption></figcaption></figure>
      2. 고유한 스킴 이름을 선택하여 App scheme 항목에 입력한 후, 해당 App scheme을 개발자에게 전달합니다.
      3. 개발자가 제공한 App ID prefix와 App scheme을 입력합니다. 해당 정보는 개발자가 다음 가이드를 참고할 수 있습니다: [Apple 개발자 계정과 Xcode에서 설정 확인](https://help.adjust.com/ko/article/set-up-universal-links#verify-developer-account-xcode).\ <br>

         <figure><img src="https://2169208401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyVXUZrslHG2PDHHcdyk%2Fuploads%2Fg998MS08dzsWqcre5WQN%2FScreenshot%202026-03-27%20at%2011.42.45%E2%80%AFAM.png?alt=media&#x26;token=bfd9e9de-a1ce-4a29-977c-ba74177da7d7" alt=""><figcaption></figcaption></figure>

         <figure><img src="https://2169208401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyVXUZrslHG2PDHHcdyk%2Fuploads%2FhJeccQTzrSnNCCafW1xE%2Fimage.png?alt=media&#x26;token=afd6bc0b-be20-4189-83f0-43f01a28ecdb" alt=""><figcaption></figcaption></figure>
   2. Android 앱 링크:
      1. 플랫폼(Platforms) > 유니버셜 링크(Universal linking)으로 이동하여 **토글을 활성화**합니다.<br>

         <figure><img src="https://2169208401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyVXUZrslHG2PDHHcdyk%2Fuploads%2F7QNN6MD2rt41OTbbNwoa%2FScreenshot%202026-03-27%20at%2011.39.09%E2%80%AFAM.png?alt=media&#x26;token=c3ebcf10-f221-415d-9260-88639067f8ef" alt=""><figcaption></figcaption></figure>
      2. 고유한 스킴 이름을 선택하여 App scheme 항목에 입력한 후, 해당 App scheme을 개발자에게 전달합니다.<br>

         <figure><img src="https://2169208401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyVXUZrslHG2PDHHcdyk%2Fuploads%2FEA00C3DdZxEyVrCQ7sev%2FScreenshot%202026-03-27%20at%2011.40.41%E2%80%AFAM.png?alt=media&#x26;token=493a0389-9df2-4b50-8ff6-b49bf93b9201" alt=""><figcaption></figcaption></figure>
      3. 개발자가 제공한 SHA-256 인증서 지문(certificate fingerprints)을 입력합니다. 지문 확인 방법은 개발자가 다음 가이드를 참고할 수 있습니다: [SHA-256 인증 핑거프린트 조회](https://help.adjust.com/ko/article/set-up-android-app-links#retrieve-sha-256-certificate-fingerprints).<br>

         <figure><img src="https://2169208401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyVXUZrslHG2PDHHcdyk%2Fuploads%2Fi5FKM4HMsiBgRcOm3gDQ%2Fimage.png?alt=media&#x26;token=9567a6df-7846-4e2e-8ad2-9b6bdc1c4f44" alt=""><figcaption></figcaption></figure>

***

### iOS 유니버설 링크 (iOS Universal Link)

#### 개발자 작업 사항 (Developer Actions)

1. Associated Domains 설정: 개발자는 Xcode에서 Associated Domain을 활성화하고, 마케터가 제공한 브랜디드 도메인을 추가합니다. 참고: [Associated Domains 구성(개발자)](https://help.adjust.com/ko/article/set-up-universal-links#configure-associated-domains).<br>

   <figure><img src="https://2169208401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGyVXUZrslHG2PDHHcdyk%2Fuploads%2FWU0JnAo8wgx9OBZNqCVZ%2Fimage.png?alt=media&#x26;token=4b115674-7c56-40c5-af51-1b2df4dd9f4f" alt=""><figcaption></figcaption></figure>
2. 딥링크 코드 구현: 개발자는 Adjust의 딥링크 어트리뷰션 가이드를 따라 구현해야 합니다: [AppDelegate 라이프사이클을 사용하는 SwiftUI 앱](https://dev.adjust.com/ko/sdk/ios/features/deep-links/direct/#swiftui-apps-using-appdelegate-lifecycle).

→ 유니버설 링크가 활성화되면, Adjust에서 자동으로 AASA 파일을 생성하고 호스팅합니다.

{% hint style="info" %}
AASA란 무엇인가요?

Apple App Site Association(AASA) 파일은 MMP(모바일 측정 파트너) 도메인에 호스팅되는 보안 문서입니다. 이는 웹사이트와 앱이 공식적으로 연결되어 있음을 증명하는 "디지털 악수(Digital Handshake)" 역할을 합니다.

이 파일이 없으면 유니버설 링크는 작동하지 않으며, 사용자를 광고에서 앱으로 직접 연결하는 핵심 요소입니다.
{% endhint %}

### Android 앱 링크 (Android App Link)

#### **개발자 작업 사항 (Developer Actions)**

1. 마케터로부터 App scheme 정보를 받아 앱의 `AndroidManifest.xml` 파일에 scheme name을 설정합니다. \* 참고: [스킴 이름 설정](https://dev.adjust.com/ko/sdk/android/features/deep-links#configure-your-scheme-name).
2. 마케터로부터 브랜디드 도메인 정보를 받습니다. `AndroidManifest.xml` 파일에 `intent` 필터를 추가하여 앱이 처리할 URL을 지정하고, `data` 요소에 `android:autoVerify="true"` 속성을 포함합니다. \* 참고: [Android 앱 링크 구성](https://dev.adjust.com/ko/sdk/android/features/deep-links#configure-android-app-links).
3. 딥링크 코드 구현: 개발자는 Adjust의 딥링크 어트리뷰션 가이드를 따라 구현해야 합니다. \* 참고: [딥링크를 통한 리어트리뷰션](https://dev.adjust.com/ko/sdk/android/features/deep-links/#reattribution-via-deep-links).

→ 앱 링크가 활성화되면, Adjust에서 자동으로 Digital Asset Links JSON 파일을 생성하고 호스팅합니다.