Ajout de contenu personnalisé aux modèles de messages

Pour diffuser du contenu dynamique et personnalisé dans des messages qui utilisent un modèle, ajoutez des variables de message au modèle de message. Une variable de message est un espace réservé qui fait référence à un attribut spécifique que vous ou Amazon Pinpoint avez créé pour stocker des informations sur vos utilisateurs. Chaque attribut correspond généralement à une caractéristique d'un utilisateur, comme le prénom d'un utilisateur ou la ville où il habite. En ajoutant des variables de messages aux modèles, vous pouvez utiliser ces attributs pour fournir du contenu personnalisé à chaque destinataire d'un message qui utilise un modèle.

Si un modèle contient des variables de messages, Amazon Pinpoint remplace chaque variable par la valeur actuelle correspondante de l’attribut pour chaque destinataire. Il le fait lors de chaque envoi d’un message qui utilise le modèle. Cela signifie que vous pouvez envoyer du contenu personnalisé à chaque destinataire sans créer plusieurs versions personnalisées d'un message ou d’un modèle de message. Vous pouvez également être sûr que le message contient les dernières informations dont vous disposez pour un destinataire.

Par exemple, si votre projet est une application de fitness pour les coureurs et qu'il comprend des attributs pour le prénom de chaque utilisateur, son activité préférée et son enregistrement personnel, vous pouvez utiliser les variables de texte et de messages suivantes dans un modèle :

Hi {{User.UserAttributes.FirstName}}, congratulations on your new {{User.UserAttributes.Activity}} record of {{User.UserAttributes.PersonalRecord}}!

Lorsque vous envoyez un message qui utilise le modèle, Amazon Pinpoint remplace les variables par la valeur actuelle de chaque attribut pour chaque destinataire. Voici quelques exemples :

Exemple 1

Hi Sofia, congratulations on your new half marathon record of 1:42:17!

Exemple 2

Hi Alejandro, congratulations on your new 5K record of 20:52!

Si aucune valeur d’attribut n’existe pour un destinataire, Amazon Pinpoint peut remplacer une variable par une valeur par défaut que vous spécifiez pour cette dernière. Par exemple, si un utilisateur de votre application de fitness n'a pas choisi son activité préférée, vous pouvez utiliser running comme valeur par défaut pour la variable {{User.UserAttributes.Activity}}. Dans ce cas, Amazon Pinpoint remplace la variable comme illustré dans les exemples suivants.

Exemple 1

Hi Jane, congratulations on your new running record of 1:42:17!

Exemple 2

Hi John, congratulations on your new running record of 20:52!

Si vous ne spécifiez pas de valeur par défaut et qu’il n’existe aucune valeur pour un destinataire, Amazon Pinpoint omet tout le texte de la variable lorsqu’il envoie un message à ce destinataire. Par exemple :

Hi Mary, congratulations on your new record of 20:52!

Nous vous recommandons de spécifier une valeur par défaut pour chaque variable que vous incluez dans un modèle.

Ajout de variables de messages

Vous pouvez ajouter des attributs de message à un nouveau modèle que vous créez ou à un modèle existant. Si vous ajoutez des variables à un modèle existant, Amazon Pinpoint n’applique pas nécessairement les modifications aux messages qui utilisent le modèle et qui n’ont pas encore été envoyés, par exemple, les messages de campagne qui doivent être envoyés ultérieurement. Cela dépend de la version du modèle à laquelle vous ajoutez des variables et de la façon dont vous avez configuré les messages qui utilisent le modèle. Pour plus d’informations, consultez Gestion des versions des modèles de message.

Note

Les modèles de messagerie intégrés à l’application ne prennent pas en charge l’utilisation de variables de message.

Pour ajouter une variable de message à un modèle de message

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. Sur la page Message templates (Modèles de message) effectuez l'une des opérations suivantes :

   • Pour créer un nouveau modèle et y ajouter une variable de message, choisissez Create a template (Créer un modèle). Ensuite, sur la page du modèle, saisissez un nom pour ce dernier et, éventuellement, une description.

   • Pour ajouter une variable de message à un modèle existant, choisissez le modèle auquel vous souhaitez ajouter une variable. Ensuite, sur la page du modèle, choisissez Edit (Modifier). Sous Template details (Détails du modèle), utilisez le sélecteur de version pour choisir la version du modèle que vous souhaitez utiliser comme point de départ. Si vous choisissez la version la plus récente du modèle, vous pouvez enregistrer vos modifications directement dans cette version du modèle. Dans le cas contraire, vous pouvez enregistrer vos modifications en tant que nouvelle version du modèle.

4. Dans la section des détails du message, déterminez où vous souhaitez ajouter une variable de message. Vous pouvez ajouter une variable au corps de tout type de modèle. Pour les modèles de notification par e-mail et push, vous pouvez également ajouter une variable à l'objet ou au titre du message.

5. Dans Attribute finder (Recherche d'attributs), développez la section correspondant au type d'attribut pour lequel vous souhaitez ajouter une variable de message. Vous pouvez choisir parmi les types d'attributs suivants :

   Attributs standard

   Il s’agit d’attributs créés automatiquement par Amazon Pinpoint pour n’importe quel projet. Cela signifie que vous pouvez les utiliser dans les messages que vous envoyez pour n'importe quel projet. Pour de plus amples informations sur chacun de ces attributs, veuillez consulter Attributs pris en charge.

   Pour ajouter une variable pour un attribut standard, choisissez l'attribut dans la liste.

   Custom attributes (Attributs personnalisés)

   Il s'agit d'attributs que vous pouvez créer pour des projets individuels. Étant donné que ces attributs peuvent ne pas être disponibles pour certains de vos projets, il est possible qu’Amazon Pinpoint ne puisse pas remplacer la variable par une valeur pour chaque destinataire d’un message qui utilise le modèle. Pour vous aider à éviter ce problème, Amazon Pinpoint fournit des options pour vous aider à choisir un attribut existant pour des projets spécifiques ou tous vos projets.

   Pour ajouter un attribut personnalisé :

   1. Choisissez Attributs personnalisés, puis sélectionnez Charger des attributs personnalisés. Dans la fenêtre qui apparaît, Amazon Pinpoint répertorie tous les projets que vous avez créés. Lorsque vous choisissez chaque projet, les attributs communs aux projets sélectionnés s’affichent dans le volet de navigation de droite. Si aucun attribut n’est affiché, cela signifie qu’il n’existe aucun attribut commun entre ces projets.

   2. Effectuez l’une des actions suivantes :

      • Pour utiliser tous les attributs communs aux projets sélectionnés, choisissez Charger des attributs personnalisés.

      • Si vous souhaitez utiliser un attribut spécifique de la liste, entrez une partie du nom de l’attribut dans le champ de recherche. Les attributs correspondant au texte saisi s’affichent. Choisissez Charger des attributs personnalisés lorsque l’attribut que vous souhaitez utiliser s’affiche. L’outil de Recherche d’attributs affiche les attributs personnalisés récemment ajoutés.

        Note

        Vous ne pouvez ni ajouter des attributs communs provenant de différents ensembles de projets, ni modifier la section Attributs personnalisés de l’outil de Recherche d’attributs. Si vous devez apporter des modifications aux attributs personnalisés, choisissez X pour effacer l’outil de Recherche d’attributs, puis recommencez.

   3. Dans Attribute finder (Recherche d'attributs), choisissez l'attribut pour lequel vous souhaitez ajouter une variable.

   Recommended attributes (Attributs recommandés)

   Il s’agit des attributs que vous créez éventuellement pour votre compte lorsque vous configurez Amazon Pinpoint pour récupérer des recommandations personnalisées à partir d’un modèle de recommandation. Pour de plus amples informations sur l'utilisation des modèles de recommandation, veuillez consulter Modèles de machine learning. Vous pouvez ajouter des variables pour ce type d'attribut aux modèles d'e-mail, de notification push et de SMS. Vous ne pouvez pas les ajouter à des modèles vocaux.

   Pour ajouter une variable pour un attribut recommandé, choisissez l'attribut dans la liste. Si Attribute finder (Recherche d'attributs) ne répertorie aucun attribut recommandé, vous devez d'abord connecter le modèle à un modèle de recommandation.

   Pour ajouter un attribut recommandé :

   1. Choisissez ensuite Connecter un modèle.

   2. Sélectionnez le modèle à partir duquel vous souhaitez récupérer les recommandations lorsque vous envoyez des messages qui utilisent le modèle.

   3. Choisissez ensuite Connecter un modèle.

6. Lorsque vous choisissez un attribut dans 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é. Si votre liste d’attributs est longue, entrez le texte de recherche pour affiner la liste. Choisissez X pour effacer le champ de recherche.

   Une fois que vous avez collé la variable, Amazon Pinpoint l’affiche sous forme de nom de l’attribut associé, entre deux ensembles d’accolades, par exemple, {{User.UserAttributes.FirstName}}.

7. Répétez les étapes 4 à 6 pour chaque variable de message à ajouter.

8. Pour spécifier une valeur par défaut pour une variable de message, développez la section Default attribute values (Valeurs d'attribut par défaut). Ensuite, dans la liste des variables, saisissez la valeur par défaut que vous souhaitez utiliser pour la variable.

   Note

   Nous vous recommandons de procéder ainsi pour chaque variable du modèle. Sinon, Amazon Pinpoint peut ne pas être en mesure d’envoyer un message utilisant le modèle, ou le message peut s’afficher de manière inattendue ou indésirable.

9. Lorsque vous avez terminé, effectuez l'une des opérations suivantes :

   • Si vous avez ajouté des variables de message à un nouveau modèle, choisissez Create (Créer).

   • Si vous avez ajouté des variables de message à un modèle existant et que vous souhaitez enregistrer vos modifications en tant que nouvelle version du modèle, choisissez Save as new version (Enregistrer en tant que nouvelle version).

   • Si vous avez ajouté des variables de message à un modèle existant et que vous souhaitez enregistrer vos modifications en tant que mise à jour de la version la plus récente du modèle, choisissez Update version (Mettre à jour la version). Cette option n'est disponible que si vous avez ouvert la version la plus récente du modèle à l'étape 3.

Attributs pris en charge

Chaque projet peut posséder des attributs standard et des attributs personnalisés. Les attributs standard sont des attributs qu’Amazon Pinpoint créé automatiquement pour tout projet. Les attributs personnalisés sont des attributs que vous créez de manière facultative pour un projet. Il existe trois types d'attributs personnalisés :

• Attributs utilisateur : ces attributs décrivent un utilisateur, par exemple son prénom, son nom de famille et sa date de naissance. Un utilisateur est une personne qui possède un ID utilisateur unique pour un projet.

• Attributs du point de terminaison : ces attributs décrivent un point de terminaison spécifique pour un utilisateur. Un point de terminaison est une destination à laquelle vous pouvez envoyer des messages, par exemple une adresse électronique, un numéro de téléphone ou un appareil mobile. Chaque utilisateur peut être associé à un ou plusieurs points de terminaison. Par exemple, si vous communiquez avec un utilisateur par e-mail, SMS ou téléphone, l’utilisateur peut être associé à trois points de terminaison : un pour son adresse e-mail, un autre pour son numéro de téléphone portable et un autre pour son numéro de téléphone personnel (fixe).

• Attributs de métrique : ces attributs sont des métriques numériques que votre application envoie à Amazon Pinpoint pour des points de terminaison individuels, notamment le nombre de sessions pour une application mobile ou le nombre d’éléments restant dans un panier.

• Pincez les attributs : ces attributs sont des identifiants uniques pour votre application, votre campagne ou votre parcours.

En plus des attributs personnalisés et standard créés par Amazon Pinpoint ou par vous-même pour vos projets, Amazon Pinpoint prend en charge les attributs recommandés. Un attribut recommandé est un attribut qui stocke temporairement des recommandations personnalisées pour les utilisateurs ou les points de terminaison. Amazon Pinpoint extrait ces recommandations à partir des modèles de recommandation que vous configurez pour utiliser. Les attributs recommandés ne sont pas associés à des projets spécifiques. Au lieu de cela, ils sont associés à votre compte Amazon Pinpoint. Pour de plus amples informations sur l'utilisation des modèles de recommandation, veuillez consulter Modèles de machine learning.

Vous pouvez utiliser n'importe quel attribut standard, personnalisé ou recommandé dans une variable de message. Le tableau suivant indique le texte qui s'affiche dans la variable de message pour chaque attribut pris en charge et décrit chaque attribut. Dans le tableau, custom_attribute indique le texte qui apparaît dans une variable pour un attribut personnalisé. Dans ces cas, remplacez custom_attribute par le nom de l'attribut personnalisé. Par exemple, si votre projet stocke les prénoms des utilisateurs dans un attribut utilisateur personnalisé nommé FirstName et que vous ajoutez une variable pour cet attribut, le texte de la variable est {{User.UserAttributes.FirstName}}.

Attribut	Description
Address	Adresse de destination pour les messages ou les notifications push que vous envoyez au point de terminaison, par exemple, une adresse e-mail, un numéro de téléphone ou un jeton d’appareil.
Pinpoint.ApplicationId	Identifiant unique de l'application.
Attributes.custom_attribute	Attribut de point de terminaison personnalisé décrivant le point de terminaison.
Pinpoint.CampaignId	Identifiant unique de la campagne.
ChannelType	Canal à utiliser lors de l'envoi de messages ou de notifications push au point de terminaison. Par exemple : APNS : pour un point de terminaison qui peut recevoir des notifications push que vous envoyez via le canal du service Apple Push Notification (APN) aux applications qui s'exécutent sur des appareils iOS. EMAIL : pour un point de terminaison qui peut recevoir des e-mails. GCM : pour un point de terminaison qui peut recevoir des notifications push que vous envoyez via le canal Firebase Cloud Messaging (FCM) aux applications qui s'exécutent sur des appareils Android. SMS : pour un point de terminaison qui peut recevoir des SMS. VOICE : pour un point de terminaison qui peut recevoir des messages vocaux.
CreationDate	Date et heure auxquelles le point de terminaison a été ajouté au projet, au format ISO 8601. Par exemple, 2019-06-30T11:45:25.220Z pour 11:45 UTC le 30 juin 2019.
Demographic.AppVersion	Numéro de version de l'application associée au point de terminaison.
Demographic.Locale	Les paramètres régionaux du point de terminaison, au format suivant : code ISO 639-1 alpha-2 suivi d'un trait de soulignement (_), suivi d'une valeur ISO 3166-1 alpha-2 . Par exemple, en_US est l’anglais pour les États-Unis.
Demographic.Make	Fabricant du terminal de point de terminaison, comme apple ou samsung.
Demographic.Model	Nom ou numéro du modèle du périphérique du point de terminaison, notamment iPhone ou SM-G900F.
Demographic.ModelVersion	Version du modèle du terminal de point de terminaison.
Demographic.Platform	Système d'exploitation du terminal de point de terminaison, notamment ios ou android.
Demographic.PlatformVersion	Version du système d'exploitation sur le périphérique du point de terminaison.
Demographic.Timezone	Fuseau horaire du point de terminaison, en tant que valeur de base de données tz. Par exemple, America/Los_Angeles pour Heure du Pacifique (Amérique du Nord).
EffectiveDate	Heure et date de la dernière mise à jour du point de terminaison, au format ISO 8601. Par exemple, 2019-08-23T10:54:35.220Z pour 10:54 UTC le 23 août 2019.
EndpointId	Identifiant unique du point de terminaison.
EndpointStatus	Que ce soit pour envoyer des messages ou des notifications push au point de terminaison : ACTIVE, envoyez des messages au point de terminaison ou INACTIVE, n'envoyez pas de messages au point de terminaison.
Id	Identifiant unique du point de terminaison.
Pinpoint.JourneyId	L'identifiant unique du trajet.
Location.City	Ville où se trouve le point de terminaison.
Location.Country	Code à deux lettres du pays ou de la région dans lequel/laquelle se trouve le point de terminaison, au format ISO 3166-1 alpha-2. Par exemple, US pour les États-Unis.
Location.Latitude	Latitude du point de terminaison, arrondie à une décimale.
Location.Longitude	Longitude du point de terminaison, arrondie à une décimale.
Location.PostalCode	Code postal ou ZIP de la zone où se trouve le point de terminaison.
Location.Region	Nom de la région, notamment un État ou une province, où se trouve le point de terminaison.
Metrics.custom_attribute	Métrique numérique personnalisée que votre application indique à Amazon Pinpoint pour le point de terminaison.
OptOut	Si un utilisateur a choisi de ne plus recevoir de messages et de notifications push de votre part : ALL, l'utilisateur a choisi de ne pas recevoir de messages ou de notifications push ; ou NONE, l'utilisateur souhaite continuer à recevoir tous les messages et notifications push.
RecommendationItems	Attribut recommandé standard qui stocke une recommandation pour le point de terminaison ou l'utilisateur. Cet attribut contient du texte fourni directement par un modèle de recommandation.
RecommendationItems.[#]	Attribut recommandé standard qui stocke une liste ordonnée de 2 à 5 recommandations pour le point de terminaison ou l’utilisateur. Cet attribut contient du texte fourni directement par un modèle de recommandation. L'espace réservé numérique (.[#]) indique que l'attribut contient plusieurs valeurs. Une variable de message pour cet attribut peut faire référence à une valeur spécifique dans la liste.
Recommendations.custom_attribute	Attribut recommandé personnalisé qui stocke une recommandation pour le point de terminaison ou l'utilisateur. Cet attribut contient du contenu fourni par un modèle de recommandation et amélioré par une AWS Lambda fonction.
Recommendations.custom_attribute.[#]	Attribut recommandé personnalisé qui stocke plusieurs recommandations pour le point de terminaison ou l'utilisateur. Cet attribut contient du contenu fourni par un modèle de recommandation et amélioré par une fonction AWS Lambda . L'espace réservé numérique (.[#]) indique que l'attribut contient plusieurs valeurs. Une variable de message pour cet attribut peut faire référence à l'une de ces valeurs spécifiquement.
RequestId	Identifiant unique de la dernière demande de mise à jour du point de terminaison.
User.UserAttributes.custom_attribute	Attribut utilisateur personnalisé décrivant l'utilisateur.
User.UserId	Un identifiant unique pour l'utilisateur.