Adobe recomienda el uso del Editor de SPA para proyectos que requieren una representación de cliente basada en el marco de aplicaciones de una sola página (por ejemplo, React). Más información.
Poder avisar instantáneamente a los usuarios de la aplicación de AEM Mobile con notificaciones importantes es crucial para el valor de una aplicación móvil y sus campañas de marketing. Aquí describimos los pasos que deben seguirse para permitir que la aplicación reciba notificaciones push y cómo configurar y enviar notificaciones push desde AEM Mobile a la aplicación instalada en el teléfono. Además, en esta sección se describe cómo configurar la función Vinculación profunda para las notificaciones push.
Las notificaciones push no tienen envío garantizado; son más como anuncios. Se hace el mejor esfuerzo para asegurarse de que todos los demás los reciban, pero no son un mecanismo de envío garantizado. Además, el tiempo para enviar una notificación push puede variar de menos de un segundo a media hora.
El uso de notificaciones push con AEM requiere unas tecnologías diferentes. En primer lugar, se debe utilizar un proveedor de servicio de notificaciones push para administrar las notificaciones y los dispositivos (AEM aún no lo hace). Hay dos proveedores configurados de forma predeterminada con AEM: Servicio de notificación simple de Amazon (o SNS) y Pushwoosh. En segundo lugar, la tecnología push para un sistema operativo móvil determinado debe pasar por el servicio adecuado — Servicio de notificaciones push de Apple (o APNS) para dispositivos iOS; y Google Cloud Messaging (o GCM) para dispositivos Android. Aunque AEM no se comunica directamente con estos servicios específicos de la plataforma, AEM debe proporcionar cierta información de configuración relacionada junto con las notificaciones para que estos servicios ejecuten la notificación push.
Una vez instalado y configurado (como se explica a continuación) funciona de esta manera:
Esta versión de AEM admite dispositivos móviles iOS y Android.
Para utilizar las notificaciones push en una aplicación de AEM Mobile, deben realizarse los siguientes pasos de alto nivel.
Normalmente, un desarrollador AEM:
Mientras que un administrador AEM:
Vaya a la página de Apple aquí para familiarizarse con el servicio de notificaciones push de Apple.
Para utilizar APNS, necesitará un archivo Certificate (un archivo .cer), una push Private Key (un archivo .p12) y una Private Key Password de Apple. Las instrucciones sobre cómo hacerlo pueden encontrarse aquí.
Google está reemplazando GCM con un servicio similar llamado Firebase Cloud Messaging (FCM). Para obtener más información sobre FCM, haga clic aquí.
Vaya a la página de Google aquí para familiarizarse con Google Cloud Messaging para Android.
Deberá seguir los pasos aquí para Crear un proyecto de Google API, Habilitar el servicio GCM y Obtener una clave de API. Necesitará la clave de API para enviar notificaciones push a dispositivos Android. Además, registre su Número de proyecto, que a veces también se denomina Id de remitente de GCM.
Los siguientes pasos muestran un método diferente para crear claves de API de GCM:
com.adobe.cq.mobile.weretail.outdoorsapp
. (Si no funciona, inténtelo nuevamente con "test.test").Registre la clave de API del servidor. Este valor se introduce en el sitio del proveedor push.
AEM está configurado para usar uno de los tres servicios para notificaciones push:
Las configuraciones SNS y ** Pushwoshte de Amazon le permitirán enviar datos insertados desde AEM pantallas.
La configuración de Adobe Mobile Services permite configurar y enviar notificaciones push desde Adobe Mobile Services mediante una cuenta de Adobe Analytics (pero la aplicación debe crearse con este conjunto de configuración para activar las notificaciones push de AMS).
Puede encontrar información sobre Amazon SNS y un vínculo para crear una nueva cuenta de AWS aquí. Puede obtener una cuenta gratuita durante un año.
Si no desea utilizar Amazon SNS, puede omitir estos pasos.
Siga estos pasos para configurar Amazon SNS para notificaciones push:
Registrarse con Amazon SNS
Crear clave de acceso e ID
Se puede usar una clave de acceso para varias aplicaciones.
Para las organizaciones que utilizan una cuenta de "Simulador para pruebas de AWS", los pasos son muy similares y se describen a continuación:
Crear un tema
Puede crear varios temas para distintos escenarios, como dev, test, demo, etc. El resto de la configuración de SNS puede seguir siendo la misma. Cree la aplicación con el tema diferente; las notificaciones push enviadas a ese tema solo serán recibidas por la aplicación creada con ese tema.
Crear aplicaciones de plataforma
Haga clic en Aplicaciones y, a continuación, en Crear aplicación de plataforma. Elija un nombre y seleccione una plataforma (APNS para iOS, GCM para Android). En función de la plataforma, deberán rellenarse otros campos:
Repita el paso anterior una vez para cada plataforma que admita. Para poder insertar tanto en iOS como en Android, se deben crear dos aplicaciones de plataforma.
Crear un grupo de identidades
Configurar el acceso
{ "Versión": "2012-10-17", "Declaración": [ { "Acción": [ "mobileanalytics:PutEvents", "cognito-sync:*", "SNS:CreatePlatformEndpoint", "SNS:Subscribe" ], "Efecto": "Allow", "Medio": [ "*" ] } ] }
|
Si no desea utilizar Pushwoosh, puede omitir este paso.
Para usar Pushwoosh:
Registrarse con Pushwoosh
Creación de un Token de acceso de API
Crear una aplicación nueva
Si se configura una segunda aplicación en AEM con el mismo ID de aplicación (y otros valores relacionados: TOKEN DE ACCESO de API e ID de GCM), cualquier notificación push enviada a través de la segunda aplicación en AEM irá a cualquier otra aplicación con ese ID de aplicación.
Cree dos nodos de contenido (uno en app-config y otro en app-config-dev) llamados notificationsConfig:
<your app>
/shell/jcr:content/page-app/app-config-dev/notificationsConfig<your app>
/shell/jcr:content/page-app/app-config/notificationsConfigCon estas propiedades (archivos .content.xml):
<jcr:root xmlns:jcr=" https://www.jcp.org/jcr/1.0" xmlns:nt=" https://www.jcp.org/jcr/nt/1.0">
jcr:PrimaryType="nt:unstructure"
excludeProperties="[appAPIAccessToken]"
path="…/…/…/…"
targetRootDirectory="www"
type="notificationsconfig"/>
El controlador de sincronización de contenido busca esos nodos y, si no están allí, no escribe el archivo page-notifications-config.json.
Las bibliotecas de cliente de notificaciones push deben agregarse a la aplicación siguiendo estos pasos:
En CRXDE Lite:
Si las notificaciones push se eliminan o no se utilizan por consideraciones de espacio en la aplicación y para evitar mensajes de error de la consola, elimine estos clientes de la aplicación.
Para las notificaciones push, debe realizar pruebas en un dispositivo real, ya que los emuladores no pueden recibir notificaciones push.
Para iOS deberá utilizar un equipo Mac OS y unirse al Programa para desarrolladores de iOS. Algunas corporaciones tienen licencias corporativas que pueden estar disponibles para todos los desarrolladores.
Con XCode 8.1, antes de utilizar las notificaciones push, debe ir a la ficha Capacidades del proyecto y activar la opción Notificaciones push.
Para instalar la aplicación en un teléfono Android mediante CLI (consulte a continuación: Paso 6: Cree e implemente la aplicación), primero debe poner el teléfono en "modo de desarrollador". Consulte Activación de las opciones de desarrollador en el dispositivo para obtener más información sobre cómo hacerlo.
Antes de compilar e implementar en el dispositivo móvil configurado, debe configurar las opciones de notificación para el servicio de mensajería que decidió utilizar.
Nota: Consulte también nuestras instrucciones 🔗 aquí sobre la creación de aplicaciones PhoneGap.
Existen dos formas de crear e implementar la aplicación mediante PhoneGap.
Nota: Para las pruebas de notificaciones push, los emuladores no serán suficientes porque las notificaciones push utilizan un protocolo distinto entre el proveedor push (Apple o Google) y el dispositivo. El hardware y los emuladores actuales de Mac/PC no admiten esto.
PhoneGap Builder es un servicio ofrecido por PhoneGap que creará su aplicación en sus servidores y le permitirá descargarla directamente en su dispositivo. Consulte la documentación de PhoneGap Build para obtener información sobre cómo configurar y utilizar PhoneGap Build.
La interfaz de línea de comandos de PhoneGap (CLI) le permite utilizar un completo conjunto de comandos de PhoneGap en la línea de comandos para crear, depurar e implementar la aplicación. Consulte la documentación para desarrolladores de PhoneGap para obtener información sobre cómo configurar y utilizar la CLI de PhoneGap.
Para crear una nueva notificación y enviarla, siga estos pasos.
Crear una nueva notificación
Enviar la notificación
Tratamiento de los resultados
Si el servicio de notificaciones push (Amazon SNS o Pushwoosh) recibe la solicitud de envío, la confirma como válida y la envía a los proveedores nativos (APNS y GCM) correctamente, el cuadro de diálogo de envío se cerrará sin mensaje. En la lista de notificación, el estado de la notificación se indicará como Enviada.
Si falla el envío push, el cuadro de diálogo mostrará un mensaje que indicará el problema. En la lista de notificación, el estado de esa notificación se mostrará como Error, pero si se corrige el problema, la notificación se podrá volver a enviar. En el evento de un error, debe aparecer información adicional sobre el error en el registro de errores del servidor.
Tenga en cuenta que existen algunas diferencias de plataforma entre las notificaciones push de iOS y Android. Entre ellos:
Para las notificaciones push de AMS, las notificaciones deben estar compuestas y enviadas desde el servidor de AMS. AMS proporciona capacidades adicionales de notificación push más allá de las que proporcionan las notificaciones AEM con AWS y Pushwoosh.
Las notificaciones push no tienen envío garantizado; son más como anuncios. Se hace el mejor esfuerzo para asegurarse de que todos lo escuchen, pero no son un mecanismo de envío garantizado. Además, el tiempo para enviar una notificación push puede variar de menos de un segundo a media hora.
¿Qué es la vinculación profunda? En el contexto de una notificación push, es un medio para permitir que una aplicación se abra o dirija (si está abierta) a una ubicación específica dentro de la aplicación.
¿Cómo funciona? El autor de una notificación push agrega opcionalmente una etiqueta de botón (p. ej. "¡Muéstrame!") a la notificación y elige la página que desea vincular en la notificación, a través de un navegador de rutas visuales. Cuando se envía, la pulsación se produce de la forma normal, excepto que en el mensaje en la aplicación, el botón Aceptar se reemplaza por el botón "Rechazar" y se especifica el nuevo botón ("¡Mostrar!") también aparece. Al hacer clic en el botón nuevo, la aplicación pasará a la página especificada dentro de la aplicación. Al hacer clic en Descartar, simplemente se descartará el mensaje.
Si la aplicación no está abierta, el sombreado aparecerá como normal. Si se realiza una acción en la notificación a la sombra, se abrirá la aplicación y, a continuación, se presentarán al usuario los botones de vínculo profundo en función de la configuración de la notificación push.
Cree la notificación, agregue un texto de botón y una ruta de vínculo para el vínculo profundo opcional:
.Para acceder al mosaico de notificaciones push de su panel, siga los pasos a continuación.
Haga clic en la edición en la esquina superior derecha del mosaico Administrar Cloud Services.
Seleccione la Conexión de Pushwoosh. Haga clic en Siguiente.
Introduzca los detalles de las propiedades y haga clic en Enviar.
Cuando se envía la configuración, se muestra el icono Notificaciones push en el panel.
Una vez que se muestre el mosaico Notificaciones push en el panel, utilice el asistente para crear notificaciones para agregar contenido:
Haga clic en el símbolo de adición en la esquina superior derecha del mosaico Notificaciones push para abrir el Asistente para crear notificaciones.
Al hacer clic en el icono Examinar de la ruta del vínculo, se muestra al usuario la estructura de contenido de la aplicación.
Una vez seleccionada la ruta, haga clic en el icono de verificación.
El texto del botón Vínculo está limitado a 20 caracteres.
Si el usuario final no tiene la versión más reciente de la aplicación y la ruta de acceso vinculada no está disponible, la confirmación de la acción del vínculo profundo llevará al usuario a la página principal de la aplicación.
Escriba Detalles de texto en el Asistente para crear notificación y haga clic en Crear.
Para abrir los detalles, haga clic en la notificación push que creó en el mosaico Notificaciones push.
Puede editar propiedades, enviar notificaciones o eliminar la notificación.
Información adicional:
Pushwoosh y Amazon SNS no serán compatibles después de la versión 6.4 y estarán disponibles como complemento desde el recurso compartido de paquetes.
Una vez que conozca los detalles de las notificaciones push para su aplicación, consulte Personalización del contenido de AEM Mobile.