Tạo đường liên kết động trên Android

Không dùng nữa: Đường liên kết động của Firebase không dùng nữa và không nên sử dụng trong những dự án không sử dụng loại đường liên kết này. Dịch vụ sẽ ngừng hoạt động từ ngày 25 tháng 8 năm 2025. Hãy xem phần Câu hỏi thường gặp về việc ngừng sử dụng đường liên kết động để biết thêm thông tin.

Bạn có thể tạo các Đường liên kết động ngắn hoặc dài bằng API Trình tạo đường liên kết động của Firebase. API này chấp nhận một Đường liên kết động dài hoặc một đối tượng chứa các tham số của Đường liên kết động và trả về các URL như các ví dụ sau:

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

Thiết lập Firebase và SDK liên kết động

Trước khi có thể tạo Liên kết động trong ứng dụng Android, bạn phải sử dụng SDK Firebase. Nếu ứng dụng của bạn được thiết lập để nhận Đường liên kết động, thì bạn đã hoàn tất các bước này và có thể bỏ qua phần này.

1. Thêm Firebase vào dự án Android của bạn nếu bạn chưa thực hiện.

   Khi bạn đăng ký ứng dụng, hãy chỉ định khoá ký SHA-1. Nếu bạn sử dụng Đường liên kết trong ứng dụng, hãy chỉ định cả khoá SHA-256.

2. Trong tệp Gradle (ở cấp ứng dụng) mô-đun (thường là <project>/<app-module>/build.gradle.kts hoặc <project>/<app-module>/build.gradle), hãy thêm phần phụ thuộc cho thư viện Đường liên kết động dành cho Android. Bạn nên sử dụng Firebase Android BoM để kiểm soát việc tạo phiên bản thư viện.

   Để có trải nghiệm tối ưu với Đường liên kết động, bạn nên bật Google Analytics trong dự án Firebase và thêm Firebase SDK cho Google Analytics vào ứng dụng của mình.

   dependencies {
       // Import the BoM for the Firebase platform
       implementation(platform("com.google.firebase:firebase-bom:33.1.2"))
   
       // 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'
   }
   

   Bằng cách sử dụng Firebase Android BoM, ứng dụng của bạn sẽ luôn sử dụng các phiên bản tương thích của thư viện Android trên Firebase.

   (Thay thế) Thêm các phần phụ thuộc của thư viện Firebase mà không sử dụng BoM

   Nếu chọn không sử dụng BoM của Firebase, bạn phải chỉ định từng phiên bản thư viện Firebase trong dòng phần phụ thuộc.

   Xin lưu ý rằng nếu sử dụng nhiều thư viện Firebase trong ứng dụng, thì bạn nên sử dụng BoM để quản lý các phiên bản thư viện, qua đó đảm bảo tất cả các phiên bản đều tương thích.

   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:22.1.0'
       implementation 'com.google.firebase:firebase-analytics:22.0.2'
   }
   

   Bạn đang tìm một mô-đun thư viện dành riêng cho Kotlin? Kể từ tháng 10 năm 2023 (Firebase BoM 32.5.0), cả nhà phát triển Kotlin và Java đều có thể phụ thuộc vào mô-đun thư viện chính (để biết thông tin chi tiết, vui lòng xem Câu hỏi thường gặp về sáng kiến này).
3. Trong bảng điều khiển của Firebase, hãy mở mục Đường liên kết động.

4. Nếu bạn chưa chấp nhận điều khoản dịch vụ và đặt miền cho Đường liên kết động, hãy thực hiện khi được nhắc.

   Nếu bạn đã có miền Đường liên kết động, hãy ghi lại miền đó. Bạn cần cung cấp miền Đường liên kết động khi tạo Đường liên kết động theo phương thức lập trình.

   

5. Đề xuất: Chỉ định các mẫu URL được phép trong đường liên kết sâu và đường liên kết dự phòng. Khi làm như vậy, bạn sẽ ngăn các bên không được cấp phép tạo Đường liên kết động chuyển hướng từ miền của bạn đến những trang web mà bạn không kiểm soát. Hãy xem phần Cho phép các mẫu URL cụ thể.

Sử dụng bảng điều khiển của Firebase

Nếu bạn muốn tạo một Đường liên kết động duy nhất cho mục đích thử nghiệm hoặc để nhóm tiếp thị của bạn dễ dàng tạo một đường liên kết có thể dùng trong bài đăng trên mạng xã hội, cách đơn giản nhất là truy cập vào bảng điều khiển của Firebase và tạo một đường liên kết theo cách thủ công theo biểu mẫu từng bước.

Tạo Liên kết động từ các thông số

Để tạo một Đường liên kết động, hãy tạo một đối tượng DynamicLink mới bằng Trình tạo, chỉ định tham số Đường liên kết động bằng phương thức Trình tạo. Sau đó, hãy gọi buildDynamicLink hoặc buildShortDynamicLink.

Ví dụ tối thiểu sau đây sẽ tạo một Đường liên kết động dài đến https://www.example.com/. Đường liên kết này sẽ mở bằng ứng dụng Android trên Android và ứng dụng com.example.ios trên iOS:

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
MainActivity.kt

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();
MainActivity.java

Để tạo một Đường liên kết động ngắn, hãy tạo DynamicLink theo cách tương tự, sau đó gọi buildShortDynamicLink. Việc tạo đường liên kết ngắn sẽ đòi hỏi một lệnh gọi mạng. Vì vậy, thay vì trực tiếp trả về đường liên kết, buildShortDynamicLink sẽ trả về một Task để cung cấp đường liên kết ngắn khi yêu cầu hoàn tất. Ví dụ:

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.component1 and
    // com.google.firebase.dynamiclinks.component2

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

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
                    // ...
                }
            }
        });
MainActivity.java

Theo mặc định, các Đường liên kết động ngắn được tạo bằng hậu tố của đường liên kết dài 17 ký tự, nên khả năng cao là người khác sẽ không đoán được một Đường liên kết động hợp lệ. Nếu trong trường hợp sử dụng của bạn mà không có hại khi ai đó đoán thành công một đường liên kết ngắn, thì bạn nên tạo hậu tố chỉ chừng nào cần thiết là duy nhất. Bạn có thể thực hiện việc này bằng cách truyền ShortDynamicLink.Suffix.SHORT vào phương thức buildShortDynamicLink:

Kotlin+KTX

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

Java

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

Thông số liên kết động

Bạn có thể sử dụng API Trình tạo đường liên kết động để tạo Đường liên kết động bằng bất kỳ tham số nào được hỗ trợ. Hãy xem tài liệu tham khảo API để biết thông tin chi tiết.

Ví dụ sau đây sẽ tạo một Liên kết động với một số tham số phổ biến được thiết lập:

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!"
    }
}
MainActivity.kt

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()
MainActivity.java

Bạn có thể đặt thông số Đường liên kết động bằng các phương thức sau:

Thông số DynamicLink
setLink	Đường liên kết mà ứng dụng của bạn sẽ mở ra. Chỉ định URL mà ứng dụng của bạn có thể xử lý, thường là nội dung hoặc tải trọng của ứng dụng, để bắt đầu logic dành riêng cho ứng dụng (chẳng hạn như cấp tín dụng cho người dùng bằng phiếu giảm giá hoặc hiển thị màn hình chào mừng). Đường liên kết này phải là một URL được định dạng chính xác, được mã hoá URL chính xác, sử dụng HTTP hoặc HTTPS và không được là một Đường liên kết động khác. Khi mở một Đường liên kết động trên trình duyệt web dành cho máy tính, người dùng sẽ tải URL này (trừ phi bạn chỉ định tham số ofl). Nếu không có một trang web tương đương với nội dung được liên kết, thì URL không cần trỏ đến một tài nguyên web hợp lệ. Trong trường hợp này, bạn nên thiết lập lệnh chuyển hướng từ URL này đến trang chủ của bạn chẳng hạn.
setdomainUriPrefix	Tiền tố URL đường liên kết động mà bạn có thể tìm thấy trong bảng điều khiển của Firebase. Miền Liên kết động sẽ có dạng như các ví dụ sau: https://example.com/link https://example.page.link

Tham số Android
URL dự phòng	Đường liên kết để mở khi ứng dụng chưa được cài đặt. Chỉ định thao tác này để làm một việc gì đó ngoài việc cài đặt ứng dụng qua Cửa hàng Play khi chưa cài đặt ứng dụng, chẳng hạn như mở phiên bản nội dung trên web dành cho thiết bị di động hoặc hiển thị trang quảng cáo cho ứng dụng của bạn.
setMinimumVersion	versionCode của phiên bản ứng dụng tối thiểu có thể mở đường liên kết. Nếu ứng dụng đã cài đặt là một phiên bản cũ, thì người dùng sẽ được chuyển đến Cửa hàng Play để nâng cấp.

Tham số ios
setAppStoreId	Mã App Store của ứng dụng của bạn, dùng để đưa người dùng đến App Store khi ứng dụng chưa được cài đặt
URL dự phòng	Đường liên kết để mở khi ứng dụng chưa được cài đặt. Chỉ định thao tác này để làm một việc gì đó ngoài việc cài đặt ứng dụng từ App Store khi chưa cài đặt ứng dụng, chẳng hạn như mở phiên bản nội dung trên web dành cho thiết bị di động hoặc hiển thị trang quảng cáo cho ứng dụng của bạn.
Lược đồ tùy chỉnh	Lược đồ URL tuỳ chỉnh của ứng dụng, nếu được xác định không phải là mã gói ứng dụng
setIpadFallbackUrl	Đường liên kết để mở trên iPad khi ứng dụng chưa được cài đặt. Chỉ định thao tác này để thực hiện một thao tác khác ngoài việc cài đặt ứng dụng từ App Store khi ứng dụng chưa được cài đặt, chẳng hạn như mở phiên bản nội dung trên web hoặc hiển thị trang quảng cáo cho ứng dụng của bạn.
setIpadBundleId	Mã nhận dạng gói của ứng dụng iOS dùng trên iPad để mở đường liên kết. Bạn phải kết nối ứng dụng với dự án trên trang Tổng quan của bảng điều khiển của Firebase.
setMinimumVersion	Số phiên bản của phiên bản tối thiểu của ứng dụng có thể mở đường liên kết. Cờ này được chuyển đến ứng dụng của bạn khi được mở và ứng dụng phải quyết định tác vụ cần thực hiện với cờ đó.

Thông số NavigationInfo

setForcedRedirectEnabled

Nếu bạn đặt thành '1', hãy bỏ qua trang xem trước ứng dụng khi Đường liên kết động mở, mà chuyển hướng đến ứng dụng hoặc cửa hàng. Trang xem trước ứng dụng (được bật theo mặc định) có thể đưa người dùng đến trang đích phù hợp nhất theo cách đáng tin cậy hơn khi họ mở Đường liên kết động trong ứng dụng. Tuy nhiên, nếu muốn chỉ mở Đường liên kết động trong các ứng dụng có thể mở Đường liên kết động một cách đáng tin cậy mà không cần trang này, thì bạn có thể tắt đường liên kết động đó bằng tham số này. Tham số này sẽ chỉ ảnh hưởng đến hoạt động của Liên kết động trên iOS.

Tham số SocialMetaTag
Đặt tiêu đề	Tiêu đề cần sử dụng khi Đường liên kết động được chia sẻ trong bài đăng trên mạng xã hội.
setDescription	Nội dung mô tả để sử dụng khi Đường liên kết động được chia sẻ trong bài đăng trên mạng xã hội.
setImageUrl	URL đến hình ảnh liên quan đến đường liên kết này. Hình ảnh phải có kích thước tối thiểu 300x200 pixel và nhỏ hơn 300 KB.

Thông số GoogleAnalytics
setSource setMedium setCampaign setTerm setContent	Thông số phân tích của Google Play. Các tham số này (utm_source, utm_medium, utm_campaign, utm_term, utm_content) được chuyển đến Cửa hàng Play cũng như được thêm vào tải trọng của đường liên kết.

Thông số ItunesConnectAnalytics
setProviderToken setaffiliateToken setCampaignToken	Thông số phân tích của iTunes Connect. Các tham số này (pt, at, ct) được chuyển đến App Store.

Rút ngắn một đường liên kết động dài

Để rút ngắn một Đường liên kết động dài, hãy chỉ định URL của Đường liên kết động bằng cách sử dụng setLongLink thay vì đặt tham số bằng các phương thức khác của trình tạo:

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.component1 and
    // com.google.firebase.dynamiclinks.component2

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

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
                    // ...
                }
            }
        });
MainActivity.java