Câu hỏi thường gặp về việc ngừng sử dụng đường liên kết động

Chúng tôi đã ra mắt Đường liên kết động của Firebase cách đây hơn 7 năm để giúp URL trở nên mạnh mẽ hơn - ví dụ: tự động thay đổi đí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 với các công nghệ như Đường liên kết đến ứng dụng, Google Play Instant , Đường liên kết phổ quát, và App Clips và đã 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. Chúng tôi tin rằng bạn và người dùng sẽ hưởng lợi nhiều hơn khi trực tiếp áp dụng 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, cùng với những thay đổi mới này, các API gốc ban đầu 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 của chúng tôi trong việc mang lại trải nghiệm ổn định và nhất quán cho một trong những tính năng cốt lõi của Đường liên kết động của Firebase – giúp người dùng ứng dụng chuyển đổi mượt mà sang ứng dụng sau khi cài đặt, bất kể nền tảng.

Thay vì tiếp tục hỗ trợ 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 nguồn lực vào việc giải quyết những vấn đề khác mà nhà phát triển gặp phải.

Chúng tôi hiểu rằng thay đổi này sẽ đòi hỏi bạn phải dành 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 vẫn 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 mới và bản cập nhật 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ì?

Kể từ ngày 25 tháng 8 năm 2025, Đường liên kết động của Firebase sẽ ngừng hoạt động. Tất cả đường liên kết do Đường liên kết động của Firebase cung cấp (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 với nhiều câu hỏi thường gặp hơn khi quá trình ngừng cung cấp tiến tới ngày 25 tháng 8 năm 2025 và chúng tôi phát hiện thêm vấn đề khi hỗ trợ bạn trong nỗ lực di chuyển.

Hãy xem các câu hỏi thường gặp bên dưới để giúp trả lời một số câu hỏi quan trọng nhất của bạn.

Để bắt đầu di chuyển, vui lòng xem câu hỏi thường gặp "Tôi nên di chuyển khỏi dịch vụ này như thế nào" ở bên dưới.

Kể từ ngày 25 tháng 8 năm 2025, Đường liên kết động của Firebase sẽ ngừng hoạt động. Tất cả đường liên kết do Đường liên kết động của Firebase cung cấp (cả đườ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 gian đến hết ngày 25 tháng 8 năm 2025 để hoàn tất quá trình di chuyển.

Có, đường liên kết mới và hiện có 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.

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 khỏi dịch vụ tốt nhất, và nếu cần có tính năng tương đương đầy đủ, 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 một miền mới.

Khi Đường liên kết động của Firebase ngừng hoạt động, bạn có thể dự kiến:

  • Tất cả đường liên kết được nhấp 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 (Link Stats API)

    sẽ trả về phản hồi Trạng thái HTTP 400/403.

  • Các phản hồi lỗi ở trên sẽ bắt đầu dần dần vào ngày 25 tháng 8 năm 2025 cho đến khi đạt tỷ lệ phản hồi lỗi 100% sau khi ngày ngừng hoạt động đã qua.

  • 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ã tình trạng 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 thất bại Không*
    Phân bổ lượt mở lần đầu

    Tự động được gọi trên FirebaseApp.configure (Swift) / FIRApp.configure (Objective-C)

    400 Không có lỗi nào được phát ra, nhưng một đối tượng FDL được gửi lại kèm theo dữ liệu trống Không*
    Phân bổ lượt mở lại

    handleUniversalLink (Swift)

    handleUniversalLink (Objective-C)

    400 Lỗi được phát ra kèm theo lý do thất bại Không*

    Android

    Trường hợp sử dụng Lệnh gọi API Mã tình trạng 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 thất bại Không*
    Phân bổ lượt mở lần đầu

    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*
    Phân bổ lượt mở lại

    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ý việc chuyển hướng ý định (từ *.page.link hoặc miền tuỳ chỉnh) 400 Hiển thị một 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*

Tôi nên di chuyển khỏi dịch vụ này như thế nào?

Chúng tôi nhận thấy rằng mỗi nhà phát triển có nhu cầu khác nhau 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à việc đánh giá mức sử dụng Đường liên kết động của Firebase, có khả năng một trong các trường hợp bên dưới sẽ phù hợp với nhu cầu của bạn.

Đối với trường hợp này, bạn nên sử dụng các nhà cung cấp/nhà 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. (Xin lưu ý rằng Google chưa kiểm tra các nhà cung cấp này, nhưng họ có 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 liên kết sâu, điều này có thể giúp bạn 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.

Để giúp 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:

  • Chuyển hướng người dùng đến đúng cửa hàng cho thiết bị của họ chỉ bằng một cú nhấp chuột (và quay lại trang web nếu cần)
  • Cung cấp cho người dùng hành trình tiếp tục sau khi tải xuống và cài đặt ứng dụng của bạn xem đường liên kết sâu bị trì hoãn
  • Cung cấp cho người dùng trải nghiệm theo ngữ 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 dữ liệu Analytics liên quan đến các sự kiện nhấp vào đường liên kết động
  • Cung cấp khả năng tạo URL đường 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ẻ trên 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?

Đối với trường hợp này, bạn nên sử dụng Đường liên kết đến ứng dụngĐườ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ãy xem hướng dẫn này để biết thêm thông tin về cách di chuyển sang sử dụng Đường liên kết đến ứng dụng và Đường liên kết phổ quát.

Hướng dẫn này cũng mô tả cách sử dụng Firebase Hosting để lưu trữ các tệp xác minh đường liên kết đến miền và tài sản cần thiết trên miền mà bạn dự định sử dụng cho đường liên kết mới (ví dụ: tệp assetlinks.json cho Đường liên kết đến ứng dụng, tệp apple-app-site-association cho Đường liên kết phổ quát).

Đối với trường hợp này, bạn có thể không cần thực hiện bất kỳ hành động nào 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 xét Đường liên kết động của Firebase hiện có theo hướng dẫn về cách xuất siêu dữ liệu đườ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 khi đường liên kết không còn được phân phát.

  • Xoá tiền tố URL Đường liên kết động của Firebase trong bảng điều khiển của Firebase. Lưu ý: Miền 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 nhu cầu của riêng bạn, 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) được 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ể thực hiện việc này bằng cách:

  1. Chuyển đến phần Đường liên kết động của Firebase trong bảng điều khiển của Firebase
  2. Chọn tiền tố URL mà bạn muốn xoá khỏi bộ chọn ở bên trái Ảnh chụp màn hình bảng điều khiển FDL của bộ chọn tiền tố đường dẫn URL

  3. 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" Ảnh chụp màn hình bảng điều khiển FDL về các lựa chọn tiền tố đường dẫn URL

  4. Chọn "Xoá tiền tố URL"

  5. 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 hoàn tất việc xoá 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 bạn.

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 bạn đã di chuyển hoàn toàn khỏi dịch vụ trước khi xoá tiền tố miền URL.

API Đường liên kết động của Firebase cho Đường liên kết ngắnAnalytics sẽ vẫn hoạt động cho đến ngày ngừng hoạt động là ngày 25 tháng 8 năm 2025.

Sau ngày đó, bạn sẽ không còn sử dụng được các API này nữa và dịch vụ sẽ ngừng hoạt động.

Vui lòng tham khảo hướng dẫn về cách xuất siêu dữ liệu đường liên kết để biết hướng dẫn về cách xuất siêu dữ liệu đường liên kết.

Bạn có thể sử dụng hướng dẫn xuất để truy xuất siêu dữ liệu Đườ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 Analytics của Đường liên kết động của Firebase để truy xuất dữ liệu thống kê đườ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 khoảng 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 tập hợp con dữ liệu phân tích đường liên kết, bao gồm cả các sự kiện Cập nhật ứng dụng chỉ có trong Google Analytics.

Nếu bạn cần tốc độ 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 tại Nhóm hỗ trợ của Firebase.

Miền và siêu dữ liệu đườ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.

Không, bạn không cần tham gia Đường liên kết động của Firebase vì không còn có thể tham gia nữa. Thay vào đó, bạn có thể làm theo hướng dẫn cập 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 qua 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.

Tính năng xác thực bằng đường liên kết qua 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 các 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 các hướng dẫn được liên kết bên dưới để biết hướng dẫn về cách hoàn tất quá trình di chuyển:

Xem danh sách đầy đủ các hành động bị ảnh hưởng bởi điều này.

Các cách triển khai quy trình OAuth với các phiên bản SDK Android Xác thực Firebase dưới v20.0.0 hoặc các phiên bản BoM dưới 26.0.0 bị ảnh hưởng như thế nào?

Bạn cần cập nhật lên SDK Android Xác thực Firebase mới nhất (ít nhất là v20.0.0) để tiếp tục sử dụng cách triển khai quy trình OAuth trong ứng dụng Android.

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 cung cấp Đườ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.

Các cách triển khai sử dụng thư viện Firebase JS SDK để xác thực nhà cung cấp OAuth trong ứng dụng Cordova 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 ứ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 kết quả cho Firebase để hoàn tất quy trình xác thực.

Xem hướng dẫn về Cordova để biết thêm thông tin.

Vui lòng xem câu hỏi thường gặp "Tôi nên di chuyển khỏi dịch vụ này như thế nào". Câu hỏi này trình bày chi tiết các trường hợp di chuyển khác nhau và cung cấp hướng dẫn di chuyển cho nhiều lựa chọn thay thế có sẵn.