Creare e inviare notifiche push

Nel portale per sviluppatori di Apple, vai a Chiavi.

Per creare una chiave, seleziona +.

Fornisci un Nome chiave.

Seleziona la Servizio di notifica push di Apple (APN) casella di controllo.

Seleziona Continua.

Rivedi la configurazione e seleziona Registrati.

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

Prendi nota di ID chiave. Viene utilizzato nella configurazione della superficie dell’app.

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

Dalla sezione Interfaccia di Data Collection, seleziona Superfici app 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, seleziona Apple iOS.

Immetti l’ID del bundle dell’app mobile in ID app (ID bundle iOS) campo. Ad esempio: com.adobe.luma.tutorial.swiftui.

Accendere il Credenziali push per aggiungere le credenziali.

Trascina il file .p8 Chiave di autenticazione per notifica push Apple file.

Fornisci ID chiave, stringa di 10 caratteri assegnata durante la creazione di p8 tasto auth. Si trova sotto Chiavi scheda in 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 sezione Iscrizione 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 Flussi di dati e seleziona il flusso di dati, ad esempio Luma Mobile App.

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

In Flussi di dati > > Adobe Experience Platform schermata:

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 MobileCore.setPushIdentifier Chiamata API (vedi Registra token dispositivo per notifiche push) che garantisce che l’identificatore univoco per le notifiche push (ovvero l’identificatore push) venga memorizzato come parte del profilo dell’utente.

2. Adobe Journey Optimizer è selezionato. Consulta Impostazioni Adobe Experience Platform per ulteriori informazioni.

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

Accedi a Tag > Estensioni > Catalogo,

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

Seleziona Catalogo.

Cerca Adobe Journey Optimizer estensione.

Installa l’estensione.

In Installa estensione finestra di dialogo

1. Seleziona un ambiente, ad esempio Sviluppo.

2. Seleziona la Set di dati evento di tracciamento push AJO set di dati da Set di dati evento elenco.

3. Seleziona Salva nella libreria e genera.

   

Rivedi istruzioni di configurazione per collegare il simulatore o il dispositivo ad Assurance.

Nell’interfaccia utente Assurance, seleziona Configura.

Seleziona accanto a Debug push.

Seleziona Salva.

Seleziona Debug push dal menu di navigazione a sinistra.

Seleziona la Convalida configurazione scheda.

Selezionare il dispositivo dalla Client elenco.

Verifica che non siano presenti errori.

Seleziona la Invia messaggio push di prova scheda.

(facoltativo) Modifica dei dettagli predefiniti per Titolo e Corpo

Seleziona Invia notifica push di prova.

Controlla la Risultati del test.

Dovresti visualizzare nell’app la notifica push di prova.

{width="300"}

Vai all’app in Xcode.

Seleziona Luma nel Navigatore progetti.

Seleziona la Luma target.

Seleziona la Firma e funzionalità scheda.

Configura Gestisci firma automatica, Team, e Identificatore bundle, oppure utilizza i dettagli specifici del provisioning per lo sviluppo di Apple.

{modal="regular"}

In Xcode, seleziona Luma dal TARGET , seleziona la Firma e funzionalità , seleziona la scheda + Funzionalità , quindi seleziona Notifiche push. In questo modo l’app può ricevere notifiche push.

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

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 su Fine pulsante.

In Xcode, assicurati che Messaggistica AEP viene aggiunto all’elenco dei pacchetti in Dipendenze dai pacchetti. Consulta Gestione pacchetti Swift.

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

Assicurare AEPMessaging fa parte dell’elenco delle importazioni.

import AEPMessaging

Assicurare Messaging.self fa parte dell’array di estensioni che si stanno 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
]

Aggiungi il MobileCore.setPushIdentifier API per func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) funzione.

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

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

Nell’editor schema:

1. Seleziona la eventType campo.

2. In Proprietà campo , scorri verso il basso per visualizzare l’elenco dei valori possibili per il tipo di evento. Seleziona Aggiungi riga, e aggiungi 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.

In Dashboard , seleziona la Gestisci pulsante in Eventi affiancare.

In Eventi schermata, seleziona Crea evento.

In Modifica evento 1 riquadro:

1. Invio LumaTestEvent come Nome dell’evento.

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

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

4. Seleziona accanto al Campi elenco.

   

   In Campi , accertati che siano selezionati i seguenti campi (oltre ai campi predefiniti sempre selezionati (_id, id, e timestamp). Utilizzando l’elenco a discesa puoi alternare tra Selezionato, Tutti e Principale o utilizza campo.

   • Identificato dall’applicazione (ID),
   • Tipo evento (eventType),
   • Principale (principale).

   

   Quindi seleziona Ok.

5. Seleziona accanto al Condizione ID evento campo.

   1. In Aggiungi una condizione per l’ID evento finestra di dialogo, trascinamento della selezione Tipo evento (eventType) su a Trascina qui un elemento.

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

   3. Seleziona Ok per salvare la condizione.

      

6. Seleziona ECID (ECID) dal Namespace elenco. Automaticamente il Identificatore profilo il campo è compilato 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.

Seleziona Crea Percorso.

In Proprietà percorso pannello:

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

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

3. Assicurare Consenti rientro è selezionato e impostato Periodo di attesa per rientro a 30 Secondi.

4. Seleziona Ok.

   

Tornando all'area di lavoro del percorso, dal EVENTI, trascina LumaTestEvent nell’area di lavoro in cui viene visualizzato Seleziona un evento di ingresso o un’attività di lettura del pubblico.

• In Eventi: LumaTestEvent , immettere un Etichetta, ad esempio Luma Test Event.

Dalla sezione AZIONI menu a discesa, trascinamento della selezione Push il apparendo a destra del LumaTestEvent attività. In Azioni: push riquadro:

1. Fornisci un Etichetta, ad esempio Luma Test Push Notification, fornisci un Descrizione, ad esempio Test push notification for Luma mobile app, seleziona Transazionale dal Categoria elenca e seleziona Luma dal Superficie push.

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

   

   In Notifica push editor:

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

   2. Facoltativamente, puoi inserire 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, seleziona .

      

3. Per salvare e terminare la definizione della notifica push, seleziona Ok.

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

Accedi a Luma > Luma > Modello > XDM > TestPushPayload nel Navigatore progetti Xcode ed esamina 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
   ]
}

Accedi a Luma > Luma > Utils > MobileSDK nel Navigator del progetto 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 testPushPayload che utilizza i parametri forniti alla funzione (applicationId e eventType) e quindi chiamate 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.

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

Vai a Impostazioni scheda.

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

{width="300"}