Créer et envoyer des notifications push

Sur le portail destiné aux développeurs Apple, accédez à Clés.

Pour créer une clé, sélectionnez +.

Fournissez un nom de clé.

Cochez la case Service de notification push Apple (APNS) .

Sélectionnez Continuer.

Vérifiez la configuration et sélectionnez Enregistrer.

Téléchargez la clé privée .p8. Il est utilisé dans la configuration Surface de l’application plus loin dans cette leçon.

Prenez note de l'ID de clé. Il est utilisé dans la configuration Surface de l’application.

Prenez note de l'ID d'équipe. Il est utilisé dans la configuration Surface de l’application.

Dans l’ interface de collecte de données, sélectionnez App Surfaces dans le panneau de gauche.

Pour créer une configuration, sélectionnez Créer une surface d’application.

Saisissez un Nom pour la configuration, par exemple Luma App Tutorial .

Dans Configuration d'application mobile, sélectionnez Apple iOS.

Saisissez l’ID du lot de l’application mobile dans le champ ID de l’application (ID du lot iOS) . Par exemple, com.adobe.luma.tutorial.swiftui.

Activez la bascule Push Credentials (Informations d’identification push) pour ajouter vos informations d’identification.

Faites glisser et déposez votre fichier .p8 Apple Push Notification Authentication Key .

Fournissez l’ ID de clé, une chaîne de 10 caractères attribuée lors de la création de la clé d’authentification p8. Elle se trouve sous l’onglet Clés de la page Certificats, identifiants et profils des pages du portail du développeur Apple. Voir aussi Création d’une clé privée.

Indiquez l'identifiant d'équipe. L’ID d’équipe est une valeur qui se trouve sous l’onglet Adhésion ou en haut de la page du portail des développeurs Apple. Voir aussi Création d’une clé privée.

Sélectionnez Enregistrer.

Dans l’interface utilisateur de la collecte de données, sélectionnez Datastreams, puis sélectionnez votre flux de données, par exemple Luma Mobile App.

Sélectionnez pour Experience Platform et Modifier dans le menu contextuel.

Dans l’écran Datastreams > > Adobe Experience Platform :

1. Si cette option n’est pas déjà sélectionnée, sélectionnez Jeu de données de profil push AJO dans le jeu de données de profil. Ce jeu de données de profil est requis lors de l’utilisation de l’appel de l’API MobileCore.setPushIdentifier (voir Enregistrer le jeton de l’appareil pour les notifications push) qui garantit que l’identifiant unique des notifications push (ou l’identifiant push) est stocké dans le profil de l’utilisateur.

2. Adobe Journey Optimizer est sélectionné. Voir Paramètres Adobe Experience Platform pour plus d’informations.

3. Pour enregistrer votre configuration de flux de données, sélectionnez Enregistrer.

Accédez à Balises > Extensions > Catalogue,

Ouvrez votre propriété, par exemple Luma Mobile App Tutorial.

Sélectionnez Catalog.

Recherchez l’extension Adobe Journey Optimizer.

Installez l’extension .

Dans la boîte de dialogue Installer l’extension

1. Sélectionnez un environnement, par exemple Développement.

2. Sélectionnez le jeu de données Jeu de données d’événement de suivi d’expérience AJO dans la liste Jeu de données d’événement.

3. Sélectionnez Enregistrer dans la bibliothèque et créer.

   

Consultez la section instructions de configuration pour connecter votre simulateur ou périphérique à Assurance.

Dans l’interface utilisateur d’assurance, sélectionnez Configurer.

Sélectionnez en regard de Débogage push.

Sélectionnez Enregistrer.

Sélectionnez Débogage push dans le volet de navigation de gauche.

Sélectionnez l’onglet Valider la configuration .

Sélectionnez votre appareil dans la liste Client.

Confirmez que vous n’obtenez aucune erreur.

Sélectionnez l’onglet Envoyer le test push .

(Facultatif) Modifiez les détails par défaut pour Title et Body

Sélectionnez Envoyer la notification push de test.

Vérifiez les résultats du test.

La notification push de test devrait apparaître dans votre application.

{width="300"}

Accédez à votre application dans Xcode.

Sélectionnez Luma dans le navigateur de projet.

Sélectionnez la cible Luma.

Sélectionnez l’onglet Signing & Capabilities .

Configurez la gestion automatique de la signature, Team et Bundle Identifier, ou utilisez vos détails de mise en service de développement Apple spécifiques.

{modal="regular"}

Dans Xcode, sélectionnez Luma dans la liste TARGETS, sélectionnez l’onglet Signing & Capabilities, cliquez sur le bouton + Capability, puis sélectionnez Push Notifications. Cela permet à votre application de recevoir des notifications push.

Vous devez ensuite ajouter une extension de notification à l’application. Revenez à l’onglet General et sélectionnez l’icône + au bas de la section TARGETS .

Vous êtes invité à sélectionner le modèle correspondant à votre nouvelle cible. Sélectionnez Extension du service de notification, puis Suivant.

Dans la fenêtre suivante, utilisez NotificationExtension comme nom de l'extension et cliquez sur le bouton Terminer .

Dans Xcode, assurez-vous que AEP Messaging est ajouté à la liste des packages dans les dépendances de modules. Voir Swift Package Manager.

Accédez à Luma > Luma > AppDelegate dans le navigateur de projet Xcode.

Assurez-vous que AEPMessaging fait partie de votre liste d’importations.

import AEPMessaging

Vérifiez que Messaging.self fait partie du tableau des extensions que vous enregistrez.

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
]

Ajoutez l’API MobileCore.setPushIdentifier à la fonction func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data).

// Send push token to Mobile SDK
MobileCore.setPushIdentifier(deviceToken)

Cette fonction récupère le jeton de l’appareil unique sur lequel l’application est installée. Définit ensuite le jeton pour la diffusion de la notification push à l’aide de la configuration que vous avez configurée et qui repose sur le service Apple Push Notification (APN).

Dans l’interface utilisateur de Journey Optimizer, sélectionnez Schémas dans le rail de gauche.

Sélectionnez Parcourir dans la barre d’onglets.

Sélectionnez votre schéma, par exemple Luma Mobile App Event Schema pour l’ouvrir.

Dans l’éditeur de schémas :

1. Sélectionnez le champ eventType .

2. Dans le volet Propriétés du champ, faites défiler l’écran vers le bas pour afficher la liste des valeurs possibles pour le type d’événement. Sélectionnez Ajouter une ligne et ajoutez application.test comme VALUE et Test event for push notification comme DISPLAY NAME.

3. Sélectionnez Appliquer.

4. Sélectionnez Enregistrer.

   

Dans l’interface utilisateur de Journey Optimizer, sélectionnez Configurations dans le rail de gauche.

Dans l’écran Tableau de bord, sélectionnez le bouton Gérer dans la mosaïque Événements.

Dans l’écran Events, sélectionnez Create Event.

Dans le volet Edit event1 :

1. Saisissez LumaTestEvent comme Nom de l’événement.

2. Fournissez une description, par exemple Test event to trigger push notifications in Luma app.

3. Sélectionnez le schéma d’événement d’expérience d’application mobile que vous avez créé précédemment dans Création d’un schéma XDM dans la liste Schéma, par exemple Luma Mobile App Event Schema v.1.

4. Sélectionnez en regard de la liste Fields.

   de l’événement

   Dans la boîte de dialogue Fields, assurez-vous que les champs suivants sont sélectionnés (en plus des champs par défaut toujours sélectionnés (_id, id et timestamp). Vous pouvez basculer, à l’aide de la liste déroulante, entre Sélectionné, Tous et Principal ou utiliser le champ .

   • Application identifiée (id),
   • Type d’événement (eventType),
   • Principal (principal).

   

   Sélectionnez ensuite Ok.

5. Sélectionnez en regard du champ Event id condition.

   1. Dans la boîte de dialogue Ajouter une condition d’ID d’événement, placez Type d’événement (eventType) sur Faites glisser un élément ici.

   2. Dans la fenêtre contextuelle, faites défiler l’écran vers le bas et sélectionnez application.test (qui est le type d’événement que vous avez ajouté précédemment à la liste des types d’événement dans le cadre de la mise à jour de votre schéma). Faites ensuite défiler l’écran jusqu’en haut et sélectionnez Ok.

   3. Sélectionnez Ok pour enregistrer la condition.

      

6. Sélectionnez ECID (ECID) dans la liste Espace de noms. Le champ Identifiant du profil est automatiquement renseigné avec l’identifiant du premier élément de l’ECID clé pour la carte identityMap.

7. Sélectionnez Enregistrer.

   

Dans l’interface utilisateur de Journey Optimizer, sélectionnez Parcours dans le rail de gauche.

Sélectionnez Créer un Parcours.

Dans le panneau Propriétés du Parcours :

1. Saisissez un Nom pour le parcours, par exemple Luma - Test Push Notification Journey.

2. Saisissez une Description pour le parcours, par exemple Journey for test push notifications in Luma mobile app.

3. Assurez-vous que l’option Autoriser la rentrée est sélectionnée et définissez la Période d’attente de rentrée sur 30 Secondes.

4. Cliquez sur OK.

   

De retour dans la zone de travail du parcours, à partir de EVENTS, effectuez un glisser-déposer de votre LumaTestEvent sur la zone de travail où se trouve Sélectionner un événement d’entrée ou une activité de lecture d’audience.

• Dans le panneau Events: LumaTestEvent , saisissez un libellé, par exemple Luma Test Event.

Dans la liste déroulante ACTIONS, effectuez un glisser-déposer de Push sur l’écran apparaissant à droite de votre activité LumaTestEvent. Dans le volet Actions : Push :

1. Fournissez un libellé, par exemple Luma Test Push Notification, fournissez une description, par exemple Test push notification for Luma mobile app, sélectionnez Transactional dans la liste Category et sélectionnez Luma dans la surface push.

2. Sélectionnez Modifier le contenu pour commencer à modifier la notification push réelle.

   

   Dans l’éditeur Notification push :

   1. Saisissez un Titre, par exemple Luma Test Push Notification, puis un Corps, par exemple Test push notification for Luma mobile app.

   2. Vous pouvez éventuellement saisir un lien vers une image (.png ou .jpg) dans Ajouter un média. Si vous le faites, l’image fera partie de la notification push.

   3. Pour enregistrer et quitter l’éditeur, sélectionnez .

      

3. Pour enregistrer et terminer la définition de notification push, sélectionnez Ok.

Votre parcours devrait ressembler à celui-ci. Sélectionnez Publish pour publier et activer votre parcours.

Accédez à Luma > Luma > Modèle > XDM > TestPushPayload dans le navigateur de projet Xcode et inspectez le code.

import Foundation

// MARK: - TestPush
struct TestPushPayload: Codable {
   let application: Application
   let eventType: String
}

// MARK: - Application
struct Application: Codable {
   let id: String
}

Le code est une représentation de la payload simple suivante que vous allez envoyer pour déclencher votre parcours de notification push de test.

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

Accédez à Luma > Luma > Utils > MobileSDK dans le navigateur de projet Xcode et ajoutez le code suivant à 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() ?? [:]
    )
}

Ce code crée une instance testPushPayload à l’aide des paramètres fournis à la fonction (applicationId et eventType), puis appelle sendExperienceEvent lors de la conversion de la charge utile en dictionnaire. Cette fois-ci, ce code prend également en compte les aspects asynchrones de l’appel du SDK Adobe Experience Platform en utilisant le modèle d’accès simultané de Swift basé sur await et async.

Accédez à Luma > Luma > Views > General > ConfigView dans le navigateur de projet Xcode. Dans la définition du bouton de notification push, ajoutez le code suivant pour envoyer la payload de l’événement d’expérience de notification push de test afin de déclencher votre parcours lorsque ce bouton est activé.

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

Recréez et exécutez l’application dans le simulateur ou sur un appareil physique à partir de Xcode, en utilisant .

Accédez à l’onglet Paramètres .

Appuyez sur Notification push. La notification push apparaît dans votre application.

{width="300"}