Firebase Summit에서 발표된 모든 내용을 살펴보고 Firebase로 앱을 빠르게 개발하고 안심하고 앱을 실행하는 방법을 알아보세요. 자세히 알아보기

iOS에서 동적 링크 만들기

Firebase Dynamic Links Builder API를 사용하여 짧거나 긴 동적 링크를 만들 수 있습니다. 이 API는 긴 동적 링크 또는 동적 링크 매개변수가 포함된 개체를 허용하고 다음 예와 같은 URL을 반환합니다.

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

전제 조건

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

Swift 패키지 관리자를 사용하여 Firebase 종속 항목을 설치하고 관리합니다.

  1. Xcode에서 앱 프로젝트를 연 상태에서 파일 > 패키지 추가 로 이동합니다.
  2. 메시지가 표시되면 Firebase Apple 플랫폼 SDK 저장소를 추가합니다.
  3.   https://github.com/firebase/firebase-ios-sdk
  4. 동적 링크 라이브러리를 선택합니다.
  5. 최적의 동적 링크 경험을 위해 Firebase 프로젝트에서 Google 애널리틱스를 활성화 하고 앱에 Google 애널리틱스용 Firebase SDK를 추가하는 것이 좋습니다. IDFA 컬렉션이 없는 라이브러리 또는 IDFA 컬렉션이 있는 라이브러리를 선택할 수 있습니다.
  6. 완료되면 Xcode는 백그라운드에서 종속성을 자동으로 해결하고 다운로드하기 시작합니다.

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

  1. Firebase 콘솔에서 동적 링크 섹션을 엽니다.
  2. 아직 서비스 약관에 동의하지 않고 동적 링크에 대한 URI 접두사를 설정하지 않은 경우 메시지가 표시되면 수락하십시오.

    동적 링크 URI 접두사가 이미 있는 경우 이를 기록해 두십시오. 프로그래밍 방식으로 동적 링크를 만들 때 제공해야 합니다.

  3. 권장 사항 : 딥 링크 및 대체 링크에서 허용되는 URL 패턴을 지정합니다. 이렇게 하면 권한이 없는 당사자가 도메인에서 제어할 수 없는 사이트로 리디렉션되는 동적 링크를 만드는 것을 방지할 수 있습니다. 특정 URL 패턴 허용을 참조하세요.
  4. 앱의 App Store ID와 App ID 접두사가 앱 설정에 지정되어 있는지 확인하십시오. 앱 설정을 보고 수정하려면 Firebase 프로젝트의 설정 페이지 로 이동하여 iOS 앱을 선택하세요.

    동적 링크 도메인에서 호스팅되는 apple-app-site-association 파일을 열어 Firebase 프로젝트가 iOS 앱에서 동적 링크를 사용하도록 올바르게 구성되었는지 확인합니다. 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 속성이 비어 있으면 App ID 접두사를 지정했는지 다시 확인하십시오. 앱 ID 접두사는 팀 ID와 동일하지 않을 수 있습니다.

앱에 Firebase 추가

  1. UIApplicationDelegate 에서 FirebaseCore 모듈과 앱 대리자가 사용하는 다른 Firebase 모듈 을 가져옵니다. 예를 들어 Cloud Firestore 및 인증을 사용하려면 다음 안내를 따르세요.

    빠른

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    오브젝티브-C

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

    빠른

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

    오브젝티브-C

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

Firebase 콘솔 사용

테스트 목적으로 또는 마케팅 팀이 소셜 미디어 게시물과 같은 항목에 사용할 수 있는 링크를 쉽게 생성할 수 있도록 단일 동적 링크를 생성하려는 경우 가장 간단한 방법은 Firebase 콘솔 을 방문하여 생성하는 것입니다. 수동으로 단계별 양식을 따릅니다.

iOS 빌더 API 사용

iOS Builder API를 사용하여 매개변수에서 동적 링크를 빌드하거나 긴 동적 링크를 줄일 수 있습니다.

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

다음 최소 예제는 iOS의 iOS 앱과 Android의 com.example.android 앱과 함께 열리는 https://www.example.com/my-page 에 대한 긴 동적 링크를 만듭니다.

빠른

참고: 이 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)")

오브젝티브-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);

짧은 동적 링크를 생성하려면 같은 방식으로 DynamicLinkComponents 를 빌드한 다음 short shorten() 를 호출하십시오.

짧은 링크를 빌드하려면 네트워크 호출이 필요하므로 링크를 직접 반환하는 대신 short shorten() 는 요청이 완료될 때 호출되는 완료 처리기를 수락합니다. 예를 들어:

빠른

참고: 이 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)")
}

오브젝티브-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);
}];
      

기본적으로 짧은 동적 링크는 17자의 링크 접미사로 생성되어 누군가가 유효한 동적 링크를 추측할 가능성이 극히 낮습니다. 사용 사례에 대해 누군가가 짧은 링크를 성공적으로 추측하는 데 아무런 해가 없다면 고유한 데 필요한 만큼만 접미사를 생성하는 것을 선호할 수 있습니다. 이 작업은 dynamicLinkComponentsOptions 속성을 설정하여 수행할 수 있습니다.

빠른

참고: 이 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)")
}

오브젝티브-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 Builder API를 사용하여 지원되는 매개변수로 동적 링크를 생성할 수 있습니다. 자세한 내용은 API 참조 를 참조하세요.

다음 예에서는 몇 가지 공통 매개변수가 설정된 동적 링크를 만듭니다.

빠른

참고: 이 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)")

오브젝티브-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);

다음 개체 및 속성을 사용하여 동적 링크 매개변수를 설정할 수 있습니다.

DynamicLink 구성 요소
링크

앱이 열릴 링크입니다. 앱이 처리할 수 있는 URL(일반적으로 앱의 콘텐츠 또는 페이로드)을 지정하여 앱별 로직(예: 사용자에게 쿠폰 제공 또는 시작 화면 표시)을 시작합니다. 이 링크는 올바른 형식의 URL이어야 하고, 올바르게 URL 인코딩되어야 하며, HTTP 또는 HTTPS를 사용해야 하며, 다른 동적 링크가 될 수 없습니다.

도메인URIPPrefix Firebase 콘솔에서 찾을 수 있는 동적 링크 URL 접두사. 동적 링크 도메인은 다음 예와 같습니다.
https://example.com/link
https://example.page.link
DynamicLinkAndroid 매개변수
대체 URL 앱이 설치되지 않았을 때 열리는 링크입니다. 앱이 설치되어 있지 않을 때 Play 스토어에서 앱을 설치하는 것 외에 콘텐츠의 모바일 웹 버전을 열거나 앱에 대한 프로모션 페이지를 표시하는 등의 작업을 수행하려면 이를 지정합니다.
최소 버전 링크를 열 수 있는 versionCode 의 최소 버전 버전 코드입니다. 설치된 앱이 이전 버전인 경우 사용자는 앱을 업그레이드하기 위해 Play 스토어로 이동합니다.
DynamicLinkIOSParameters
앱스토어ID 앱이 설치되지 않았을 때 사용자를 App Store로 보내는 데 사용되는 앱의 App Store ID
대체 URL 앱이 설치되지 않았을 때 열리는 링크입니다. 앱이 설치되어 있지 않을 때 앱 스토어에서 앱을 설치하는 것 외에 콘텐츠의 모바일 웹 버전을 열거나 앱에 대한 프로모션 페이지를 표시하는 등의 작업을 수행하려면 이를 지정합니다.
커스텀 스킴 앱의 번들 ID가 아닌 다른 것으로 정의된 경우 앱의 맞춤 URL 스키마
iPad폴백URL 앱이 설치되지 않은 경우 iPad에서 열리는 링크입니다. 콘텐츠의 웹 버전을 열거나 앱에 대한 프로모션 페이지를 표시하는 등 앱이 설치되지 않은 경우 App Store에서 앱을 설치하는 것 외에 다른 작업을 수행하려면 이를 지정합니다.
아이패드번들ID iPad에서 링크를 여는 데 사용할 iOS 앱의 번들 ID입니다. Firebase 콘솔의 개요 페이지에서 앱을 프로젝트에 연결해야 합니다.
최소 앱 버전 링크를 열 수 있는 앱의 최소 버전 버전 번호 입니다. 이 플래그는 앱이 열릴 때 앱에 전달되며 앱에서 무엇을 할지 결정해야 합니다.
DynamicLinkNavigationInfoParameters
강제 리디렉션 가능 '1'로 설정하면 Dynamic Link가 열렸을 때 앱 미리보기 페이지를 건너뛰고 대신 앱이나 스토어로 리디렉션합니다. 앱 미리보기 페이지(기본적으로 활성화됨)는 사용자가 앱에서 동적 링크를 열 때 가장 적절한 대상으로 사용자를 더 안정적으로 보낼 수 있습니다. 그러나 이 페이지 없이 동적 링크를 안정적으로 열 수 있는 앱에서만 동적 링크가 열릴 것으로 예상하는 경우 이 매개변수를 사용하여 비활성화할 수 있습니다. 이 매개변수는 iOS에서만 동적 링크의 동작에 영향을 줍니다.
DynamicLinkSocialMetaTagParameters
제목 소셜 게시물에서 Dynamic Link를 공유할 때 사용할 제목입니다.
설명텍스트 소셜 게시물에서 Dynamic Link를 공유할 때 사용할 설명입니다.
이미지URL 이 링크와 관련된 이미지의 URL입니다. 이미지는 300x200픽셀 이상, 300KB 미만이어야 합니다.
DynamicLinkGoogleAnalytics매개변수
원천
중간
운동
기간
콘텐츠
Google Play 분석 매개변수. 이러한 매개변수( utm_source , utm_medium , utm_campaign , utm_term , utm_content )는 Play 스토어로 전달되고 링크 페이로드에 추가됩니다.
DynamicLinkItunesConnectAnalyticsParameters
공급자 토큰
제휴 토큰
캠페인 토큰
iTunes Connect 분석 매개변수. 이러한 매개변수( pt , at , ct )는 App Store로 전달됩니다.

긴 동적 링크를 줄이려면 짧은 접미사가 있는 링크를 생성하려는 경우 DynamicLinkComponentsOptions 개체와 함께 긴 동적 링크를 shortenURL(url:options:) 에 전달합니다.

빠른

참고: 이 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)")
}

오브젝티브-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 체계로 사용합니다. 구현을 단순하게 유지하려면 이 기본값을 유지하는 것이 좋습니다.

그러나 이미 다른 용도로 사용자 정의 URL 스키마를 사용하고 있는 개발자는 동적 링크에도 이와 동일한 사용자 정의 URL 스키마를 사용하기를 원할 수 있습니다. 이 상황에 있는 경우 다음 단계에 따라 Firebase 동적 링크에 대해 다른 URL 스키마를 지정할 수 있습니다.

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

    빠른

    참고: 이 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
    }
    

    오브젝티브-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. 동적 링크를 만들 때마다 앱에서 사용하는 사용자 지정 URL 체계를 지정해야 합니다. Firebase 콘솔을 통해 이 작업을 수행하고 Builder API에서 customScheme 을 설정하거나 URL에 ius 매개변수를 지정하거나 iosCustomScheme 매개변수를 REST API로 보낼 수 있습니다.

다음 단계

이제 동적 링크를 만들었으므로 동적 링크를 수신하고 사용자가 링크를 연 후 사용자를 앱의 올바른 위치로 보내도록 앱을 설정해야 합니다.

앱에서 동적 링크를 수신하려면 iOS , Android , C++Unity 설명서를 참조하세요.