iOS에서 동적 링크 만들기

지원 중단됨: Firebase 동적 링크는 지원 중단되었으며 아직 사용하지 않는 프로젝트에는 채택해서는 안 됩니다. 이 서비스는 2025년 8월 25일에 종료됩니다. 자세한 내용은 동적 링크 지원 중단 FAQ를 참조하세요.

Firebase Dynamic Links Builder API를 사용하여 짧거나 긴 Dynamic Links를 만들 수 있습니다. 이 API는 긴 Dynamic Link 또는 Dynamic Link 매개변수가 포함된 객체를 취하며 다음 예시와 같은 URL을 반환합니다.

https://example.com/link/WXYZ
https://example.page.link/WXYZ

기본 요건

시작하기 전에 iOS 프로젝트에 Firebase를 추가해야 합니다.

Firebase 및 Dynamic Links SDK 설정

Swift Package Manager를 사용해 Firebase 종속 항목을 설치하고 관리하세요.

설치 가이드를 참조하여 직접 프레임워크 가져오기, CocoaPods 사용 등 Firebase SDK를 Apple 프로젝트에 추가하는 다양한 방법을 알아보세요.

1. 앱 프로젝트를 연 상태로 Xcode에서 File(파일) > Add Packages(패키지 추가)로 이동합니다.
2. 메시지가 표시되면 Firebase Apple 플랫폼 SDK 저장소를 추가합니다.

  https://github.com/firebase/firebase-ios-sdk.git

참고: 새 프로젝트에서 기본(최신) SDK 버전을 사용해야 하지만, 필요하면 이전 버전을 선택할 수도 있습니다.
3. Dynamic Links 라이브러리를 선택합니다.
4. 타겟 빌드 설정의 Other Linker Flags(기타 링커 플래그) 섹션에 -ObjC 플래그를 추가합니다.
5. Dynamic Links 사용 환경을 최적화하려면 Firebase 프로젝트에서 Google Analytics를 사용 설정하고 Google 애널리틱스용 Firebase SDK를 앱에 추가하는 것이 좋습니다. IDFA 수집이 없는 라이브러리 또는 IDFA 수집이 있는 라이브러리를 선택할 수 있습니다.
6. 완료되면 Xcode가 백그라운드에서 자동으로 종속 항목을 확인하고 다운로드하기 시작합니다.

이제 몇 가지 구성 단계를 수행합니다.

1. Firebase 콘솔에서 Dynamic Links 섹션을 엽니다.

2. 아직 서비스 약관에 동의하지 않았고 Dynamic Links의 URI 프리픽스도 설정하지 않았다면 관련 메시지가 표시될 때 동의하고 설정합니다.

   Dynamic Links URI 프리픽스가 이미 있다면 기록해 둡니다. 프로그래매틱 방식으로 Dynamic Links를 만들 때 제공해야 합니다.

   

3. 권장: 딥 링크 및 대체 링크에 허용되는 URL 패턴을 지정합니다. 이렇게 하면 승인되지 않은 사용자가 내 도메인에서 내가 제어하지 않는 사이트로 리디렉션되는 Dynamic Links를 만드는 것을 막을 수 있습니다. 특정 URL 패턴 허용을 참조하세요.

4. 앱 설정에서 앱의 App Store ID 및 앱 ID 프리픽스를 지정합니다. 앱 설정을 확인하고 수정하려면 Firebase 프로젝트의 설정 페이지로 이동하고 iOS 앱을 선택합니다.

   Dynamic Links 도메인에서 호스팅되는 apple-app-site-association 파일을 열어 iOS 앱에서 Dynamic Links를 사용할 수 있도록 Firebase 프로젝트가 올바르게 구성되었는지 확인합니다. Firebase는 도메인의 루트와 .well-known 하위 디렉터리에서 apple-app-site-association 파일을 제공합니다. 예를 들면 다음과 같습니다.

       https://example.com/apple-app-site-association
       https://example.com/.well-known/apple-app-site-association
       

   앱이 연결되면 apple-app-site-association 파일에 앱의 앱 ID 프리픽스 및 번들 ID에 대한 참조가 포함됩니다. 예를 들면 다음과 같습니다.

   {"applinks":{"apps":[],"details":[{"appID":"1234567890.com.example.ios","paths":["/*"]}]}}

   details 속성이 비어 있는 경우 앱 ID 프리픽스를 지정했는지 확인해 보세요. 앱 ID 프리픽스와 팀 ID가 같지 않을 수도 있습니다.

앱에 Firebase 추가

1. UIApplicationDelegate의 FirebaseCore 모듈과 앱 대리자가 사용하는 다른 Firebase 모듈을 가져옵니다. 예를 들어 Cloud Firestore와 Authentication을 사용하려면 다음을 따르세요.

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Swift

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. 앱 대리자의 application(_:didFinishLaunchingWithOptions:) 메서드에서 FirebaseApp 공유 인스턴스를 구성합니다.

   SwiftUI

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Swift

   // Use Firebase library to configure APIs
   FirebaseApp.configure()

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. SwiftUI를 사용하는 경우 앱 대리자를 만들고 UIApplicationDelegateAdaptor 또는 NSApplicationDelegateAdaptor를 통해 App 구조체에 연결해야 합니다. 앱 대리자 재구성도 중지해야 합니다. 자세한 내용은 SwiftUI 안내를 참조하세요.

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

Firebase 콘솔 사용

테스트에 사용하거나 마케팅팀에서 소셜 미디어 게시물 등에 사용할 수 있는 링크를 간편하게 만들 수 있도록 Dynamic Link 하나를 생성하려고 할 때 가장 간단한 방법은 Firebase 콘솔로 이동하여 단계별 양식에 따라 직접 만드는 것입니다.

iOS Builder API 사용

iOS Builder API를 사용하여 매개변수에서 Dynamic Links를 빌드하거나 긴 Dynamic Link를 축약할 수 있습니다.

매개변수로 Dynamic Link 만들기

Dynamic Link를 만들려면 새 DynamicLinkComponents 객체를 만들고 객체의 해당 속성을 설정하여 Dynamic Link 매개변수를 지정합니다. 그런 다음 객체의 url 속성에서 긴 링크를 가져오거나 shorten()를 호출하여 짧은 링크를 가져옵니다.

다음은 iOS의 경우 iOS 앱, Android의 경우 com.example.android 앱에서 열리는 https://www.example.com/my-page의 긴 Dynamic Link를 만드는 간단한 예시입니다.

Swift

참고: 이 Firebase 제품은 macOS, Mac Catalyst, tvOS 또는 watchOS 대상에서는 사용할 수 없습니다.

guard let link = URL(string: "https://www.example.com/my-page") else { return }
let dynamicLinksDomainURIPrefix = "https://example.com/link"
let linkBuilder = DynamicLinkComponents(link: link, domainURIPrefix: dynamicLinksDomainURIPRefix)
linkBuilder.iOSParameters = DynamicLinkIOSParameters(bundleID: "com.example.ios")
linkBuilder.androidParameters = DynamicLinkAndroidParameters(packageName: "com.example.android")

guard let longDynamicLink = linkBuilder.url else { return }
print("The long URL is: \(longDynamicLink)")

Objective-C

참고: 이 Firebase 제품은 macOS, Mac Catalyst, tvOS 또는 watchOS 대상에서는 사용할 수 없습니다.

NSURL *link = [[NSURL alloc] initWithString:@"https://www.example.com/my-page"];
NSString *dynamicLinksDomainURIPrefix = @"https://example.com/link";
FIRDynamicLinkComponents *linkBuilder = [[FIRDynamicLinkComponents alloc]
                                         initWithLink:link
                                               domainURIPrefix:dynamicLinksDomainURIPrefix];
linkBuilder.iOSParameters = [[FIRDynamicLinkIOSParameters alloc]
                             initWithBundleID:@"com.example.ios"];
linkBuilder.androidParameters = [[FIRDynamicLinkAndroidParameters alloc]
                                 initWithPackageName:@"com.example.android"];

NSLog(@"The long URL is: %@", linkBuilder.url);

짧은 Dynamic Link를 만들려면 같은 방법으로 DynamicLinkComponents를 빌드한 후 shorten()를 호출합니다.

짧은 링크를 작성하려면 네트워크 호출이 필요하므로 shorten()은 링크를 직접 반환하는 대신 요청이 완료될 때 호출되는 완료 핸들러를 취합니다. 예를 들면 다음과 같습니다.

Swift

참고: 이 Firebase 제품은 macOS, Mac Catalyst, tvOS 또는 watchOS 대상에서는 사용할 수 없습니다.

linkBuilder.shorten() { url, warnings, error in
  guard let url = url, error != nil else { return }
  print("The short URL is: \(url)")
}

Objective-C

참고: 이 Firebase 제품은 macOS, Mac Catalyst, tvOS 또는 watchOS 대상에서는 사용할 수 없습니다.

[linkBuilder shortenWithCompletion:^(NSURL * _Nullable shortURL,
                                     NSArray<NSString *> * _Nullable warnings,
                                     NSError * _Nullable error) {
  if (error || shortURL == nil) { return; }
  NSLog(@"The short URL is: %@", shortURL);
}];
      

기본적으로 짧은 Dynamic Links는 17자 링크 서픽스와 함께 생성되어 누군가가 유효한 Dynamic Link를 추측하는 것이 거의 불가능합니다. 누군가가 짧은 링크를 추측해도 괜찮다면 고유성을 위해 꼭 필요한 만큼의 길이로 서픽스를 만드는 것이 좋을 수 있으며, dynamicLinkComponentsOptions 속성을 설정하면 됩니다.

Swift

참고: 이 Firebase 제품은 macOS, Mac Catalyst, tvOS 또는 watchOS 대상에서는 사용할 수 없습니다.

linkBuilder.options = DynamicLinkComponentsOptions()
linkBuilder.options.pathLength = .short
linkBuilder.shorten() { url, warnings, error in
  guard let url = url, error != nil else { return }
  print("The short URL is: \(url)")
}

Objective-C

참고: 이 Firebase 제품은 macOS, Mac Catalyst, tvOS 또는 watchOS 대상에서는 사용할 수 없습니다.

linkBuilder.dynamicLinkComponentsOptions = [[FIRDynamicLinkComponentsOptions alloc] init];
linkBuilder.dynamicLinkComponentsOptions.pathLength = FIRShortDynamicLinkPathLengthShort;
[linkBuilder shortenWithCompletion:^(NSURL * _Nullable shortURL,
                                     NSArray<NSString *> * _Nullable warnings,
                                     NSError * _Nullable error) {
  if (error || shortURL == nil) { return; }
  NSLog(@"The short URL is: %@", shortURL);
}];
      

Dynamic Link 매개변수

Dynamic Link Builder API를 사용하여 지원되는 매개변수로 Dynamic Links를 만들 수 있습니다. 자세한 내용은 API 참조를 확인하세요.

다음 예시에서는 일반적인 몇 가지 매개변수를 설정하여 Dynamic Link를 만듭니다.

Swift

참고: 이 Firebase 제품은 macOS, Mac Catalyst, tvOS 또는 watchOS 대상에서는 사용할 수 없습니다.

guard let link = URL(string: "https://www.example.com/my-page") else { return }
let dynamicLinksDomainURIPrefix = "https://example.com/link"
let linkBuilder = DynamicLinkComponents(link: link, domainURIPRefix: dynamicLinksDomainURIPrefix)

linkBuilder.iOSParameters = DynamicLinkIOSParameters(bundleID: "com.example.ios")
linkBuilder.iOSParameters.appStoreID = "123456789"
linkBuilder.iOSParameters.minimumAppVersion = "1.2.3"

linkBuilder.androidParameters = DynamicLinkAndroidParameters(packageName: "com.example.android")
linkBuilder.androidParameters.minimumVersion = 123

linkBuilder.analyticsParameters = DynamicLinkGoogleAnalyticsParameters(source: "orkut",
                                                                       medium: "social",
                                                                       campaign: "example-promo")

linkBuilder.iTunesConnectParameters = DynamicLinkItunesConnectAnalyticsParameters()
linkBuilder.iTunesConnectParameters.providerToken = "123456"
linkBuilder.iTunesConnectParameters.campaignToken = "example-promo"

linkBuilder.socialMetaTagParameters = DynamicLinkSocialMetaTagParameters()
linkBuilder.socialMetaTagParameters.title = "Example of a Dynamic Link"
linkBuilder.socialMetaTagParameters.descriptionText = "This link works whether the app is installed or not!"
linkBuilder.socialMetaTagParameters.imageURL = "https://www.example.com/my-image.jpg"

guard let longDynamicLink = linkBuilder.url else { return }
print("The long URL is: \(longDynamicLink)")

Objective-C

참고: 이 Firebase 제품은 macOS, Mac Catalyst, tvOS 또는 watchOS 대상에서는 사용할 수 없습니다.

NSURL *link = [[NSURL alloc] initWithString:@"https://www.example.com/my-page"];
NSString *dynamicLinksDomainURIPrefix = @"https://example.com/link";
FIRDynamicLinkComponents *linkBuilder = [[FIRDynamicLinkComponents alloc]
                                         initWithLink:link
                                         domainURIPrefix:dynamicLinksDomainURIPrefix];

linkBuilder.iOSParameters = [[FIRDynamicLinkIOSParameters alloc]
                             initWithBundleID:@"com.example.ios"];
linkBuilder.iOSParameters.appStoreID = @"123456789";
linkBuilder.iOSParameters.minimumAppVersion = @"1.2.3";

linkBuilder.androidParameters = [[FIRDynamicLinkAndroidParameters alloc]
                                 initWithPackageName:@"com.example.android"];
linkBuilder.androidParameters.minimumVersion = 123;

linkBuilder.analyticsParameters = [[FIRDynamicLinkGoogleAnalyticsParameters alloc]
                                   initWithSource:@"orkut"
                                           medium:@"social"
                                         campaign:@"example-promo"];

linkBuilder.iTunesConnectParameters = [[FIRDynamicLinkItunesConnectAnalyticsParameters alloc] init];
linkBuilder.iTunesConnectParameters.providerToken = @"123456";
linkBuilder.iTunesConnectParameters.campaignToken = @"example-promo";

linkBuilder.socialMetaTagParameters = [[FIRDynamicLinkSocialMetaTagParameters alloc] init];
linkBuilder.socialMetaTagParameters.title = @"Example of a Dynamic Link";
linkBuilder.socialMetaTagParameters.descriptionText = @"This link works whether the app is installed or not!";
linkBuilder.socialMetaTagParameters.imageURL = @"https://www.example.com/my-image.jpg";

NSLog(@"The long URL is: %@", linkBuilder.url);

다음 객체 및 속성으로 Dynamic Link 매개변수를 설정할 수 있습니다.

DynamicLinkComponents
링크	앱에서 열리는 링크입니다. 앱이 처리할 수 있는 URL(일반적으로 앱의 콘텐츠 또는 페이로드)을 지정할 수 있으며, 이를 통해 사용자에게 쿠폰을 지급하거나 시작 화면을 표시하는 등 앱의 특정 로직을 시작할 수 있습니다. 이 링크는 올바른 형식의 URL이어야 하며 적절한 URL 인코딩을 적용해야 합니다. HTTP 또는 HTTPS를 사용해야 하며 다른 동적 링크가 아니어야 합니다. (ofl 매개변수가 지정되지 않은 상태에서) 사용자가 데스크톱 웹브라우저에서 Dynamic Link를 열면 이 URL이 로드됩니다. 연결된 콘텐츠에 해당하는 웹 콘텐츠가 없다면 URL이 유효한 웹 리소스를 반드시 가리킬 필요는 없습니다. 이러한 경우 이 URL에서 홈페이지 등으로 연결되도록 리디렉션을 설정해야 합니다.
domainURIPrefix	Dynamic Link 콘솔에서 확인할 수 있는 Firebase URL 프리픽스입니다. Dynamic Link 도메인의 형식은 일반적으로 다음 예와 같습니다. https://example.com/link https://example.page.link

DynamicLinkAndroidParameters
fallbackURL	앱이 설치되지 않았을 때 열리는 링크입니다. 앱이 설치되지 않았을 때 Play 스토어에서 앱 설치 이외에 콘텐츠의 모바일 웹 버전 열기나 앱 홍보 페이지 표시와 같은 다른 작업을 수행하려는 경우에 이 매개변수를 지정합니다.
minimumVersion	링크를 열 수 있는 앱의 최소 버전 versionCode입니다. 설치된 앱이 이전 버전이라면 앱을 업그레이드하기 위해 Play 스토어로 이동합니다.

DynamicLinkIOSParameters
appStoreID	앱이 설치되지 않은 경우 사용자를 App Store로 보내는 데 사용되는 앱의 App Store ID입니다.
fallbackURL	앱이 설치되지 않았을 때 열리는 링크입니다. 앱이 설치되지 않았을 때 App Store에서 앱을 설치하는 것 이외에 콘텐츠의 모바일 웹 버전 열기, 앱 홍보 페이지 표시 등의 다른 작업을 수행하려는 경우 이 매개변수를 지정합니다.
customScheme	앱의 번들 ID와 다른 값으로 정의하면 앱의 맞춤 URL 스키마로 사용됩니다.
iPadFallbackURL	앱이 설치되지 않은 경우 iPad에서 열리는 링크입니다. 앱이 설치되지 않았을 때 App Store에서 앱 설치 이외에 콘텐츠의 웹 버전 열기나 앱 홍보 페이지 표시와 같은 다른 작업을 수행하려는 경우에 이 매개변수를 지정합니다.
iPadBundleID	iPad에서 링크를 여는 데 사용할 iOS 앱의 번들 ID입니다. Firebase 콘솔의 개요 페이지에서 앱을 프로젝트에 연결해야 합니다.
minimumAppVersion	링크를 열 수 있는 앱 최소 버전의 버전 번호입니다. 이 플래그는 앱이 열렸을 때 앱에 전달되며 앱에서 수행할 작업을 결정해야 합니다.

DynamicLinkNavigationInfoParameters
forcedRedirectEnabled	'1'로 설정하는 경우 Dynamic Link가 열리면 앱 미리보기 페이지를 건너뛰고 대신 앱 또는 스토어로 리디렉션합니다. 기본적으로 사용 설정되는 앱 미리보기 페이지는 앱에서 Dynamic Links를 연 사용자를 더욱 안정적으로 가장 적절한 도착 페이지로 안내할 수 있습니다. 하지만 이 페이지 없이 Dynamic Links를 안정적으로 열 수 있는 앱에서만 Dynamic Link가 열리게 하려면 이 매개변수를 사용하여 리디렉션을 중지하면 됩니다. 이 매개변수는 iOS에서만 Dynamic Link의 동작에 영향을 미칩니다.

DynamicLinkSocialMetaTagParameters
title	소셜 게시물에서 Dynamic Link를 공유할 때 사용되는 제목입니다.
descriptionText	소셜 게시물에서 Dynamic Link를 공유할 때 사용되는 설명입니다.
imageURL	이 링크와 관련된 이미지의 URL입니다. 이미지는 300x200픽셀 이상, 300KB 미만이어야 합니다.

DynamicLinkGoogleAnalyticsParameters
source medium campaign term content	Google Play 애널리틱스 매개변수입니다. 이러한 매개변수(utm_source, utm_medium, utm_campaign, utm_term, utm_content)는 Play 스토어에 전달될 뿐 아니라 링크 페이로드에도 추가됩니다.

DynamicLinkItunesConnectAnalyticsParameters
providerToken affiliateToken campaignToken	iTunes Connect 애널리틱스 매개변수입니다. 이러한 매개변수(pt, at, ct)는 앱 스토어로 전달됩니다.

긴 Dynamic Link 길이 단축

긴 Dynamic Link를 단축할 때 짧은 서픽스가 있는 링크를 만들려면 긴 Dynamic Link를 DynamicLinkComponentsOptions 객체와 함께 shortenURL(url:options:)로 전달합니다.

Swift

참고: 이 Firebase 제품은 macOS, Mac Catalyst, tvOS 또는 watchOS 대상에서는 사용할 수 없습니다.

DynamicLinkComponents.shortenURL(url: longLinkUrl, options: nil) { url, warnings, error in
  guard let url = url, error != nil else { return }
  print("The short URL is: \(url)")
}

Objective-C

참고: 이 Firebase 제품은 macOS, Mac Catalyst, tvOS 또는 watchOS 대상에서는 사용할 수 없습니다.

[FIRDynamicLinkComponents shortenURL:longLinkUrl
                             options:nil
                          completion:^(NSURL * _Nullable shortURL,
                                       NSArray<NSString *> * _Nullable warnings,
                                       NSError * _Nullable error) {
  if (error || shortURL == nil) { return; }
  NSLog(@"The short URL is: %@", shortURL);
}];

Dynamic Links에 커스텀 URL 스키마 지정

기본적으로 Dynamic Links는 앱의 번들 식별자를 애플리케이션을 여는 데 필요한 URL 스키마로 사용합니다. 구현이 간단해지도록 이 기본값을 그대로 두는 것이 좋습니다.

하지만 이미 다른 목적으로 커스텀 URL 스키마를 사용하는 개발자는 Dynamic Links에도 동일한 커스텀 URL 스키마를 사용할 수 있습니다. 이러한 경우에 해당한다면 다음 단계에 따라 Firebase Dynamic Links에 다른 URL 스키마를 지정할 수 있습니다.

1. 앱을 설정할 때 FirebaseApp 공유 인스턴스를 구성하기 전에 애플리케이션에서 사용할 기본 URL 스키마를 지정해야 합니다.

   Swift

   참고: 이 Firebase 제품은 macOS, Mac Catalyst, tvOS 또는 watchOS 대상에서는 사용할 수 없습니다.

   func application(_ application: UIApplication,
                    didFinishLaunchingWithOptions launchOptions: [UIApplication
                      .LaunchOptionsKey: Any]?) -> Bool {
     // Set deepLinkURLScheme to the custom URL scheme you defined in your
     // Xcode project.
     FirebaseOptions.defaultOptions()?.deepLinkURLScheme = customURLScheme
     FirebaseApp.configure()
   
     return true
   }

   Objective-C

   참고: 이 Firebase 제품은 macOS, Mac Catalyst, tvOS 또는 watchOS 대상에서는 사용할 수 없습니다.

   - (BOOL)application:(UIApplication *)application
       didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
     // Set deepLinkURLScheme to the custom URL scheme you defined in your
     // Xcode project.
     [FIROptions defaultOptions].deepLinkURLScheme = CUSTOM_URL_SCHEME;
     [FIRApp configure];
   
     return YES;
   }

2. Dynamic Link를 만들 때마다 앱에서 사용하는 커스텀 URL 스키마를 지정해야 합니다. Builder API에 customScheme을 설정하거나, URL에 ius 매개변수를 지정하거나, REST API에 iosCustomScheme 매개변수를 전송하여 Firebase 콘솔을 통해 지정할 수 있습니다.

다음 단계

이제 Dynamic Links를 만들었으므로 앱에서 Dynamic Links를 수신하고 링크를 연 사용자를 앱의 적절한 위치로 안내하도록 설정해야 합니다.

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