Creare e inviare notifiche push

Nel portale per sviluppatori Apple, passa a Chiavi.

Per creare una chiave, selezionare +.

Fornisci un nome chiave.

Selezionare la casella di controllo Servizio notifiche push Apple (APNs).

Seleziona Continua.

Rivedi la configurazione e seleziona Registra.

Scarica la chiave privata .p8. Viene utilizzato nella configurazione della superficie dell’app più avanti in questa lezione.

Prendere nota dell'ID chiave. Viene utilizzato nella configurazione della superficie dell’app.

Prendi nota dell'ID team. Viene utilizzato nella configurazione della superficie dell’app.

Dall'interfaccia Data Collection, seleziona App Surfaces nel pannello a sinistra.

Per creare una configurazione, seleziona Crea superficie app.

Immetti un Nome per la configurazione, ad esempio Luma App Tutorial.

Da Configurazione applicazione mobile, selezionare Apple iOS.

Immetti l'ID del bundle per app mobile nel campo ID app (ID bundle iOS). Ad esempio, com.adobe.luma.tutorial.swiftui.

Attiva l'interruttore Push Credentials per aggiungere le tue credenziali.

Trascina e rilascia il file .p8 Chiave di autenticazione notifica push Apple.

Specificare l'ID chiave, una stringa di 10 caratteri assegnata durante la creazione della chiave di autenticazione p8. È disponibile nella scheda Chiavi nella pagina Certificati, identificatori e profili delle pagine del portale Apple Developer. Vedi anche Creare una chiave privata.

Fornisci ID team. L'ID team è un valore che si trova nella scheda Appartenenza o nella parte superiore della pagina del portale Apple Developer. Vedi anche Creare una chiave privata.

Seleziona Salva.

Nell'interfaccia utente di Data Collection, seleziona Datastreams e quindi il tuo datastream, ad esempio Luma Mobile App.

Seleziona per Experience Platform e seleziona Modifica dal menu di scelta rapida.

Nella schermata Datastreams > > Adobe Experience Platform:

1. Se non è già selezionato, seleziona Set di dati profilo push AJO da Set di dati profilo. Questo set di dati di profilo è necessario quando si utilizza la chiamata API MobileCore.setPushIdentifier (vedi Registrare il token del dispositivo per le notifiche push) che garantisce che l'identificatore univoco per le notifiche push (ovvero l'identificatore push) sia memorizzato come parte del profilo dell'utente.

2. Adobe Journey Optimizer è selezionato. Per ulteriori informazioni, vedere Impostazioni di Adobe Experience Platform.

3. Per salvare la configurazione dello stream di dati, seleziona Salva.

Passa a Tag > Estensioni > Catalogo,

Apri la proprietà, ad esempio Luma Mobile App Tutorial.

Seleziona Catalogo.

Cerca l'estensione Adobe Journey Optimizer.

Installa l’estensione.

Nella finestra di dialogo Installa estensione

1. Seleziona un ambiente, ad esempio Sviluppo.

2. Seleziona il set di dati dell'evento di tracciamento push di AJO dall'elenco Set di dati evento.

3. Selezionare Salva nella libreria e genera.

   

Consulta la sezione istruzioni di installazione per collegare il simulatore o il dispositivo ad Assurance.

Nell'interfaccia utente Assurance, selezionare Configura.

Seleziona accanto a Debug push.

Seleziona Salva.

Seleziona Debug push dal menu di navigazione a sinistra.

Selezionare la scheda Convalida installazione.

Selezionare il dispositivo dall'elenco Client.

Verifica che non siano presenti errori.

Selezionare la scheda Invia push test.

(facoltativo) Modificare i dettagli predefiniti per Titolo e Corpo

Seleziona Invia notifica push di prova.

Controlla i risultati del test.

Dovresti visualizzare nell’app la notifica push di prova.

{width="300"}

Vai all’app in Xcode.

Selezionare Luma nel Navigatore progetti.

Selezionare la destinazione Luma.

Selezionare la scheda Firma e funzionalità.

Configura Firma gestione automatica, Team e Identificatore bundle oppure utilizza i dettagli specifici del provisioning di sviluppo Apple.

{modal="regular"}

In Xcode, seleziona Luma dall'elenco TARGET, seleziona la scheda Firma e funzionalità, seleziona il pulsante + funzionalità, quindi seleziona Notifiche push. In questo modo l’app può ricevere notifiche push.

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

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

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

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

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

Assicurarsi che AEPMessaging faccia parte dell'elenco delle importazioni.

import AEPMessaging

Assicurarsi che Messaging.self faccia parte dell'array di estensioni che si sta 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
]

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

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

Nell'interfaccia utente di Journey Optimizer, seleziona Schemi dalla barra a sinistra.

Seleziona Sfoglia nella barra delle schede.

Selezionare lo schema, ad esempio Luma Mobile App Event Schema per aprirlo.

Nell’editor schema:

1. Selezionare il campo eventType.

2. Nel riquadro Proprietà campo, scorri verso il basso per visualizzare l'elenco dei valori possibili per il tipo di evento. Selezionare Aggiungi riga e aggiungere application.test come VALORE e Test event for push notification come DISPLAY NAME.

3. Seleziona Applica.

4. Seleziona Salva.

   

Nell'interfaccia utente di Journey Optimizer, seleziona Configurazioni dalla barra a sinistra.

Nella schermata Dashboard, seleziona il pulsante Gestisci nel riquadro Eventi.

Nella schermata Eventi, seleziona Crea evento.

Nel riquadro Modifica evento evento1:

1. Immetti LumaTestEvent come Nome dell'evento.

2. Fornisci una Descrizione, ad esempio Test event to trigger push notifications in Luma app.

3. Seleziona lo schema evento esperienza app mobile creato in precedenza in Crea uno schema XDM dall'elenco Schema, ad esempio Luma Mobile App Event Schema v.1.

4. Seleziona accanto all'elenco Campi.

   

   Nella finestra di dialogo Campi, accertati che siano selezionati i seguenti campi (oltre ai campi predefiniti sempre selezionati (_id, id e timestamp). Utilizzando l'elenco a discesa, puoi scegliere tra Selezionati, Tutti e Primari oppure utilizzare il campo .

   • Applicazione identificata (ID),
   • Tipo evento (eventType),
   • Principale (primario).

   

   Quindi selezionare Ok.

5. Seleziona accanto al campo Condizione ID evento.

   1. Nella finestra di dialogo Aggiungi una condizione ID evento, trascina Tipo evento (eventType) su Trascina e rilascia qui un elemento.

   2. Nel popover, scorri verso il basso e seleziona application.test (che è il tipo di evento aggiunto in precedenza all'elenco dei tipi di evento come parte di Aggiorna lo schema). Quindi scorri verso l'alto e seleziona Ok.

   3. Selezionare Ok per salvare la condizione.

      

6. Selezionare ECID (ECID) dall'elenco Spazio dei nomi. Il campo Identificatore profilo viene compilato automaticamente con ID del primo elemento dell'ECID chiave per la mappa identityMap.

7. Seleziona Salva.

   

Nell'interfaccia utente di Journey Optimizer, seleziona Percorsi dalla barra a sinistra.

Selezionare Crea Percorso.

Nel pannello Proprietà Percorso:

1. Immetti un Nome per il percorso, ad esempio Luma - Test Push Notification Journey.

2. Immetti una Descrizione per il percorso, ad esempio Journey for test push notifications in Luma mobile app.

3. Verificare che Consenti rientro sia selezionato e impostare Periodo di attesa rientro su 30 Secondi.

4. Selezionare Ok.

   

Torna all'area di lavoro del percorso, da EVENTI, trascina e rilascia LumaTestEvent nell'area di lavoro in cui viene visualizzato Seleziona un evento di ingresso o un'attività di lettura pubblico.

• Nel pannello Events: LumaTestEvent, immetti un Label, ad esempio Luma Test Event.

Dal menu a discesa ACTIONS, trascina e rilascia Push sulla visualizzata a destra dell'attività LumaTestEvent. Nel riquadro Azioni: Push:

1. Fornisci un Etichetta, ad esempio Luma Test Push Notification, fornisci una Descrizione, ad esempio Test push notification for Luma mobile app, seleziona Transazionale dall'elenco Categoria e seleziona Luma dalla Superficie push.

2. Seleziona Modifica contenuto per iniziare a modificare la notifica push effettiva.

   

   Nell'editor Notifica push:

   1. Immetti un Titolo, ad esempio Luma Test Push Notification, e un Corpo, ad esempio Test push notification for Luma mobile app.

   2. Se necessario, è possibile immettere un collegamento a un'immagine (.png o .jpg) in Aggiungi file multimediali. In tal caso, l’immagine farà parte della notifica push.

   3. Per salvare e lasciare l'editor, selezionare .

      

3. Per salvare e completare la definizione della notifica push, selezionare Ok.

Il percorso deve essere simile al seguente. Seleziona Publish per pubblicare e attivare il percorso.

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

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

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

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

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, questa volta, prende in considerazione anche gli aspetti asincroni della chiamata all'SDK di Adobe Experience Platform utilizzando il modello di concorrenza di Swift basato su await e async.

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.

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

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

Passa alla scheda Impostazioni.

Tocca Notifica push. Nell’app viene visualizzata la notifica push.

{width="300"}