Chúng tôi đã ra mắt Đường liên kết động của Firebase hơn 7 năm trước để tăng cường sức mạnh cho URL, chẳng hạn như thay đổi linh hoạt đích đến của một đường liên kết dựa trên các điều kiện trong thời gian chạy.
Trong những năm qua, hệ sinh thái web và thiết bị di động đã phát triển cùng với các công nghệ như Đường liên kết trong ứng dụng, Google Play Instant, Đường liên kết phổ quát và Đoạn ứng dụng, đồng thời giúp hành trình của người dùng trên các ứng dụng và web trở nên liền mạch và dễ dự đoán hơn cho người dùng ứng dụng của bạn. Chúng tôi tin rằng bạn và người dùng của bạn sẽ hưởng lợi nhiều hơn từ việc áp dụng trực tiếp các công nghệ này và tiếp tục thúc đẩy hệ sinh thái phát triển. Tuy nhiên, bên cạnh những thay đổi mới này, các API gốc mà Đường liên kết động của Firebase được xây dựng cũng phát triển và đặt ra những thách thức mới.
Ví dụ: những thay đổi trong hệ sinh thái đã ảnh hưởng đến khả năng cung cấp trải nghiệm ổn định nhất quán cho một trong các tính năng cốt lõi của Đường liên kết động của Firebase, đó là mang đến cho người dùng ứng dụng trải nghiệm chuyển đổi mượt mà vào ứng dụng sau khi cài đặt, bất kể nền tảng.
Thay vì tiếp tục hỗ trợ một trải nghiệm chưa lý tưởng, chúng tôi đã quyết định ngừng cung cấp Đường liên kết động của Firebase và tập trung lại nguồn lực vào việc giải quyết các điểm khó khăn khác của nhà phát triển.
Chúng tôi hiểu rằng bạn sẽ cần thời gian để đánh giá và áp dụng các giải pháp hoặc nhà cung cấp nền tảng thay thế trên thị trường.
Chúng tôi sẽ tiếp tục phát triển Firebase để đáp ứng nhu cầu của bạn khi hệ sinh thái tiếp tục phát triển và thay đổi. Chúng tôi sẽ tiếp tục ra mắt các tính năng và bản cập nhật mới trên các sản phẩm của Firebase, đồng thời cam kết giúp bạn đạt được thành công trong hành trình phát triển ứng dụng.
Bạn cần biết điều gì?
Đường liên kết động của Firebase sẽ ngừng hoạt động vào ngày 25 tháng 8 năm 2025. Tất cả đường liên kết do Đường liên kết động của Firebase phân phát (cả đường liên kết được lưu trữ trên miền tuỳ chỉnh và miền con page.link) sẽ ngừng hoạt động và bạn sẽ không thể tạo đường liên kết mới nữa.
Để giúp bạn quyết định cách di chuyển khỏi Đường liên kết động của Firebase, chúng tôi sẽ tiếp tục cập nhật tài liệu Câu hỏi thường gặp này với thông tin bổ sung để bạn cân nhắc, cũng như cung cấp hướng dẫn di chuyển cho các trường hợp di chuyển khác nhau có thể phù hợp với cách bạn sử dụng Đường liên kết động của Firebase hiện nay.
Chúng tôi cũng sẽ tiếp tục cập nhật hướng dẫn này bằng các câu hỏi thường gặp khác khi quá trình ngừng hoạt động tiến gần đến ngày ngừng hoạt động là ngày 25 tháng 8 năm 2025 và chúng tôi phát hiện thêm bất kỳ vấn đề nào trong quá trình hỗ trợ bạn di chuyển.
Hãy xem phần Câu hỏi thường gặp bên dưới để biết câu trả lời cho một số câu hỏi quan trọng nhất.
Để bắt đầu di chuyển, vui lòng xem phần "Làm cách nào để di chuyển khỏi dịch vụ này" trong Câu hỏi thường gặp ở bên dưới.
Khi nào Đường liên kết động của Firebase sẽ ngừng hoạt động?
Đường liên kết động của Firebase sẽ ngừng hoạt động vào ngày 25 tháng 8 năm 2025. Tất cả đường liên kết do Đường liên kết động của Firebase phân phát (cả những đường liên kết được lưu trữ trên miền tuỳ chỉnh và trên miền con page.link) sẽ ngừng hoạt động.
Tôi sẽ có bao nhiêu thời gian để di chuyển?
Bạn có thời hạn đến ngày 25 tháng 8 năm 2025 để hoàn tất quá trình di chuyển.
Các đường liên kết mới và hiện có có tiếp tục hoạt động không?
Có, các đường liên kết mới và hiện có của bạn sẽ tiếp tục hoạt động cho đến khi dịch vụ Đường liên kết động ngừng hoạt động vào ngày 25 tháng 8 năm 2025.
Tôi có thể giữ lại hoặc chuyển miền .page.link được cấp tự động dùng cho các đường liên kết không?
Không, sau khi dịch vụ Đường liên kết động của Firebase ngừng hoạt động, mọi miền .page.link sẽ không còn hoạt động nữa. Bạn nên xem qua danh sách câu hỏi này để đánh giá cách di chuyển hiệu quả nhất khỏi dịch vụ này. Nếu cần có đầy đủ tính năng tương đương, hãy làm theo hướng dẫn này về cách xuất siêu dữ liệu và di chuyển sang một nhà cung cấp dịch vụ liên kết sâu khác bằng miền mới.
Điều gì sẽ xảy ra với các đường liên kết và (các) ứng dụng của tôi khi Đường liên kết động của Firebase ngừng hoạt động (vào ngày 25 tháng 8 năm 2025)?
Khi Đường liên kết động của Firebase ngừng hoạt động, bạn có thể thấy rằng:
- Tất cả đường liên kết được nhấp vào sẽ trả về phản hồi trạng thái HTTP 404 cho người dùng cuối.
Tất cả yêu cầu HTTP đến:
- https://firebasedynamiclinks.googleapis.com/v1/shortLinks (Short Links API)
- https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats (API Thống kê đường liên kết)
sẽ trả về phản hồi Trạng thái HTTP 400/403.
Các phản hồi lỗi nêu trên sẽ bắt đầu xuất hiện dần từ ngày 25 tháng 8 năm 2025 cho đến khi đạt tỷ lệ phản hồi lỗi 100% sau ngày ngừng hoạt động.
Hành vi sau đây dựa trên phiên bản nền tảng SDK và lệnh gọi API được thực hiện trong ứng dụng của bạn:
iOS
Trường hợp sử dụng Lệnh gọi API Mã trạng thái Hành vi Ứng dụng của bạn có gặp sự cố không? Tạo đường liên kết ngắn shorten (Swift)
shortenUrl (Swift)
shortenWithCompletion (Objective-C)
403 Lỗi được phát ra kèm theo lý do không thành công Không* Phân bổ lượt mở đầu tiên Được gọi tự động trên FirebaseApp.configure (Swift) / FIRApp.configure (Objective-C)
400 Không có lỗi nào được phát ra, nhưng đối tượng FDL được gửi lại với dữ liệu trống Không* Mở lại Attribution handleUniversalLink (Swift)
handleUniversalLink (Objective-C)
400 Lỗi được phát ra kèm theo lý do không thành công Không* Android
Trường hợp sử dụng Lệnh gọi API Mã trạng thái Hành vi Ứng dụng của bạn có gặp sự cố không? Tạo đường liên kết ngắn buildShortDynamicLink (Kotlin)
buildShortDynamicLink (Java)
403 Lỗi được phát ra kèm theo lý do không thành công Không* Phân bổ lượt mở đầu tiên getDynamicLink(getIntent()) (Kotlin)
getDynamicLink(getIntent()) (Java)
400 Tác vụ trả về phản hồi thành công, nhưng dữ liệu FDL sẽ trống Không* Mở lại Attribution getDynamicLink(getIntent()) (Kotlin)
getDynamicLink(getIntent()) (Java)
400 Tác vụ trả về phản hồi thành công, nhưng dữ liệu FDL sẽ trống Không* Chấp nhận lời mời Mô-đun AppInvite trong Dịch vụ Google Play được gọi khi xử lý lệnh chuyển hướng ý định (từ *.page.link hoặc miền tuỳ chỉnh) 400 Hiện vòng quay khi Dịch vụ Google Play được gọi và biến mất khi phản hồi 400 được trả về Không*
Làm cách nào để di chuyển khỏi dịch vụ này?
Chúng tôi nhận thấy rằng mỗi nhà phát triển có nhu cầu riêng khi sử dụng Đường liên kết động của Firebase.
Tuỳ thuộc vào trường hợp sử dụng của riêng bạn và kết quả đánh giá về việc sử dụng Đường liên kết động của Firebase, có thể một trong các trường hợp dưới đây sẽ phù hợp với nhu cầu của bạn.
Tôi nên làm gì nếu cần có đầy đủ tính năng tương đương với Đường liên kết động của Firebase?
Trong trường hợp này, bạn nên sử dụng các nhà cung cấp/bên cung cấp dịch vụ liên kết sâu khác, chẳng hạn như Adjust, Airbridge, AppsFlyer, Bitly, Branch, Kochava, Singular và các nhà cung cấp tương tự khác trên thị trường. (Lưu ý: Google chưa kiểm tra các nhà cung cấp này, nhưng họ cung cấp chức năng tương tự như Đường liên kết động của Firebase).
Bạn cũng có thể xuất siêu dữ liệu đường liên kết sâu để dễ dàng di chuyển đường liên kết sang bất kỳ nhà cung cấp nào bạn chọn.
Để tìm một nhà cung cấp có các tính năng phù hợp với Đường liên kết động của Firebase, hãy tham khảo danh sách các tính năng sau đây.
Các tính năng của Đường liên kết động của Firebase:
- Đưa người dùng đến đúng cửa hàng cho thiết bị của họ chỉ bằng một lượt nhấp (và quay lại trang web nếu cần)
- Giúp người dùng tiếp tục hành trình sau khi tải xuống và cài đặt ứng dụng của bạn thông qua một đường liên kết sâu bị trì hoãn
- Cung cấp cho người dùng trải nghiệm theo bối cảnh thông qua nội dung được liên kết sâu trong ứng dụng của bạn (khi đã cài đặt)
- Cung cấp số liệu phân tích liên quan đến sự kiện nhấp chuột vào liên kết động
- Cung cấp khả năng tạo URL liên kết ngắn
- Cung cấp khả năng thêm siêu dữ liệu vào đường liên kết để chia sẻ qua mạng xã hội
Nếu tôi chỉ quan tâm đến việc liên kết sâu đến ứng dụng của mình sau khi ứng dụng đã được cài đặt thì sao?
Trong trường hợp này, bạn nên sử dụng Đường liên kết đến ứng dụng và Đường liên kết phổ quát. Đây là những cách được nền tảng hỗ trợ để nhà phát triển cung cấp trải nghiệm liên kết sâu cho người dùng.
Hướng dẫn này cũng mô tả cách sử dụng Lưu trữ Firebase (không bắt buộc) để lưu trữ miền cần thiết và các tệp xác minh đường liên kết đến tài sản trên miền mà bạn dự định sử dụng cho các đường liên kết mới (ví dụ: tệp assetlinks.json cho App Link, tệp apple-app-site-association cho Đường liên kết phổ quát).
Nếu ứng dụng của tôi không cần các tính năng của Đường liên kết động của Firebase nữa và không cần thay thế thì sao?
Đối với trường hợp này, bạn có thể không cần làm gì trong ứng dụng để xử lý việc ngừng hoạt động sắp tới, tuy nhiên, bạn nên:
Xem lại các Đường liên kết động của Firebase hiện có theo hướng dẫn xuất siêu dữ liệu của đường liên kết để đảm bảo người dùng và ứng dụng của bạn sẽ không bị ảnh hưởng sau khi các đường liên kết không còn được phân phát.
Xoá tiền tố URL của Đường liên kết động của Firebase trong bảng điều khiển của Firebase. Lưu ý: Các miền có tiền tố URL sẽ tự động bị xoá sau ngày 25 tháng 8 năm 2025.
Xoá SDK Đường liên kết động của Firebase khỏi ứng dụng.
Nếu bạn thấy một trường hợp di chuyển không đáp ứng được nhu cầu của mình, vui lòng liên hệ để cho chúng tôi biết
Tôi nên làm gì sau khi hoàn tất quá trình di chuyển?
Sau khi hoàn tất quá trình di chuyển khỏi Đường liên kết động của Firebase, hãy nhớ xoá tất cả tiền tố miền URL (miền FDL) liên kết với Đường liên kết động của Firebase trước đó trong dự án của bạn.
Bạn có thể làm việc này bằng cách:
- Chuyển đến mục Đường liên kết động của Firebase trong bảng điều khiển của Firebase
Chọn tiền tố URL mà bạn muốn xoá trong bộ chọn ở bên trái
Nhấp vào trình đơn có biểu tượng ba dấu chấm bên cạnh nút "Đường liên kết động mới"
Chọn "Xoá tiền tố URL"
Nhập tiền tố URL để xác nhận rằng bạn muốn xoá tiền tố đó, rồi nhấp vào "Xoá tiền tố URL"
Sau khi bạn xoá xong tất cả tiền tố miền URL, dự án Firebase của bạn sẽ được đánh dấu là đã hoàn tất quá trình di chuyển khỏi Đường liên kết động của Firebase. Thao tác này cũng sẽ xoá lời nhắc bật lên mà bạn có thể đã thấy trong bảng điều khiển của Firebase cho dự án của mình.
Xin lưu ý rằng thao tác này sẽ xoá tất cả Đường liên kết động của Firebase sau khi hoàn tất. Vì vậy, hãy đảm bảo rằng bạn đã di chuyển hoàn toàn khỏi dịch vụ này trước khi xoá tiền tố miền URL.
Tôi có thể tiếp tục sử dụng các API Đường liên kết động của Firebase không?
Các API Đường liên kết động của Firebase cho Đường liên kết ngắn và Analytics sẽ tiếp tục hoạt động cho đến ngày ngừng cung cấp là ngày 25 tháng 8 năm 2025.
Sau ngày đó, bạn sẽ không thể sử dụng các API này nữa và dịch vụ sẽ bị ngừng hoạt động.
Làm cách nào để xuất siêu dữ liệu của đường liên kết?
Vui lòng tham khảo hướng dẫn về cách xuất siêu dữ liệu của đường liên kết để biết hướng dẫn về cách xuất siêu dữ liệu của đường liên kết.
Làm cách nào để lấy dữ liệu phân tích về đường liên kết của Đường liên kết động của Firebase?
Bạn có thể sử dụng hướng dẫn xuất để truy xuất siêu dữ liệu của Đường liên kết động của Firebase, bao gồm cả chính đường liên kết đó.
Bạn có thể sử dụng API Firebase Dynamic Links Analytics để truy xuất dữ liệu thống kê về đường liên kết cho từng Đường liên kết động của Firebase. API Analytics này bị giới hạn ở mức ~5 QPS. Để xem ví dụ về cách hoạt động trong giới hạn yêu cầu đó khi sử dụng API, vui lòng tham khảo mẫu Cloud Task này.
Bạn cũng có thể sử dụng Google Analytics và xuất dữ liệu cho một nhóm nhỏ dữ liệu phân tích về đường liên kết, bao gồm cả sự kiện bản cập nhật ứng dụng chỉ có trong Google Analytics.
Nếu bạn cần tỷ lệ yêu cầu cao hơn để hỗ trợ quá trình di chuyển, vui lòng liên hệ với chúng tôi qua Nhóm hỗ trợ Firebase.
Điều gì sẽ xảy ra với siêu dữ liệu của các đường liên kết hiện có sau ngày ngừng hoạt động (ngày 25 tháng 8 năm 2025)?
Siêu dữ liệu về miền và đường liên kết của bạn sẽ được đánh dấu để xoá vào ngày 25 tháng 8 năm 2025 và bị xoá hoàn toàn theo chính sách giữ lại dữ liệu của chúng tôi.
Tác động của Đường liên kết động của Firebase đối với quy trình Xác thực Firebase
Tôi muốn bật tính năng xác thực bằng đường liên kết trong email trong Xác thực Firebase cho dự án của mình. Tôi có cần làm quen với Đường liên kết động của Firebase không?
Không, bạn không cần phải tham gia Đường liên kết động của Firebase vì bạn không thể tham gia được nữa. Thay vào đó, bạn có thể làm theo hướng dẫn mới nhất về cách bắt đầu sử dụng tính năng xác thực bằng đường liên kết trong email để bật và triển khai tính năng này cho dự án của mình:
Xem danh sách đầy đủ các hành động bị ảnh hưởng bởi thay đổi này.
Các tính năng Xác thực sau đây bị ảnh hưởng như thế nào: xác thực bằng đường liên kết trong email, đặt lại mật khẩu và xác minh email?
Tính năng xác thực bằng đường liên kết trong email và các hành động qua email ngoài băng tần của bạn với Firebase sẽ tiếp tục hoạt động, tuy nhiên, bạn cần nâng cấp lên Firebase Authentication SDK mới nhất và di chuyển sang giải pháp mới để tiếp tục sử dụng các hành động này sau khi dịch vụ Firebase Dynamic Links ngừng hoạt động vào ngày 25 tháng 8 năm 2025.
Bạn có thể làm theo hướng dẫn trong các đường liên kết bên dưới để biết cách hoàn tất quá trình di chuyển:
Xem danh sách đầy đủ các hành động chịu ảnh hưởng của thay đổi này.
Các phương thức triển khai quy trình OAuth có phiên bản SDK Android xác thực Firebase dưới phiên bản 20.0.0 hoặc phiên bản BoM dưới phiên bản 26.0.0 sẽ bị ảnh hưởng như thế nào?
Bạn cần cập nhật lên SDK Firebase Authentication mới nhất cho Android (ít nhất là phiên bản 20.0.0) để tiếp tục sử dụng quy trình triển khai OAuth trong các ứng dụng Android của mình.
Các hành động qua email của Xác thực Firebase trên ứng dụng web có bị ảnh hưởng không?
Không. Việc ngừng sử dụng Đường liên kết động của Firebase chỉ ảnh hưởng đến việc xử lý URL đến trên thiết bị di động.
Những cách triển khai sử dụng thư viện SDK JS của Firebase để xác thực nhà cung cấp OAuth trong ứng dụng Cordova sẽ bị ảnh hưởng như thế nào?
Firebase JS SDK sử dụng Đường liên kết động của Firebase để triển khai quy trình xác thực OAuth trong các ứng dụng Cordova. Bạn cần sửa đổi cách triển khai quy trình bằng cách thực hiện quy trình OAuth theo cách thủ công và truyền thông tin xác thực OAuth thu được đến Firebase để hoàn tất quy trình xác thực.
Hãy xem hướng dẫn về Cordova để biết thêm thông tin.
Có những lựa chọn nào khác thay thế cho Đường liên kết động của Firebase?
Vui lòng xem phần "Làm cách nào để di chuyển khỏi dịch vụ này" trong Câu hỏi thường gặp. Phần này trình bày chi tiết các trường hợp di chuyển và cung cấp hướng dẫn di chuyển cho nhiều phương án thay thế hiện có.