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 tirer parti des informations exploitables de Fullstory dans Braze pour créer des instantanés de l’expérience d’un utilisateur sur un site web ou une application, et ainsi envoyer 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 les messages Braze, ce qui est particulièrement puissant lorsqu’on l’exploite 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 réutiliser dans toutes les étapes Canvas suivantes. Cela évite également d’écrire ces données dans un profil utilisateur Braze via des custom events ou des attributs personnalisés.
Dans l’exemple suivant, les données de Canvas Context sont exploitées dans une étape Canvas Agent AI pour générer le message optimal encourageant un utilisateur à reprendre un panier abandonné. Cependant, vous pouvez également tirer parti de ces données pour personnaliser directement le message, déterminer le parcours de l’utilisateur à l’aide de parcours d’audience, ou encore définir le texte ou les ressources utilisés dans les étapes de communication suivantes.
Prérequis
Avant de commencer, vous avez besoin des éléments suivants :
| Condition requise | Description |
|---|---|
| Un jeton d’autorisation pour l’API Session de Fullstory | Voir l’étape 1 de ce guide. |
| Un jeton d’autorisation pour le contenu connecté Braze activé | Voir la note d’accès anticipé dans cette section. |
| Une étape de contexte Canvas Braze | Voir la note d’accès anticipé dans cette section. |
| Une étape BrazeAI Agent activée | Voir la note d’accès anticipé dans cette section. |
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 :
- Dans Fullstory, accédez à Settings > API Keys.
- Sélectionnez le niveau de permission Standard.
- 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 élément clé 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é
- Dans Braze, accédez à Settings > Workspace Settings > Connected Content > Add Credential > Token Authentication.
- Nommez l’authentification
fullstory. - Ajoutez la clé d’en-tête « Authorization ». Indiquez la valeur d’en-tête fournie par Fullstory à l’étape précédente.
- Sous Allowed Domain, saisissez api.fullstory.com.
Cas d’usage
Créer des parcours de messages dynamiques
En utilisant les Activation Streams de Fullstory, vous pouvez déclencher des Canvas Braze immédiatement après des interactions utilisateur clés. La puissance de cette intégration réside dans l’identifiant unique client_session_id (accessible via {{canvas_entry_properties.${client_session_id}}}), que le système transmet automatiquement de Fullstory à Braze. Cet ID agit comme une clé, permettant à Braze de récupérer le résumé de session complet correspondant exactement à ce que l’utilisateur a vécu.
En tirant parti des étapes Context du Canvas et du contenu connecté, vous pouvez utiliser cet ID pour envoyer une requête API à Fullstory, récupérer les données de session et les stocker en tant que variable pour une utilisation ultérieure 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 }}
La réponse est stockée sous la forme de l’étiquette Liquid {{context.${summary_result}.response}}. Utilisez cette étiquette Context dans les étapes suivantes du Canvas.
À 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.
Exemple de payload de l’API Session Summary
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.
Pour éviter tout comportement inattendu, incluez une étape de parcours d’audience après l’étape Context. Celle-ci peut exclure les utilisateurs du contexte si leur étiquette Context 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 Context décrite dans cette section, vous pouvez référencer les données du 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, qui peut encourager l’utilisateur à revenir à son panier abandonné.
Utilisez le même nom pour l’étiquette Liquid Context créée dans cette étape que celle utilisée dans l’étape AI Agent créée précédemment.
Le prompt requis varie en fonction de votre cas d’usage. Pour les bonnes pratiques sur la création de prompts d’agent efficaces, consultez Rédiger des instructions.
Dans votre Canvas, sélectionnez une étape AI Agent, puis sélectionnez l’agent Session Context dans le menu déroulant. Enregistrez la sortie en tant que 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’AI Agent. Utilisez l’étiquette Liquid dans cette étape.
L’API Session Summary de Fullstory peut renvoyer des données d’identification sensibles concernant les utilisateurs. Pour garantir la conformité lors du traitement des données d’identification (PII), confirmez que vos règles de capture de données Fullstory excluent les PII avant d’exploiter ce cas d’usage.