Création de modèles de notification push

Un modèle de notification push est un modèle de message qui contient du contenu et des paramètres que vous pouvez utiliser avec vos projets Amazon Pinpoint. Lorsque vous utilisez un modèle pour envoyer une notification push, Amazon Pinpoint remplit la notification avec le contenu et les paramètres que vous avez définis dans le modèle.

Lorsque vous créez un modèle de notification push, vous spécifiez le contenu et les paramètres que vous souhaitez réutiliser dans divers composants des notifications push basés sur le modèle. Ces composants, appelés parties de modèle, peuvent contenir du texte (tel que le titre ou le corps d'une notification) ou des paramètres (tels qu'un son personnalisé à lire lorsqu'un destinataire reçoit une notification).

Pour personnaliser un modèle pour des canaux de notification push spécifiques, vous pouvez créer plusieurs ensembles de parties de modèle dans chaque modèle : un ensemble par défaut et, éventuellement, un ou plusieurs ensembles spécifiques à un service. Le jeu par défaut contient le contenu et les paramètres que vous souhaitez utiliser par défaut pour n'importe quel canal de notification push. Un ensemble spécifique à un service contient le contenu et les paramètres que vous souhaitez utiliser pour un service de notification spécifique, tel que le service Apple Push Notification ou Firebase Cloud Messaging. En ajoutant des paramètres spécifiques à un service à un modèle, vous pouvez personnaliser vos notifications afin d’afficher un contenu propre au type d’appareil de chaque destinataire.

Vous pouvez également créer des modèles contenant des données de message brutes. Cette option est plus avancée, mais elle est utile si vous souhaitez définir des paramètres pour un canal spécifique qui ne figurent pas dans le modèle de notification push Amazon Pinpoint standard.

Création d’un modèle standard de notification push

Effectuez cette procédure si vous souhaitez spécifier le contenu de base du message, tel que le titre, le corps du message, l’image et l’action. Si vous devez spécifier le contenu brut du message, complétez plutôt la procédure figurant dans Création d’un modèle de notification push avec des données de message brutes.

Pour créer un modèle de notification push

1. Ouvrez la console Amazon Pinpoint à l'adresse. https://console.aws.amazon.com/pinpoint/

2. Dans le panneau de navigation, choisissez Message templates (Modèles de message).

3. Sélectionnez Create template (Créer un modèle).

4. Sous Channel (Canal), choisissez Push notifications (Notifications push).

5. Sous Template details (Détails du modèle), pour Template name (Nom du modèle), entrez un nom pour le modèle. Le nom doit commencer par une lettre ou un chiffre. Il peut contenir jusqu'à 128 caractères. Les caractères peuvent être des lettres, des chiffres, des traits de soulignement (_) ou des traits d’union (‐).

6. (Facultatif) Pour Version description (Description de la version), saisissez une brève description du modèle. La description peut contenir jusqu'à 500 caractères.

7. Sous Détails de notification push, procédez comme suit :

   • Pour Type de notification, choisissez Message standard.

   • Pour Titre, saisissez le titre que vous souhaitez afficher au-dessus du corps du message.

   • Pour Body (Corps), entrez le texte que vous souhaitez afficher dans le corps du message de notification.

     Astuce

     Vous pouvez inclure du contenu personnalisé dans le titre et le corps du modèle. Pour cela, ajoutez des variables de message qui font référence à des attributs spécifiques, tel qu’un attribut qui stocke le prénom d’un utilisateur, par exemple. En utilisant des variables de message, vous pouvez afficher différents contenus pour chaque destinataire d'une notification push qui utilise le modèle.

     Pour utiliser une variable de message, choisissez le nom d’un attribut existant dans l’outil de Recherche d’attributs. Amazon Pinpoint crée une variable de message pour l’attribut et la copie dans votre presse-papiers. Collez la variable à l'emplacement souhaité. Pour plus d’informations, consultez Ajout de contenu personnalisé aux modèles de messages.

   • Pour le Custom alert sound (Son d'alerte personnalisé), entrez le nom du fichier audio contenant le son personnalisé que vous souhaitez lire lorsqu'un destinataire reçoit la notification push. Ce nom doit correspondre au nom d'un fichier audio existant sur le périphérique d'un destinataire.

   • Pour Action, choisissez ce que vous voulez que le périphérique d'un destinataire fasse si le destinataire appuie sur la notification push :

     • Ouvrir votre application : ouvrez votre application ou mettez-la au premier plan si elle a été envoyée en arrière-plan.

     • Accéder à un URL — Ouvrez le navigateur par défaut sur l'appareil du destinataire et chargez une page Web spécifique. Si vous choisissez cette option, saisissez le nom URL de la page Web dans le URL champ Destination.

     • Ouvrir un lien profond : ouvrez votre application et affichez une interface utilisateur spécifique dans l’application. Si vous choisissez cette option, entrez le nom URL de l'interface dans le URL champ Destination.

8. (Facultatif) Pour personnaliser le modèle pour des services de notification push spécifiques, choisissez l’onglet de service approprié sous Personnaliser le contenu pour les services push individuels). Choisissez ensuite les options que vous souhaitez pour ce service.

   Si vous cochez la case Remplacer le contenu push par défaut dans l’onglet d’un service, Amazon Pinpoint remplace automatiquement le contenu et les paramètres par défaut que vous avez choisis à l’étape précédente par les options que vous avez sélectionnées dans l’onglet. Si vous souhaitez conserver le contenu et les paramètres par défaut et simplement personnaliser le modèle pour utiliser d'autres paramètres spécifiques au canal, ne cochez pas cette case.

   Apple

   Utilisez ces options pour définir le contenu et les paramètres personnalisés des notifications push que vous envoyez via le canal du service de notifications push d'Apple (APNs) aux applications exécutées sur des appareils iOS.

   En plus du contenu et des paramètres standard, vous pouvez inclure une image ou une vidéo personnalisée dans les notifications push qui utilisent le modèle. Pour ce faire, entrez le URL nom du fichier image ou vidéo dans le champ multimédia iOS. Ils URL doivent être accessibles au public. Sinon, l'appareil du destinataire ne pourra pas afficher l'image ou la vidéo.

   Google

   Utilisez ces options pour définir le contenu et les paramètres personnalisés des notifications push que vous envoyez via le canal Google Firebase Cloud Messaging (FCM) aux applications exécutées sur des appareils Android.

   Outre le contenu et les paramètres standard, vous pouvez choisir les options suivantes pour afficher des images personnalisées dans les notifications push qui utilisent le modèle :

   • Image Android — Entrez URL l'image à afficher dans le corps de la notification push.

   • Icône Android — Entrez la grande image URL de l'icône à afficher dans l'affichage du contenu de la notification push.

   • Petite icône Android — Entrez l'image URL de la petite icône à afficher dans la barre d'état et dans l'affichage du contenu de la notification push.

   Amazon

   Utilisez ces options pour définir un contenu et des paramètres personnalisés pour les notifications push que vous envoyez via le canal Amazon Device Messaging (ADM) aux applications exécutées sur des appareils Amazon, tels que les tablettes Kindle Fire.

   Outre le contenu et les paramètres standard, vous pouvez choisir les options suivantes pour afficher des images personnalisées dans les notifications push qui utilisent le modèle :

   • Image Android — Entrez URL l'image à afficher dans le corps de la notification push.

   • Icône Android — Entrez la grande image URL de l'icône à afficher dans l'affichage du contenu de la notification push.

   • Petite icône Android — Entrez l'image URL de la petite icône à afficher dans la barre d'état et dans l'affichage du contenu de la notification push.

   Baidu

   Utilisez ces options pour spécifier du contenu et des paramètres personnalisés pour les notifications push que vous envoyez via le canal Baidu aux applications qui utilisent la plateforme Baidu Cloud Push.

   Outre le contenu et les paramètres standard, vous pouvez choisir les options suivantes pour afficher des images personnalisées dans les notifications push qui utilisent le modèle :

   • Image Android — Entrez URL l'image à afficher dans le corps de la notification push.

   • Icône Android — Entrez la grande image URL de l'icône à afficher dans l'affichage du contenu de la notification push.

   • Petite icône Android — Entrez l'image URL de la petite icône à afficher dans la barre d'état et dans l'affichage du contenu de la notification push.

9. Si vous avez ajouté du contenu personnalisé au modèle en utilisant des variables de message, spécifiez une valeur par défaut pour chaque variable. Si vous procédez ainsi, Amazon Pinpoint remplace la variable par la valeur que vous spécifiez s’il n’existe aucune valeur pour un destinataire. Nous vous recommandons de procéder ainsi pour chaque variable du modèle.

   Pour spécifier des valeurs par défaut pour des variables, développez la section Default attribute values (Valeurs d’attribut par défaut). Puis, saisissez la valeur par défaut que vous souhaitez utiliser pour chaque variable. Si vous ne spécifiez pas de valeur par défaut et qu’il n’existe pas de valeur pour un destinataire, Amazon Pinpoint n’envoie pas le message.

10. Lorsque vous avez terminé de saisir le contenu et les paramètres du modèle, choisissez Create (Créer).

Création d’un modèle de notification push avec des données de message brutes

Effectuez cette procédure si vous souhaitez spécifier manuellement la charge utile du message brut. Vous devez uniquement spécifier la charge utile brute des messages si vous souhaitez utiliser une fonctionnalité d’un service de notification push spécifique qu’Amazon Pinpoint ne vous autorise pas à configurer. Si vous n’avez pas besoin de spécifier le contenu brut du message, suivez plutôt la procédure détaillée dans Création d’un modèle standard de notification push.

Par exemple, vous devez utiliser un modèle de message brut lorsque vous souhaitez envoyer des messages aux utilisateurs du navigateur Web Safari pour ordinateur de bureau. Dans ce cas, vous devez inclure un attribut spécifique dans la charge utile du message brut. Pour plus d'informations, consultez la section Envoi d'un message dans le Guide de l'utilisateur AWS final pour la messagerie push.

Pour créer un modèle de notification push

1. Ouvrez la console Amazon Pinpoint à l'adresse. https://console.aws.amazon.com/pinpoint/

2. Dans le panneau de navigation, choisissez Message templates (Modèles de message).

3. Sélectionnez Create template (Créer un modèle).

4. Sous Channel (Canal), choisissez Push notifications (Notifications push).

5. Sous Template details (Détails du modèle), pour Template name (Nom du modèle), entrez un nom pour le modèle. Le nom doit commencer par une lettre ou un chiffre. Il peut contenir jusqu'à 128 caractères. Les caractères peuvent être des lettres, des chiffres, des traits de soulignement (_) ou des traits d’union (‐).

6. (Facultatif) Pour Version description (Description de la version), saisissez une brève description du modèle. La description peut contenir jusqu'à 500 caractères.

7. Sous Détails des notifications push, pour Type de notification, sélectionnez Message brut. L’éditeur de message affiche un aperçu du code à utiliser pour le modèle. Dans l’éditeur de message, entrez les paramètres que vous souhaitez utiliser pour chaque service de notification push, y compris les paramètres facultatifs (tels que les images, les sons et les actions) que vous souhaitez spécifier pour le modèle. Pour plus d’informations, consultez la documentation relative aux services de notification push que vous utilisez.

8. Lorsque vous avez fini de saisir le contenu du message brut, choisissez Créer.

Si vous souhaitez tester le modèle avant de l'utiliser dans une notification push que vous envoyez aux utilisateurs, vous pouvez envoyer une notification de test utilisant le modèle. Dans ce cas, assurez-vous de mettre en œuvre d'abord l'étape 10 pour spécifier des valeurs par défaut pour toutes les variables du modèle. Dans le cas contraire, il se peut que la notification push ne soit pas envoyée ou qu’elle ne s'affiche pas correctement.