Notificaciones push push-notifications
Poder alertar instantáneamente a los usuarios de aplicaciones móviles de Adobe Experience Manager AEM () con notificaciones importantes es crucial para el valor de una aplicación móvil y sus campañas de marketing. Aquí se describen los pasos que debe seguir para permitir que la aplicación reciba notificaciones push. También aprenderá a configurar y enviar mensajes 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.
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 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:
- AEM Se crea una notificación push en el y se envía al proveedor de servicios (Amazon SNS o Pushwoosh).
- El proveedor de servicios lo recibe y lo envía al proveedor principal (APNS o GCM).
- El proveedor principal inserta la notificación en todos los dispositivos registrados para esa notificación push. Para cada dispositivo, utiliza la red de datos móviles o WiFi, la que esté disponible en el dispositivo.
- La notificación se muestra en el dispositivo si la aplicación para la que está registrada no se está ejecutando. Un usuario que pulsa la notificación inicia la aplicación y muestra la notificación dentro de la aplicación. En caso de que la aplicación ya se esté ejecutando, solo se mostrará la notificación dentro de la aplicación.
AEM Esta versión de es compatible con dispositivos móviles iOS y Android™.
Información general y procedimiento overview-and-procedure
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:
- Regístrese en los servicios de mensajería de Apple y Google
- Regístrese en un servicio de mensajería push y configúrelo
- Añadir la compatibilidad push a la aplicación
- Preparar un teléfono para probarlo
Mientras que un Experience Manager Administrator hace lo siguiente:
- AEM Configuración de notificaciones push en aplicaciones de
- Creación e implementación de la aplicación
- Enviar una notificación push
- Configuración de la vinculación profunda (opcional)
Paso 1: Regístrese en los servicios de mensajería de Apple y Google step-register-with-apple-and-google-messaging-services
Uso del servicio de notificaciones push de Apple (APNS) using-the-apple-push-notification-service-apns
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í.
Uso del servicio Google Cloud Messaging (GCM) using-the-google-cloud-messaging-gcm-service
Vaya a la página de Google. aquí para familiarizarse con Google Cloud Messaging para Android™.
Siga estos pasos hasta Creación de un proyecto de API de Google, Habilitar el servicio GCM, y Obtener una clave API. Necesita 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 siguientes pasos muestran un método diferente de crear claves de API GCM:
- Inicie sesión en Google y vaya a Página para desarrolladores de Google.
- Elija su aplicación en la lista (o cree una).
- En Nombre del paquete de Android™, introduzca su ID de aplicación, es decir,
com.adobe.cq.mobile.weretail.outdoorsapp. (Si esto no funciona, inténtelo de nuevo con "test.test"). - Clic Continuar para elegir y configurar servicios
- Seleccione Mensajería en la nube y haga clic en Habilitar la mensajería de Google Cloud.
- A continuación, se mostrarán la nueva clave de API de servidor y el ID de remitente (nuevo o existente).
Paso 2: Registro y configuración de un servicio de mensajería push step-register-and-configure-a-push-messaging-service
AEM Se configura para que utilice uno de los tres servicios de notificaciones push:
- SNS de Amazon
- Pushwoosh
- Adobe Mobile Services
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 para habilitar las notificaciones push de AMS).
Uso del servicio de mensajería SNS de Amazon using-the-amazon-sns-messaging-service
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
- Registre su ID de cuenta. El formato debe ser de 12 dígitos sin espacios ni guiones, es decir, "123456789012".
- Asegúrese de que se encuentra en la región "us-east" o "eu", ya que un paso posterior (Creación del grupo de identidad) requiere uno de ellos.
- 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.
-
Crear clave e ID de acceso
- Haga clic en el nombre de inicio de sesión en la parte superior derecha de la pantalla y seleccione Credenciales de seguridad en el menú.
- Haga clic en Teclas de acceso y, en el espacio siguiente, haga clic en Crear nueva clave de acceso.
- Clic Mostrar clave de acceso y copie y guarde el ID de clave de acceso y la clave de acceso secreta que se muestran. Si elige la opción para descargar las claves, obtendrá un archivo CSV que contiene esos mismos valores.
- En esta página se pueden administrar otros certificados relacionados con la seguridad y otros.
note note NOTE 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 similares y se describen a continuación:
- Haga clic en su nombre de inicio de sesión en la parte superior derecha de la pantalla y elija Mis credenciales de seguridad en el menú.
- Haga clic en Usuarios en la lista izquierda de acciones y elija su nombre de usuario.
- Haga clic en la ficha Credenciales de seguridad.
- Desde aquí, verá sus claves y creará nuevas claves. Guarde las claves para usarlas más adelante.
-
Crear un tema
- Clic Crear tema y elija un nombre de tema. Registre todos los campos, como ARN del tema, Propietario del tema, Región y Nombre para mostrar.
- Clic Otras acciones de temas > Editar política de tema. En Permitir que estos usuarios se suscriban a este tema, seleccione Todos.
- Clic Actualizar directiva.
note note NOTE Puede crear varios temas para diferentes escenarios, como desarrollo, prueba y demostración. 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 deben rellenar otros campos:
- 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) arriba.
- Para GCM, se debe introducir una clave de API. Esto se debería haber obtenido en el paso Uso del servicio Google Cloud Messaging (GCM) arriba.
-
Repita el paso anterior una vez para cada plataforma compatible. Para poder insertar iOS y Android™, se deben crear dos aplicaciones de plataforma.
-
-
Crear un grupo de identidad
- Uso Cognito para crear un grupo de identidad, que almacenará datos básicos de usuarios no autenticados. Tenga en cuenta que actualmente solo las regiones "us-east" y "eu" son compatibles con Amazon Cognito.
- Asigne un nombre y marque la casilla de "Habilitar el acceso a identidades no autenticadas".
- En la página siguiente ("Sus identidades de Cognito requieren acceso a sus recursos") haga clic en Permitir.
- En la parte superior derecha de la página, haga clic en el enlace "Editar grupo de identidad". Se muestra el ID del grupo de identidad. Guarde este texto para más adelante.
- En la misma página, elija la lista desplegable junto a "Función no autenticada" y asegúrese de que tiene la función Cognito_<pool name="">UnauthRole seleccionado. Guarde los cambios.
-
Configuración del acceso
- Iniciar sesión en Administración de acceso e identidad (IAM).
- Seleccione Roles.
- Haga clic en el rol creado en el paso anterior, llamado Cognito_<youridentitypoolname>Unauth_Role. Registre el "ARN de la función" mostrado.
- Abra "Directivas en línea" si aún no lo está. Debería ver allí una directiva con un nombre como oneClick_Cognito_<youridentitypoolname>Unauth_Role_1234567890123.
- Haga clic en "Editar política". Reemplace el contenido del documento de política por este fragmento de JSON:
table 0-row-1 html-authored no-header {
"Versión": "17-10-2012",
"Instrucción": [
{
"Acción": [
"mobileanalytics:PutEvents",
"cognito-sync:*",
"SNS:CreatePlatformEndpoint",
"SNS:Suscribirse"
],
"Efecto": "Permitir",
"Recurso": [
"*"
]
}
]
}
- Clic Aplicar directiva.
Uso del servicio de mensajería de Pushwoosh using-the-pushwoosh-messaging-service
Si no desea utilizar Pushwoosh, puede omitir este paso.
Para usar Pushwoosh:
-
Registrarse en Pushwoosh
- Vaya a pushwoosh.com y cree una cuenta.
-
Creación de un token de acceso a API
- En el sitio de Pushwoosh, vaya al elemento de menú Acceso a API para generar un token de acceso a API. Registre este token de forma segura.
-
Crear una aplicación
- Para la compatibilidad con Android™, debe proporcionar la clave de API GCM.
- Al configurar la aplicación, elija Cordova como marco de trabajo.
- Para que sea compatible con iOS, debe proporcionar el archivo de certificado (.cer), el certificado push (.p12) y la contraseña de clave privada; estos deben haberse obtenido del sitio APNS de Apple. Para Framework, elija Cordova.
- Pushwoosh generará un ID de aplicación para esa aplicación, con el formato "XXXXX-XXXXX", donde cada X es un valor hexadecimal (0 a F).
Paso 3: Agregar compatibilidad push a la aplicación step-add-push-support-to-the-app
Añadir configuración de ContentSync add-contentsync-configuration
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=" <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"/>
Añadir bibliotecas de cliente add-client-libraries
Las bibliotecas de cliente de notificaciones push deben agregarse a la aplicación siguiendo estos pasos:
En el CRXDE Lite:
- Vaya a /etc/designs/phonegap/<app name="">/clientlibsall.
- Haga doble clic en la sección incrustar del panel de propiedades.
- En el cuadro de diálogo que aparece, agregue una biblioteca de cliente haciendo clic en el botón +.
- En el nuevo campo de texto, añada "cq.mobile.push" y haga clic en Aceptar.
- Agregue uno más llamado cq.mobile.push.amazon y haga clic en Aceptar.
- Guarde los cambios.
Paso 4: Preparar un teléfono para pruebas step-prepare-a-phone-for-testing
IOS ios
Para iOS, utilice un equipo con macOS y únase 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 pestaña Funcionalidades del proyecto y activar la opción Notificaciones push.
Android™ android
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.
AEM Paso 5: Configuración de push en aplicaciones de step-configure-push-on-aem-apps
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.
- Cree los grupos de autorización adecuados para las notificaciones push.
- AEM Inicie sesión en la pestaña Aplicaciones, haga clic en la pestaña Aplicaciones, que es el usuario adecuado.
- Haga clic en la aplicación.
- Busque el mosaico Administrar Cloud Service y haga clic en el lápiz para modificar las configuraciones de la nube.
- Seleccione Conexión de Amazon SNS, Conexión Pushwoosh o Adobe Mobile Services como la configuración de notificación.
- Introduzca las propiedades del proveedor y haga clic en Enviar para guardarlas y en Listo. No se verifican a distancia en esta fase, excepto si hay AMS.
- Ahora debería ver la configuración que acaba de introducir en el mosaico Administrar Cloud Service.
Paso 6: Creación e implementación de la aplicación step-build-and-deploy-the-app
Nota: Consulte las 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 en
https://build.phonegap.com/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 (
https://docs.phonegap.com/en/edge/guide_cli_index.md.html#The%20Command-Line%20Interface) para aprender a configurar y utilizar PhoneGap CLI.
Paso 7: Envío de una notificación push step-send-a-push-notification
Para crear y enviar una notificación, siga estos pasos.
-
Creación de una 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, seleccione "Crear". Este botón no está disponible hasta que se establece por primera vez la configuración de la nube.
- En el Asistente para crear notificaciones, introduzca un título y un mensaje y, a continuación, haga clic en el botón "Crear". La notificación ya está lista para enviarse inmediatamente o más tarde. Se puede editar, y el mensaje o el título se pueden cambiar y guardar.
-
Envío de la notificación
- En el panel 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 enviarse, si ya se ha enviado o si se ha producido un error durante la entrega.
- Seleccione la casilla de verificación de una notificación (solo) y haga clic en el botón "Enviar notificación" situado encima de la lista. Tiene la oportunidad de "Cancelar" o "Enviar" la notificación en el cuadro de diálogo que aparece.
-
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 Enviar se cierra sin ningún mensaje. En la lista de notificaciones, el estado de esa notificación se muestra como Enviado.
-
Si el envío push falla, el cuadro de diálogo muestra un mensaje que indica el problema. En la lista de notificaciones, el estado de esa notificación se muestra como Error, pero si se corrige el problema, se puede volver a enviar la notificación. Si se produce un error, debería 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 generación con CLI inicia la aplicación una vez que se haya implementado en Android™. En iOS, debe iniciarlo manualmente. Dado que el paso de registro push se produce al inicio, las aplicaciones de Android™ pueden recibir notificaciones push inmediatamente (porque ya se ha iniciado y registrado), mientras que las aplicaciones de iOS no pueden.
- En Android™, el texto del botón Aceptar aparece en mayúsculas (y en cualquier otro botón añadido en la notificación dentro de la aplicación), mientras que en iOS no.
-
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.
Configuración de la vinculación profunda con notificaciones push configuring-deep-linking-with-push-notifications
¿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 (es decir, "¡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 botón nuevo, la aplicación se dirige a la página especificada de la aplicación. Al hacer clic en Descartar, se expulsa el mensaje.
Si la aplicación no está abierta, la sombra aparece 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:
-
Haga clic en la edición en la esquina superior derecha de la Administración de Cloud Service 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.
Crear asistente de notificación create-notification-wizard
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.
note note NOTE 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.
Pasos siguientes the-next-steps
Una vez que haya comprendido los detalles de las notificaciones push para su aplicación, consulte Personalización de contenido de AEM Mobile.