Creación y envío de notificaciones push

En el portal para desarrolladores de Apple, vaya a Claves.

Para crear una clave, seleccione +.

Proporcione un Nombre de clave.

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

Seleccionar Continuar.

Revise la configuración y seleccione Registrar.

Descargue la .p8 clave privada. 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 la Identificador de equipo. Se utiliza en la configuración de la superficie de la aplicación.

Desde el Interfaz de recopilación de datos, seleccione Superficies de aplicación en el panel izquierdo.

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

Introduzca una Nombre para la configuración, por ejemplo Luma App Tutorial .

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

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

Encienda el Credenciales push alterne para añadir sus credenciales.

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

Proporcione el ID de clave, una cadena de 10 caracteres asignada durante la creación de p8 clave de autenticación. Se encuentra en la sección Claves en la pestaña Certificados, identificadores y perfiles de las páginas del portal para desarrolladores de Apple. Consulte también Crear una clave privada.

Proporcione el Identificador de equipo. El identificador de equipo es un valor que se encuentra en Suscripción o en la parte superior de la página de Apple Developer portal. Consulte también Crear una clave privada.

Seleccione Guardar.

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

Seleccionar para Experience Platform y seleccione Editar en el menú contextual.

En el Datastreams > > Adobe Experience Platform pantalla:

1. Si no está seleccionada, seleccione Conjunto de datos del perfil push AJO de Conjunto de datos de perfil. Este conjunto de datos de perfil es necesario al utilizar MobileCore.setPushIdentifier Llamada de API (consulte Registrar token de dispositivo para notificaciones push), que garantiza que el identificador único de las 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 la secuencia de datos, seleccione Guardar.

Vaya a Etiquetas > Extensiones > Catálogo,

Abra la propiedad, por ejemplo Luma Mobile App Tutorial.

Seleccionar Catálogo.

Busque la variable Adobe Journey Optimizer extensión.

Instale la extensión de.

En el Instalar extensión diálogo

1. Seleccione un entorno, por ejemplo Desarrollo.

2. Seleccione el Conjunto de datos de evento de experiencia de seguimiento push AJO conjunto de datos del Conjunto de datos de evento lista.

3. Seleccionar Guardar en biblioteca y crear.

   

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

En la IU de Assurance, seleccione Configurar.

Seleccionar junto a Depuración push.

Seleccione Guardar.

Seleccionar Depuración push en el panel de navegación izquierdo.

Seleccione el Validar configuración pestaña.

Seleccione el dispositivo en la Cliente lista.

Confirme que no está recibiendo ningún error.

Seleccione el Enviar inserción de prueba pestaña.

(opcional) Cambie los detalles predeterminados de Título y Cuerpo

Seleccionar Enviar notificación push de prueba.

Compruebe la Resultados de prueba.

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

{width="300"}

Vaya a la aplicación en Xcode.

Seleccionar Luma en el navegador del proyecto.

Seleccione el Luma objetivo.

Seleccione el Firma y capacidades pestaña.

Configurar Administrar firma automáticamente, Equipo, y Identificador de paquete o use los detalles específicos de aprovisionamiento de desarrollo de Apple.

{modal="regular"}

En Xcode, seleccione Luma desde el OBJETIVOS , seleccione la Firma y capacidades , seleccione la pestaña + Funcionalidad botón, luego 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 General y seleccione la pestaña + en la parte inferior de la OBJETIVOS sección.

Se le pedirá que seleccione la plantilla para el nuevo destino. Seleccionar Extensión de servicio de notificaciones luego seleccione Siguiente.

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

En Xcode, asegúrese de que Mensajería AEP se añade 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.

Asegurar AEPMessaging forma parte de su lista de importaciones.

import AEPMessaging

Asegurar Messaging.self forma 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
]

Añada el MobileCore.setPushIdentifier API para func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) función.

// 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 IU de Journey Optimizer, seleccione Esquemas desde el carril izquierdo.

Seleccionar Examinar en la barra de pestañas.

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

En el Editor de esquemas:

1. Seleccione el eventType field.

2. En el Propiedades del campo , desplácese hacia abajo para ver la lista de valores posibles para el tipo de evento. Seleccionar Añadir fila y agregue. application.test como el VALOR y Test event for push notification como el DISPLAY NAME.

3. Seleccione Aplicar.

4. Seleccione Guardar.

   

En la IU de Journey Optimizer, seleccione Configuraciones desde el carril izquierdo.

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

En el Eventos pantalla, seleccione Crear evento.

En el Editar evento1 panel:

1. Entrar LumaTestEvent como el Nombre del evento.

2. Proporcione un 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 creado anteriormente en Creación de un esquema XDM desde el Esquema , por ejemplo Luma Mobile App Event Schema v.1.

4. Seleccionar junto al Campos lista.

   

   En el Campos , asegúrese de que los siguientes campos están seleccionados (sobre los campos predeterminados que siempre están seleccionados (_id, id, y timestamp)). Mediante la lista desplegable, puede alternar entre Seleccionado, Todo y Principal o use el field.

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

   

   A continuación seleccione Ok.

5. Seleccionar junto al Condición de ID de evento field.

   1. En el Añadir una condición de ID de evento diálogo, arrastrar y soltar Tipo de evento (eventType) en a Arrastre y suelte 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 Ok.

   3. Seleccionar Ok para guardar la condición.

      

6. Seleccionar ECID (ECID) desde el Área de nombres lista. Automáticamente el Identificador de perfil el campo se rellena con El ID del primer elemento del ECID de clave para el identityMap de mapa.

7. Seleccione Guardar.

   

En la IU de Journey Optimizer, seleccione Recorridos desde el carril izquierdo.

Seleccionar Crear Recorrido.

En el Propiedades de recorrido panel:

1. Introduzca una Nombre para el recorrido, por ejemplo Luma - Test Push Notification Journey.

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

3. Asegurar Permitir la reentrada está seleccionado y configurado Período de espera de reentrada hasta 30 Seconds.

4. Seleccionar Ok.

   

De vuelta en el lienzo de recorrido, de la EVENTOS, arrastre y suelte su LumaTestEvent en el lienzo donde se muestra Seleccione un evento de entrada o una actividad de audiencia de lectura.

• En el Eventos: LumaTestEvent , introduzca un Etiqueta, por ejemplo Luma Test Event.

Desde el ACCIONES desplegable, arrastrar y soltar Push en el a la derecha de su LumaTestEvent actividad. En el Acciones: push panel:

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

2. Seleccionar Editar contenido para empezar a editar la notificación push real.

   

   En el Notificación push editor:

   1. Introduzca una Título, por ejemplo Luma Test Push Notification e introduzca un Cuerpo, por ejemplo Test push notification for Luma mobile app.

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

   3. Para guardar y salir del editor, seleccione .

      

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

El recorrido debe ser similar al siguiente. Seleccionar Publish para publicar y activar el 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 añada 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 un testPushPayload usando los parámetros proporcionados a la función (applicationId y eventType) y luego llama a sendExperienceEvent al convertir 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 mediante .

Vaya a la Configuración pestaña.

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

{width="300"}