Créer une notification
Le but de cet article est de guider les utilisateurs sur la création d'une notification sur la console EngageLab.
Créer un message de notification
Accédez à la page [Push] - [Créer un Push] - [Créer un message de notification] pour créer une tâche de notification push. Les instructions de configuration des paramètres sont les suivantes :
Paramètres de base
- Plateforme cible :
- Avant de sélectionner une plateforme, configurez la plateforme correspondante dans [Paramètres d'intégration].
- Seule la plateforme autorisée par le compte principal peut être sélectionnée pour le sous-compte.
- Titre :
- Le titre du message push. Veuillez éviter d'utiliser des contenus dénués de sens tels que "test, test, purement numérique", sinon le fabricant peut intercepter et ne pas recevoir le message de notification !
- Contenu : le contenu du message push. Veuillez éviter d'utiliser des contenus dénués de sens tels que "test, test, purement numérique", sinon le fabricant peut intercepter et ne pas recevoir le message de notification !
- Prise en charge de l'ajout de titres et de contenus push dans plusieurs langues : nous détecterons automatiquement la langue de l'appareil des utilisateurs finaux. Si d'autres langues ne sont pas définies, tous les utilisateurs cibles recevront le contenu selon les paramètres de langue [par défaut].
- Prise en charge de la traduction IA en un clic.

- Heure d'envoi : Sélectionnez l'heure d'envoi
- Immédiatement : Livraison instantanée du message.
- Différé : L'heure d'envoi ne peut être définie qu'au moins trois minutes après l'heure actuelle, et la tâche planifiée ne peut pas dépasser un an.
- Push à vitesse constante : Effectuer la notification push dans le délai imparti pour réduire la charge sur le serveur.
- Cliquer sur la notification pour ouvrir : Action après avoir cliqué sur la notification.
- Ouvrir l'app
- Intent (recommandé) :
- Le format est : intent:#Intent;action=chemin d'action;component=nomdupackage/cheminActivité;end
- deeplink :
- Le format est : scheme://test?key1=val1&key2=val2

Options avancées (facultatif)
- Liaison de l'identifiant du plan de push : Vous pouvez gérer des messages push similaires via l'identifiant du plan de push. Par la suite, vous pouvez consulter le nombre total de messages envoyés, les clics utilisateurs, etc. selon la dimension du plan.
- Sélection du type de message :
- Messages système : Correspondent aux notifications de service sur les canaux des différents fabricants (Huawei/Honor : catégorie Service et Communication, Xiaomi/OPPO : Messages privés, vivo : Messages système). Généralement, les fabricants ne limitent pas le nombre de messages pouvant être envoyés.
- Messages opérationnels : Correspondent aux messages marketing et opérationnels sur les canaux des différents fabricants (Huawei/Honor : catégorie Consultation marketing, Xiaomi/OPPO : Messages publics, vivo : Messages opérationnels). Généralement, les fabricants limitent strictement le nombre de messages pouvant être envoyés.
- Les messages opérationnels sont sélectionnés par défaut.
- Durée de vie (Time To Live) : Lorsqu'un message push est envoyé à un utilisateur qui n'est pas en ligne, il sera enregistré comme message hors ligne et sera envoyé à l'utilisateur lors de sa prochaine connexion.
- Cette valeur permet de spécifier la durée de conservation des messages hors ligne. Ainsi, dans la limite de temps, les utilisateurs continueront de recevoir le push lors de leur connexion, sinon ils expireront.
- La durée par défaut est de 1 jour. Si la valeur est 0, cela signifie que les messages hors ligne ne sont pas conservés, seuls les utilisateurs actuellement en ligne les recevront, les autres non.
- Champs supplémentaires : Utilisés pour la gestion personnalisée des événements côté client. Vous pouvez ajouter ou supprimer des champs supplémentaires.

Configuration Android
- Statut du canal fabricant : Après l'intégration et la configuration du canal fabricant correspondant, le statut du canal sera mis en surbrillance.
- Stratégie d'envoi du message : Vous pouvez spécifier la politique de distribution prioritaire pour le canal fabricant et le canal EngageLab. Lors de la sélection de la politique fabricant, assurez-vous que le canal fabricant a été configuré avec succès.
- La distribution via le canal système signifie que tant que le processus du navigateur existe dans le système d'exploitation, le message peut être livré.
- La distribution via le canal EngageLab signifie qu'il est livré via le websocket d'EngageLab. L'utilisateur doit ouvrir la page de votre site.
- Styles de notification : Différent des styles de barre de notification intégrés dans le SDK MTPush, les styles ici sont trois styles courants construits avec l'API système. Pour plus de détails, cliquez sur "?" pour voir la description. Pris en charge à partir de MTPush Android SDK 3.0.1.
- Style de barre de notification personnalisé : Vous pouvez définir plusieurs styles côté client pour spécifier différents numéros, et lors du push côté serveur, spécifier le numéro pour utiliser le style précédemment défini. La valeur par défaut est 0, c'est-à-dire le style par défaut.
- Icône de notification : Icône à droite de la barre de notification.
- Logo par défaut : La barre de notification affiche l'icône par défaut de l'application.
- Icône de chemin spécifié : La barre de notification affiche une icône pour le chemin spécifié. L'image peut être une ressource réseau commençant par HTTP ou HTTPS, ou un chemin de dossier de ressource drawable.
- Modèle de rappel de notification : Vous pouvez définir la priorité d'alerte des notifications pour éviter des interruptions fréquentes des clients. Par défaut, le modèle de rappel général est sélectionné. Le modèle inclut le nom du modèle, le nom du canal, l'ID du canal, la priorité, la catégorie, le type d'alerte et le réglage du son.
- Modèle de rappel général : La priorité de la notification est PRIORITY_DEFAULT, et le type d'alerte est Son | Vibration | Lumières.
- Modèle de rappel imperceptible : La priorité de la notification est PRIORITY_LOW et le type d'alerte est Vibration | Lumières.
- Modèle de rappel fort : La priorité de la notification est PRIORITY_HIGH et le type d'alerte est Son | Vibration | Lumières.
- Cliquez sur "Nouveau modèle de rappel de message" pour personnaliser le modèle de rappel.
- Channel_id : Pour la fonction de canal de notification des systèmes Android 8.0 et ultérieurs, l'ID du canal de notification doit être spécifié pour le push.
- Priorité : cette priorité ne prend effet que pour les canaux EngageLab. La priorité par défaut est définie sur PRIORITY_DEFAULT. Pour plus d'informations, consultez la documentation développeur. Prend effet à partir de MTPush Android SDK 3.0.1.
- Catégorie : Le système peut utiliser l'attribut catégorie des notifications pour trier ou filtrer dans la barre de notification. Prend effet à partir de MTPush Android SDK 3.0.1. Voir la documentation développeur.
- Type d'alerte : Le développeur peut cocher l'élément correspondant pour spécifier le type de rappel sur le téléphone lors de la livraison de la notification. Cependant, les limitations du système ne peuvent être dépassées. Par exemple, si la sonnerie du téléphone est activée, la vibration est autorisée, et le voyant LED est allumé. (effectif à partir de MTpush Android SDK version 3.0.3.)
- Numéro de badge : L'icône en haut à droite de l'icône de l'application.
- Cet attribut n'est valable que pour Huawei emui 8.0 et supérieur, et Xiaomi MIUI 6 et supérieur.
- Si ce champ n'est pas renseigné, cela signifie que le numéro de badge ne sera pas modifié (en raison du contrôle système, les appareils Xiaomi auront toujours l'effet +1 par défaut, que ce soit en push EngageLab ou fabricant) ; sinon, le badge configuré pour le prochain message de la barre de notification badge_add_num augmentera avec le nombre de badges précédents ;
- Il est conseillé de configurer Badge_add_num à 1 ; Exemple : Badge_add_num est configuré à 1. Le nombre de badges avant l'application est 2. Après l'envoi de ce message, le nombre de badges appliqué est affiché à 3.

Configuration iOS
- silent_push :
- Content available : 1. Ne comporte aucun badge, son, contenu de message ou autre paramètre. Vous pouvez mettre à jour le contenu sans déranger l'utilisateur. Voir "Notifications distantes silencieuses".
- Sous-titre de notification : Ce champ ne s'applique qu'aux versions système supérieures à iOS 10. La plateforme Android et les autres versions iOS ne sont pas affectées par ce champ.
- content-available : À partir d'iOS 7, ajout de nouvelles fonctionnalités. Il s'agit ici de la notification distante en arrière-plan. Si non activé, il s'agit d'une notification distante classique. Voir "Notification distante en arrière-plan".
- mutable-content : À partir d'iOS 10, ajout de nouvelles fonctionnalités. Si activé, cela signifie que la fonctionnalité unnotificationserviceextension d'iOS 10 est prise en charge. Sinon, il s'agit d'une notification distante classique. Voir "UNNotificationServiceExtension".
- apns-collapse-id : La notification comporte le paramètre collapse ID, qui écrasera la notification avec le même collapse ID dans le centre de notifications. La valeur ne peut pas dépasser 64 octets. Voir Guide APNs.
- Modèle de rappel de notification : Vous pouvez définir la priorité d'alerte pour éviter des interruptions fréquentes. Par défaut, le modèle général est sélectionné. Le modèle inclut le nom du modèle, la classification de la notification, le son, le volume, Critique, Catégorie, Thread-id et Interruption-level.
- Modèle de rappel général : Classification "Notification générale", son "notification par défaut", interruption-level "active".
- Modèle de rappel imperceptible : Type de notification "notification type", son "silencieux", interruption-level "passive".
- Cliquez sur "Nouveau modèle de rappel de message" pour personnaliser le modèle d'alerte.
- Notification générale : Spécifiez le son via le champ sound. Par défaut, c'est default, le son système. Si la valeur est vide, il n'y a pas de son. Si un nom spécial est défini, il faut configurer le son dans votre app.
- Notification d'alarme : Les applications nécessitant une notification d'alarme doivent demander l'autorisation auprès d'Apple Developer.
- Catégorie : Catégorie iOS. Seuls les systèmes iOS 8 et supérieurs prennent en charge ce paramètre.
- thread-id : Identifiant spécifique à l'application pour regrouper les notifications.
- interruption-level : Définit le niveau d'interruption de la notification et le moment de livraison. Voir Champ interruption-level.
- Numéro de badge :
- Vous pouvez spécifier directement le badge de la notification push APNs, qui s'affiche en haut à droite de l'icône de l'application, indiquant le nombre de messages non lus.
- Prend aussi en charge des opérations telles que +12, -3. MTPush effectue des opérations séparées pour chaque badge utilisateur. Par exemple, si les badges de A et B sont 1 et 2, après un push +2, A aura 3 et B aura 4. La valeur par défaut est 1.

Public cible
- Tous : Cette notification sera envoyée à tous les utilisateurs en ligne actuellement enregistrés et à ceux qui s'enregistreront à l'avenir sur l'app.
- registrationID : Push jusqu'à 1000 à la fois.
- Segmentation Utilisateur : Prise en charge de la segmentation personnalisée des utilisateurs selon des règles pour un push ciblé.
Programmation de l'envoi
- Livraison immédiate : Les messages seront envoyés immédiatement.
- Programmée selon l'heure de l'organisation : Envoyée selon le fuseau horaire de l'organisation. Les tâches planifiées ne peuvent pas dépasser un an.
- Programmée selon l'heure de l'utilisateur final : Envoyée selon le fuseau horaire de chaque appareil utilisateur. Pour envoyer une notification à tous les utilisateurs dans différents fuseaux horaires à 10h demain, il suffit de la programmer à 10h ; note : si le message est envoyé après l'heure d'un fuseau, il sera ignoré. Veuillez donc commencer l'envoi au moins 24h à l'avance pour éviter que des messages importants n'atteignent pas les utilisateurs finaux.
- Livraison planifiée récurrente : Les notifications push récurrentes peuvent être programmées pour être envoyées automatiquement à intervalles réguliers sur une période donnée. Si vous choisissez une récurrence mensuelle et sélectionnez le 30 février, la sélection du 30 sera ignorée.
Aperçu
Après avoir configuré les paramètres de push, cliquez sur "Aperçu" pour visualiser les paramètres configurés.

Confirmez les paramètres d'envoi et cliquez sur "Confirmer" pour créer la tâche de notification push avec succès.

Si aucune cible de push ne correspond aux conditions, l'erreur suivante s'affiche :

Créer un message personnalisé
Accédez à la page [Créer un Push] - [Message personnalisé] pour créer une tâche de notification push. Pour les instructions de configuration des paramètres, référez-vous à Créer un message de notification.

Créer des messages in-app
Les messages in-app sont des messages affichés dans une application pour transmettre des informations, promouvoir des activités ou rappeler aux utilisateurs d'effectuer certaines actions. Ce document présente les types de messages in-app pris en charge et les étapes de création correspondantes.
- Les messages in-app sont uniquement envoyés via le canal Jiguang et ne sont pris en charge que sur Android et iOS.
- Les messages in-app ne peuvent être envoyés que via le webPortal et ne prennent pas en charge l'envoi via API pour le moment.
- Cette fonctionnalité nécessite la version SDK v4.5.0+.
Paramètres de base
Nom du message : Jusqu'à 20 caractères.
Plateforme cible : Choisissez la plateforme devant recevoir le message push selon le SDK intégré.
- Vous devez configurer la plateforme correspondante dans "Paramètres push" avant de la sélectionner.
- Les sous-comptes ne peuvent sélectionner que les plateformes autorisées par le compte principal.
Après avoir sélectionné la plateforme, vous pouvez également choisir comment le message doit s'afficher :
- Aucune restriction de page : Cela signifie que le message in-app peut s'afficher sur n'importe quelle page (chaque message ne s'affiche qu'une fois).
- Spécifier un chemin de page spécifique : Cela signifie que le message in-app ne s'affichera que sur la page spécifiée de l'app (chaque message ne s'affiche qu'une fois).
- Public cible : Le public cible devant recevoir le message push. Pour les tests, il est recommandé d'utiliser le
registrationIDobtenu dans le log d'enregistrement.
- Tous / Diffusion à tous : Le message sera envoyé à tous les utilisateurs en ligne actuellement enregistrés et à ceux qui s'enregistreront à l'avenir.
- Segments utilisateur : Prise en charge de la segmentation personnalisée des utilisateurs selon des règles, pour un push ciblé.
- registrationID : Jusqu'à 1 000 IDs peuvent être poussés à la fois.
Contenu du message
Notre système de message in-app prend en charge trois modèles fixes : interstitiel, bannière et plein écran, sélectionnables via des boutons. Vous pouvez également utiliser du code HTML personnalisé pour créer des modèles.
- Contenu du message :
- Image du message :
- URL de l'image : Prend en charge les images réseau.
- Action de l'image : Utilisez des liens réseau ou des deeplinks pour guider vos utilisateurs vers une page externe ou une page spécifique de votre app. Prend en charge les options Aller à l'URL, Ouvrir un Deeplink, Notification push, et Aucune action.
- Aller à l'URL
- Ouvrir un Deeplink
- Notification push : Si l'utilisateur a précédemment refusé les autorisations dans la demande native, cliquer sur l'action ouvrira les paramètres de l'appareil. Si l'utilisateur a déjà activé les notifications, cela n'ouvrira pas les paramètres.
- Aucune action : Cette option ferme la pop-up lorsque l'utilisateur clique dessus.
- Titre du message :
- Paramètres du titre : Prise en charge du gras, de la taille de police, de la position et de la couleur.
- Contenu du message :
- Paramètres du contenu : Prise en charge du gras, de la taille de police, de la position et de la couleur.
- Prise en charge de plusieurs langues pour les titres et contenus push : Nous détecterons automatiquement la langue de l'appareil utilisateur. Si d'autres langues ne sont pas définies, le contenu de la langue [par défaut] sera envoyé à tous les utilisateurs cibles.
- Boutons d'action : Pour l'envoi d'informations marketing ou promotionnelles, assurez-vous que la page comporte une fonction de fermeture en un clic bien visible.
- Prise en charge de boutons primaire et secondaire.
- Noms et actions des boutons personnalisables : Les actions des boutons sont basées sur les actions d'image décrites ci-dessus.
- Bouton de fermeture : Cliquer ferme la page en cours. Prise en charge de la position centrée en bas ou en haut à droite.
- Image du message :
Programmation de l'envoi
- Heure d'envoi : Choisissez l'heure d'envoi du message
- Immédiat : Envoie le message immédiatement.
- Planifié : L'heure d'envoi ne peut être définie qu'au moins 3 minutes plus tard, et la tâche planifiée ne peut pas dépasser un an.
- Push à vitesse limitée : Effectuer la notification push dans le délai imparti pour réduire la charge sur le serveur.
Paramètres avancés
- Pop-up différée :
- Pop-up immédiate : Lorsque les conditions du message in-app sont remplies, il s'affiche immédiatement ;
- Pop-up différée : Prise en charge du paramétrage "afficher après être resté sur la page pendant ** secondes", par défaut 3 secondes, et prise en charge du paramétrage "afficher ** secondes après le dernier message in-app", par défaut 3 secondes.
- Durée d'affichage : Par défaut, le message disparaît après un certain temps, mais il est possible de demander à l'utilisateur de fermer manuellement la pop-up.
- Disparaît après un certain temps : Par défaut, les bannières disparaissent après 5 secondes, les interstitiels et HTML après 30 secondes. Plage autorisée : 5-180 secondes. Les messages plein écran ne sont pas concernés si un bouton et un temps de saut sont configurés.
- Fermeture manuelle par l'utilisateur : Si cette option est sélectionnée, le bouton de fermeture doit être activé. Sinon, le système l'activera automatiquement.
- Période de validité d'affichage : Les utilisateurs doivent être en ligne et entrer sur la page d'affichage pendant cette durée pour que le message s'affiche, sinon il expirera.
- Un message envoyé à un utilisateur spécifique, si celui-ci est hors ligne avant la "date d'expiration d'affichage", sera conservé comme message hors ligne et envoyé lors de sa prochaine connexion.
- Si le message a été envoyé à l'app mais que l'utilisateur n'entre jamais sur la page spécifiée et que la "date d'expiration d'affichage" est dépassée, le message in-app ne s'affichera plus.
- Paramètres supplémentaires : Utilisés pour la gestion personnalisée des événements côté client.

Test A/B
Accédez à la page [Créer Push] - [Test A/B] pour créer une tâche de notification push. Les instructions de configuration des paramètres sont les suivantes :

- Nom du message : Personnalisez le nom du message pour ce test A/B afin de faciliter la gestion et la recherche ultérieure.
- Sélectionner la plateforme : Prend en charge actuellement Android et iOS. Pour iOS, vous pouvez choisir entre environnement de développement et de production. Si aucune plateforme n'est sélectionnée, le contenu du message du groupe A/B sera prévisualisé pour les deux plateformes. Après sélection, les paramètres de configuration correspondants seront ajoutés dans les options avancées.
Contenu du message des groupes A/B
La configuration du contenu du message pour les groupes A/B est identique à celle de la "Notification", avec prise en charge du multilingue, du titre, du sous-titre, du contenu, des champs supplémentaires, du comportement au clic, des styles avancés, etc. Le groupe B prend en charge la copie en un clic de toutes les configurations du groupe A, ce qui facilite la configuration rapide du groupe témoin.
Le groupe B prend en charge la copie en un clic des paramètres du groupe A. Vous pouvez cliquer sur copier puis modifier selon le groupe A.

Public cible
La plateforme de push EngageLab prend en charge différents modes de sélection du public cible, permettant aux développeurs et opérateurs de cibler précisément selon les besoins métier. Il est recommandé d'utiliser le registrationID du log d'enregistrement pour les tests. Pour la configuration, référez-vous à "Notification".
Paramètres du test A/B

Définissez le pourcentage d'utilisateurs participant au test A/B parmi ceux répondant aux conditions de public cible et de plateforme (MacOS/Android). Le ratio d'utilisateurs pour les groupes A et B est égal. Par exemple, si le ratio est de 40 %, chaque groupe aura 20 %.
Le nombre d'utilisateurs calculé est arrondi à l'entier inférieur. Si le nombre d'utilisateurs du test A/B est inférieur à 2, le push échouera.
Heure d'envoi et paramètres avancés
L'heure d'envoi et les paramètres avancés pour les pushs des groupes A/B sont identiques à ceux de la "Notification". Pour plus de détails, référez-vous à "Notification".
Configuration Android

Stratégie d'envoi du message : Vous pouvez spécifier la stratégie de livraison prioritaire pour les canaux fabricants et le canal EngageLab. Lors de la sélection de la stratégie fabricant, assurez-vous que le canal fabricant est configuré avec succès.
- Définissez la priorité lorsque FCM et le canal fabricant coexistent.
Paramètres avancés : Choisissez entre un modèle de notification classique ou personnalisé pour répondre aux besoins de style de notification selon les scénarios métier. Le paramètre du numéro de badge (badge_add_num) n'est effectif que pour les appareils Huawei EMUI 8.0+ et Xiaomi MIUI 6+.
Pour chaque fabricant Android, EngageLab prend en charge la personnalisation des paramètres de push. Remplissez les champs spécifiques selon les spécifications de chaque fabricant et les instructions détaillées de la page.
Configuration iOS

EngageLab prend en charge la personnalisation des paramètres de push. Remplissez les champs spécifiques selon les spécifications de chaque fabricant et les instructions détaillées de la page.
Modèle de rappel de notification : Choisissez entre un modèle classique ou un modèle silencieux. Cliquez sur "Créer un nouveau modèle de message" pour ajouter un modèle personnalisé.

Numéro de badge : Définissez le numéro de badge de l'icône de l'app, en choisissant "Défaut système" ou une valeur personnalisée, adapté aux scénarios comme le nombre de messages non lus.
Aperçu de l'envoi
Après toutes les configurations, cliquez sur le bouton "Envoyer un aperçu" en bas de page pour visualiser l'effet réel du modèle de notification. Une fois confirmé, cliquez sur "Confirmer l'envoi" pour envoyer le message push au public test.
Après l'envoi, vous pouvez consulter l'analyse détaillée de ce test A/B sur la page "Historique des notifications push".

