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 une Nom de la clé.

Sélectionnez la variable Service de notification push Apple (APNS) .

Sélectionnez Continuer.

Vérifiez la configuration et sélectionnez Enregistrer.

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

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

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

Dans la Interface de collecte de données, sélectionnez Surfaces de l’application 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 .

De Configuration des applications mobiles, sélectionnez Apple iOS.

Saisissez l’ID du lot de l’application mobile dans la ID d’application (ID de bundle iOS) champ . Par exemple : com.adobe.luma.tutorial.swiftui.

Activez l’option Informations d’identification push pour ajouter vos informations d’identification.

Faites glisser et déposez votre .p8 Clé d’authentification des notifications push Apple fichier .

Fournissez les ID de clé, chaîne de 10 caractères attribuée lors de la création de la variable p8 clé auth. Elle se trouve sous la variable Clés dans le Certificats, identifiants et profils page des pages du portail des développeurs 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 la variable Abonnement ou dans la partie supérieure de la page 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électionner pour Experience Platform et sélectionnez Modifier dans le menu contextuel.

Dans le Datastreams > > Adobe Experience Platform écran :

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

2. Adobe Journey Optimizer est sélectionnée. 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électionner Catalogue.

Recherchez le Adobe Journey Optimizer extension .

Installez l’extension .

Dans le Installer l’extension dialog

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

2. Sélectionnez la variable Jeu de données d’événement de suivi push AJO jeu de données à partir du Jeu de données d’événement liste.

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

   

Consultez la section instructions de configuration pour connecter le simulateur ou l’appareil à Assurance.

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

Sélectionner en regard de Débogage Push.

Sélectionnez Enregistrer.

Sélectionner Débogage Push dans le volet de navigation de gauche.

Sélectionnez la variable Validation de la configuration .

Sélectionnez votre périphérique dans le Client liste.

Confirmez que vous n’obtenez aucune erreur.

Sélectionnez la variable Envoyer le test push .

(Facultatif) Modifiez les détails par défaut de la variable Titre et Corps

Sélectionner Envoi de la notification push de test.

Vérifiez les Résultats du test.

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

img-md
w-300

Accédez à votre application dans Xcode.

Sélectionner Luma dans le navigateur de projet.

Sélectionnez la variable Luma cible.

Sélectionnez la variable Signature et fonctionnalités .

Configurer Gestion automatique de la signature, Équipe, et Identifiant du lot ou utilisez les détails de mise en service du développement Apple spécifiques.

{zoomable="yes"}

Dans Xcode, sélectionnez Luma de la CIBLES , sélectionnez la variable Signature et fonctionnalités , sélectionnez l’onglet + Fonctionnalité , puis sélectionnez Notifications push. Cela permet à votre application de recevoir des notifications push.

Vous devez ensuite ajouter une extension de notification à l’application. Revenez au General et sélectionnez l’option + en bas de la page CIBLES .

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

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

Dans Xcode, assurez-vous que Messagerie AEP est ajouté à la liste des modules 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

Assurez-vous 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 la variable MobileCore.setPushIdentifier de l’API func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) de la fonction

// 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électionner 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 la variable eventType champ .

2. Dans le 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électionner Ajouter une ligne et ajoutez application.test comme la propriété VALEUR et Test event for push notification comme la propriété 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 le Tableau de bord sélectionnez l’écran Gérer dans le Événements mosaïque.

Dans le Événements écran, sélectionnez Créer un événement.

Dans le Modifier event1 Volet :

1. Entrée LumaTestEvent comme la propriété 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éer un schéma XDM de la Schéma liste, par exemple Luma Mobile App Event Schema v.1.

4. Sélectionner en regard de Champs liste.

   

   Dans le Champs , assurez-vous que les champs suivants sont sélectionnés (en plus des champs par défaut qui sont toujours sélectionnés (_id, id, et timestamp). Vous pouvez basculer entre les Sélectionné, Tous et Principal ou utilisez la fonction champ .

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

   

   Sélectionnez Ok.

5. Sélectionner en regard de Condition d’identifiant d’événement champ .

   1. Dans le Ajout d’une condition d’identifiant d’événement boîte de dialogue, glisser-déposer Type d’événement (eventType) à Faire glisser et déposer un élément ici.

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

   3. Sélectionner Ok pour enregistrer la condition.

      

6. Sélectionner ECID (ECID) de la Espace de noms liste. Automatiquement la variable Identifiant de profil est renseigné par ID 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électionner Créer un Parcours.

Dans le Propriétés du parcours panel :

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

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

3. Assurez-vous que Autoriser une rentrée est sélectionné et défini. Période d’attente de rentrée to 30 Secondes.

4. Cliquez sur OK.

   

De retour dans la zone de travail du parcours, à partir de la ÉVÉNEMENTS, effectuez un glisser-déposer de la LumaTestEvent sur la zone de travail dans laquelle elle s’affiche Sélectionner un événement d’entrée ou une activité de lecture d’audience.

• Dans le Événements : LumaTestEvent , saisissez une Libellé, par exemple Luma Test Event.

Dans la ACTIONS menu déroulant, glisser-déposer Push sur le apparaissant à droite de votre LumaTestEvent activité. Dans le Actions : Push Volet :

1. Fournissez une Libellé, par exemple Luma Test Push Notification, fournissez une Description, par exemple Test push notification for Luma mobile app, sélectionnez Transactionnel de la Catégorie répertorier et sélectionner Luma de la Surface push.

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

   

   Dans le Notification push editor:

   1. Saisissez un Titre, par exemple Luma Test Push Notification et saisissez 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 la notification push, sélectionnez Ok.

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

Accédez à Luma > Luma > Modèle > XDM > TestPushPayload dans le navigateur de projet Xcode et examinez 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 testPushPayload à l’aide des paramètres fournis à la fonction (applicationId et eventType), puis les appels sendExperienceEvent lors de la conversion de la payload en dictionnaire. Cette fois-ci, ce code prend également en compte les aspects asynchrones de l’appel du SDK Adobe Experience Platform à l’aide du 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 au Paramètres .

Appuyer Notification push. La notification push apparaît dans votre application.

img-md
w-300