다음 형식으로 URL을 직접 작성하여 Dynamic Link를 만들 수 있습니다.
https://your_subdomain.page.link/?link=your_deep_link&apn=package_name[&amv=minimum_version][&afl=fallback_link]
Dynamic Link 매개변수
| 딥 링크 매개변수(페이로드 매개변수) | |
|---|---|
| 링크 |
앱에서 열리는 링크입니다. 앱이 처리할 수 있는 URL(일반적으로 앱의 콘텐츠 또는 페이로드)을 지정할 수 있으며, 이를 통해 사용자에게 쿠폰을 지급하거나 시작 화면을 표시하는 등 앱의 특정 로직을 시작할 수 있습니다. 이 링크는 올바른 형식의 URL이어야 하며 적절한 URL 인코딩을 적용해야 합니다. HTTP 또는 HTTPS를 사용해야 하며 다른 동적 링크가 아니어야 합니다. |
| Android 매개변수 | |
|---|---|
| apn | 링크를 여는 데 사용할 Android 앱의 패키지 이름입니다. Firebase 콘솔의 개요 페이지에서 앱을 프로젝트에 연결해야 합니다. Dynamic Link에서 Android 앱을 여는 데 필요합니다. |
| afl | 앱이 설치되지 않은 경우에 열리는 링크입니다. 앱이 설치되지 않았을 때 Play 스토어에서 앱을 설치하는 것 이외에 콘텐츠의 모바일 웹 버전 열기, 앱 홍보 페이지 표시 등의 다른 작업을 수행하려는 경우 이 매개변수를 지정합니다. |
| amv | 링크를 열 수 있는 앱의 최소 버전 versionCode입니다. 설치된 앱이 이전 버전이라면 앱을 업그레이드하기 위해 Play 스토어로 이동합니다. |
| iOS 매개변수 | |
|---|---|
| ibi | 링크를 여는 데 사용할 iOS 앱의 번들 ID입니다. Firebase 콘솔의 개요 페이지에서 앱을 프로젝트에 연결해야 합니다. Dynamic Link에서 iOS 앱을 여는 데 필요합니다. |
| ifl | 앱이 설치되지 않은 경우에 열리는 링크입니다. 앱이 설치되지 않았을 때 App Store에서 앱을 설치하는 것 이외에 콘텐츠의 모바일 웹 버전 열기, 앱 홍보 페이지 표시 등의 다른 작업을 수행하려는 경우 이 매개변수를 지정합니다. |
| ius | 앱의 번들 ID와 다른 값으로 정의하면 앱의 커스텀 URL 스킴으로 사용됩니다. |
| ipfl | 앱이 설치되지 않은 경우 iPad에서 열리는 링크입니다. 앱이 설치되지 않았을 때 App Store에서 앱을 설치하는 것 이외에 콘텐츠의 웹 버전 열기, 앱 홍보 페이지 표시 등의 다른 작업을 수행하려는 경우 이 매개변수를 지정합니다. |
| ipbi | iPad에서 링크를 여는 데 사용할 iOS 앱의 번들 ID입니다. Firebase 콘솔의 개요 페이지에서 앱을 프로젝트에 연결해야 합니다. |
| isi | 앱이 설치되지 않은 경우 사용자를 App Store로 보내는 데 사용되는 앱의 App Store ID입니다. |
| imv | 링크를 열 수 있는 앱의 최소 버전 번호입니다. 이 플래그는 앱이 열렸을 때 앱에 전달되며 앱에서 수행할 작업을 결정해야 합니다. |
| efr | '1'로 설정하는 경우 Dynamic Link가 열리면 앱 미리보기 페이지를 건너뛰고 대신 앱 또는 스토어로 리디렉션합니다. 기본적으로 사용 설정되는 앱 미리보기 페이지는 앱에서 Dynamic Links를 연 사용자를 더욱 안정적으로 가장 적절한 도착 페이지로 안내할 수 있습니다. 하지만 이 페이지 없이 Dynamic Links를 안정적으로 열 수 있는 앱에서만 Dynamic Link가 열리게 하려면 이 매개변수를 사용하여 리디렉션을 중지하면 됩니다. 이 매개변수는 iOS에서만 Dynamic Link의 동작에 영향을 미칩니다. |
| 기타 플랫폼 매개변수 | |
|---|---|
| ofl | Android 및 iOS 이외의 플랫폼에서 열리는 링크입니다. 데스크톱에 다른 동작을 지정할 때 유용합니다. 예를 들어 link 매개변수가 지정하는 앱 콘텐츠/페이로드의 전체 웹페이지를 표시하고 다른 동적 링크를 사용해 앱을 설치할 수 있습니다. |
| 소셜 메타 태그 매개변수 | |
|---|---|
| st | 소셜 게시물에서 Dynamic Link를 공유할 때 사용되는 제목입니다. |
| sd | 소셜 게시물에서 Dynamic Link를 공유할 때 사용되는 설명입니다. |
| si | 이 링크와 관련된 이미지의 URL입니다. 이미지는 300x200픽셀 이상, 300KB 미만이어야 합니다. |
| 애널리틱스 매개변수 | |
|---|---|
| utm_source utm_medium utm_campaign utm_term utm_content |
Google Play 애널리틱스 매개변수입니다. |
| at ct mt pt |
iTunes Connect 애널리틱스 매개변수입니다. |
URL 디버깅
긴 URL 또는 단축 URL을 취하고 디버그 매개변수를 연결하면 Dynamic Link를 디버깅할 수 있습니다.
https://example.page.link/?link=https://www.example.com&d=1 https://example.page.link/WXYZ?d=1
| 디버그 매개변수 | |
|---|---|
| d | Dynamic Link를 로드하는 대신 다양한 플랫폼과 구성에서 Dynamic Links의 동작을 미리 확인하는 데 사용할 수 있는 플로우 차트를 생성합니다. |
다음 단계
Dynamic Link를 만든 후에는 앱에서 Dynamic Links를 수신하고 링크를 연 사용자를 앱의 적절한 위치로 안내하도록 설정해야 합니다.
앱에서 Dynamic Links를 수신하는 방법은 iOS, Android, C++, Unity 관련 문서를 참조하세요.