Creación y envío de notificaciones push

Los siguientes pasos no son específicos de Adobe Experience Cloud y están diseñados para guiarle a través de la configuración de APNS.

1. En Apple Developer Portal, vaya a Keys.

2. Para crear una clave, seleccione +.

   {modal="regular"}

3. Proporcione un Nombre de clave.

4. Seleccione Servicio de notificaciones push de Apple (APN) y seleccione Configurar.

   1. En la pantalla Configurar clave, seleccione Zona protegida y producción del menú desplegable Entorno.
   2. Seleccione Guardar.

5. Seleccione Continuar.

   {modal="regular"}

6. Revise la configuración y seleccione Registrar.

7. Descargar la clave privada .p8. Se utiliza en el siguiente ejercicio cuando configura las credenciales push de Journey Optimizer.

8. Tome nota de la ID de clave. Se utiliza en el siguiente ejercicio cuando configura las credenciales push de Journey Optimizer.

9. Tome nota de Id. de equipo. Se utiliza en el siguiente ejercicio cuando configura las credenciales push de Journey Optimizer. El ID de equipo se encuentra en la parte superior derecha de la pantalla, junto al nombre de inicio de sesión.
   {modal="regular"}

Encontrará documentación adicional aquí.

Los siguientes pasos no son específicos de Adobe Experience Cloud y están diseñados para guiarle a través de la configuración de Firebase.

1. Acceda a la consola de Firebase.

2. Seleccione Crear un proyecto de Firebase.

   1. Escriba un nombre de proyecto.
   2. Seleccione Continuar en Crear un proyecto - Empecemos con un nombre para su proyecto. Por ejemplo, Luma Android App.
   3. Deshabilite Gemini en Firebase y seleccione Continuar en Crear un proyecto - Asistencia de IA para su proyecto Firebase.
   4. Deshabilite Google Analytics para este proyecto y seleccione Continuar en Crear un proyecto - Google Analytics para su proyecto Firebase.
   5. Seleccione Crear proyecto.
   6. Una vez que el proyecto esté listo, seleccione Continuar.

3. Vuelva a la consola de Firebase y asegúrese de que el proyecto esté seleccionado en la parte superior. Por ejemplo, aplicación para Android de Luma.

   {modal="regular"}

4. Seleccione > Configuración del proyecto.

5. En Configuración del proyecto, seleccione Agregar aplicación.

   1. En Agregar Firebase a su aplicación, seleccione Android como plataforma.

   2. En Agregar Firebase a su aplicación de Android:

      1. En el paso 1, Registrar aplicación:

         1. Introduzca un nombre de paquete Android, similar al identificador de la aplicación. Por ejemplo, com.adobe.luma.tutorial.android.
         2. Escriba un apodo de aplicación opcional.
         3. Seleccione Registrar aplicación.

      2. En el paso 2, Descargue y luego agregue el archivo de configuración.

         1. Seleccione Descargar google-services.json. Cuando genere su propia versión de la aplicación de Android, debe reemplazar el archivo google-services.json actual en el proyecto de Android Studio de ejemplo con la versión del archivo que genera esta nueva configuración de la aplicación.
            Los demás pasos se tratan en la aplicación de ejemplo.

   La pantalla debería tener un aspecto similar al siguiente:

   {modal="regular"}

6. En Configuración del proyecto, seleccione Cuentas de servicio.

7. Seleccione Generar nueva clave privada. Se genera un archivo de luma-android-app-firebase-adminsdk-xxxx-xxxxxxxx.json. Guarde este archivo en un lugar seguro, ya que lo necesitará en una etapa posterior.

Para obtener más información, consulte la documentación para desarrolladores de Firebase.

1. 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. Esta selección permite que la aplicación reciba notificaciones push.

2. 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.

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

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

Ahora debería tener una extensión de notificación push agregada a la aplicación, similar a la pantalla siguiente.

{modal="regular"}

El proyecto de Android Studio ya está configurado para las notificaciones push. No es necesario que realice pasos adicionales para habilitar la versión de Android de la aplicación Luma para las notificaciones push. Consulte Acerca de las notificaciones para obtener más información.

Las notificaciones push de Android requieren que defina un id de canal de notificación, tanto en la aplicación como al enviar una notificación push. El id. de notificación de canal utilizado en la aplicación de Android Luma es LUMA_CHANNEL ID.

1. En Xcode, asegúrese de que Mensajería de AEP se agrega a la lista de paquetes en Dependencias del paquete. Consulte Administrador De Paquetes Swift.

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

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

   import AEPMessaging

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

   code language-swift
   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 ]

1. En Android Studio, asegúrese de que aepsdk-messaing-android forme parte de las dependencias de build.gradle.kts (Módulo :app) en Android Gradle Scripts. Ver Gradle.

2. Vaya a Android > app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication en el navegador de proyectos de Android Studio.

3. Asegúrese de que com.adobe.marketing.mobile.Messaging forme parte de su lista de importaciones.

   import import com.adobe.marketing.mobile.Messaging

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

   code language-kotlin
   val extensions = listOf( Identity.EXTENSION, Lifecycle.EXTENSION, Signal.EXTENSION, Edge.EXTENSION, Consent.EXTENSION, UserProfile.EXTENSION, Places.EXTENSION, Messaging.EXTENSION, Optimize.EXTENSION, Assurance.EXTENSION )

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

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

   code language-swift
   // 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).

1. Vaya a Android > app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication en el navegador de proyectos de Android Studio.

2. Agregue la API MobileCore.setPushIdentifier a la función override fun onCreate() en class LumaAplication : Application, en FirebaseMessaging.getInstance().token.addOnCompleteListener.

   code language-kotlin
   // Send push token to Mobile SDK MobileCore.setPushIdentifier(token)

   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 de Firebase Cloud Messaging (FCM).

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

   code language-swift
   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.

   code language-json
   { "eventType": string, "application" : [ "id": string ] }

2. 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):

   code language-swift
   // 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 también tiene en cuenta los aspectos asíncronos de llamar a Adobe Experience Platform SDK mediante el uso del modelo de concurrencia de Swift, basado en await y async.

3. 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.

   code language-swift
   // 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) }

1. Vaya a Android > app > kotlin+java > com.adobe.luma.tutorial.android > xdm > TestPushPayload.kt en el navegador de Android Studio e inspeccione el código.

   code language-kotlin

   import com.google.gson.annotations.SerializedName data class TestPushPayload( @SerializedName("application") val application: Application, @SerializedName("eventType") val eventType: String ) { fun asMap(): Map<String, Any> { return mapOf( "application" to application.asMap(), "eventType" to eventType ) } } data class Application( @SerializedName("id") val id: String ) { fun asMap(): Map<String, Any> { return mapOf( "id" to id ) } }

   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.

   code language-json
   { "eventType": string, "application" : [ "id": string ] }

2. Vaya a Android > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK en el navegador de Android Studio y agregue el siguiente código a func sendTestPushEvent(applicationId: String, eventType: String):

   code language-kotlin
   // Create payload and send experience event val testPushPayload = TestPushPayload( Application(applicationId), eventType ) sendExperienceEvent(testPushPayload.asMap())

   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 mapa.

3. Vaya a Android > app > kotlin+java > com.adobe.luma.android.tutorial > views > ConfigView.kt en el navegador de Android Studio. 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.

   code language-kotlin
   // Setting parameters and calling function to send push notification val eventType = testPushEventType val applicationId = context.packageName scope.launch { MobileSDK.shared.sendTestPushEvent( applicationId, eventType ) }

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

2. Vaya a la ficha Configuración.

3. Pulse Notificación push.

   Verá la notificación push en la parte superior de la aplicación.

   {width="300"}

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

2. Vaya a la ficha Configuración.

3. Pulse Notificación push.

   Verá la notificación push en la parte superior de la aplicación.

   {width="300"}