Fullstory

La plateforme de données comportementales de Fullstory aide les leaders technologiques à prendre de meilleures décisions, plus éclairées. En injectant des données comportementales numériques dans leur stack d’analyse, la technologie brevetée de Fullstory libère la puissance des données comportementales de qualité à grande échelle, transformant chaque visite numérique en informations exploitables.

Cette intégration est maintenue par Fullstory

À propos de cette intégration

Vous pouvez exploiter les informations de Fullstory dans Braze pour dresser un portrait instantané de l’expérience d’un utilisateur sur votre site web ou votre application, et ainsi diffuser des messages ultra-contextuels. L’API Session Summary de Fullstory permet de capturer des métadonnées détaillées sur le comportement de navigation d’un utilisateur afin de les utiliser dans la communication Braze, ce qui est particulièrement puissant lorsque cette fonctionnalité est exploitée dans un parcours de communication en plusieurs étapes comme un Canvas.

La valeur en temps réel des données de résumé de session de Fullstory est optimisée grâce au contenu connecté. En utilisant le contenu connecté dans une étape Canvas Context, vous pouvez stocker les données de Fullstory tout au long du parcours Canvas d’un utilisateur pour les utiliser dans toutes les étapes Canvas suivantes. Cela évite également d’écrire ces données dans un profil utilisateur Braze par le biais d’événements personnalisés ou d’attributs.

Dans l’exemple suivant, les données Canvas Context sont exploitées dans une étape Canvas Agent IA pour générer le message optimal encourageant un utilisateur à reprendre un panier abandonné. Cependant, vous pouvez exploiter ces données pour personnaliser le message directement, pour déterminer le parcours de l’utilisateur avec des parcours d’audience, ou pour déterminer le texte ou les ressources utilisés dans les étapes de communication suivantes.

Prérequis

Avant de commencer, vous aurez besoin des éléments suivants :

Important

Braze Agents, Canvas Context et les jetons d’autorisation de contenu connecté sont tous en accès anticipé. Si vous souhaitez tirer parti de cette solution, contactez votre CSM Braze pour activer ces outils.

Intégrer Fullstory

Étape 1 : Configurer Fullstory pour l’activation de l’API Session Summary

Étape 1.1 : Récupérer le jeton d’authentification pour l’endpoint de l’API Session Summary

Pour créer une clé API Fullstory :

1. Dans Fullstory, accédez à Settings > API Keys.
2. Sélectionnez le niveau de permission Standard.
3. Copiez immédiatement la valeur de la clé, car elle n’apparaît qu’une seule fois.

Étape 1.2 : Créer un identifiant de profil de résumé de session

En suivant les instructions de Fullstory, créez un profil de résumé de session à l’aide de l’endpoint dédié. C’est ici que vous définissez le type de données que vous souhaitez que la réponse du résumé de session fournisse à Braze.

Dans la réponse à cette requête, Fullstory fournit un identifiant de profil de session. Cet identifiant de profil est un composant essentiel du corps de la requête de contenu connecté utilisé dans le cas d’usage suivant.

Étape 2 : Créer l’authentification par jeton pour le contenu connecté

1. Dans Braze, accédez à Paramètres > Paramètres de l’espace de travail > Contenu connecté > Ajouter des identifiants > Authentification par jeton.
2. Nommez l’authentification fullstory.
3. Ajoutez la clé d’en-tête « Authorization ». Renseignez la valeur d’en-tête fournie par Fullstory à l’étape précédente.
4. Sous Domaine autorisé, saisissez api.fullstory.com.

Cas d’usage

Créer des parcours de messages dynamiques

Grâce aux Activation Streams de Fullstory, vous pouvez déclencher des Canvas Braze immédiatement après des interactions clés de l’utilisateur. La puissance de cette intégration réside dans le client_session_id unique (accessible via {{canvas_entry_properties.${client_session_id}}}), que le système transmet automatiquement de Fullstory à Braze. Cet identifiant agit comme une clé, permettant à Braze de récupérer le résumé complet de la session correspondant exactement à ce que l’utilisateur a vécu.

En tirant parti des étapes de contexte Canvas et du contenu connecté, vous pouvez utiliser cet identifiant pour effectuer une requête API vers Fullstory, récupérer les données de session et les stocker comme variable pour les utiliser plus tard dans le parcours.

Avec le jeton d’autorisation créé précédemment, utilisez la structure de requête suivante pour récupérer les données du résumé de session.

1
2
{% connected_content https://api.fullstory.com/v2/sessions/{{canvas_entry_properties.${client_session_id} | url_encode}}/summary?config_profile=[YOUR-FULLSTORY-PROFILE-ID] :auth_credentials fullstory :save summary_result %}
{{summary_result | as_json_string }}

Remarque

La réponse est stockée sous l’étiquette Liquid {{context.${summary_result}.response}}. Utilisez cette étiquette de contexte dans les étapes Canvas suivantes.

À ce stade, le Canvas peut accéder à la réponse de l’appel de contenu connecté, qui contient l’intégralité du payload du message pour la session de l’utilisateur.

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
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
{
    "response": {
        "primary_goal": "User attempted to update payment method.",
        "issues_encountered": [
            "Received 'invalid card number' error twice.",
            "Clicked 'Submit' button multiple times with apparent frustration (based on event patterns)."
        ],
        "final_action": "Navigated away from payment page to dashboard.",
        "reason_for_termination_suggestion": "Could not update payment method successfully.",
        "help_pages_visited": [
            "/help/payment-errors"
        ]
    },
    "response_schema": {
        "type": "OBJECT",
        "properties": {
            "primary_goal": {
                "type": "STRING",
                "description": "A summary of the user's main objective during the session."
            },
            "issues_encountered": {
                "type": "ARRAY",
                "description": "A list of problems or errors the user faced.",
                "items": {
                    "type": "STRING",
                    "description": "A description of a single issue."
                }
            },
            "final_action": {
                "type": "STRING",
                "description": "The last significant action the user took before the session ended."
            },
            "reason_for_termination_suggestion": {
                "type": "STRING",
                "description": "A suggested reason for why the user ended their session."
            },
            "help_pages_visited": {
                "type": "ARRAY",
                "description": "A list of URLs for help or documentation pages the user visited.",
                "items": {
                    "type": "STRING",
                    "description": "The URL of a help page."
                }
            }
        },
        "required": [
            "primary_goal",
            "issues_encountered",
            "final_action",
            "reason_for_termination_suggestion",
            "help_pages_visited"
        ]
    }
}

Vous pouvez exploiter n’importe quelle donnée disponible dans l’objet précédent en utilisant l’étiquette Liquid de contexte plus tard dans le parcours Canvas de l’utilisateur. Les étapes suivantes montrent comment utiliser ces données dans une étape Agent.

Remarque

Pour éviter tout comportement inattendu, ajoutez une étape de parcours d’audience après l’étape de contexte, qui peut exclure les utilisateurs du contexte si leur étiquette de contexte est vide, ce qui indique que l’appel de contenu connecté a échoué ou n’a renvoyé aucune information.

Produire un contenu approprié

En créant une étape Agent dans un Canvas déclenché par Fullstory, et en incluant l’étape de contexte décrite dans cette section, vous pouvez référencer les données de résumé de session de Fullstory dans l’agent.

Dans cet exemple, vous utilisez ces données pour permettre à l’agent Braze de générer un contenu de message approprié destiné à une Content Card, afin d’encourager l’utilisateur à revenir à son panier abandonné.

Utilisez le même nom pour l’étiquette Liquid de contexte créée dans cette étape que celle utilisée dans l’étape Agent IA créée précédemment.

Le prompt requis varie selon votre cas d’usage. Pour les bonnes pratiques de création de prompts d’agent efficaces, consultez Rédiger des instructions.

Dans votre Canvas, sélectionnez une étape Agent IA, puis sélectionnez l’agent Session Context dans le menu déroulant. Enregistrez la sortie comme variable, dans ce cas « message », que vous pouvez insérer dans le contenu du message en utilisant l’étiquette Liquid {{context.${message}.message}}.

Créez une étape Message qui exploite le contenu généré par l’agent IA. Utilisez l’étiquette Liquid dans cette étape.

Important

L’API Session Summary de Fullstory peut renvoyer des données d’identification sensibles de l’utilisateur. Pour garantir la conformité lors de la manipulation des données d’identification (PII), confirmez que vos règles de capture de données Fullstory excluent les données d’identification avant d’exploiter ce cas d’usage.