Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

동적 링크 URL 직접 만들기

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

다음 형식으로 URL을 직접 작성하여 동적 링크를 만들 수 있습니다.

https://your_subdomain.page.link/?link=your_deep_link&apn=package_name[&amv=minimum_version][&afl=fallback_link]

동적 링크 매개변수

딥 링크 매개변수(페이로드 매개변수)
link

앱에서 열리는 링크입니다. 앱이 처리할 수 있는 URL(일반적으로 앱의 콘텐츠 또는 페이로드)을 지정할 수 있으며, 이를 통해 사용자에게 쿠폰을 지급하거나 시작 화면을 표시하는 등 앱의 특정 로직을 시작할 수 있습니다. 이 링크는 올바른 형식의 URL이어야 하며, 적절한 URL 인코딩을 적용해야 합니다. HTTP 또는 HTTPS를 사용해야 하며 다른 동적 링크가 아니어야 합니다.

Android 매개변수
apn 링크를 여는 데 사용할 Android 앱의 패키지 이름입니다. Firebase Console의 개요 페이지에서 앱을 프로젝트에 연결해야 합니다. 동적 링크를 통해 Android 앱을 여는 데 필요합니다.
afl 앱이 설치되지 않은 경우에 열리는 링크입니다. 앱이 설치되지 않았을 때 Play 스토어에서 앱을 설치하는 것 이외에 콘텐츠의 모바일 웹 버전 열기, 앱 홍보 페이지 표시 등의 다른 작업을 수행하려는 경우 이 매개변수를 지정합니다.
amv 링크를 열 수 있는 앱의 최소 버전 versionCode입니다. 설치된 앱이 이전 버전이라면 앱을 업그레이드하기 위해 Play 스토어로 이동합니다.
iOS 매개변수
ibi 링크를 여는 데 사용할 iOS 앱의 번들 ID입니다. Firebase Console의 개요 페이지에서 앱을 프로젝트에 연결해야 합니다. 동적 링크를 통해 iOS 앱을 여는 데 필요합니다.
ifl 앱이 설치되지 않은 경우에 열리는 링크입니다. 앱이 설치되지 않았을 때 App Store에서 앱을 설치하는 것 이외에 콘텐츠의 모바일 웹 버전 열기, 앱 홍보 페이지 표시 등의 다른 작업을 수행하려는 경우 이 매개변수를 지정합니다.
ius 앱의 번들 ID와 다른 값으로 정의하면 앱의 커스텀 URL 스킴으로 사용됩니다.
ipfl 앱이 설치되지 않은 경우 iPad에서 열리는 링크입니다. 앱이 설치되지 않았을 때 App Store에서 앱을 설치하는 것 이외에 콘텐츠의 웹 버전 열기, 앱 홍보 페이지 표시 등의 다른 작업을 수행하려는 경우 이 매개변수를 지정합니다.
ipbi iPad에서 링크를 여는 데 사용할 iOS 앱의 번들 ID입니다. Firebase Console의 개요 페이지에서 앱을 프로젝트에 연결해야 합니다.
isi 앱이 설치되지 않은 경우 사용자를 App Store로 보내는 데 사용되는 앱의 App Store ID입니다.
imv 링크를 열 수 있는 앱의 최소 버전 번호입니다. 이 플래그는 앱이 열렸을 때 앱에 전달되며 앱에서 수행할 작업을 결정해야 합니다.
efr '1'로 설정하는 경우, 동적 링크가 열리면 앱 미리보기 페이지를 건너뛰고 앱 또는 스토어로 리디렉션합니다. 기본적으로 사용 설정되는 앱 미리보기 페이지는 앱에서 동적 링크를 연 사용자를 가장 적절한 목적지로 더 안정적으로 안내할 수 있지만, 이 페이지 없이 동적 링크를 안정적으로 열 수 있는 앱에서만 동적 링크가 열리게 하려면 이 매개변수를 사용하여 리디렉션을 중지하면 됩니다. 이 매개변수는 iOS에서만 동적 링크의 동작에 영향을 미칩니다.
기타 플랫폼 매개변수
ofl Android 및 iOS 이외의 플랫폼에서 열리는 링크입니다. 데스크톱에 다른 동작을 지정할 때 유용합니다. 예를 들어 link 매개변수가 지정하는 앱 콘텐츠/페이로드의 전체 웹페이지를 표시하고 다른 동적 링크를 사용해 앱을 설치할 수 있습니다.
소셜 메타 태그 매개변수
st 소셜 게시물에서 동적 링크를 공유할 때 사용되는 제목입니다.
sd 소셜 게시물에서 동적 링크를 공유할 때 사용되는 설명입니다.
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을 취하고 디버그 매개변수를 추가하면 동적 링크를 디버깅할 수 있습니다.

https://example.page.link/?link=https://www.example.com&d=1
https://example.page.link/WXYZ?d=1
디버그 매개변수
d 동적 링크를 로드하는 대신 다양한 플랫폼과 구성에서 동적 링크의 동작을 미리 확인하는 데 사용할 수 있는 흐름 차트를 생성합니다.

다음 단계

동적 링크를 만든 후에는 앱에서 동적 링크를 수신하고, 링크를 연 사용자를 앱의 적절한 위치로 안내하도록 설정해야 합니다.

앱에서 동적 링크를 수신하는 방법은 iOS, Android, C++, Unity 관련 문서를 참조하세요.