Show Menu
TEMAS×

Notificaciones push

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 a las notificaciones push.
Las notificaciones push no están garantizadas; son más como anuncios. Se hace el 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 unas pocas tecnologías diferentes. En primer lugar, se debe utilizar un proveedor de servicios 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: Amazon Simple Notification Service (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:
  1. Se crea una notificación push en AEM y se envía al proveedor de servicios (Amazon SNS o Pushwoosh).
  2. El proveedor de servicios lo recibe y lo envía al proveedor principal (APNS o GCM).
  3. El proveedor principal envía la notificación a todos los dispositivos registrados para esa notificación push. Para cada dispositivo utiliza la red de datos móviles o WiFi, lo que esté disponible en el dispositivo.
  4. La notificación se muestra en el dispositivo si la aplicación para la que está registrado no se está ejecutando. Un usuario que toque la notificación iniciará la aplicación y mostrará la notificación dentro de la aplicación. En el caso de que la aplicación ya se esté ejecutando, solo se mostrará la notificación en la aplicación.
Esta versión de AEM admite dispositivos móviles iOS y Android.

Información general y procedimiento

Para utilizar las notificaciones push en una aplicación de AEM Mobile, se deben realizar los siguientes pasos de alto nivel.
Normalmente, un desarrollador de AEM:
  1. Registrarse con los servicios de mensajería de Apple y Google
  2. Regístrese con un servicio de mensajería push y configúrelo
  3. Añadir compatibilidad push a la aplicación
  4. Preparar un teléfono para realizar pruebas
Mientras que un administrador de AEM:
  1. Configuración de push en aplicaciones AEM
  2. Creación e implementación de la aplicación
  3. Enviar una notificación push
  4. Configurar vinculación profunda (opcional)

Paso 1: Registrarse con los servicios de mensajería de Apple y Google

Uso del servicio de notificaciones push de Apple (APNS)

Vaya a la página de Apple aquí para familiarizarse con el servicio de notificaciones push de Apple.
Para utilizar APNS necesitará un archivo de certificado (un archivo .cer), una clave ​privada push (un archivo .p12) y una contraseña de clave privada de Apple. Las instrucciones sobre cómo hacerlo pueden encontrarse aquí .

Uso del servicio Google Cloud Messaging (GCM)

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, activar el servicio GCM y obtener una clave de API. Necesitará la clave de API para enviar notificaciones push a dispositivos Android. Además, registre el número ​de proyecto, que también se denomina a veces Id de remitente GCM.
Los siguientes pasos muestran un método diferente para crear claves de API de GCM:
  1. Inicie sesión en Google y vaya a la página de desarrolladores de Google.
  2. Elija la aplicación de la lista (o cree una nueva).
  3. En Nombre del paquete de Android, introduzca su ID de aplicación, por ejemplo: com.adobe.cq.mobile.weretail.outdoorsapp . (Si no funciona, inténtelo nuevamente con "test.test").
  4. Haga clic en Continuar para elegir y configurar servicios
  5. Seleccione Cloud Messaging y, a continuación, haga clic en Habilitar Google Cloud Messaging .
  6. Se mostrarán la nueva clave de API de servidor y el ID del remitente (nuevo o existente).
Registre la clave de API del servidor. Este valor se introduce en el sitio del proveedor push.

Paso 2: Registro y configuración de un servicio de mensajería push

AEM está configurado para utilizar uno de los tres servicios para notificaciones push:
  • SNS de Amazon
  • Pushwoosh
  • Adobe Mobile Services
Las configuraciones de Amazon SNS y Pushwoosh le permitirán enviar datos insertados desde pantallas de AEM.
La configuración de Adobe Mobile Services le 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).

Uso del servicio de mensajería de Amazon SNS

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:
  1. Registrarse con Amazon SNS
    1. Registre su ID de cuenta. El formato debe ser de doce dígitos sin espacios ni guiones, es decir "123456789012".
    2. Asegúrese de que se encuentra en la región "us-east" o "eu", ya que un paso posterior (Creación de grupos de identidades) requiere uno de ellos.
    3. Después de registrarse, inicie sesión en la consola de administración y seleccione SNS (servicio de notificaciones push). Haga clic en "Comenzar" si aparece.
  2. Crear clave de acceso e ID
    1. Haga clic en el nombre de inicio de sesión en la parte superior derecha de la pantalla y elija Credenciales de seguridad en el menú.
    2. Haga clic en Teclas de acceso y, en el espacio siguiente, haga clic en Crear nueva clave de acceso.
    3. Haga clic en Mostrar clave de acceso y copie y guarde la ID de clave de acceso y la clave de acceso secreto que se muestran. Si elige la opción de descargar las claves, obtendrá un archivo csv que contenga esos mismos valores.
    4. En esta página se pueden administrar otros certificados relacionados con la seguridad, entre otros.
    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:
    1. Haga clic en el nombre de inicio de sesión en la parte superior derecha de la pantalla y elija Mis credenciales de seguridad en el menú.
    2. Haga clic en Usuarios en la lista izquierda de acciones y elija su nombre de usuario.
    3. Haga clic en la ficha Credenciales de seguridad.
    4. Desde aquí puede ver sus claves y crear nuevas claves. Guarde las claves para usarlas posteriormente.
  3. Crear un tema
    1. Haga clic en Crear tema y elija un nombre de tema. Registre todos los campos, como ARN del tema, Propietario del tema, Región, Nombre para mostrar.
    2. Haga clic en Otras acciones de tema > Editar directiva de tema. En Permitir que estos usuarios se suscriban a este tema , seleccione Todos.
    3. Haga clic en Actualizar directiva .
    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.
  4. Crear aplicaciones de plataforma
    1. 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:
      1. Para APNS, se debe introducir un archivo P12, una contraseña, un certificado y una clave privada. Estos deberían haberse obtenido en el paso Uso del servicio de notificaciones push de Apple (APNS) anterior.
      2. Para GCM, se debe introducir una clave de API. Esto debería haberse obtenido en el paso anterior Uso del servicio Google Cloud Messaging (GCM).
    2. 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.
  5. Crear un grupo de identidades
    1. Utilice Cognito para crear un grupo de identidades, que almacenará datos básicos de usuarios no autenticados. Tenga en cuenta que solo las regiones "us-east" y "eu" son compatibles con Amazon Cognito en este momento.
    2. Póngale un nombre y marque la casilla "Habilitar el acceso a identidades no autenticadas".
    3. En la página siguiente (" Sus identidades de Cognito requieren acceso a sus recursos "), haga clic en Permitir.
    4. En la parte superior derecha de la página, haga clic en el vínculo " Editar grupo de identidades" . Se muestra el Id. del grupo de identidades. Guarde este texto para más adelante.
    5. En la misma página, elija la lista desplegable junto a "Función no autenticada" y asegúrese de que tiene seleccionada la función Cognito_<nombre del grupo>UnauthRole. Guarde los cambios.
  6. Configurar el acceso
    1. Inicio de sesión en Administración de identidad y acceso (IAM)
    2. Seleccionar funciones
    3. Haga clic en la función creada en el paso anterior, llamada Cognito_<yourIdentityPoolName>Unauth_Role. Registre el "ARN de rol" mostrado.
    4. Abra "Directivas en línea" si aún no se ha abierto. Debe ver una directiva con un nombre como oneClick_Cognito_<yourIdentityPoolName>Unauth_Role_1234567890123.
    5. Haga clic en "Editar directiva". Reemplace el contenido del documento de política con este fragmento de JSON:
    {
    "Versión": "2012-10-17",
    "Declaración": [
    {
    "Acción": [
    "mobileanalytics:PutEvents",
    "cognito-sync:*",
    "SNS:CreatePlatformEndpoint",
    "SNS:Subscribe"
    ],
    "Efecto": "Allow",
    "Medio": [
    "*"
    ]
    }
    ]
    }
    1. Haga clic en Aplicar directiva

Uso del servicio de mensajería Pushwoosh

Si no desea utilizar Pushwoosh, puede omitir este paso.
Para usar Pushwoosh:
  1. Registrarse con Pushwoosh
    1. Vaya a pushwoosh.com y cree una nueva cuenta.
  2. Creación de un autentificador de acceso a API
    1. En el sitio de Pushwoosh, vaya al elemento de menú Acceso a API para generar un autentificador de acceso a API. Tendrá que registrar esto de forma segura.
  3. Crear una aplicación nueva
    1. Para la compatibilidad con Android, debe proporcionar la clave de API de GCM.
    2. Al configurar la aplicación, elija Cordova como marco.
    3. Para la compatibilidad con iOS, debe proporcionar el archivo de certificado (.cer), el certificado push (.p12) y la contraseña de clave privada; estos deberían haberse obtenido en el sitio APNS de Apple. En Marco, elija Cordova.
    4. Pushwoosh generará un ID de aplicación para esa aplicación, en la forma "XXXXX-XXXXX", donde cada X es un valor hexadecimal (de 0 a F).
Si se configura una segunda aplicación en AEM con el mismo ID de aplicación (y otros valores relacionados: (el autentificador de acceso a API y el identificador 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.

Paso 3: Añadir compatibilidad push a la aplicación

Agregar configuración de ContentSync

Cree dos nodos de contenido (uno en app-config y otro en app-config-dev) llamados notificationsConfig:
  • /content/ <your app> /shell/jcr:content/page-app/app-config-dev/notificationsConfig
  • /content/ <your app> /shell/jcr:content/page-app/app-config/notificationsConfig
Con 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=" #" 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.

Agregar bibliotecas de cliente

Las bibliotecas de cliente de notificaciones push deben agregarse a la aplicación siguiendo estos pasos:
En CRXDE Lite:
  1. Vaya a /etc/designs/phonegap/<nombre de la aplicación>/clientlibsall.
  2. Haga doble clic en la sección incrustar del panel de propiedades.
  3. En el cuadro de diálogo que aparece, agregue una nueva biblioteca de cliente haciendo clic en el botón +.
  4. En el nuevo campo de texto, agregue "cq.mobile.push" y haga clic en Aceptar.
  5. Agregue otro llamado cq.mobile.push.amazon y haga clic en Aceptar.
  6. Guarde los cambios.
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.

Paso 4: Preparar un teléfono para realizar pruebas

Para las notificaciones push, debe realizar pruebas en un dispositivo real, ya que los emuladores no pueden recibir notificaciones push.

IOS

Para iOS, deberá utilizar un ordenador con 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.

Android

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.

Paso 5: Configuración de push en aplicaciones AEM

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.
  1. Cree los grupos de autorización adecuados para las notificaciones push.
  2. Inicie sesión en AEM como el usuario adecuado, haga clic en la ficha Aplicaciones.
  3. Haga clic en la aplicación.
  4. Busque el mosaico Administrar servicios de nube y haga clic en el lápiz para modificar las configuraciones de nube.
  5. Seleccione Conexión de Amazon SNS, Conexión de Pushwoosh o Adobe Mobile Services como configuración de notificación.
  6. Introduzca las propiedades del proveedor y haga clic en Enviar para guardarlas y en Finalizado. No se verifican a distancia en esta fase, salvo en el caso de AMS.
  7. Ahora debería ver la configuración que acaba de introducir en el mosaico Administrar servicios de nube.

Paso 6: Creación e implementación de la aplicación

​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 la prueba 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.
  1. 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 de PhoneGap Build para obtener información sobre cómo configurar y utilizar PhoneGap Build.
  2. La interfaz de línea de comandos (CLI) de PhoneGap 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 del desarrollador de PhoneGap para obtener información sobre cómo configurar y utilizar la CLI de PhoneGap.

Paso 7: Enviar una notificación push

Para crear una nueva notificación y enviarla, siga estos pasos.
  1. Crear una nueva notificación
    • En el tablero de su aplicación de AEM Mobile, busque el mosaico Notificaciones push.
    • En el menú de la esquina superior derecha, elija "Crear". Tenga en cuenta que este botón no estará disponible hasta que se configure la configuración de nube por primera vez.
    • En el Asistente para crear notificaciones, escriba un título y un mensaje y, a continuación, haga clic en el botón "Crear". Su notificación ya está lista para enviarse inmediatamente o más tarde. Se puede editar y el mensaje y/o el título se pueden cambiar y guardar.
  2. Enviar la notificación
    • En el tablero Aplicaciones, busque el mosaico Notificaciones push.
    • Seleccione la notificación o haga clic en el botón de detalles en la parte inferior derecha (. . .), para mostrar la lista de notificaciones. Esta lista también indica si una notificación está lista para ser enviada, si ya se ha enviado o si se ha producido un error durante el envío.
    • Seleccione la casilla de verificación de una notificación (solamente) y haga clic en el botón "Enviar notificación" encima de la lista. Tendrá la oportunidad de "Cancelar" o "Enviar" la notificación en el cuadro de diálogo que aparece.
  3. 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 enumerará como Enviado.
    • Si falla el envío push, el cuadro de diálogo mostrará un mensaje que indicará el problema. En la lista de notificaciones, el estado de esa notificación se enumerará como Error, pero si se corrige el problema, la notificación se puede volver a enviar. En caso de 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:
      • La creación con CLI iniciará la aplicación después de implementarla en Android. En iOS, debe iniciarlo manualmente. Dado que el paso de registro push se produce al iniciar, las aplicaciones de Android pueden recibir notificaciones push de inmediato (ya que se iniciarán y se registrarán) mientras que las aplicaciones de iOS no.
      • En Android, el texto del botón Aceptar está en mayúsculas (y en cualquier otro botón que se añada a la notificación en la aplicación), mientras que en iOS no lo está.
Para las notificaciones push de AMS, las notificaciones deben estar compuestas y enviadas desde el servidor de AMS. AMS proporciona funciones de notificación push adicionales a las proporcionadas por las notificaciones de AEM con AWS y Pushwoosh.
Las notificaciones push no están garantizadas; son más como anuncios. Se hace el 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.

Configuración de vinculación profunda con notificaciones push

¿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 del tablero, siga los pasos a continuación.
  1. Haga clic en la edición en la esquina superior derecha del mosaico Administrar servicios de nube.
  2. Seleccione la Conexión Pushwoosh. Haga clic en Siguiente .
  3. Introduzca los detalles de las propiedades y haga clic en Enviar .
    Una vez que haya enviado la configuración, se muestra el mosaico Notificaciones ​push en el tablero.

Crear asistente de notificación

Una vez que se muestre el mosaico Notificaciones ​push en el tablero, utilice el asistente para crear notificaciones para agregar el contenido:
  1. 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 .
  2. 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.
  3. Introduzca los 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 que ha creado desde el mosaico de Notificaciones ​push.
    Puede editar propiedades, enviar notificaciones o eliminar la notificación.
Información adicional :
Pushwoosh y Amazon SNS no serán compatibles con la versión 6.4 y estarán disponibles como complemento desde el recurso compartido de paquetes.

Pasos siguientes

Una vez que conozca los detalles sobre las notificaciones push de la aplicación, consulte Personalización del contenido de AEM Mobile.