Adobe recomienda utilizar el Editor de SPA para proyectos que requieren una representación del lado del cliente basada en el marco de aplicaciones de una sola página (por ejemplo, React). Más información.
Poder alertar 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 se deben seguir para permitir que la aplicación reciba notificaciones push y cómo configurar y enviar mensajes push desde AEM Mobile a la aplicación instalada por teléfono. Además, en esta sección se describe cómo configurar la variable Enlaces profundos para las notificaciones push.
Las notificaciones push no están garantizadas para la entrega; son más como anuncios. Se realiza un mejor esfuerzo para asegurarse de que todos los usuarios los reciban, pero no son un mecanismo de entrega 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 algunas tecnologías diferentes. En primer lugar, se debe utilizar un proveedor de servicios de notificaciones push para administrar notificaciones y dispositivos (AEM aún no lo hace). Hay dos proveedores configurados de forma predeterminada con AEM: Servicio de notificaciones simples de Amazon (o SNS) y Pushwoosh. En segundo lugar, la tecnología push para el sistema operativo móvil determinado debe pasar por el servicio adecuado: Servicio de notificaciones push (o APNS) de Apple 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 parte de la 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 es compatible con dispositivos móviles iOS y Android.
Para utilizar notificaciones push en una aplicación de AEM Mobile, se deben seguir los siguientes pasos de alto nivel.
Normalmente, un desarrollador de AEM:
Mientras que un administrador AEM:
Vaya a la página de Apple . here para familiarizarse con el servicio de notificaciones push de Apple.
Para utilizar APNS, necesitará un Certificado (un archivo .cer), una notificación push Clave privada (un archivo .p12) y Contraseña de clave privada de Apple. Se pueden encontrar instrucciones sobre cómo hacerlo here.
Google está reemplazando GCM con un servicio similar llamado Firebase Cloud Messaging (FCM). Para obtener más información sobre FCM, haga clic en here.
Vaya a la página de Google . here para familiarizarse con Google Cloud Messaging para Android.
Debe seguir los pasos here a Creación de un proyecto de API de Google, Habilitar el servicio GCM y Obtener una clave de API. Necesitará la variable 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. del remitente GCM.
Los siguientes pasos muestran un método diferente para crear claves de API de GCM:
com.adobe.cq.mobile.weretail.outdoorsapp
. (Si eso no funciona, vuelva a intentarlo con "test.test").Registre la clave de API del servidor. Este valor se introduce en el sitio del proveedor push.
AEM está configurado para utilizar uno de los tres servicios para las notificaciones push:
SNS de Amazon y Pushwoosh las configuraciones le permiten enviar mensajes insertados desde dentro de AEM pantallas.
Adobe Mobile Services permite configurar y enviar notificaciones push desde Adobe Mobile Services con una cuenta de Adobe Analytics (pero la aplicación debe crearse con este conjunto de configuración para habilitar las notificaciones push de AMS).
Encontrará información sobre Amazon SNS y un vínculo para crear una nueva cuenta de AWS here. 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:
Regístrese en Amazon SNS
Crear clave de acceso e ID
Se puede usar una clave de acceso para varias aplicaciones.
Para las organizaciones que usan una cuenta "AWS Sandbox", los pasos son muy similares y se describen aquí:
Crear un tema
Puede crear varios temas para distintos escenarios, como desarrollo, prueba, demostración, 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 las recibirá la aplicación creada con ese tema.
Creación de 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). Según la plataforma, se deberán rellenar otros campos:
Repita el paso anterior una vez para cada plataforma que admita. Para poder insertar tanto iOS como 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": "Permitir", "Recurso": [ "*" ] } ] }
|
Si no desea utilizar Pushwoosh, puede omitir este paso.
Para usar Pushwoosh:
Regístrese en 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 a la API y el ID de GCM), cualquier notificación push enviada a través de la segunda aplicación 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=" <span id=" translate="no" />https://www.jcp.org/jcr/1.0" xmlns:nt=" https://www.jcp.org/jcr/nt/1.0" jcr:primaryType="nt:unstructured" excludeProperties="[appAPIAccessToken]" path="…/…/…/…/…"
🔗
targetRootDirectory="www" type="notificationsconfig"/>
El controlador de sincronización de contenido busca esos nodos y, si no están presentes, 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 usan por consideraciones de espacio en la aplicación y para evitar mensajes de error de la consola, elimine estos clientlibs 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á usar un equipo Mac OS y unirse a la 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 pestaña Funcionalidades 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: Creación e implementación de la aplicación), primero debe poner el teléfono en "modo desarrollador". Consulte Activación de las opciones del desarrollador en el dispositivo para obtener más información sobre cómo hacerlo.
Antes de crear e implementar en el dispositivo móvil configurado, debe configurar la configuración de notificación para el servicio de mensajería que ha decidido utilizar.
Nota: Consulte también nuestras instrucciones here al crear aplicaciones de 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 son compatibles con esto.
PhoneGap Build 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 del PhoneGap Build para aprender a configurar y utilizar PhoneGap Build.
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 su aplicación. Consulte la Documentación para desarrolladores de PhoneGap para aprender a configurar y utilizar la CLI de PhoneGap.
Para crear una nueva notificación y enviarla, siga estos pasos.
Creación de 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 ningún mensaje. En la lista de notificaciones, el estado de esa notificación se enumera como Enviado.
Si la notificación push falla, el cuadro de diálogo mostrará un mensaje que indicará el problema. En la lista de notificaciones, el estado de esa notificación aparece como Error, pero si el problema se corrige, la notificación se puede enviar de nuevo. En caso de error, debe aparecer información de error adicional en el registro de errores del servidor.
Tenga en cuenta que existen algunas diferencias entre las plataformas 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 AMS. AMS proporciona funciones de notificación push adicionales, además de las proporcionadas por las notificaciones AEM con AWS y Pushwoosh.
Las notificaciones push no están garantizadas para la entrega; son más como anuncios. Se realiza un mejor esfuerzo para asegurarse de que todos lo escuchen, pero no son un mecanismo de entrega 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 se dirija (si está abierta) a una ubicación especificada 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 explorador 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 el nuevo botón especificado ("Mostrar") también aparece. Al hacer clic en el nuevo botón, la aplicación pasará a la página especificada dentro de la aplicación. Al hacer clic en Rechazar , se descartará el mensaje.
Si la aplicación no está abierta, el sombreado aparecerá como de costumbre. 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 basados en lo configurado en la notificación push.
Cree la notificación y añada un texto de botón y una ruta de vínculo para el vínculo profundo opcional:
.Para acceder al mosaico de notificaciones push en el tablero, siga los pasos a continuación.
Haga clic en la edición en la esquina superior derecha del Administrar Cloud Services mosaico.
Seleccione el Conexión Pushwoosh. Haga clic en Siguiente.
Introduzca los detalles de las propiedades y haga clic en Submit.
Una vez que envíe la configuración, Notificaciones push el mosaico se muestra en el tablero.
Una vez que la variable Notificaciones push El mosaico se muestra en el tablero, utilice el asistente crear notificación para añadir el contenido:
Haga clic en el símbolo add en la esquina superior derecha del 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 de vínculo está limitado a 20 caracteres.
Si el usuario final no tiene la última versión de la aplicación y la ruta vinculada no está disponible, confirmar la acción del vínculo profundo llevará al usuario a la página principal de la aplicación.
Introduzca la variable Detalles de texto en el Asistente para crear notificaciones y haga clic en Crear.
Para abrir los detalles, haga clic en la notificación push creada en la Notificaciones push mosaico.
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 del paquete compartido.
Una vez que conozca los detalles sobre las notificaciones push para su aplicación, consulte Personalización del contenido de AEM Mobile.