Créer et envoyer des notifications push

Les étapes suivantes ne sont pas spécifiques à Adobe Experience Cloud et sont conçues pour vous guider tout au long de la configuration d’APNS.

1. Dans le portail de développement Apple, accédez à Clés.

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

   {modal="regular"}

3. Fournissez un Nom de la clé.

4. Sélectionnez Service de notification push Apple (APNs) puis sélectionnez Configurer.

   1. Dans l’écran Configurer la clé, sélectionnez Sandbox et production dans le menu déroulant Environnement.
   2. Sélectionnez Enregistrer.

5. Sélectionnez Continuer.

   {modal="regular"}

6. Vérifiez la configuration et sélectionnez S’inscrire.

7. Téléchargez la clé privée .p8. Il est utilisé dans l’exercice suivant lorsque vous configurez vos informations d’identification push Journey Optimizer.

8. Notez l’identifiant Key. Il est utilisé dans l’exercice suivant lorsque vous configurez vos informations d’identification push Journey Optimizer.

9. Notez l’identifiant d’équipe. Il est utilisé dans l’exercice suivant lorsque vous configurez vos informations d’identification push Journey Optimizer. L’identifiant de l’équipe se trouve dans le coin supérieur droit de l’écran, en regard de votre nom d’utilisateur.
   {modal="regular"}

Une documentation supplémentaire est disponible ici.

Les étapes suivantes ne sont pas spécifiques à Adobe Experience Cloud et sont conçues pour vous guider tout au long de la configuration de Firebase.

1. Accédez à la console Firebase.

2. Sélectionnez Créer un projet Firebase.

   1. Saisissez un Nom du projet.
   2. Sélectionnez Continuer dans Créer un projet - Commençons par attribuer un nom à votre projet. Par exemple : Luma Android App.
   3. Désactivez Gemini dans Firebase et sélectionnez Continuer dans Créer un projet - Assistance IA pour votre projet Firebase.
   4. Désactivez Google Analytics pour ce projet puis sélectionnez Continuer dans Créer un projet - Google Analytics pour votre projet Firebase.
   5. Sélectionnez Créer un projet.
   6. Une fois le projet prêt, sélectionnez Continuer.

3. De retour dans la console Firebase, assurez-vous que votre projet est sélectionné dans la partie supérieure. Par exemple, application Luma Android.

   {modal="regular"}

4. Sélectionnez > Paramètres du projet.

5. Dans Paramètres du projet, sélectionnez Ajouter une application.

   1. Dans la Ajouter Firebase à votre application, sélectionnez Android comme plateforme.

   2. Dans l’Ajouter Firebase à votre application Android :

      1. À l’étape 1, Enregistrement de l’application :

         1. Saisissez un nom de package Android, similaire à votre identifiant d’application. Par exemple : com.adobe.luma.tutorial.android.
         2. Saisissez un surnom de l’application facultatif.
         3. Sélectionnez Enregistrer l’application.

      2. À l’étape 2, Télécharger puis ajouter le fichier de configuration.

         1. Sélectionnez Télécharger google-services.json. Lorsque vous créez votre propre version de l’application Android, vous devez remplacer le fichier google-services.json actuel dans l’exemple de projet Android Studio par la version du fichier générée par cette nouvelle configuration d’application.
            Les autres étapes sont déjà effectuées dans l’exemple d’application.

   Votre écran doit ressembler à ce qui suit :

   {modal="regular"}

6. Dans Paramètres du projet, sélectionnez Comptes de service.

7. Sélectionnez Générer une clé privée. Un fichier luma-android-app-firebase-adminsdk-xxxx-xxxxxxxx.json est généré. Conservez ce fichier en lieu sûr, car vous en aurez besoin ultérieurement.

Pour plus d’informations, consultez la documentation Firebase destinée aux développeurs.

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

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

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

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

Vous devriez maintenant avoir une extension de notification push ajoutée à votre application, similaire à l'écran ci-dessous.

{modal="regular"}

Le projet Android Studio est déjà configuré pour les notifications push. Vous n’avez pas besoin de prendre des mesures supplémentaires pour activer la version Android de l’application Luma pour les notifications push. Voir À propos des notifications pour plus d’informations.

Les notifications push Android requièrent la définition d’un identifiant de canal de notification, à la fois dans votre application et lors de l’envoi d’une notification push. L’identifiant de notification de canal utilisé dans l’application Android Luma est LUMA_CHANNEL ID.

1. Dans Xcode, assurez-vous que AEP Messaging est ajouté à la liste des packages dans Dépendances de packages. Voir Gestionnaire de packages Swift.

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

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

   import AEPMessaging

4. Assurez-vous que Messaging.self fait partie du tableau d’extensions que vous enregistrez.

   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. Dans Android Studio, assurez-vous que aepsdk-messaing-android fait partie des dépendances dans build.gradle.kts (module :app) dans Android Gradle Scripts. Voir Gradle.

2. Accédez à Android > app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication dans le navigateur de projet Android Studio.

3. Assurez-vous que com.adobe.marketing.mobile.Messaging fait partie de votre liste d’importations.

   import import com.adobe.marketing.mobile.Messaging

4. Assurez-vous que Messaging.EXTENSION fait partie du tableau d’extensions que vous enregistrez.

   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. Accédez à Luma > Luma > AppDelegate dans le navigateur de projet Xcode.

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

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

   Cette fonction récupère le jeton d’appareil propre à l’appareil 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 définie et qui repose sur le service de notification push Apple (APNs).

1. Accédez à Android > app > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication dans le navigateur de projet Android Studio.

2. Ajoutez l’API MobileCore.setPushIdentifier à la fonction override fun onCreate() dans class LumaAplication : Application, dans FirebaseMessaging.getInstance().token.addOnCompleteListener.

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

   Cette fonction récupère le jeton d’appareil propre à l’appareil 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 définie et qui repose sur Firebase Cloud Messaging (FCM).

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

   code language-swift
   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.

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

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

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

3. 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 d’événement d’expérience de notification push de test afin de déclencher votre parcours chaque fois que vous appuyez sur ce bouton.

   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. Accédez à Android > app > kotlin+java > com.adobe.luma.tutorial.android > xdm > TestPushPayload.kt dans le navigateur d’Android Studio et inspectez le code.

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

   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.

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

2. Accédez à Android > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK dans le navigateur d’Android Studio et ajoutez le code suivant à func sendTestPushEvent(applicationId: String, eventType: String) :

   code language-kotlin
   // Create payload and send experience event val testPushPayload = TestPushPayload( Application(applicationId), eventType ) sendExperienceEvent(testPushPayload.asMap())

   Ce code crée une instance de testPushPayload à l’aide des paramètres fournis à la fonction (applicationId et eventType), puis appelle sendExperienceEvent lors de la conversion de la payload en mappage.

3. Accédez à Android > app > kotlin+java > com.adobe.luma.android.tutorial > views > ConfigView.kt dans le navigateur d’Android Studio. Dans la définition du bouton de notification push , ajoutez le code suivant pour envoyer la payload d’événement d’expérience de notification push de test afin de déclencher votre parcours chaque fois que vous appuyez sur ce bouton.

   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. Recréez et exécutez l’application dans le simulateur ou sur un appareil physique à partir de Xcode, à l’aide de .

2. Accédez à l’onglet Paramètres.

3. Appuyez sur Notification push.

   La notification push s’affiche au-dessus de l’application.

   {width="300"}

1. Recréez et exécutez l’application dans le simulateur ou sur un appareil physique à partir d’Android Studio, à l’aide de .

2. Accédez à l’onglet Paramètres.

3. Appuyez sur Notification push.

   La notification push s’affiche au-dessus de l’application.

   {width="300"}