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

Android에서 동적 링크 만들기

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

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

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

Android 앱에서 동적 링크를 만들려면 먼저 Firebase SDK를 포함해야 합니다. 앱이 동적 링크를 수신하도록 설정된 경우 이미 이 단계를 완료했으며 이 섹션을 건너뛸 수 있습니다.

  1. 아직 Android 프로젝트에 Firebase를 추가 하지 않았다면 추가합니다.

    앱을 등록할 때 SHA-1 서명 키를 지정하십시오. 앱 링크를 사용하는 경우 SHA-256 키도 지정하십시오.

  2. 모듈(앱 수준) Gradle 파일 (일반적으로 <project>/<app-module>/build.gradle )에서 Dynamic Links Android 라이브러리에 대한 종속성을 추가합니다. Firebase Android BoM 을 사용하여 라이브러리 버전 관리를 제어하는 ​​것이 좋습니다.

    최적의 동적 링크 경험을 위해 Firebase 프로젝트에서 Google 애널리틱스를 활성화 하고 앱에 Google 애널리틱스용 Firebase SDK를 추가하는 것이 좋습니다.

    Java

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:31.1.0')
    
        // Add the dependencies for the Dynamic Links and Analytics libraries
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-dynamic-links'
        implementation 'com.google.firebase:firebase-analytics'
    }
    

    Firebase Android BoM 을 사용하면 앱에서 항상 호환되는 Firebase Android 라이브러리 버전을 사용합니다.

    (또는) BoM을 사용 하지 않고 Firebase 라이브러리 종속성을 추가합니다.

    Firebase BoM을 사용하지 않기로 선택한 경우 종속성 줄에 각 Firebase 라이브러리 버전을 지정해야 합니다.

    앱에서 여러 Firebase 라이브러리를 사용하는 경우 모든 버전이 호환되도록 BoM을 사용하여 라이브러리 버전을 관리하는 것이 좋습니다.

    dependencies {
        // Add the dependencies for the Dynamic Links and Analytics libraries
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-dynamic-links:21.1.0'
        implementation 'com.google.firebase:firebase-analytics:21.2.0'
    }
    

    Kotlin+KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:31.1.0')
    
        // Add the dependencies for the Dynamic Links and Analytics libraries
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-dynamic-links-ktx'
        implementation 'com.google.firebase:firebase-analytics-ktx'
    }
    

    Firebase Android BoM 을 사용하면 앱에서 항상 호환되는 Firebase Android 라이브러리 버전을 사용합니다.

    (또는) BoM을 사용 하지 않고 Firebase 라이브러리 종속성을 추가합니다.

    Firebase BoM을 사용하지 않기로 선택한 경우 종속성 줄에 각 Firebase 라이브러리 버전을 지정해야 합니다.

    앱에서 여러 Firebase 라이브러리를 사용하는 경우 모든 버전이 호환되도록 BoM을 사용하여 라이브러리 버전을 관리하는 것이 좋습니다.

    dependencies {
        // Add the dependencies for the Dynamic Links and Analytics libraries
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-dynamic-links-ktx:21.1.0'
        implementation 'com.google.firebase:firebase-analytics-ktx:21.2.0'
    }
    
  3. Firebase 콘솔에서 동적 링크 섹션을 엽니다.
  4. 아직 서비스 약관에 동의하지 않고 동적 링크에 대한 도메인을 설정하지 않은 경우 메시지가 표시되면 동의하십시오.

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

  5. 권장 사항 : 딥 링크 및 대체 링크에서 허용되는 URL 패턴을 지정합니다. 이렇게 하면 권한이 없는 당사자가 도메인에서 제어할 수 없는 사이트로 리디렉션되는 동적 링크를 만드는 것을 방지할 수 있습니다. 특정 URL 패턴 허용을 참조하세요.

Firebase 콘솔 사용

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

동적 링크를 만들려면 빌더를 사용하여 새 DynamicLink 개체를 만들고 빌더 메서드로 동적 링크 매개변수를 지정합니다. 그런 다음 buildDynamicLink 또는 buildShortDynamicLink 를 호출합니다.

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

Java

DynamicLink dynamicLink = FirebaseDynamicLinks.getInstance().createDynamicLink()
        .setLink(Uri.parse("https://www.example.com/"))
        .setDomainUriPrefix("https://example.page.link")
        // Open links with this app on Android
        .setAndroidParameters(new DynamicLink.AndroidParameters.Builder().build())
        // Open links with com.example.ios on iOS
        .setIosParameters(new DynamicLink.IosParameters.Builder("com.example.ios").build())
        .buildDynamicLink();

Uri dynamicLinkUri = dynamicLink.getUri();

Kotlin+KTX

val dynamicLink = Firebase.dynamicLinks.dynamicLink {
    link = Uri.parse("https://www.example.com/")
    domainUriPrefix = "https://example.page.link"
    // Open links with this app on Android
    androidParameters { }
    // Open links with com.example.ios on iOS
    iosParameters("com.example.ios") { }
}

val dynamicLinkUri = dynamicLink.uri

짧은 동적 링크를 만들려면 같은 방법으로 DynamicLink 를 만든 다음 buildShortDynamicLink 를 호출합니다. 짧은 링크를 빌드하려면 네트워크 호출이 필요하므로 링크를 직접 반환하는 대신 buildShortDynamicLink 는 요청이 완료될 때 짧은 링크를 사용할 수 있도록 하는 Task 를 반환합니다. 예를 들어:

Java

Task<ShortDynamicLink> shortLinkTask = FirebaseDynamicLinks.getInstance().createDynamicLink()
        .setLink(Uri.parse("https://www.example.com/"))
        .setDomainUriPrefix("https://example.page.link")
        // Set parameters
        // ...
        .buildShortDynamicLink()
        .addOnCompleteListener(this, new OnCompleteListener<ShortDynamicLink>() {
            @Override
            public void onComplete(@NonNull Task<ShortDynamicLink> task) {
                if (task.isSuccessful()) {
                    // Short link created
                    Uri shortLink = task.getResult().getShortLink();
                    Uri flowchartLink = task.getResult().getPreviewLink();
                } else {
                    // Error
                    // ...
                }
            }
        });

Kotlin+KTX

val shortLinkTask = Firebase.dynamicLinks.shortLinkAsync {
    link = Uri.parse("https://www.example.com/")
    domainUriPrefix = "https://example.page.link"
    // Set parameters
    // ...
}.addOnSuccessListener { (shortLink, flowchartLink) ->
    // You'll need to import com.google.firebase.dynamiclinks.ktx.component1 and
    // com.google.firebase.dynamiclinks.ktx.component2

    // Short link created
    processShortLink(shortLink, flowchartLink)
}.addOnFailureListener {
    // Error
    // ...
}

기본적으로 짧은 동적 링크는 17자의 링크 접미사로 생성되어 누군가가 유효한 동적 링크를 추측할 가능성이 극히 낮습니다. 귀하의 사용 사례에 대해 누군가가 짧은 링크를 성공적으로 추측하는 데 해가 없는 경우 고유한 데 필요한 buildShortDynamicLink ShortDynamicLink.Suffix.SHORT 를 생성하는 것을 선호할 수 있습니다. :

Java

Task<ShortDynamicLink> shortLinkTask = FirebaseDynamicLinks.getInstance().createDynamicLink()
        // ...
        .buildShortDynamicLink(ShortDynamicLink.Suffix.SHORT);
        // ...

Kotlin+KTX

val shortLinkTask = Firebase.dynamicLinks.shortLinkAsync(ShortDynamicLink.Suffix.SHORT) {
    // Set parameters
    // ...
}

Dynamic Link Builder API를 사용하여 지원되는 매개변수로 동적 링크를 생성할 수 있습니다. 자세한 내용은 API 참조 를 참조하세요.

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

Java

DynamicLink dynamicLink = FirebaseDynamicLinks.getInstance().createDynamicLink()
        .setLink(Uri.parse("https://www.example.com/"))
        .setDomainUriPrefix("https://example.page.link")
        .setAndroidParameters(
                new DynamicLink.AndroidParameters.Builder("com.example.android")
                        .setMinimumVersion(125)
                        .build())
        .setIosParameters(
                new DynamicLink.IosParameters.Builder("com.example.ios")
                        .setAppStoreId("123456789")
                        .setMinimumVersion("1.0.1")
                        .build())
        .setGoogleAnalyticsParameters(
                new DynamicLink.GoogleAnalyticsParameters.Builder()
                        .setSource("orkut")
                        .setMedium("social")
                        .setCampaign("example-promo")
                        .build())
        .setItunesConnectAnalyticsParameters(
                new DynamicLink.ItunesConnectAnalyticsParameters.Builder()
                        .setProviderToken("123456")
                        .setCampaignToken("example-promo")
                        .build())
        .setSocialMetaTagParameters(
                new DynamicLink.SocialMetaTagParameters.Builder()
                        .setTitle("Example of a Dynamic Link")
                        .setDescription("This link works whether the app is installed or not!")
                        .build())
        .buildDynamicLink();  // Or buildShortDynamicLink()

Kotlin+KTX

val dynamicLink = Firebase.dynamicLinks.dynamicLink { // or Firebase.dynamicLinks.shortLinkAsync
    link = Uri.parse("https://www.example.com/")
    domainUriPrefix = "https://example.page.link"
    androidParameters("com.example.android") {
        minimumVersion = 125
    }
    iosParameters("com.example.ios") {
        appStoreId = "123456789"
        minimumVersion = "1.0.1"
    }
    googleAnalyticsParameters {
        source = "orkut"
        medium = "social"
        campaign = "example-promo"
    }
    itunesConnectAnalyticsParameters {
        providerToken = "123456"
        campaignToken = "example-promo"
    }
    socialMetaTagParameters {
        title = "Example of a Dynamic Link"
        description = "This link works whether the app is installed or not!"
    }
}

다음 방법으로 동적 링크 매개변수를 설정할 수 있습니다.

DynamicLink 매개변수
세트링크

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

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

긴 동적 링크를 줄이려면 다른 빌더 메소드로 매개변수를 설정하는 대신 setLongLink 를 사용하여 동적 링크의 URL을 지정하십시오.

Java

Task<ShortDynamicLink> shortLinkTask = FirebaseDynamicLinks.getInstance().createDynamicLink()
        .setLongLink(Uri.parse("https://example.page.link/?link=https://www.example.com/&apn=com.example.android&ibn=com.example.ios"))
        .buildShortDynamicLink()
        .addOnCompleteListener(this, new OnCompleteListener<ShortDynamicLink>() {
            @Override
            public void onComplete(@NonNull Task<ShortDynamicLink> task) {
                if (task.isSuccessful()) {
                    // Short link created
                    Uri shortLink = task.getResult().getShortLink();
                    Uri flowchartLink = task.getResult().getPreviewLink();
                } else {
                    // Error
                    // ...
                }
            }
        });

Kotlin+KTX

val shortLinkTask = Firebase.dynamicLinks.shortLinkAsync {
    longLink = Uri.parse("https://example.page.link/?link=" +
            "https://www.example.com/&apn=com.example.android&ibn=com.example.ios")
}.addOnSuccessListener { (shortLink, flowChartLink) ->
    // You'll need to import com.google.firebase.dynamiclinks.ktx.component1 and
    // com.google.firebase.dynamiclinks.ktx.component2

    // Short link created
    processShortLink(shortLink, flowChartLink)
}.addOnFailureListener {
    // Error
    // ...
}