Creare e inviare notifiche push

I passaggi seguenti non sono specifici per Adobe Experience Cloud e sono progettati per guidarti nella configurazione di APN.

1. Nel portale per sviluppatori Apple, passa a Chiavi.

2. Per creare una chiave, selezionare +.

   {modal="regular"}

3. Fornisci un nome chiave.

4. Seleziona Servizio di notifica push di Apple (APNs), quindi seleziona Configura.

   1. Nella schermata Configura chiave, seleziona Sandbox e produzione dal menu a discesa Ambiente.
   2. Seleziona Salva.

5. Seleziona Continua.

   {modal="regular"}

6. Rivedi la configurazione e seleziona Registra.

7. Scarica la chiave privata .p8. Viene utilizzato nell’esercizio successivo quando configuri le credenziali push di Journey Optimizer.

8. Prendere nota dell'ID chiave. Viene utilizzato nell’esercizio successivo quando configuri le credenziali push di Journey Optimizer.

9. Prendi nota dell'ID team. Viene utilizzato nell’esercizio successivo quando configuri le credenziali push di Journey Optimizer. L’ID del team si trova in alto a destra, accanto al nome di accesso.
   {modal="regular"}

Ulteriori informazioni sono disponibili qui.

I passaggi seguenti non sono specifici per Adobe Experience Cloud e sono progettati per guidarti nella configurazione di Firebase.

1. Accedi alla console Firebase.

2. Selezionare Crea un progetto Firebase.

   1. Immetti un nome progetto.
   2. Seleziona Continua in Crea un progetto - Iniziamo con un nome per il progetto. Ad esempio, Luma Android App.
   3. Disabilita Gemini in Firebase e seleziona Continua in Crea un progetto - Assistenza IA per il progetto Firebase.
   4. Disabilita Google Analytics per questo progetto e seleziona Continua in Crea un progetto - Google Analytics per il tuo progetto Firebase.
   5. Selezionare Crea progetto.
   6. Quando il progetto è pronto, selezionare Continua.

3. Nella console Firebase, accertati che il progetto sia selezionato in alto. Ad esempio, App Android Luma.

   {modal="regular"}

4. Selezionare > Impostazioni progetto.

5. In Impostazioni progetto, selezionare Aggiungi app.

   1. In Aggiungi Firebase all'app, seleziona Android come piattaforma.

   2. In Aggiungi Firebase all'app Android:

      1. Nel passaggio 1, Registra app:

         1. Immetti un nome per il pacchetto Android, simile all'identificatore dell'app. Ad esempio, com.adobe.luma.tutorial.android.
         2. Immettere un nome alternativo app facoltativo.
         3. Seleziona Registra app.

      2. Nel passaggio 2, Scaricare e aggiungere il file di configurazione.

         1. Seleziona Scarica google-services.json. Quando crei la tua versione dell'app Android, devi sostituire il file google-services.json corrente nel progetto Android Studio di esempio con la versione del file generato da questa nuova configurazione dell'app.
            Gli altri passaggi vengono gestiti già nell’app di esempio.

   Lo schermo dovrebbe essere simile al seguente:

   {modal="regular"}

6. In Impostazioni progetto, selezionare Account servizio.

7. Seleziona Genera nuova chiave privata. È stato generato un file luma-android-app-firebase-adminsdk-xxxx-xxxxxxxx.json. Archivia il file in un luogo sicuro, poiché è necessario in una fase successiva.

Per ulteriori informazioni, consulta la documentazione per gli sviluppatori di Firebase.

1. In Xcode, seleziona Luma dall'elenco TARGET, seleziona la scheda Firma e funzionalità, seleziona il pulsante + funzionalità, quindi seleziona Notifiche push. Questa selezione consente all’app di ricevere notifiche push.

2. Quindi, devi aggiungere un’estensione di notifica all’app. Torna alla scheda General e seleziona l'icona + nella parte inferiore della sezione TARGET.

3. Viene richiesto di selezionare il modello per la nuova destinazione. Seleziona Estensione del servizio di notifica, quindi seleziona Successivo.

4. Nella finestra successiva, utilizza NotificationExtension come nome dell'estensione e fai clic sul pulsante Fine.

Ora dovresti avere aggiunto all’app un’estensione per le notifiche push, simile alla schermata seguente.

{modal="regular"}

Il progetto Android Studio è già configurato per le notifiche push. Non è necessario eseguire ulteriori passaggi per abilitare la versione Android dell’app Luma per le notifiche push. Per ulteriori informazioni, vedere Informazioni sulle notifiche.

Le notifiche push in Android richiedono la definizione di un ID canale di notifica, sia nell’app che durante l’invio di una notifica push. L'ID di notifica del canale utilizzato nell'app Android Luma è LUMA_CHANNEL ID.

1. In Xcode, accertati che Messaggistica AEP sia aggiunto all'elenco dei pacchetti nelle dipendenze dei pacchetti. Consulta Gestione pacchetti Swift.

2. Passa a Luma > Luma > AppDelegate nel Navigatore progetti Xcode.

3. Assicurarsi che AEPMessaging faccia parte dell'elenco delle importazioni.

   import AEPMessaging

4. Assicurarsi che Messaging.self faccia parte dell'array di estensioni che si sta 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. In Android Studio, assicurati che aepsdk-messaing-android faccia parte delle dipendenze in build.gradle.kts (Modulo :app) in Android Script Gradle. Vedi Gradle.

2. Passa a Android > app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication nel Navigatore progetti di Android Studio.

3. Assicurarsi che com.adobe.marketing.mobile.Messaging faccia parte dell'elenco delle importazioni.

   import import com.adobe.marketing.mobile.Messaging

4. Assicurarsi che Messaging.EXTENSION faccia parte dell'array di estensioni che si sta 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. Passa a Luma > Luma > AppDelegate nel Navigatore progetti Xcode.

2. Aggiungere l'API MobileCore.setPushIdentifier alla funzione func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data).

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

   Questa funzione recupera il token del dispositivo univoco per il dispositivo su cui è installata l’app. Quindi imposta il token per la consegna delle notifiche push utilizzando la configurazione impostata e che si basa sul servizio APN (Push Notification Service) di Apple.

1. Passa a Android > app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication nel Navigatore progetti di Android Studio.

2. Aggiungere l'API MobileCore.setPushIdentifier alla funzione override fun onCreate() in class LumaAplication : Application, in FirebaseMessaging.getInstance().token.addOnCompleteListener.

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

   Questa funzione recupera il token del dispositivo univoco per il dispositivo su cui è installata l’app. Imposta quindi il token per il recapito delle notifiche push utilizzando la configurazione configurata e basata su Firebase Cloud Messaging (FCM).

1. Passa a Luma > Luma > Modello > XDM > TestPushPayload nel Navigatore progetti Xcode e controlla il codice.

   code language-swift
   import Foundation // MARK: - TestPush struct TestPushPayload: Codable { let application: Application let eventType: String } // MARK: - Application struct Application: Codable { let id: String }

   Il codice è una rappresentazione del seguente semplice payload che stai per inviare per attivare il percorso di notifica push di prova.

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

2. Passa a Luma > Luma > Utils > MobileSDK nel navigatore progetti Xcode e aggiungi il seguente codice 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() ?? [:] ) }

   Questo codice crea un'istanza testPushPayload utilizzando i parametri forniti alla funzione (applicationId e eventType), quindi chiama sendExperienceEvent durante la conversione del payload in un dizionario. Questo codice prende in considerazione anche gli aspetti asincroni della chiamata a Adobe Experience Platform SDK tramite l'utilizzo del modello di concorrenza di Swift, basato su await e async.

3. Passa a Luma > Luma > Views > General > ConfigView nel navigatore progetti Xcode. Nella definizione del pulsante di notifica push, aggiungi il seguente codice per inviare il payload dell’evento di esperienza di notifica push di prova in modo da attivare il percorso ogni volta che il pulsante viene toccato.

   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. Passa a Android > app > kotlin+java > com.adobe.luma.tutorial.android > xdm > TestPushPayload.kt nel navigatore di Android Studio e ispeziona il codice.

   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 ) } }

   Il codice è una rappresentazione del seguente semplice payload che stai per inviare per attivare il percorso di notifica push di prova.

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

2. Passa a Android > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK nel navigatore di Android Studio e aggiungi il seguente codice 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())

   Questo codice crea un'istanza testPushPayload utilizzando i parametri forniti alla funzione (applicationId e eventType), quindi chiama sendExperienceEvent durante la conversione del payload in una mappa.

3. Passa a Android > app > kotlin+java > com.adobe.luma.android.tutorial > views > ConfigView.kt nel navigatore di Android Studio. Nella definizione del pulsante di notifica push, aggiungi il seguente codice per inviare il payload dell’evento di esperienza di notifica push di prova in modo da attivare il percorso ogni volta che il pulsante viene toccato.

   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. Rigenera ed esegui l'app nel simulatore o su un dispositivo fisico da Xcode, utilizzando .

2. Passa alla scheda Impostazioni.

3. Tocca Notifica push.

   La notifica push viene visualizzata sopra l’app.

   {width="300"}

1. Rigenera ed esegui l'app nel simulatore o su un dispositivo fisico da Android Studio, utilizzando .

2. Passa alla scheda Impostazioni.

3. Tocca Notifica push.

   La notifica push viene visualizzata sopra l’app.

   {width="300"}