Thông số và điều kiện của Cấu hình từ xa

Firebase Remote Config cho phép bạn kiểm soát linh hoạt hành vi và giao diện của ứng dụng mà không cần yêu cầu người dùng tải bản cập nhật ứng dụng xuống hoặc yêu cầu triển khai lại phần phụ trợ.

Để định cấu hình ứng dụng, bạn cần xác định tham số (cặp khoá-giá trị) trong Remote Config và sử dụng các tham số đó trong mã ứng dụng hoặc mã phụ trợ. Bạn cũng có thể xác định điều kiện (quy tắc nhắm mục tiêu) để chỉ định giá trị có điều kiện ghi đè giá trị mặc định cho đối tượng, môi trường hoặc tiêu chí tuỳ chỉnh cụ thể.

Remote Config sắp xếp các tham số và điều kiện thành mẫu. Tuỳ thuộc vào cấu trúc, bạn có thể sử dụng mẫu ứng dụng, mẫu máy chủ hoặc cả hai:

  • Tham số và điều kiện trong mẫu ứng dụng: Cung cấp cấu hình cho các phiên bản ứng dụng khách trên các nền tảng Apple, Android, Web, Flutter, Unity và C++. Nhắm đến các phiên bản ứng dụng bằng cách sử dụng đối tượng Google Analytics, phiên bản ứng dụng, nền tảng, ngôn ngữ thiết bị, quốc gia, phân vị người dùng và tín hiệu tuỳ chỉnh phía máy khách.

  • Tham số và điều kiện trong mẫu máy chủ: Cung cấp cấu hình cho môi trường phụ trợ như Cloud Run, Cloud Functions for Firebase hoặc máy chủ trong vùng chứa bằng cách sử dụng Firebase Admin SDK cho Node.js, Python, Go và Java. Đánh giá các tham số phía máy chủ với độ trễ gần như bằng không bằng cách sử dụng tín hiệu tuỳ chỉnh của máy chủ và triển khai theo tỷ lệ phần trăm ngẫu nhiên.

So sánh mẫu ứng dụng và mẫu máy chủ

Mẫu phía máy khách và phía máy chủ phục vụ cho các cấu trúc khác nhau, đồng thời hỗ trợ các SDK và quy tắc nhắm mục tiêu riêng biệt. Hãy tham khảo bảng sau đây để biết loại mẫu nào phù hợp với trường hợp sử dụng của bạn:

Tính năng Mẫu khách hàng Mẫu phía máy chủ
Môi trường mục tiêu Ứng dụng khách (Apple, Android, Web, Flutter, Unity, C++) Môi trường máy chủ (Cloud Run, Cloud Functions for Firebase, GKE, dịch vụ phụ trợ)
SDK được hỗ trợ Firebase client SDK Firebase Admin SDK (Node.js, Python, Go, Java)
Mô hình đánh giá Được tìm nạp và lưu vào bộ nhớ đệm trên thiết bị của khách hàng; được kích hoạt bằng mã ứng dụng Được tải vào bộ nhớ máy chủ; được đánh giá theo từng yêu cầu với độ trễ gần như bằng không
Quy tắc về tình trạng Phiên bản ứng dụng, hệ điều hành/nền tảng, ngôn ngữ của thiết bị, quốc gia/khu vực, Analytics đối tượng và thuộc tính người dùng, người dùng trong phân vị ngẫu nhiên, lần đầu tiên mở ứng dụng, tín hiệu tuỳ chỉnh của ứng dụng khách Người dùng theo tỷ lệ phần trăm ngẫu nhiên, tín hiệu tuỳ chỉnh của máy chủ
Các trường hợp sử dụng phổ biến Ra mắt tính năng, khuyến mãi theo mùa, giao diện người dùng, A/B Testing, Cá nhân hoá Câu lệnh AI và lựa chọn mô hình, cờ tính năng phía máy chủ, giới hạn tốc độ phụ trợ, định tuyến động
Hướng dẫn chi tiết Tham số trong mẫu ứng dụng Tham số trong mẫu phía máy chủ

Các khái niệm chính

Cho dù bạn làm việc với mẫu ứng dụng hay mẫu máy chủ, Remote Config đều chia sẻ các khái niệm cơ bản:

Thông số

Tham số là các cặp khoá-giá trị mà bạn xác định trong bảng điều khiển Firebase hoặc bằng cách sử dụng Remote Config backend API.

  • Khoá tham số: Giá trị nhận dạng chuỗi cho tham số. Khoá có thể dài tối đa 256 ký tự, phải bắt đầu bằng dấu gạch dưới hoặc ký tự chữ cái tiếng Anh (A-Z, a-z) và có thể bao gồm cả số.
  • Giá trị tham số: Giá trị được gán cho tham số. Các giá trị được lưu trữ dưới dạng chuỗi, nhưng bạn có thể chọn các kiểu dữ liệu trong bảng điều khiển để xác thực các giá trị theo các định dạng như String, Boolean, Number hoặc JSON.
  • Giá trị mặc định: Giá trị cơ sở được chỉ định khi không có quy tắc điều kiện nào được áp dụng. Bạn có thể xác định các giá trị mặc định trong ứng dụng trong mã của mình, cũng như các giá trị mặc định của mẫu trong phần phụ trợ Remote Config.

Điều kiện, quy tắc và giá trị có điều kiện

Điều kiện cho phép bạn nhắm đến các phân khúc người dùng ứng dụng hoặc yêu cầu máy chủ cụ thể bằng các giá trị tham số tuỳ chỉnh:

  • Quy tắc: Các tiêu chí riêng lẻ được đánh giá dựa trên siêu dữ liệu của ứng dụng khách hoặc bối cảnh yêu cầu (chẳng hạn như số phiên bản, quốc gia hoặc tín hiệu tuỳ chỉnh).
  • Điều kiện: Tập hợp có tên gồm một hoặc nhiều quy tắc. Tất cả quy tắc trong một điều kiện phải có kết quả đánh giá là true thì điều kiện đó mới có kết quả đánh giá là true.
  • Giá trị có điều kiện: Giá trị thay thế được chỉ định cho một tham số khi một điều kiện được đánh giá là true. Nếu nhiều điều kiện được đánh giá là true, thì điều kiện có mức độ ưu tiên cao nhất trong bảng điều khiển Firebase sẽ được ưu tiên.

Nhóm tham số

Để sắp xếp các cấu hình có hàng chục hoặc hàng trăm tham số, bạn có thể sử dụng nhóm tham số. Nhóm giúp sắp xếp trực quan trong bảng điều khiển Firebase và nhóm logic trong API REST.

  • Một tham số chỉ có thể thuộc về một nhóm tại một thời điểm.
  • Khoá tham số vẫn là duy nhất trên toàn hệ thống trong dự án của bạn, bất kể nhóm.
  • Việc nhóm không làm thay đổi cách tham chiếu các giá trị tham số trong mã SDK của bạn.

Để biết hướng dẫn về cách tạo và quản lý nhóm, hãy xem hướng dẫn chi tiết về tham số máy khách hoặc máy chủ.

Tạo phiên bản và khôi phục mẫu

Mỗi khi bạn cập nhật và xuất bản các tham số hoặc điều kiện trong Remote Config, Firebase sẽ tạo và lưu trữ một phiên bản mới của mẫu. Bạn có thể xem nhật ký phiên bản, so sánh các thay đổi giữa các phiên bản và khôi phục về phiên bản trước đó bất cứ khi nào cần thiết.

Để tìm hiểu thêm về cách quản lý phiên bản mẫu, hãy xem bài viết Quản lý phiên bản mẫu Remote Config.

Hạn mức và giới hạn

Trong một dự án Firebase, Remote Config thực thi các giới hạn sau:

  • Thông số: Tối đa 3.000 thông số cho mỗi dự án.
  • Điều kiện: Tối đa 2.000 điều kiện cho mỗi dự án.
  • Độ dài khoá tham số: Tối đa 256 ký tự.
  • Tổng độ dài chuỗi giá trị: Tối đa 1.000.000 ký tự cho tất cả giá trị tham số trong một dự án.

Để xem danh sách đầy đủ các hạn mức, hãy xem phần Hạn mức và giới hạn.

Các bước tiếp theo