PUSH-11-QA Firebase Console

Objetivo
El objetivo de este documento es hacer una descripción rápida del sistema de mensajería de Firebase a
través de la Consola de Firebase.
 
Ingreso a la Consola
Para acceder a la consola es necesario ingresar al link https://firebase.google.com/
Una vez en la página, encontraremos un link ACCEDER en la parte superior derecha de la pantalla.
 

 
Allí debemos ingresar el usuario y contraseña:
 

 
Al ser identificados, volveremos a la pantalla inicial, donde ahora podremos ingresar a IR A LA CONSOLA .
 

 
 

 
Consola
Antes de permitirnos entrar, Firebase nos pedirá seleccionar el Proyecto con el cual queremos trabajar.
 

 
Al seleccionar el proyecto, ingresaremos realmente a la Consola de Firebase
Una vez dentro de la consola, descubriremos algunas estadísticas sobre el proyecto, y un menú en la parte
izquierda de la página. Este menú tiene dos niveles de opciones, que se puede desplegar o replegar
haciendo click sobre ellas.
 
 
Si, por ejemplo, Desplegamos la opción ANALITICS , y seleccionamos Dashboard , podremos ver las
estadísticas de Firebase Analytics para nuestro proyecto.
 

 
Allí mismo, podemos consultar también las variables de usuario que tenemos disponibles. Esto se
encuentra en ANALYTICS / User Properties .
 

 
 
Enviar un Mensaje
Debajo de la carpeta de opciones de ANALYTICS (cuando la carpeta está cerrada se vé directamente abajo),
encontraremos la carpeta GROW .
Dentro de la carpeta GROW , la segunda opción es Notifications .
 

 
En esta página podemos ver los últimos mensajes que han sido enviados desde esta consola, así como su
estado, Fecha de entrega, Plataforma y un estimado de destinatarios y de aperturas.
En la parte superior derecha de este cuadro, nos encontraremos con la opción MENSAJE NUEVO . Esa es la
opción para crear una nueva notificación.
 
 
Dentro de esta nueva pantalla, descubriremos varias campos a completar:
 
Texto del mensaje : es el texto que queremos enviar como cuerpo de nuestro mensaje. Es un campo de
texto.
 
Etiqueta del mensaje (opcional) : esta es una etiqueta que nos puede servir para identificar el mensaje de
forma más sencilla en la lista de mensaje que vimos en la pantalla anterior. Como lo indica su nombre, es
opcional.
 
Fecha de entrega : este combo nos permite elegir entre Enviar ahora o Enviar más tarde . En el caso de
seleccionar enviar más tarde, nos permitirá ingresar una fecha y hora para postdatar el envío.
 
Destino : es una de las partes más importantes del envío. Desde aquí definiremos a quién le va a llegar
nuestro texto. Tenemos tres opciones:
 
Segmento de usuarios : Aquí podremos especificar las condiciones que deberá cumplir el usuario para poder
recibir el mensaje.
Tema : nos permitirá especificar uno de los tópicos existentes y enviar el mensaje a todos aquellos usuarios
que se hayan registrado el tópico (Ej anonimous ).
Un único dispositivo : permite ingresar un token específico de dispositivo, y enviarle el mensaje sólo a tal
device.
 
Más abajo, encontraremos una solapa con el nombre Opciones avanzadas . Allí se ofrece un conjunto de
opciones que sirven para refinar la forma de envío del mensaje (la prioridad, datos extras que se le quieran
pasar a la aplicación, fecha de vencimiento de la entrega, etc.)
 
 
 
Inicialmente, utilizaremos sólo el llamado Título , que nos dejará especificar un Título más grande y más
visible por encima del texto del mensaje.
 
Finalmente, cuando hayamos completado los datos mínimos para el envío del mensaje, se encenderá la
opción ENVIAR MENSAJE en la parte inferior derecha del formulario.
 
 

Segmento de usuarios
Para utilizar el segmento de usuarios, Firebase Notification se vale de:
Seleccionar una aplicación (luego veremos que se puede mandar a varias al mismo tiempo), y
dentro de la aplicación, definir parámetro según las variables de usuario.
 
Primero seleccionamos a qué aplicación queremos enviar.
 
 
Una vez seleccionada, veremos que se habilita en azul la condición Y . Clickeándola, obtendremos un
nuevo renglón de definiciones.
En este nuevo renglón, podremos acceder a las variables de usuario que tenemos definida.
 

 
Una vez definida la variable, podremos elegir el operador . El más sencillo de ellos es contiene .
Por último, podemos especificar el texto que debe estar contenido en la variable. En nuestro ejemplo: MX .
 
 
Luego de esto, sólo nos queda seleccionar ENVIAR MENSAJE y aceptar la confirmación que nos pedira luego.
 
 

Tema
Para enviar un mensaje a todos los devices registrados en un tema (en nuestro caso anonimous ) los pasos
de envío son similares al Segmento de usuarios.
La diferencia consiste en que al seleccionar TEMA , nos mostrará un text-box donde podremos elegir el
topic al que le queremos mandar el mensaje.
 
¡IMPORTANTE! Firebase verifica que haya tokens activos en el tópico. Esto nos sirve para verificar que no
erremos al escribir el nombre. En el caso de insistir en el nombre del tópico, un mensaje nos avisará que
ese mensaje no va a llegar a ningún destinatario.
 
 
 

Un único dispositivo
Para enviar un mensaje a un dispositivo específico, es necesario conocer el token del usuario. Por favor,
revisar el documento PUSH-10-QA Circuitos para ver la forma de obtener estos tokens. Esta forma de envío
está pensada más que nada para testeos.
 
Para envíar nuestro mensaje a un token específico, alcanza con seleccionar Un único dispositivo , y
pegar el token tal como se nos solicita.
 
 
 
 
Otras referencias
Aconsejamos visitar al menos las siguientes páginas y videos para una mejor comprensión de este
documento.
 
 
Cómo redactar un mensaje
https://support.google.com/firebase/answer/6394759
 
YOUTUBE : Video enviando mensaje (Español) (Desde 4m 9s)
https://youtu.be/KTQ4d3ZUS8g?t=4m9s
 
YOUTUBE : Video enviando mensaje (Inglés) (Desde 12m 58s) https://youtu.be/ydcMY4J3tJI?t=12m58s
 
DOCUMENTACIÓN : Acerca de los mensajes de FCM
https://firebase.google.com/docs/cloud-messaging/concept-options
 
DOCUMENTACIÓN : Introducción a Firebase Cloud Messaging
https://firebase.google.com/docs/cloud-messaging/