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ụ: thay đổi linh động đích đến của một đường liên kết dựa trên các điều kiện thời gian chạy.

Trong những năm qua, hệ sinh thái web và di động đã phát triển 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Đoạn mã ứng dụng, giúp người dùng di chuyển liền mạch và dễ dự đoán hơn trên các ứng dụng và web. Chúng tôi tin rằng bạn và người dùng sẽ được hưởng lợi nhiều hơn khi trực tiếp sử dụng các công nghệ này và tiếp tục phát triển hệ sinh thái. Tuy nhiên, cùng với những thay đổi mới này, các API gốc ban đầu mà Liên kết động của Firebase được xây dựng cũng đã phát triển và đưa 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 cung cấp trải nghiệm ổn định nhất quán cho một trong những tính năng cốt lõi của Liên kết động Firebase – giúp người dùng ứng dụng chuyển đổi suôn sẻ sang ứ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 Firebase và tập trung lại tài nguyên của mình vào việc giải quyết các vấn đề khác mà nhà phát triển gặp phải.

Chúng tôi hiểu rằng sự thay đổi này sẽ khiến bạn mất 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 này 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 Firebase, đồng thời cam kết giúp bạn 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ì?

Vào 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 Liên kết động của Firebase phân phát (cả đượ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 từ Đườ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 bằng 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 nhiều tình huống di chuyển 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 sử dụng tiến đến ngày ngừng hoạt động vào 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 khác khi hỗ trợ bạn trong quá trình di chuyển.

Hãy xem các câu hỏi thường gặp bên dưới để giải đáp 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 về"Cách di chuyển từ dịch vụ" ở bên dưới.

Vào 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 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 hết ngày 25 tháng 8 năm 2025 để hoàn tất quá trình di chuyển.

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.

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

  • Tất cả cá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ả cá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.

  • 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 rút gọn

    shorten (Swift)

    shortenUrl (Swift)

    shortenWithCompletion (Objective-C)

    400 Lỗi được phát ra kèm theo lý do không thành công Không*
    Mô hình phân bổ lượt mở lần đầu

    Đượ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 mô hình phân bổ

    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 rút gọn

    buildShortDynamicLink (Kotlin)

    buildShortDynamicLink (Java)

    400 Lỗi được phát ra kèm theo lý do không thành công Không*
    Mô hình phân bổ lượt mở lần đầu

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

    400 Tác vụ trả về một phản hồi thành công, nhưng dữ liệu FDL sẽ trống Không*
    Mở lại mô hình phân bổ

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

    400 Tác vụ trả về một 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 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 các nhà phát triển có nhu cầu khác nhau khi sử dụng Liên kết động của Firebase.

Tuỳ thuộc vào trường hợp sử dụng và đánh giá của riêng bạn về việc sử dụng Liên kết động của Firebase, có thể 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 và các nhà cung cấp tương tự khác trên thị trường. (Lưu ý: các nhà cung cấp này chưa được Google kiểm tra, nhưng 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 của đường liên kết sâu để dễ dàng di chuyển các đường liên kết sang nhà cung cấp mà bạn chọn.

Để tìm một nhà cung cấp có các tính năng phù hợp với Liên kết động của Firebase, hãy tham khảo danh sách tính năng sau.

Các tính năng của 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 lần nhấp (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 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 bối cảnh thông qua nội dung được liên kết sâu trong ứng dụng (khi đã cài đặt)
  • Cung cấp dữ liệu phân tích liên quan đến 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
  • Cho phép 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 chi tiết về cách chuyển sang sử dụng Đường liên kết trong ứ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 tính năng Lưu trữ Firebase (không bắt buộc) để lưu trữ các tệp xác minh đường liên kết đến tài sản và miền cần thiết 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 Đường liên kết trong ứ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, có thể bạn không cần làm gì trong ứng dụng để xử lý việc mặt trời sắp lặn. 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 đường liên kết để đảm bảo người dùng và ứng dụng của bạn 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 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 mình, vui lòng liên hệ để cho chúng tôi biết

Các 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 thể sử dụng 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 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.

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

Nếu bạn cần tăng tốc độ yêu cầu để hỗ trợ quá trình di chuyển, vui lòng liên hệ với chúng tôi theo Nhóm hỗ trợ Firebase.

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.

Có, tính năng xác thực đường liên kết email bằng Xác thực Firebase sẽ tiếp tục hoạt động.

Tính năng Xác thực Firebase hiện sử dụng Đường liên kết động của Firebase để tuỳ chỉnh các đường liên kết Xác thực, nhưng chúng tôi sẽ cung cấp một bản cập nhật yêu cầu bạn cập nhật phía máy khách để đảm bảo rằng tính năng xác thực bằng đường liên kết email vẫn hoạt động sau khi dịch vụ Đường liên kết động của Firebase ngừng hoạt động.

Xin lưu ý rằng tính năng Xác thực Firebase chỉ phụ thuộc vào dịch vụ Đường liên kết động của Firebase trong nội bộ, nhưng không phụ thuộc vào SDK Đường liên kết động của Firebase.

Hiện tại, bạn không thể sử dụng Đường liên kết động của Firebase nếu dự án Firebase của bạn chưa bật FDL kể từ ngày công bố ngừng hoạt động vào ngày 25 tháng 8 năm 2023.

Nếu bạn cần bật Đường liên kết động của Firebase để bật tính năng xác thực đường liên kết qua email, vui lòng liên hệ với Nhóm hỗ trợ Firebase và chúng tôi sẽ liên hệ lại với bạn để giúp bạn định cấu hình.

Xin lưu ý rằng việc tiếp tục chức năng này tách biệt với việc sử dụng Đường liên kết động của Firebase cho các trường hợp sử dụng chính là định tuyến cửa hàng và web, liên kết sâu thông thường và bị trì hoãn. Các trường hợp sử dụng này sẽ không được dùng nữa theo tiến trình di chuyển được chia sẻ ở trên.

Vui lòng xem câu hỏi thường gặp "Làm cách nào để di chuyển khỏi dịch vụ này". Câu hỏi này trình bày chi tiết về các tình huống di chuyển khác nhau và cung cấp hướng dẫn di chuyển cho nhiều giải pháp thay thế có sẵn.