Adobe SPA recomienda utilizar el Editor de para proyectos que requieran procesamiento del lado del cliente basado en el marco de trabajo de la aplicación 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. A continuación, se describen los pasos que se deben seguir 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 el Vinculación profunda a sus notificaciones push.
Las notificaciones push no son entregas garantizadas, sino más bien anuncios. Se realiza el mejor esfuerzo para asegurarse de que todos los usuarios los reciban, pero no se trata de un mecanismo de envío garantizado. Además, el tiempo para enviar una notificación push puede variar de menos de un segundo a hasta media hora.
AEM El uso de notificaciones push con requiere varias tecnologías diferentes. AEM En primer lugar, se debe utilizar un proveedor de servicios de notificaciones push para administrar notificaciones y dispositivos (aún no lo hace, por el momento). AEM Dos proveedores están configurados de forma predeterminada con la siguiente configuración: Amazon Simple Notification Service (o SNS), y Pushwoosh. En segundo lugar, la tecnología push para el sistema operativo móvil dado debe pasar por el servicio adecuado: el servicio de notificaciones push de Apple (o APNS) para dispositivos iOS y la mensajería en la nube de Google (o GCM) para dispositivos Android. AEM AEM Aunque no se comunica directamente con estos servicios específicos de la plataforma, el usuario 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:
AEM Esta versión de es compatible con dispositivos móviles iOS y Android.
Para utilizar notificaciones push en una aplicación de AEM Mobile, se deben realizar los siguientes pasos generales.
Normalmente, un desarrollador Experience Manager hace lo siguiente:
Mientras que un Experience Manager Administrator hace lo siguiente:
Vaya a la página de Apple. aquí para familiarizarse con el servicio de notificaciones push de Apple.
Para utilizar APNS, necesita un Certificado archivo (un archivo .cer), una notificación push Clave privada (un archivo .p12) y Contraseña de clave privada de Apple. Puede encontrar instrucciones sobre cómo hacerlo aquí.
Google está reemplazando GCM con un servicio similar llamado Firebase Cloud Messaging (FCM). Para obtener más información sobre FCM, haga clic en aquí.
Vaya a la página de Google. aquí para familiarizarse con Google Cloud Messaging para Android.
Tendrá que seguir los pasos aquí hasta Creación de un proyecto de API de Google, Habilitar el servicio GCM, y Obtener una clave API. Necesitará el Clave de API para enviar notificaciones push a dispositivos Android. Además, grabe su Número de proyecto, que a veces también se denomina ID de remitente de GCM.
Los pasos siguientes muestran un método diferente de crear claves de API GCM:
com.adobe.cq.mobile.weretail.outdoorsapp
. (Si esto no funciona, inténtelo de nuevo con "test.test").Registre la clave de API del servidor. Este valor se introduce en el sitio del proveedor push.
AEM Se configura para que utilice uno de los tres servicios de notificaciones push:
SNS de Amazon y Pushwoosh AEM Las configuraciones de le permiten enviar mensajes insertados desde pantallas de la aplicación de.
Adobe Mobile Services La configuración de le permite configurar y enviar notificaciones push desde Adobe Mobile Services con una cuenta de Adobe Analytics (pero la aplicación debe crearse con esta configuración establecida para habilitar las notificaciones push de AMS).
Encontrará información sobre Amazon SNS y un vínculo para crear una nueva cuenta de AWS aquí. Usted puede obtener una cuenta gratuita por un año.
Si no desea utilizar SNS de Amazon, puede omitir estos pasos.
Siga estos pasos para configurar Amazon SNS para notificaciones push:
Regístrese en Amazon SNS
Crear clave e ID de acceso
Se puede usar una clave de acceso para varias aplicaciones.
Para las organizaciones que utilizan una cuenta de "zona protegida de AWS", los pasos son muy similares y se describen a continuación:
Crear un tema
Puede crear varios temas para diferentes 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 otro tema; las notificaciones push enviadas a ese tema solo las recibirá la aplicación creada con ese tema.
Crear aplicaciones de Platform
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 vaya a admitir. Para poder insertar iOS y Android, se deben crear dos aplicaciones de plataforma.
Crear un grupo de identidad
Configurar el acceso
{ "Versión": "17-10-2012", "Declaración": [ { "Acción": [ "mobileanalytics:PutEvents", "cognito-sync:*", "SNS:CreatePlatformEndpoint", "SNS:Suscribirse" ], "Efecto": "Permitir", "Recurso": [ "*" ] } ] }
|
Si no desea utilizar Pushwoosh, puede omitir este paso.
Para usar Pushwoosh:
Registrarse en Pushwoosh
Creación de un token de acceso a API
Crear una aplicación nueva
AEM AEM Si se configura una segunda aplicación con el mismo ID de aplicación (y otros valores relacionados: token de acceso de API e ID de GCM) en el caso de que se configure una segunda aplicación, cualquier notificación push enviada a través de la segunda aplicación en el caso de que se configure la aplicación se enviará a cualquier otra aplicación con ese ID de aplicación en el caso de que se configure una segunda aplicación, en el caso de que se configure una segunda aplicación, con el mismo ID (y otros valores relacionados: token de acceso de API e ID de GCM), cualquier notificación push se enviará a través de la aplicación en el caso de que se vaya a cualquier otra aplicación con ese ID.
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://developer.adobe.com/experience-manager/reference-materials/spec/jcr/1.0/index.html" xmlns:nt=" https://developer.adobe.com/experience-manager/reference-materials/spec/jcr/1.0/index.html" jcr:primaryType="nt:unstructured" excludeProperties="[appAPIAccessToken]" ruta="…/…/…/…/…"
🔗
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 el CRXDE Lite:
Si las notificaciones push se eliminan o no se utilizan, por cuestiones 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á utilizar un equipo con el sistema operativo Mac 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 lo siguiente: Paso 6: Creación e implementación de la aplicación), primero debe poner el teléfono en "modo de desarrollador". Consulte Habilitar las opciones de 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 los ajustes de notificación del servicio de mensajería que decidió utilizar.
Nota: Consulte también nuestras instrucciones aquí al crear aplicaciones de PhoneGap.
Existen dos maneras 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 la aplicación. Consulte la Documentación para desarrolladores de PhoneGap para aprender a configurar y utilizar la CLI de PhoneGap.
Para crear y enviar una nueva notificación, siga estos pasos.
Creación de una nueva notificación
Envío de 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 notificaciones, el estado de esa notificación se muestra como Enviada.
Si el envío push falla, el cuadro de diálogo muestra un mensaje que indica el problema. En la lista de notificación, el estado de esa notificación se muestra como Error, pero si se corrige el problema, la notificación se puede enviar de nuevo. En caso de error, debería aparecer información adicional 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 redactarse y enviarse desde el servidor de AMS. AEM AMS proporciona funciones de notificación push adicionales, además de las proporcionadas por las notificaciones de con AWS y Pushwoosh.
Las notificaciones push no son entregas garantizadas, sino más bien anuncios. Se hace el mejor esfuerzo para asegurarse de que todos lo escuchan, 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 hasta media hora.
¿Qué es la vinculación profunda? En el contexto de una notificación push, permite abrir o dirigir una aplicación (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 (por ejemplo, "¡Mostrarme!") a la notificación y elige la página que desean vincular en la notificación, a través de un explorador de rutas visual. Cuando se envía, la notificación push se produce normalmente, excepto en el mensaje en la aplicación, en el que el botón Aceptar se sustituye por el botón "Descartar" y se especifica el nuevo botón ("Mostrar") también aparece. Al hacer clic en el nuevo botón, la aplicación se dirige a la página especificada de la aplicación. Al hacer clic en Descartar, el mensaje se descartará.
Si la aplicación no está abierta, la sombra aparecerá con normalidad. Al realizar una acción en la notificación en la sombra, se abre la aplicación y, a continuación, se presentan al usuario los botones de vínculo profundo según lo configurado en la notificación push.
Cree la notificación, añada un texto de botón y una ruta de vínculo para el vínculo profundo opcional:
.Para acceder al mosaico Notificación push en el panel, siga los pasos a continuación.
Haga clic en la edición en la esquina superior derecha de la Administración de Cloud Services mosaico.
Seleccione el Conexión de Pushwoosh. Haga clic en Siguiente.
Introduzca los detalles de las propiedades y haga clic en Enviar.
Una vez enviada la configuración, el Notificaciones push el mosaico se muestra en el panel.
Una vez que Notificaciones push El mosaico se muestra en el panel. Utilice el asistente de creación de notificaciones para añadir el contenido:
Haga clic en el símbolo add situado en la esquina superior derecha de la Notificaciones push mosaico para abrir Asistente de creación de notificaciones.
Al hacer clic en el icono de examinar en la ruta de vínculo, se presenta 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, la confirmación de la acción del vínculo profundo lleva al usuario a la página principal de la aplicación.
Introduzca el Detalles de texto en el Asistente de creación de notificaciones y haga clic en Crear.
Abra los detalles haciendo clic en la notificación push que ha creado desde el 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 en el paquete compartido.
Una vez que haya comprendido los detalles de las notificaciones push para su aplicación, consulte Personalización de contenido de AEM Mobile.