Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Parámetros y condiciones de configuración remota

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Cuando usa Firebase console o las API de backend de Remote Config , define uno o más parámetros (pares clave-valor) y proporciona valores predeterminados en la aplicación para esos parámetros. Puede anular los valores predeterminados en la aplicación definiendo valores de parámetros del lado del servidor. Las claves de parámetro y los valores de parámetro son cadenas, pero los valores de parámetro se pueden convertir como otros tipos de datos cuando usa estos valores en su aplicación.

Con Firebase console, Admin SDK o la REST API de Remote Config , puede crear nuevos valores predeterminados para sus parámetros, así como valores condicionales que se usan para orientar grupos de instancias de aplicaciones. Cada vez que actualiza su configuración en Firebase console, Firebase crea y publica una nueva versión de su plantilla de Remote Config. La versión anterior se almacena, lo que le permite recuperarla o revertirla según sea necesario. Estas operaciones están disponibles para usted a través de Firebase console, Firebase Admin SDK y REST API y se describen más detalladamente en Administrar versiones de plantillas de Remote Config .

Esta guía explica parámetros, condiciones, reglas, valores condicionales y cómo se priorizan varios valores de parámetros en el servidor de configuración remota y en su aplicación. También proporciona detalles sobre los tipos de reglas utilizadas para crear condiciones.

Condiciones, reglas y valores condicionales

Se utiliza una condición para apuntar a un grupo de instancias de la aplicación. Las condiciones se componen de una o más reglas que deben evaluarse como true para que la condición se evalúe como true para una instancia de aplicación determinada. Si el valor de una regla no está definido (por ejemplo, cuando no hay ningún valor disponible), esa regla se evaluará como false .

Por ejemplo, un parámetro que define la página de inicio de una aplicación podría mostrar diferentes imágenes según el tipo de sistema operativo usando la regla simple if device_os = Android :

Captura de pantalla del parámetro 'splash_page' en Firebase console que muestra su valor predeterminado para iOS y su valor condicional para Android

O bien, se podría usar una condición de tiempo para controlar cuándo su aplicación muestra artículos promocionales especiales.

Un parámetro puede tener varios valores condicionales que usan diferentes condiciones y los parámetros pueden compartir condiciones dentro de un proyecto. En la pestaña Parámetros de Firebase console, puede ver el porcentaje de obtención de los valores condicionales de cada parámetro. Esta métrica indica el porcentaje de solicitudes en las últimas 24 horas que recibieron cada valor.

Prioridad del valor del parámetro

Un parámetro puede tener varios valores condicionales asociados. Las siguientes reglas determinan qué valor se obtiene del servidor de configuración remota y qué valor se usa en una instancia de aplicación determinada en un momento determinado:

Los valores de los parámetros del lado del servidor se obtienen de acuerdo con la siguiente lista de prioridades

  1. En primer lugar, se aplican valores condicionales, si alguno tiene condiciones que se evalúen como true para una instancia de aplicación determinada. Si varias condiciones se evalúan como true , la primera (superior) que se muestra en la IU de la consola de Firebase tiene prioridad, y los valores condicionales asociados con esa condición se proporcionan cuando una aplicación obtiene valores del backend. Puede cambiar la prioridad de las condiciones arrastrando y soltando condiciones en la pestaña Condiciones .

  2. Si no hay valores condicionales con condiciones que se evalúen como true , el valor predeterminado del lado del servidor se proporciona cuando una aplicación obtiene valores del backend. Si un parámetro no existe en el backend, o si el valor predeterminado se establece en Usar valor predeterminado en la aplicación , entonces no se proporciona ningún valor para ese parámetro cuando una aplicación obtiene valores.

En su aplicación, los valores de los parámetros se devuelven mediante métodos de get de acuerdo con la siguiente lista de prioridades

  1. Si se obtuvo un valor del backend y luego se activó, la aplicación usa el valor obtenido. Los valores de los parámetros activados son persistentes.
  2. Si no se obtuvo ningún valor del backend, o si los valores obtenidos del backend de Remote Config no se han activado, la aplicación usa el valor predeterminado en la aplicación.

    Para obtener más información sobre cómo obtener y configurar los valores predeterminados, consulte Descargar los valores predeterminados de la plantilla de configuración remota .

  3. Si no se ha establecido ningún valor predeterminado en la aplicación, la aplicación usa un valor de tipo estático (como 0 para int y false para boolean ).

Este gráfico resume cómo se priorizan los valores de los parámetros en el backend de Remote Config y en su aplicación:

Diagrama que muestra el flujo descrito por las listas ordenadas arriba

Tipos de datos de valor de parámetro

Remote Config le permite seleccionar un tipo de datos para cada parámetro y valida todos los valores del lado del servidor contra ese tipo antes de una actualización de la plantilla. El tipo de datos se almacena y se devuelve en una solicitud getRemoteConfig .

Los tipos soportados actualmente son:

  • String
  • Boolean
  • Number
  • JSON

En la interfaz de usuario de Firebase console, el tipo de datos se puede seleccionar en un menú desplegable junto a la clave de parámetro. En la API REST, los tipos se pueden establecer utilizando el campo value_type dentro del objeto de parámetro.

Grupos de parámetros

Remote Config le permite agrupar parámetros para obtener una interfaz de usuario y un modelo mental más organizados.

Por ejemplo, supongamos que necesita habilitar o deshabilitar tres tipos de autenticación diferentes mientras implementa una nueva función de inicio de sesión. Con Remote Config, puede crear los tres parámetros para habilitar los tipos como desee y luego organizarlos en un grupo llamado "Nuevo inicio de sesión", sin necesidad de agregar prefijos o clasificación especial.

Puede crear grupos de parámetros mediante Firebase console o la API REST de Remote Config. Cada grupo de parámetros que crea tiene un nombre único en su plantilla de configuración remota. Al crear grupos de parámetros, tenga en cuenta:

  • Los parámetros se pueden incluir en un solo grupo en cualquier momento, y una clave de parámetro aún debe ser única en todos los parámetros.
  • Los nombres de los grupos de parámetros están limitados a 256 caracteres.
  • Si usa tanto la API de REST como Firebase console, asegúrese de que la lógica de la API de REST esté actualizada para manejar los grupos de parámetros en la publicación.

Crear o modificar grupos de parámetros con Firebase console

Puede agrupar parámetros en la pestaña Parámetros de Firebase console. Para crear o modificar un grupo:

  1. Seleccione Administrar grupos .
  2. Seleccione las casillas de verificación de los parámetros que desea agregar y seleccione Mover al grupo .
  3. Seleccione un grupo existente o cree un nuevo grupo ingresando un nombre y una descripción, y seleccionando Crear nuevo grupo . Después de guardar un grupo, está disponible para publicarse mediante el botón Publicar cambios .

Crear grupos programáticamente

La API REST de Remote Config proporciona una forma automatizada de crear y publicar grupos de parámetros. Suponiendo que está familiarizado con REST y está configurado para autorizar solicitudes a la API, puede realizar estos pasos para administrar grupos mediante programación:

  1. Recuperar la plantilla actual
  2. Agregue objetos JSON para representar sus grupos de parámetros
  3. Publique los grupos de parámetros mediante una solicitud HTTP PUT.

El objeto ParameterGroups contiene claves de grupo, con una descripción anidada y una lista de parameterGroups agrupados. Tenga en cuenta que cada clave de grupo debe ser globalmente única.

Por ejemplo, aquí hay un extracto de una revisión de plantilla que agrega el grupo de parámetros "menú nuevo" con un parámetro, pumpkin_spice_season :

{
  "parameters": {},
  "version": {
    "versionNumber": "1",

    …


  },
  "parameterGroups": {
    "new menu": {
      "description": "New Menu",
      "parameters": {
        "pumpkin_spice_season": {
          "defaultValue": {
            "value": "true"
          },
          "description": "Whether it's currently pumpkin spice season."
        }
      }
    }
  }
}

Tipos de reglas de condición

Los siguientes tipos de reglas son compatibles con Firebase console. La funcionalidad equivalente está disponible en la API REST de Remote Config, como se detalla en la referencia de expresión condicional .

Tipo de regla Operador(es) Valores) Nota
aplicación == Seleccione de una lista de ID de aplicaciones para aplicaciones asociadas con su proyecto de Firebase. Cuando agrega una aplicación a Firebase, ingresa un ID de paquete o un nombre de paquete de Android que define un atributo que se expone como ID de aplicación en las reglas de configuración remota.

Utilice este atributo de la siguiente manera:
  • Para plataformas Apple: use el CFBundleIdentifier de la aplicación. Puede encontrar el Identificador de paquete en la pestaña General para el objetivo principal de su aplicación en Xcode.
  • Para Android: usa el applicationId de la aplicación . Puede encontrar el ID de la applicationId en su archivo build.gradle de nivel de aplicación.
Version de aplicacion Para valores de cadena:
coincide exactamente,
contiene,
no contiene,
expresión regular

Para valores numéricos:
=, ≠, >, ≥, <, ≤

Especifique la(s) versión(es) de su aplicación para apuntar.

Antes de usar esta regla, debe usar una regla de ID de aplicación para seleccionar una aplicación de Android/Apple asociada con su proyecto de Firebase.

Para plataformas Apple: use el CFBundleShortVersionString de la aplicación.

Nota: Asegúrese de que su aplicación de Apple utilice la versión 6.24.0 o superior del SDK de las plataformas Apple de Firebase, ya que CFBundleShortVersionString no se envía en versiones anteriores (consulte las notas de la versión ).

Para Android: usa el nombre de la versión de la aplicación.

Las comparaciones de cadenas para esta regla distinguen entre mayúsculas y minúsculas. Cuando se utiliza el operador de expresión regular , contiene , no contiene o coincide exactamente , puede seleccionar varios valores.

Al utilizar el operador de expresión regular , puede crear expresiones regulares en formato RE2 . Su expresión regular puede coincidir con la totalidad o parte de la cadena de la versión de destino. También puede usar los anclajes ^ y $ para hacer coincidir el principio, el final o la totalidad de una cadena de destino.

Número de compilación Para valores de cadena:
coincide exactamente,
contiene,
no contiene,
expresión regular

Para valores numéricos:
=, ≠, >, ≥, <, ≤

Especifique la(s) compilación(es) de su aplicación para apuntar.

Antes de usar esta regla, debe usar una regla de ID de aplicación para seleccionar una aplicación de Apple o Android asociada con su proyecto de Firebase.

Este operador está disponible solo para aplicaciones de Apple y Android. Corresponde a CFBundleVersion de la aplicación para Apple y versionCode para Android. Las comparaciones de cadenas para esta regla distinguen entre mayúsculas y minúsculas.

Cuando se utiliza el operador de expresión regular , contiene , no contiene o coincide exactamente , puede seleccionar varios valores.

Al utilizar el operador de expresión regular , puede crear expresiones regulares en formato RE2 . Su expresión regular puede coincidir con la totalidad o parte de la cadena de la versión de destino. También puede usar los anclajes ^ y $ para hacer coincidir el principio, el final o la totalidad de una cadena de destino.

Plataforma == iOS
Androide
Web
Sistema operativo ==

Especifique los sistemas operativos de destino.

Antes de usar esta regla, debe usar una regla de ID de aplicación para seleccionar una aplicación web asociada con su proyecto de Firebase.

Esta regla se evalúa como true para una instancia de aplicación web determinada si el sistema operativo y su versión coinciden con un valor de destino en la lista especificada.
Navegador ==

Especifique los navegadores a los que apuntar.

Antes de usar esta regla, debe usar una regla de ID de aplicación para seleccionar una aplicación web asociada con su proyecto de Firebase.

Esta regla se evalúa como true para una instancia de aplicación web determinada si el navegador y su versión coinciden con un valor de destino en la lista especificada.
Categoría de dispositivo no lo es móvil Esta regla evalúa si el dispositivo que accede a su aplicación web es móvil o no móvil (escritorio o consola). Este tipo de regla solo está disponible para aplicaciones web.
Idiomas es en Seleccione uno o más idiomas. Esta regla se evalúa como true para una instancia de aplicación dada si esa instancia de aplicación está instalada en un dispositivo que usa uno de los idiomas enumerados.
País/Región es en Seleccione una o más regiones o países. Esta regla se evalúa como true para una instancia de aplicación determinada si la instancia se encuentra en cualquiera de las regiones o países enumerados. El código de país del dispositivo se determina mediante la dirección IP del dispositivo en la solicitud o el código de país determinado por Firebase Analytics (si los datos de Analytics se comparten con Firebase).
Audiencia(s) de usuarios Incluye al menos uno Seleccione uno o más de una lista de audiencias de Google Analytics que ha configurado para su proyecto.

Esta regla requiere una regla de ID de aplicación para seleccionar una aplicación asociada con su proyecto de Firebase.

Nota: Debido a que muchas audiencias de Analytics están definidas por eventos o propiedades de usuario, que pueden basarse en las acciones de los usuarios de la aplicación, es posible que la regla Usuario en la audiencia tarde algún tiempo en surtir efecto para una instancia de aplicación determinada.

Propiedad de usuario Para valores de cadena:
contiene,
no contiene,
coincide exactamente,
expresión regular

Para valores numéricos:
=, ≠, >, ≥, <, ≤

Nota: En el cliente, solo puede establecer valores de cadena para las propiedades del usuario. Para las condiciones que utilizan operadores numéricos, Remote Config convierte el valor de la propiedad de usuario correspondiente en un número entero/flotante.
Seleccione de una lista de propiedades de usuario de Google Analytics disponibles. Para obtener información sobre cómo puede usar las propiedades de usuario para personalizar su aplicación para segmentos muy específicos de su base de usuarios, consulte Configuración remota y propiedades de usuario .

Para obtener más información sobre las propiedades de usuario, consulte las siguientes guías:

Cuando se utiliza el operador de expresión regular , contiene , no contiene o coincide exactamente , puede seleccionar varios valores.

Al utilizar el operador de expresión regular , puede crear expresiones regulares en formato RE2 . Su expresión regular puede coincidir con la totalidad o parte de la cadena de la versión de destino. También puede usar los anclajes ^ y $ para hacer coincidir el principio, el final o la totalidad de una cadena de destino.

Nota: Las propiedades de usuario recopiladas automáticamente no están disponibles actualmente cuando se crean condiciones de configuración remota.
Usuario en percentil aleatorio <=, > 0-100

Utilice este campo para aplicar un cambio a una muestra aleatoria de instancias de la aplicación (con tamaños de muestra tan pequeños como 0,0001 %), utilizando los operadores <= y > para segmentar a los usuarios (instancias de la aplicación) en grupos.

Cada instancia de la aplicación se asigna de manera persistente a un número entero o fraccionario aleatorio, de acuerdo con una clave definida en ese proyecto. Una regla usará la clave predeterminada (que se muestra como DEF en Firebase console) a menos que seleccione o cree otra clave. Puede hacer que una regla vuelva a usar la clave predeterminada borrando el campo Aleatorizar usuarios usando esta clave . Puede usar una sola clave en todas las reglas para abordar de manera consistente las mismas instancias de la aplicación dentro de los rangos de porcentaje dados. O bien, puede seleccionar un nuevo grupo de instancias de aplicaciones asignadas aleatoriamente para un rango de porcentaje dado creando una nueva clave.

Por ejemplo, para crear dos condiciones relacionadas que se apliquen a un 5 % de los usuarios de una aplicación que no se superpongan, podría hacer que una condición incluyera una regla <= 5 % y otra condición incluyera una regla > 5 % y una regla <= regla del 10% . Para hacer posible que algunos usuarios aparezcan aleatoriamente en ambos grupos, use diferentes claves para las reglas en cada condición.

Segmento importado es en Seleccione uno o más segmentos importados. Esta regla requiere configurar segmentos importados personalizados.
Fecha y hora Antes después Una fecha y hora específicas, ya sea en la zona horaria del dispositivo o en una zona horaria específica como "(GMT+11) hora de Sydney". Compara la hora actual con la hora de obtención del dispositivo.
Primero abierto Antes después Una fecha y hora especificadas, en la zona horaria especificada.

Coincide con los usuarios que abren por primera vez la aplicación de destino dentro del intervalo de tiempo especificado.

Requiere los siguientes SDK:

  • SDK de Firebase para Google Analytics
  • Plataformas Apple SDK v9.0.0+ o Android SDK v21.1.1+ (Firebase BoM v30.3.0+)

ID de instalación es en Especifique uno o más ID de instalación (hasta 50) para el objetivo. Esta regla se evalúa como true para una instalación dada si la ID de esa instalación está en la lista de valores separados por comas.

Para saber cómo puede obtener ID de instalación, consulte Recuperar identificadores de cliente .

Búsqueda de parámetros y condiciones

Puede buscar las claves de parámetros, los valores de los parámetros y las condiciones de su proyecto desde Firebase console usando el cuadro de búsqueda en la parte superior de la pestaña Parámetros de configuración remota.

Límites de parámetros y condiciones

Dentro de un proyecto de Firebase, puede tener hasta 2000 parámetros y hasta 500 condiciones. Las claves de parámetros pueden tener hasta 256 caracteres, deben comenzar con un guión bajo o una letra inglesa (AZ, az) y también pueden incluir números. La longitud total de las cadenas de valores de los parámetros dentro de un proyecto no puede superar los 1 000 000 de caracteres.

Visualización de cambios en parámetros y condiciones

Puede ver los cambios más recientes en sus plantillas de Remote Config desde la consola de Firebase . Para cada parámetro y condición individual, puede:

  • Ver el nombre del usuario que modificó por última vez el parámetro o la condición.

  • Si el cambio se produjo en el mismo día, vea la cantidad de minutos u horas que han transcurrido desde que se publicó el cambio en la plantilla de configuración remota activa.

  • Si el cambio ocurrió hace uno o más días, vea la fecha en que se publicó el cambio en la plantilla de Remote Config activa.

Actualizaciones de parámetros

En la página Parámetros de configuración remota, la columna Última publicación muestra el último usuario que modificó cada parámetro y la última fecha de publicación del cambio:

  • Para ver los metadatos de cambio de los parámetros agrupados, expanda el grupo de parámetros.

  • Para ordenar en orden ascendente o descendente por fecha de publicación, haga clic en la etiqueta de la columna Última publicación .

Actualizaciones de condición

En la página Condiciones de configuración remota, puede ver el último usuario que modificó la condición y la fecha en que la modificó junto a Última modificación debajo de cada condición.

Próximos pasos

Para comenzar a configurar su proyecto de Firebase, consulte Configurar un proyecto de configuración remota de Firebase .

,

Cuando usa Firebase console o las API de backend de Remote Config , define uno o más parámetros (pares clave-valor) y proporciona valores predeterminados en la aplicación para esos parámetros. Puede anular los valores predeterminados en la aplicación definiendo valores de parámetros del lado del servidor. Las claves de parámetro y los valores de parámetro son cadenas, pero los valores de parámetro se pueden convertir como otros tipos de datos cuando usa estos valores en su aplicación.

Con Firebase console, Admin SDK o la REST API de Remote Config , puede crear nuevos valores predeterminados para sus parámetros, así como valores condicionales que se usan para orientar grupos de instancias de aplicaciones. Cada vez que actualiza su configuración en Firebase console, Firebase crea y publica una nueva versión de su plantilla de Remote Config. La versión anterior se almacena, lo que le permite recuperarla o revertirla según sea necesario. Estas operaciones están disponibles para usted a través de Firebase console, Firebase Admin SDK y REST API y se describen más detalladamente en Administrar versiones de plantillas de Remote Config .

Esta guía explica parámetros, condiciones, reglas, valores condicionales y cómo se priorizan varios valores de parámetros en el servidor de configuración remota y en su aplicación. También proporciona detalles sobre los tipos de reglas utilizadas para crear condiciones.

Condiciones, reglas y valores condicionales

Se utiliza una condición para apuntar a un grupo de instancias de la aplicación. Las condiciones se componen de una o más reglas que deben evaluarse como true para que la condición se evalúe como true para una instancia de aplicación determinada. Si el valor de una regla no está definido (por ejemplo, cuando no hay ningún valor disponible), esa regla se evaluará como false .

Por ejemplo, un parámetro que define la página de inicio de una aplicación podría mostrar diferentes imágenes según el tipo de sistema operativo usando la regla simple if device_os = Android :

Captura de pantalla del parámetro 'splash_page' en Firebase console que muestra su valor predeterminado para iOS y su valor condicional para Android

O bien, se podría usar una condición de tiempo para controlar cuándo su aplicación muestra artículos promocionales especiales.

Un parámetro puede tener varios valores condicionales que usan diferentes condiciones y los parámetros pueden compartir condiciones dentro de un proyecto. En la pestaña Parámetros de Firebase console, puede ver el porcentaje de obtención de los valores condicionales de cada parámetro. Esta métrica indica el porcentaje de solicitudes en las últimas 24 horas que recibieron cada valor.

Prioridad del valor del parámetro

Un parámetro puede tener varios valores condicionales asociados. Las siguientes reglas determinan qué valor se obtiene del servidor de configuración remota y qué valor se usa en una instancia de aplicación determinada en un momento determinado:

Los valores de los parámetros del lado del servidor se obtienen de acuerdo con la siguiente lista de prioridades

  1. En primer lugar, se aplican valores condicionales, si alguno tiene condiciones que se evalúen como true para una instancia de aplicación determinada. Si varias condiciones se evalúan como true , la primera (superior) que se muestra en la IU de la consola de Firebase tiene prioridad, y los valores condicionales asociados con esa condición se proporcionan cuando una aplicación obtiene valores del backend. Puede cambiar la prioridad de las condiciones arrastrando y soltando condiciones en la pestaña Condiciones .

  2. Si no hay valores condicionales con condiciones que se evalúen como true , el valor predeterminado del lado del servidor se proporciona cuando una aplicación obtiene valores del backend. Si un parámetro no existe en el backend, o si el valor predeterminado se establece en Usar valor predeterminado en la aplicación , entonces no se proporciona ningún valor para ese parámetro cuando una aplicación obtiene valores.

En su aplicación, los valores de los parámetros se devuelven mediante métodos de get de acuerdo con la siguiente lista de prioridades

  1. Si se obtuvo un valor del backend y luego se activó, la aplicación usa el valor obtenido. Los valores de los parámetros activados son persistentes.
  2. Si no se obtuvo ningún valor del backend, o si los valores obtenidos del backend de Remote Config no se han activado, la aplicación usa el valor predeterminado en la aplicación.

    Para obtener más información sobre cómo obtener y configurar los valores predeterminados, consulte Descargar los valores predeterminados de la plantilla de configuración remota .

  3. Si no se ha establecido ningún valor predeterminado en la aplicación, la aplicación usa un valor de tipo estático (como 0 para int y false para boolean ).

Este gráfico resume cómo se priorizan los valores de los parámetros en el backend de Remote Config y en su aplicación:

Diagrama que muestra el flujo descrito por las listas ordenadas arriba

Tipos de datos de valor de parámetro

Remote Config le permite seleccionar un tipo de datos para cada parámetro y valida todos los valores del lado del servidor contra ese tipo antes de una actualización de la plantilla. El tipo de datos se almacena y se devuelve en una solicitud getRemoteConfig .

Los tipos soportados actualmente son:

  • String
  • Boolean
  • Number
  • JSON

En la interfaz de usuario de Firebase console, el tipo de datos se puede seleccionar en un menú desplegable junto a la clave de parámetro. En la API REST, los tipos se pueden establecer utilizando el campo value_type dentro del objeto de parámetro.

Grupos de parámetros

Remote Config le permite agrupar parámetros para obtener una interfaz de usuario y un modelo mental más organizados.

Por ejemplo, supongamos que necesita habilitar o deshabilitar tres tipos de autenticación diferentes mientras implementa una nueva función de inicio de sesión. Con Remote Config, puede crear los tres parámetros para habilitar los tipos como desee y luego organizarlos en un grupo llamado "Nuevo inicio de sesión", sin necesidad de agregar prefijos o clasificación especial.

Puede crear grupos de parámetros mediante Firebase console o la API REST de Remote Config. Cada grupo de parámetros que crea tiene un nombre único en su plantilla de configuración remota. Al crear grupos de parámetros, tenga en cuenta:

  • Los parámetros se pueden incluir en un solo grupo en cualquier momento, y una clave de parámetro aún debe ser única en todos los parámetros.
  • Los nombres de los grupos de parámetros están limitados a 256 caracteres.
  • Si usa tanto la API de REST como Firebase console, asegúrese de que la lógica de la API de REST esté actualizada para manejar los grupos de parámetros en la publicación.

Crear o modificar grupos de parámetros con Firebase console

Puede agrupar parámetros en la pestaña Parámetros de Firebase console. Para crear o modificar un grupo:

  1. Seleccione Administrar grupos .
  2. Seleccione las casillas de verificación de los parámetros que desea agregar y seleccione Mover al grupo .
  3. Seleccione un grupo existente o cree un nuevo grupo ingresando un nombre y una descripción, y seleccionando Crear nuevo grupo . Después de guardar un grupo, está disponible para publicarse mediante el botón Publicar cambios .

Crear grupos programáticamente

La API REST de Remote Config proporciona una forma automatizada de crear y publicar grupos de parámetros. Suponiendo que está familiarizado con REST y está configurado para autorizar solicitudes a la API, puede realizar estos pasos para administrar grupos mediante programación:

  1. Recuperar la plantilla actual
  2. Agregue objetos JSON para representar sus grupos de parámetros
  3. Publique los grupos de parámetros mediante una solicitud HTTP PUT.

El objeto ParameterGroups contiene claves de grupo, con una descripción anidada y una lista de parameterGroups agrupados. Tenga en cuenta que cada clave de grupo debe ser globalmente única.

Por ejemplo, aquí hay un extracto de una revisión de plantilla que agrega el grupo de parámetros "menú nuevo" con un parámetro, pumpkin_spice_season :

{
  "parameters": {},
  "version": {
    "versionNumber": "1",

    …


  },
  "parameterGroups": {
    "new menu": {
      "description": "New Menu",
      "parameters": {
        "pumpkin_spice_season": {
          "defaultValue": {
            "value": "true"
          },
          "description": "Whether it's currently pumpkin spice season."
        }
      }
    }
  }
}

Tipos de reglas de condición

Los siguientes tipos de reglas son compatibles con Firebase console. La funcionalidad equivalente está disponible en la API REST de Remote Config, como se detalla en la referencia de expresión condicional .

Tipo de regla Operador(es) Valores) Nota
aplicación == Seleccione de una lista de ID de aplicaciones para aplicaciones asociadas con su proyecto de Firebase. Cuando agrega una aplicación a Firebase, ingresa un ID de paquete o un nombre de paquete de Android que define un atributo que se expone como ID de aplicación en las reglas de configuración remota.

Utilice este atributo de la siguiente manera:
  • Para plataformas Apple: use el CFBundleIdentifier de la aplicación. Puede encontrar el Identificador de paquete en la pestaña General para el objetivo principal de su aplicación en Xcode.
  • Para Android: usa el applicationId de la aplicación . Puede encontrar el ID de la applicationId en su archivo build.gradle de nivel de aplicación.
Version de aplicacion Para valores de cadena:
coincide exactamente,
contiene,
no contiene,
expresión regular

Para valores numéricos:
=, ≠, >, ≥, <, ≤

Especifique la(s) versión(es) de su aplicación para apuntar.

Antes de usar esta regla, debe usar una regla de ID de aplicación para seleccionar una aplicación de Android/Apple asociada con su proyecto de Firebase.

Para plataformas Apple: use el CFBundleShortVersionString de la aplicación.

Nota: Asegúrese de que su aplicación de Apple utilice la versión 6.24.0 o superior del SDK de las plataformas Apple de Firebase, ya que CFBundleShortVersionString no se envía en versiones anteriores (consulte las notas de la versión ).

Para Android: usa el nombre de la versión de la aplicación.

Las comparaciones de cadenas para esta regla distinguen entre mayúsculas y minúsculas. Cuando se utiliza el operador de expresión regular , contiene , no contiene o coincide exactamente , puede seleccionar varios valores.

Al utilizar el operador de expresión regular , puede crear expresiones regulares en formato RE2 . Su expresión regular puede coincidir con la totalidad o parte de la cadena de la versión de destino. También puede usar los anclajes ^ y $ para hacer coincidir el principio, el final o la totalidad de una cadena de destino.

Número de compilación Para valores de cadena:
coincide exactamente,
contiene,
no contiene,
expresión regular

Para valores numéricos:
=, ≠, >, ≥, <, ≤

Especifique la(s) compilación(es) de su aplicación para apuntar.

Antes de usar esta regla, debe usar una regla de ID de aplicación para seleccionar una aplicación de Apple o Android asociada con su proyecto de Firebase.

Este operador está disponible solo para aplicaciones de Apple y Android. Corresponde a CFBundleVersion de la aplicación para Apple y versionCode para Android. Las comparaciones de cadenas para esta regla distinguen entre mayúsculas y minúsculas.

Cuando se utiliza el operador de expresión regular , contiene , no contiene o coincide exactamente , puede seleccionar varios valores.

Al utilizar el operador de expresión regular , puede crear expresiones regulares en formato RE2 . Su expresión regular puede coincidir con la totalidad o parte de la cadena de la versión de destino. También puede usar los anclajes ^ y $ para hacer coincidir el principio, el final o la totalidad de una cadena de destino.

Plataforma == iOS
Androide
Web
Sistema operativo ==

Especifique los sistemas operativos de destino.

Antes de usar esta regla, debe usar una regla de ID de aplicación para seleccionar una aplicación web asociada con su proyecto de Firebase.

Esta regla se evalúa como true para una instancia de aplicación web determinada si el sistema operativo y su versión coinciden con un valor de destino en la lista especificada.
Navegador ==

Especifique los navegadores a los que apuntar.

Antes de usar esta regla, debe usar una regla de ID de aplicación para seleccionar una aplicación web asociada con su proyecto de Firebase.

Esta regla se evalúa como true para una instancia de aplicación web determinada si el navegador y su versión coinciden con un valor de destino en la lista especificada.
Categoría de dispositivo no lo es móvil Esta regla evalúa si el dispositivo que accede a su aplicación web es móvil o no móvil (escritorio o consola). Este tipo de regla solo está disponible para aplicaciones web.
Idiomas es en Seleccione uno o más idiomas. Esta regla se evalúa como true para una instancia de aplicación dada si esa instancia de aplicación está instalada en un dispositivo que usa uno de los idiomas enumerados.
País/Región es en Seleccione una o más regiones o países. Esta regla se evalúa como true para una instancia de aplicación determinada si la instancia se encuentra en cualquiera de las regiones o países enumerados. El código de país del dispositivo se determina mediante la dirección IP del dispositivo en la solicitud o el código de país determinado por Firebase Analytics (si los datos de Analytics se comparten con Firebase).
Audiencia(s) de usuarios Incluye al menos uno Seleccione uno o más de una lista de audiencias de Google Analytics que ha configurado para su proyecto.

Esta regla requiere una regla de ID de aplicación para seleccionar una aplicación asociada con su proyecto de Firebase.

Nota: Debido a que muchas audiencias de Analytics están definidas por eventos o propiedades de usuario, que pueden basarse en las acciones de los usuarios de la aplicación, es posible que la regla Usuario en la audiencia tarde algún tiempo en surtir efecto para una instancia de aplicación determinada.

Propiedad de usuario Para valores de cadena:
contiene,
no contiene,
coincide exactamente,
expresión regular

Para valores numéricos:
=, ≠, >, ≥, <, ≤

Nota: En el cliente, solo puede establecer valores de cadena para las propiedades del usuario. Para las condiciones que utilizan operadores numéricos, Remote Config convierte el valor de la propiedad de usuario correspondiente en un número entero/flotante.
Seleccione de una lista de propiedades de usuario de Google Analytics disponibles. Para obtener información sobre cómo puede usar las propiedades de usuario para personalizar su aplicación para segmentos muy específicos de su base de usuarios, consulte Configuración remota y propiedades de usuario .

Para obtener más información sobre las propiedades de usuario, consulte las siguientes guías:

Cuando se utiliza el operador de expresión regular , contiene , no contiene o coincide exactamente , puede seleccionar varios valores.

Al utilizar el operador de expresión regular , puede crear expresiones regulares en formato RE2 . Su expresión regular puede coincidir con la totalidad o parte de la cadena de la versión de destino. También puede usar los anclajes ^ y $ para hacer coincidir el principio, el final o la totalidad de una cadena de destino.

Nota: Las propiedades de usuario recopiladas automáticamente no están disponibles actualmente cuando se crean condiciones de configuración remota.
Usuario en percentil aleatorio <=, > 0-100

Utilice este campo para aplicar un cambio a una muestra aleatoria de instancias de la aplicación (con tamaños de muestra tan pequeños como 0,0001 %), utilizando los operadores <= y > para segmentar a los usuarios (instancias de la aplicación) en grupos.

Cada instancia de la aplicación se asigna de manera persistente a un número entero o fraccionario aleatorio, de acuerdo con una clave definida en ese proyecto. Una regla usará la clave predeterminada (que se muestra como DEF en Firebase console) a menos que seleccione o cree otra clave. Puede hacer que una regla vuelva a usar la clave predeterminada borrando el campo Aleatorizar usuarios usando esta clave . Puede usar una sola clave en todas las reglas para abordar de manera consistente las mismas instancias de la aplicación dentro de los rangos de porcentaje dados. O bien, puede seleccionar un nuevo grupo de instancias de aplicaciones asignadas aleatoriamente para un rango de porcentaje dado creando una nueva clave.

For example, to create two related conditions that each apply to a non-overlapping 5% of an app's users, you could have one condition include a <= 5% rule, and another condition include both a > 5% rule and a <= 10% rule. To make it possible for some users to randomly appear in both groups, use different keys for the rules in each condition.

Imported segment is in Select one or more imported segment. This rule requires setting up custom imported segments .
Date/Time Before, After A specified date and time, either in the device timezone or a specified timezone such as "(GMT+11) Sydney time." Compares the current time to the device fetch time.
First open Before, After A specified date and time, in the specified timezone.

Matches users who first open the targeted app within the specified time range.

Requires the following SDKs:

  • Firebase SDK for Google Analytics
  • Apple platforms SDK v9.0.0+ or Android SDK v21.1.1+ (Firebase BoM v30.3.0+)

Installation ID is in Specify one or more Installation IDs (up to 50) to target. This rule evaluates to true for a given installation if that installation's ID is in the comma-separated list of values.

To learn how you can get installation IDs, see Retrieve client identifiers .

Searching parameters and conditions

You can search your project's parameter keys, parameter values, and conditions from the Firebase console using the search box at the top of the Remote Config Parameters tab.

Limits on parameters and conditions

Within a Firebase project, you can have up to 2000 parameters, and up to 500 conditions. Parameter keys can be up to 256 characters long, must start with an underscore or English letter character (AZ, az), and may also include numbers. The total length of parameter value strings within a project cannot exceed 1,000,000 characters.

Viewing changes to parameters and conditions

You can view the latest changes to your Remote Config templates from the Firebase console . For each individual parameter and condition, you can:

  • View the name of the user who last modified the parameter or condition.

  • If the change occurred within the same day, view the number of minutes or hours that have elapsed since the change was published to the active Remote Config template.

  • If the change occurred one or more days in the past, view the date when the change was published to the active Remote Config template.

Parameter updates

On the Remote Config Parameters page, the Last published column shows the last user who modified each parameter and the last publish date for the change:

  • To view change metadata for grouped parameters, expand the parameter group.

  • To sort in ascending or descending order by publish date, click the Last published column label.

Condition updates

On the Remote Config Conditions page, you can see the last user who modified the condition and the date they modified it next to Last modified beneath each condition.

Next steps

To get started configuring your Firebase project, see Set up a Firebase Remote Config Project .