Creación y envío de notificaciones push

En Apple Developer Portal, vaya a Keys.

Para crear una clave, seleccione +.

Proporcione un Nombre de clave.

Seleccione la casilla de verificación Servicio de notificaciones push de Apple (APN).

Seleccione Continuar.

Revise la configuración y seleccione Registrar.

Descargar la clave privada .p8. Se utiliza en la configuración de la superficie de la aplicación más adelante en esta lección.

Tome nota de la ID de clave. Se utiliza en la configuración de la superficie de la aplicación.

Tome nota de Id. de equipo. Se utiliza en la configuración de la superficie de la aplicación.

En la interfaz de recopilación de datos, seleccione Superficies de la aplicación en el panel izquierdo.

Para crear una configuración, seleccione Crear superficie de aplicación.

Escriba un Nombre para la configuración, por ejemplo Luma App Tutorial .

En Configuración de aplicaciones móviles, seleccione Apple iOS.

Introduzca el ID del paquete de la aplicación móvil en el campo ID de la aplicación (ID del paquete de iOS). Por ejemplo, com.adobe.luma.tutorial.swiftui.

Active la opción Credenciales push para agregar sus credenciales.

Arrastre y suelte su archivo .p8 Clave de autenticación de notificaciones push de Apple.

Proporcione la ID de clave, una cadena de 10 caracteres asignada durante la creación de la clave de autenticación p8. Se encuentra en la ficha Keys de la página Certificados, identificadores y perfiles de las páginas del portal de Apple Developer. Consulte también Crear una clave privada.

Proporcione el ID de equipo. El identificador de equipo es un valor que se encuentra en la ficha Pertenencia o en la parte superior de la página del portal para desarrolladores de Apple. Consulte también Crear una clave privada.

Seleccione Guardar.

En la IU de recopilación de datos, seleccione Datastreams y su secuencia de datos, por ejemplo Luma Mobile App.

Seleccione para Experience Platform y seleccione Editar del menú contextual.

En la pantalla Datastreams > > Adobe Experience Platform:

1. Si aún no está seleccionado, seleccione Conjunto de datos del perfil push de AJO de Conjunto de datos de perfil. Este conjunto de datos de perfil es necesario al usar la llamada API MobileCore.setPushIdentifier (consulte Registrar el token de dispositivo para notificaciones push), que garantiza que el identificador único para notificaciones push (también conocido como identificador push) se almacene como parte del perfil del usuario.

2. Adobe Journey Optimizer está seleccionado. Consulte Configuración de Adobe Experience Platform para obtener más información.

3. Para guardar la configuración de su secuencia de datos, seleccione Guardar.

Vaya a Etiquetas > Extensiones > Catálogo,

Abra su propiedad, por ejemplo Luma Mobile App Tutorial.

Seleccione Catálogo.

Busque la extensión Adobe Journey Optimizer.

Instale la extensión de.

En el diálogo Instalar extensión

1. Seleccione un entorno, por ejemplo Desarrollo.

2. Seleccione el conjunto de datos AJO Push Tracking Experience Event Dataset de la lista Event Dataset.

3. Seleccione Guardar en biblioteca y compilar.

   

Revise la sección instrucciones de configuración para conectar su simulador o dispositivo a Assurance.

En la IU de Assurance, seleccione Configurar.

Seleccione junto a Push Debug.

Seleccione Guardar.

Seleccione Push Debug en el panel de navegación izquierdo.

Seleccione la ficha Validar configuración.

Seleccione su dispositivo de la lista Cliente.

Confirme que no está recibiendo ningún error.

Seleccione la ficha Enviar inserción de prueba.

(opcional) Cambie los detalles predeterminados de Title y Body

Seleccione Enviar notificación push de prueba.

Compruebe resultados de la prueba.

Debería ver la notificación push de prueba en la aplicación.

{width="300"}

Vaya a la aplicación en Xcode.

Seleccione Luma en el navegador de proyectos.

Seleccione el destino Luma.

Seleccione la pestaña Firma y capacidades.

Configure Firma automática de administración, Equipo y Identificador de paquete, o use sus detalles específicos de aprovisionamiento de desarrollo de Apple.

{modal="regular"}

En Xcode, seleccione Luma de la lista TARGETS, seleccione la pestaña Firma y capacidades, seleccione el botón + capacidad y, a continuación, seleccione Notificaciones push. Esto permite que la aplicación reciba notificaciones push.

A continuación, debe añadir una extensión de notificación a la aplicación. Vuelva a la ficha General y seleccione el icono + en la parte inferior de la sección TARGETS.

Se le pedirá que seleccione la plantilla para el nuevo destino. Seleccione Extensión del servicio de notificaciones y, a continuación, seleccione Siguiente.

En la siguiente ventana, use NotificationExtension como nombre de la extensión y haga clic en el botón Finalizar.

En Xcode, asegúrese de que AEP Messaging se añada a la lista de paquetes en Dependencias del paquete. Consulte Administrador De Paquetes Swift.

Vaya a Luma > Luma > AppDelegate en el navegador del proyecto Xcode.

Asegúrese de que AEPMessaging forme parte de su lista de importaciones.

import AEPMessaging

Asegúrese de que Messaging.self forme parte de la matriz de extensiones que está registrando.

let extensions = [
    AEPIdentity.Identity.self,
    Lifecycle.self,
    Signal.self,
    Edge.self,
    AEPEdgeIdentity.Identity.self,
    Consent.self,
    UserProfile.self,
    Places.self,
    Messaging.self,
    Optimize.self,
    Assurance.self
]

Agregar la API MobileCore.setPushIdentifier a la función func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data).

// Send push token to Mobile SDK
MobileCore.setPushIdentifier(deviceToken)

Esta función recupera el token del dispositivo exclusivo del dispositivo en el que está instalada la aplicación. A continuación, establece el token para la entrega de notificaciones push mediante la configuración que ha configurado y que depende del servicio de notificaciones push de Apple (APN).

En la interfaz de usuario de Journey Optimizer, seleccione Esquemas en el carril izquierdo.

Seleccione Examinar en la barra de fichas.

Seleccione el esquema, por ejemplo Luma Mobile App Event Schema para abrirlo.

En el Editor de esquemas:

1. Seleccione el campo eventType.

2. En el panel Propiedades del campo, desplácese hacia abajo para ver la lista de valores posibles para el tipo de evento. Seleccione Agregar fila y agregue application.test como VALUE y Test event for push notification como DISPLAY NAME.

3. Seleccione Aplicar.

4. Seleccione Guardar.

   

En la interfaz de usuario de Journey Optimizer, seleccione Configuraciones en el carril izquierdo.

En la pantalla Tablero, seleccione el botón Administrar en el mosaico Eventos.

En la pantalla Eventos, seleccione Crear evento.

En el panel Editar evento de evento1:

1. Escriba LumaTestEvent como Nombre del evento.

2. Proporcione una descripción, por ejemplo Test event to trigger push notifications in Luma app.

3. Seleccione el esquema del evento de experiencia de la aplicación móvil que creó anteriormente en Crear un esquema XDM desde la lista Esquema, por ejemplo Luma Mobile App Event Schema v.1.

4. Seleccione junto a la lista Campos.

   

   En el cuadro de diálogo Campos, asegúrese de que los siguientes campos estén seleccionados (sobre los campos predeterminados que siempre están seleccionados (_id, id y timestamp)). Con la lista desplegable, puede alternar entre Seleccionado, Todo y Principal, o usar el campo .

   • Aplicación identificada (id.),
   • Tipo de evento (eventType),
   • Principal (principal).

   

   A continuación, seleccione Aceptar.

5. Seleccione junto al campo Condición de ID de evento.

   1. En el cuadro de diálogo Agregar una condición de id. de evento, arrastre y suelte Tipo de evento (eventType) en Arrastrar y soltar un elemento aquí.

   2. En la ventana emergente, desplácese hasta la parte inferior y seleccione application.test (que es el tipo de evento que agregó anteriormente a la lista de tipos de eventos como parte de Actualizar el esquema). A continuación, desplácese hacia arriba y seleccione Aceptar.

   3. Seleccione Aceptar para guardar la condición.

      

6. Seleccione ECID (ECID) de la lista Espacio de nombres. Automáticamente, el campo Identificador de perfil se rellena con El identificador del primer elemento del ECID de clave para el identityMap del mapa.

7. Seleccione Guardar.

   

En la interfaz de usuario de Journey Optimizer, seleccione Recorridos en el carril izquierdo.

Seleccione Crear Recorrido.

En el panel Propiedades del Recorrido:

1. Escriba un Nombre para el recorrido, por ejemplo Luma - Test Push Notification Journey.

2. Escriba una descripción para el recorrido, por ejemplo Journey for test push notifications in Luma mobile app.

3. Asegúrese de seleccionar Permitir la reentrada y establezca Período de espera de reentrada en 30 Segundos.

4. Seleccione Aceptar.

   

En el lienzo del recorrido, en EVENTS, arrastra y suelta tu LumaTestEvent en el lienzo donde se muestra Selecciona un evento de entrada o una actividad de lectura de audiencia.

• En el panel Eventos: LumaTestEvent, escriba una Etiqueta, por ejemplo Luma Test Event.

En el menú desplegable ACCIONES, arrastra y suelta Insertar en el que aparece a la derecha de tu actividad LumaTestEvent. En el panel Acciones: Push:

1. Proporcione una Etiqueta, por ejemplo Luma Test Push Notification, proporcione una Descripción, por ejemplo Test push notification for Luma mobile app, seleccione Transaccional de la lista Categoría y seleccione Luma de la Superficie de inserción.

2. Seleccione Editar contenido para comenzar a editar la notificación push real.

   

   En el editor de notificaciones push:

   1. Escriba un Título, por ejemplo Luma Test Push Notification y un Cuerpo, por ejemplo Test push notification for Luma mobile app.

   2. Opcionalmente, puede escribir un vínculo a una imagen (.png o .jpg) en Agregar medios. Si lo hace, la imagen formará parte de la notificación push.

   3. Para guardar y salir del editor, selecciona .

      

3. Para guardar y finalizar la definición de la notificación push, seleccione Aceptar.

El recorrido debe ser similar al siguiente. Seleccione Publish para publicar y activar su recorrido.

Vaya a Luma > Luma > Modelo > XDM > TestPushPayload en el navegador del proyecto Xcode e inspeccione el código.

import Foundation

// MARK: - TestPush
struct TestPushPayload: Codable {
   let application: Application
   let eventType: String
}

// MARK: - Application
struct Application: Codable {
   let id: String
}

El código es una representación de la siguiente carga útil simple que va a enviar al déclencheur de su recorrido de notificaciones push de prueba

{
   "eventType": string,
   "application" : [
       "id": string
   ]
}

Vaya a Luma > Luma > Utils > MobileSDK en el navegador del proyecto Xcode y agregue el siguiente código a func sendTestPushEvent(applicationId: String, eventType: String):

// Create payload and send experience event
Task {
    let testPushPayload = TestPushPayload(
        application: Application(
            id: applicationId
        ),
        eventType: eventType
    )
    // send the final experience event
    await sendExperienceEvent(
        xdm: testPushPayload.asDictionary() ?? [:]
    )
}

Este código crea una instancia de testPushPayload utilizando los parámetros proporcionados a la función (applicationId y eventType) y, a continuación, llama a sendExperienceEvent mientras convierte la carga útil en un diccionario. Este código, esta vez, también tiene en cuenta los aspectos asíncronos de llamar al SDK de Adobe Experience Platform mediante el modelo de concurrencia de Swift basado en await y async.

Vaya a Luma > Luma > Views > General > ConfigView en el navegador del proyecto Xcode. En la definición del botón de notificación push, añada el siguiente código para enviar la carga útil del evento de experiencia de notificación push de prueba al déclencheur del recorrido cada vez que se pulse ese botón.

// Setting parameters and calling function to send push notification
Task {
    let eventType = testPushEventType
    let applicationId = Bundle.main.bundleIdentifier ?? "No bundle id found"
    await MobileSDK.shared.sendTestPushEvent(applicationId: applicationId, eventType: eventType)
}

Vuelva a compilar y ejecute la aplicación en el simulador o en un dispositivo físico desde Xcode con .

Vaya a la ficha Configuración.

Pulse Notificación push. Verá aparecer la notificación push en la aplicación.

{width="300"}