Plateforme de fidélisation SessionM

SessionM est une plateforme d’engagement client et de fidélisation, faisant partie de Capillary Technologies, qui offre des fonctionnalités de gestion de campagne et des solutions de gestion de la fidélisation pour aider les marketeurs à mener des actions de ciblage afin d’augmenter l’engagement et la rentabilité.

Conditions préalables

Remarque

Si vous utilisez l’ancienne navigation, vous pouvez créer une clé API depuis Developer Console > API Settings.

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 robuste 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.
• Fournissez 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 dans Braze

Dans Braze, créez un segment d’utilisateurs à cibler avec des promotions et des offres 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 dans 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 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 Settings, ajoutez les paires clé-valeur pour chaque champ d’en-tête de requête : - Créez une clé Content-Type avec la valeur correspondante application/json - Créez une clé Authorization avec la valeur correspondante Basic YOUR-ENCODED-STRING-KEY. Contactez votre équipe SessionM pour obtenir la clé de chaîne encodée pour votre endpoint.

Planifiez votre envoi, définissez vos Target Audiences pour cibler le segment que vous avez créé précédemment, puis lancez votre campagne.

Important

Ce processus peut également être effectué via un client API, tel que Postman, en effectuant une requête directement vers l’endpoint SessionM Tag en spécifiant le client, le nom du tag et une durée de 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 du tag 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 utilisateur 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é obsolètes, expirées ou déjà utilisé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 : Émettre une offre dans 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 d’offres SessionM

Dans une campagne ou une étape Canvas avec les offres SessionM, utilisez le contenu connecté pour effectuer un appel API vers l’endpoint SessionM get_user_offers.

Dans la requête de contenu connecté, spécifiez le user_id SessionM 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 requête vers cet endpoint ne peut concerner qu’un seul utilisateur. Contactez l’équipe SessionM pour obtenir la clé de chaîne encodée pour l’en-tête d’autorisation Basic dans votre appel de contenu connecté.

Dans le corps de la requête, culture est défini par défaut sur 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 : Intégrer le portefeuille d’offres dans les messages Braze

Lorsqu’une requête est envoyé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 Liquid, ces données peuvent être intégrées dans le message. Par exemple, pour personnaliser le message avec le résultat offer_id, vous pouvez exploiter le payload de retour en utilisant {{wallet.payload.available_points}}, qui renvoie 100.

Remarque

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 masse dans l’intégration.

Mise en place de l’envoi de messages déclenchés

L’intégration entre SessionM et Braze permet aux données du profil 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 moment de l’action.

Étape 1 : L’équipe Delivery de SessionM configure les modèles

Collaborez avec votre équipe Delivery 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 utilisateur, les détails de l’offre et les soldes de points dans les messages et les déclenchera dans Braze pour un envoi de messages en temps réel au client.

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

Remarque

Lorsque vous définissez 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 d’attribution de points : point award amount, point account name
• Données de déclenchement d’événement : toute donnée dans l’événement de déclenchement qui utilise le résultat du webhook trigger/send
• Données spécifiques à la campagne : campaign runtime, campaign_id, campaign name, campaign custom data

Les champs supplémentaires sont envoyés à Braze en tant que trigger_properties pour la personnalisation du message.

Étape 2 : Créer une campagne ou un Canvas dans Braze

Créez dans Braze une campagne ou un Canvas déclenché par 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 (par exemple {{api_trigger_properties.${offer_id}}}) pour ajouter les champs personnalisés dans votre message.

Dans l’onglet Schedule Delivery, 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 Launch.

Étape 3 : Créer une campagne promotionnelle ou de messages dans SessionM

Ensuite, créez votre campagne dans SessionM.

Mettez à jour les paramètres avancés de la campagne SessionM afin d’inclure le payload JSON suivant contenant le braze_campaign_id ou le braze_canvas_id.

1
2
3
4
{
"braze_campaign_id": "{{CAMPAIGN ID}}",
"braze_canvas_id": "{{CANVAS ID}}",
}

Créez un déclencheur de message selon la planification ou le comportement souhaité. Ensuite, sélectionnez Braze Messaging Variant comme Messaging Variant dans le menu External Message pour utiliser le modèle.

Ce modèle extrait les attributs statiques et dynamiques pertinents et fait appel à l’endpoint de Braze.