Plate-forme de fidélisation SessionM
SessionM est une plateforme d’engagement et de fidélisation des clients qui offre des fonctionnalités de gestion de campagne et des solutions de gestion de la fidélisation pour aider les marketeurs à mener un ciblage de proximité afin d’augmenter l’engagement et le bénéfice.
Conditions préalables
Source | Condition | Descriptif |
---|---|---|
Braze | Une clé de l’API REST de Braze | Une clé API REST de Braze avec des autorisations trigger_send . Elle peut être créée dans le tableau de bord de Braze depuis Paramètres > Clés d’API. |
Braze | Un endpoint REST Braze | L’URL de votre endpoint REST. Votre endpoint dépendra de l’URL de Braze pour votre instance. |
Braze et SessionM | Identifiant correspondant | Pour utiliser l’intégration, assurez-vous que SessionM et Braze disposent tous deux d’un enregistrement des identifiants utilisés par chaque plateforme. Les références à user_id correspondent à l’identifiant de l’utilisateur de SessionM généré au moment de la création du profil dans SessionM. |
SessionM | Un compte SessionM | Un compte SessionM est nécessaire pour profiter de ce partenariat. |
SessionM | Un endpoint REST de SessionM Core | Votre endpoint dépendra de l’URL SessionM de votre instance. Celui-ci peut être créé dans le tableau de bord SessionM à partir de Propriétés numériques. |
SessionM | Une clé de l’API REST de SessionM Core | La clé API de SessionM associée à votre instance et à l’intégration de Braze. Cette touche peut être utilisée pour tous les appels de base, y compris les tags. Celui-ci peut être créé dans le tableau de bord SessionM à partir de Propriétés numériques. |
SessionM | Un secret de l’API REST de SessionM Core | Le secret API de SessionM associé à votre instance et à l’intégration Braze. Cette touche peut être utilisée pour tous les appels de base, y compris les tags. Celui-ci peut être créé dans le tableau de bord SessionM à partir de Propriétés numériques. |
SessionM | Un endpoint REST de SessionM Connect | Votre endpoint dépendra de l’URL SessionM de votre instance. Veuillez contacter votre gestionnaire de compte technique ou l’équipe de réception/distribution de SessionM pour obtenir des informations. |
SessionM | Une chaîne de caractères d’autorisation REST de SessionM Connect | La chaîne de caractères d’autorisation de base de SessionM Connect associée à votre instance. Cette chaîne de caractères d’authentification peut être utilisée pour tous les appels basés sur la connexion, y compris get_user_offers. Veuillez contacter votre gestionnaire de compte technique ou l’équipe de réception/distribution de SessionM pour obtenir des informations. |
SessionM | A SessionM Connect REST Retailer ID | Une identification unique du client associé à votre instance. Contactez votre gestionnaire de compte technique ou l’équipe de réception/distribution de SessionM. |
Si vous utilisez la navigation plus ancienne, vous pouvez créer une clé API dans la console de développement > Paramètres de l’API.
Cas d’utilisation
Les cas d’utilisation suivants illustrent quelques façons de tirer parti de l’intégration de SessionM et de Braze.
- Créez une segmentation qui intègre les données de toutes les plateformes de fidélisation, de gestion de la clientèle et d’envoi de messages.
- Utilisez une segmentation solide pour cibler des ensembles d’utilisateurs spécifiques avec des offres et des promotions.
- Profitez des informations les plus récentes sur les utilisateurs, les offres et la fidélité lors de l’envoi de messages.
- Fournir des notifications détaillées aux clients sur l’avancement et l’achèvement des activités promotionnelles et de fidélisation.
- Notifiez les clients lorsqu’une nouvelle offre est attribuée et fournissez les détails de l’offre.
Intégration de SessionM avec Braze
Étape 1 : Créer un segment en Braze
Dans Braze, créez un segment d’utilisateurs à cibler avec des promotions et des offres de SessionM.
Étape 2 : Importer des segments Braze dans SessionM
Option 1 : Exporter vers l’endpoint Tag de SessionM (recommandé)
Tout d’abord, créez une campagne webhook à Braze et définissez l’URL du webhook sur {{endpoint_core}}/priv/v1/apps/{{appkey_core}}/users/{{${user_id}}}/tags
. Utilisez Liquid pour définir le site user_id
dans l’URL.
En utilisant un corps de requête en texte brut, composez le corps du webhook pour inclure les tags souhaités à ajouter au profil utilisateur dans SessionM et la durée de vie souhaitée. Voici un exemple :
1
2
3
4
5
6
{
"tags":[
"braze_test"
],
"ttl":2592000
}
Dans l’onglet Paramètres, ajoutez les paires clé-valeur pour chaque champ d’en-tête de requête :
- Créez une clé Content-Type
avec une valeur correspondante application/json
- Créez une clé Authorization
avec une valeur correspondante Basic YOUR-ENCODED-STRING-KEY
. Contactez votre équipe Teams pour obtenir la chaîne de caractères codée de votre endpoint.
Planifiez votre réception/distribution, définissez vos Audiences cibles pour cibler le segment que vous avez créé précédemment, puis lancez votre campagne.
Ce processus peut également être effectué par un client API, tel que Postman, en effectuant une demande directement à l’endpoint SessionM Tag en spécifiant le client, le nom de l’étiquette et une durée en vie pour chaque utilisateur dans l’appel (un seul utilisateur par appel).
L’exemple de requête suivant utilise cURL.
1
2
3
4
5
6
7
8
9
10
curl --location -g --request POST '{{endpoint_core}}/priv/v1/apps/{{apikey_core}}/users/{{user_id}}/tags' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{base64_encoded_string}}' \
--data-raw '{
"tags":[
"tagname1",
"tagname2"
],
"ttl":20000
}'
Option 2 : Importation CSV
Exportez votre segment Braze à l’aide du segmenteur Braze et fournissez à SessionM un fichier CSV contenant les clients à étiqueter, le nom de l’étiquette et la durée de vie pour chaque utilisateur du fichier.
Récupération du portefeuille d’offres en temps réel avec Braze
L’intégration de SessionM avec Braze permet d’extraire en temps réel les données des utilisateurs de SessionM au moment de l’envoi du message, en utilisant le contenu connecté, afin d’éliminer le risque de communiquer aux clients des offres de fidélité périmées, expirées ou déjà échangées.
L’exemple suivant montre l’utilisation du contenu connecté pour intégrer les données du portefeuille d’offres dans un message. Cependant, le contenu connecté peut être utilisé avec n’importe quel endpoint Connect de SessionM.
Étape 1 : Offre d’émission dans la SessionM
SessionM émet des offres aux clients à partir de plusieurs leviers internes différents qui peuvent être configurés. Après avoir été émises, les offres sont placées dans un état que SessionM appelle le “portefeuille d’offres”.
Le client doit effectuer l’action requise ou répondre au ciblage et reçoit l’offre dans SessionM.
SessionM ajoute ensuite l’offre au portefeuille du client dans l’état émis.
Étape 2 : Appeler l’API du portefeuille de l’offre SessionM
Dans la campagne ou l’étape du canvas avec les offres de SessionM, utilisez le contenu connecté pour faire un appel API au endpoint de SessionM get_user_offers
.
Dans la demande de contenu connecté, spécifiez la SessionM user_id
de l’utilisateur et votre retailer_id
pour récupérer la liste complète des offres actives que le client a dans son portefeuille. Chaque demande adressée à cet endpoint ne peut concerner qu’un seul utilisateur. Contactez l’équipe de Teams pour obtenir la clé de chaîne de caractères codée pour l’en-tête d’autorisation de base dans votre appel au contenu connecté.
Dans le corps de la demande, culture
est remplacé par défaut par en-US
, mais vous pouvez utiliser Liquid pour définir la langue d’un utilisateur pour les offres multilingues de SessionM (par exemple, en utilisant "culture":"{{${language}}}"
).
1
2
3
4
5
6
7
8
9
10
11
12
13
14
{% capture postbody %}
{"retailer_id":"YOUR-RETAIL-ID","user_id":"{{${user_id}}}","skip":0,"take":1000,"include_pending_extended_data":false,"culture":"en-US"}
{% endcapture %}
{% connected_content
{{endpoint_connect}}/offers/api/2.0/offers/get_user_offers
:method post
:headers {
"Content-Type": "application/json",
"Authorization": "Basic YOUR-BASE64-ENCODED-KEY"
}
:body {{postbody}}
:save wallet
%}
Étape 3 : Remplir le portefeuille d’offres à l’envoi de messages de Braze
Lorsqu’une demande est adressée à l’endpoint, SessionM renvoie la liste complète des offres dans l’état émis, ainsi que les détails complets de chaque offre. Voici un exemple de réponse renvoyée :
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
{
"status": "ok",
"payload": {
"user": {
"opted_in": false,
"activated": false,
...
},
"user_id": "00000000-0000-0000-0000-000000000000",
"user_offers": [
{
"offer_id": "1a2b3324-1da6-4e49-b921-afc386dabb60",
"offer_group_id": "00000000-0000-0000-0000-000000000000",
"offer_type": "manual_fulfillment",
...
}
],
"total_records": 1,
"offer_groups": [
{
"id": "00000000-0000-0000-0000-000000000000",
"name": "All Offers",
"sort_order": 0
}
],
"offer_categories": [
{
"id": "9a82f973-aae6-4e10-839b-7117a852cf9e",
"name": "All Offers",
"sort_order": 0
}
],
"total_points": 1000,
"available_points": 100
}
}
En utilisant la notation par points liquides, il est possible de l’insérer dans le message. Par exemple, pour personnaliser le message avec le résultat offer_id
, vous pouvez exploiter la charge utile de retour en utilisant {{wallet.payload.available_points}
, qui renvoie 100
.
Il s’agit d’une API individuelle. Si vous avez l’intention d’envoyer un lot de plus de 500 utilisateurs, contactez votre équipe de compte SessionM pour savoir comment incorporer les données en vrac dans l’intégration.
Mise en place d’un envoi déclenché de messages
L’intégration entre SessionM et Braze permet aux données du profil de l’utilisateur, aux détails de l’offre et aux soldes de points d’être dynamiquement intégrés dans les messages et envoyés en temps réel au client au point d’action.
Étape 1 : L’équipe de réception/distribution de SessionM configure les modèles
Collaborez avec votre équipe de réception/distribution de SessionM pour développer des modèles à utiliser dans vos envois de messages déclenchés. SessionM insérera les données du profil de l’utilisateur, les détails de l’offre et les soldes de points dans le message et les déclenchera dans Braze pour un envoi de messages personnalisés en temps réel.
Les champs standard présents dans tous les modèles de SessionM sont les suivants :
canvas_id
campaign_id
broadcast flag
customer identifier
email address
Si vous réglez broadcast flag
sur true
, le message sera envoyé à l’ensemble du segment que la campagne ou le Canvas cible dans Braze.
Des champs supplémentaires peuvent être configurés en fonction des besoins spécifiques :
- Données de l’offre :
offer_id
,offer title
,user offer id
,description
,terms and conditions
,logo
,pos discount id
,expiration date
- Données relatives à l’attribution des points :
point award amount
,point account name
- Données relatives au déclencheur d’événement : Toute donnée dans l’événement de déclenchement qui utilise le résultat du webhook de déclenchement/envoi.
- Données spécifiques à la campagne :
campaign runtime
,campaign_id
,campaign name
,campaign custom data
Les champs supplémentaires sont envoyés à Braze comme trigger_properties
pour la personnalisation du message.
Étape 2 : Créer une campagne ou un canvas de Braze
Créez dans Braze une campagne ou un canvas déclenché par l’API qui sera déclenché par SessionM. Si des champs supplémentaires ont été configurés, tels que offer_id
ou offer title
, utilisez Liquid (tel que {{api_trigger_properties.${offer_id}}}
) pour ajouter les champs personnalisés dans votre message.
Dans l’onglet Réception/distribution de la planification, notez l’ID de la campagne ou du canvas car il sera ajouté aux paramètres avancés de la campagne SessionM.
Finalisez les détails de votre campagne ou de votre canvas et sélectionnez Lancer.
Étape 3 : Créer une campagne de promotion ou d’envoi de messages pour la SessionM
Ensuite, créez votre campagne dans SessionM.
Mettez à jour les paramètres avancés de la campagne SessionM afin d’inclure la charge utile JSON suivante contenant le braze_campaign_id
ou braze_canvas_id
.
1
2
3
4
{
"braze_campaign_id": "{{CAMPAIGN ID}}",
"braze_canvas_id": "{{CANVAS ID}}",
}
Créez un message déclenché en fonction de la planification ou du comportement souhaité. Ensuite, sélectionnez la variante d’envoi de messages Braze dans le menu Message externe pour utiliser le modèle.
Ce modèle extrait les attributs statiques et dynamiques pertinents et fait appel au point d’extrémité de Braze.