Ir a la consola

Primeros pasos con Firebase Remote Config en la Web

Puedes usar Firebase Remote Config para definir parámetros en tu app y actualizar sus valores en la nube, lo que te permite modificar el aspecto y el comportamiento de la app sin distribuir una actualización de ella.

En esta guía, se explican los pasos que debes seguir para comenzar y se proporciona código de muestra que puedes clonar o descargar desde el repositorio firebase/quickstart-js de GitHub.

Agrega Remote Config a la app

  1. Instala el SDK de Firebase para la Web.

  2. Crea el objeto singleton de Remote Config y establece un intervalo de recuperación mínimo, como se muestra en el siguiente ejemplo:

    const remoteConfig = firebase.remoteConfig();
    remoteConfig.settings = {
      minimumFetchIntervalMillis: 3600000,
    };

El objeto se usa para almacenar los valores de parámetros predeterminados en la app, obtener los valores de parámetros actualizados desde el servicio y controlar cuándo están disponibles los valores obtenidos para la app.

Durante el desarrollo, se recomienda establecer un intervalo de recuperación mínimo relativamente bajo. Consulta Regulación obtener más detalles.

Establece los valores de los parámetros predeterminados en la app

Puedes configurar los valores de parámetros predeterminados del objeto de Remote Config para que la app se comporte según lo previsto antes de que se conecte al servicio Remote Config y los valores predeterminados estén disponibles si no hay ninguno configurado en el servicio.

  remoteConfig.defaultConfig = ({
  'welcome_message': 'Welcome',
});

Obtén valores de parámetros para usarlos en la app

Ahora puedes obtener valores de parámetros desde el objeto de Remote Config. Si más tarde configuras valores en el servicio de Remote Config, los recuperas y los activas, esos valores estarán disponibles para tu app. Si quieres obtenerlos, llama al método getValue() y proporciona la clave del parámetro como argumento.

Establece valores de parámetros en el servicio

Con Firebase console o la API de REST de Remote Config, puedes crear nuevos valores predeterminados del servicio que anulen los valores integrados en la app según la lógica condicional o la orientación a usuarios deseada. En esta sección, se explican los pasos que debes seguir en Firebase console para crear estos valores.

  1. En Firebase console, abre tu proyecto.
  2. Selecciona Remote Config desde el menú para ver el panel de Remote Config.
  3. Define parámetros que tengan los mismos nombres que los que definiste en tu app. Para cada parámetro, puedes definir un valor predeterminado (que anulará finalmente el valor predeterminado de la app) y valores condicionales. Para obtener más información, consulta los parámetros y las condiciones de Remote Config.

Recupera y activa los valores del servicio

  1. Para recuperar los valores de parámetros del servicio de Remote Config, llama al método fetch(). Cualquier valor que configures en el servicio de Remote Config se recupera y se almacena en caché en el objeto de Remote Config.
  2. Para que los valores de parámetros recuperados estén disponibles en la app, llama al método activate().

Para los casos en los que desees obtener y activar valores en una llamada, usa fetchAndActivate() como se muestra en este ejemplo:

  remoteConfig.fetchAndActivate()
  .then(() => {
    showWelcomeMessage();
  })
  .catch((err) => {
    console.error(err);
  });

Dado que estos valores de parámetros actualizados afectan el comportamiento y el aspecto de la app, debes activar los valores recuperados en un momento en el que se garantice una experiencia fluida para el usuario, como la próxima vez que la abra. Consulta las estrategias de carga de Remote Config para obtener más información y ejemplos.

Regulación

Si una app realiza recuperaciones muchas veces en poco tiempo, es posible que se regulen las llamadas de recuperación. En estos casos, el SDK arroja un error FETCH_THROTTLE. Te recomendamos detectar este error y volver a intentarlo en el modo de retirada exponencial, esperando intervalos más largos entre las solicitudes de recuperación posteriores.

Durante el desarrollo de la app, te recomendamos actualizar la caché con mucha frecuencia (varias veces por hora) para que puedas iterar con rapidez mientras desarrollas y pruebas tu app. A fin de permitir iteraciones rápidas en un proyecto con varios desarrolladores, puedes agregar temporalmente una propiedad con un intervalo de recuperación mínimo bajo (Settings.minimumFetchIntervalMillis) en la app.

En Remote Config, el intervalo de recuperación para la producción predeterminado y recomendado es de 12 horas, es decir, las configuraciones no se recuperarán desde el backend más de una vez en un período de 12 horas, sin importar cuántas llamadas se realicen. Específicamente, el intervalo de recuperación mínimo se determina en el siguiente orden:

  1. El parámetro de Settings.minimumFetchIntervalMillis
  2. El valor predeterminado de 12 horas

Pasos siguientes

Si aún no lo has hecho, explora los casos prácticos de Remote Config y revisa algunos de los conceptos clave y la documentación de estrategias avanzadas, en las que se incluye lo siguiente: