Skip to content

Fullstory

La plataforma de datos de comportamiento de Fullstory ayuda a los líderes tecnológicos a tomar decisiones mejores y más informadas. Al inyectar datos de comportamiento digital en su pila de análisis, la tecnología patentada de Fullstory libera el poder de los datos de comportamiento de calidad a escala, transformando cada visita digital en análisis accionables.

Esta integración está mantenida por Fullstory

Acerca de esta integración

Puedes aprovechar la información de Fullstory en Braze para crear imágenes momento a momento de la experiencia de un usuario en tu sitio web o aplicación y ofrecer mensajería hipercontextual. La API de resumen de sesión de Fullstory permite capturar metadatos detallados sobre el comportamiento de navegación de un usuario para su uso en la mensajería de Braze, lo cual es particularmente potente cuando se aprovecha en un recorrido de mensajería de varios pasos como un Canvas.

El valor en tiempo real de los datos de resumen de sesión de Fullstory se aprovecha mejor a través de contenido conectado. Al utilizar contenido conectado en un paso de contexto de Canvas, puedes almacenar los datos de Fullstory a lo largo del recorrido de Canvas de un usuario para usarlos en cualquier paso posterior del Canvas. Esto también evita la necesidad de escribir estos datos en un perfil de usuario de Braze a través de eventos personalizados o atributos.

En el siguiente ejemplo, los datos de contexto de Canvas se aprovechan en un paso de Canvas de Agent AI para generar el mensaje óptimo que anime a un usuario a retomar un carrito abandonado. Sin embargo, puedes aprovechar los datos para personalizar el mensaje directamente, para determinar el recorrido del usuario con rutas de audiencia, o para determinar el texto o los activos utilizados en los pasos de mensajería posteriores.

Requisitos previos

Antes de empezar, necesitas lo siguiente:

Requisito Descripción
Un token de autorización de la API de sesión de Fullstory Consulta el paso 1 de esta guía.
Un token de autorización de contenido conectado de Braze habilitado Consulta la nota de acceso anticipado en esta sección.
Un paso de contexto en Canvas de Braze Consulta la nota de acceso anticipado en esta sección.
Paso de agente de BrazeAI habilitado Consulta la nota de acceso anticipado en esta sección.

Integrar Fullstory

Paso 1: Configurar Fullstory para la habilitación de la API de resumen de sesión

Paso 1.1: Recuperar el token de autenticación para el endpoint de la API de resumen de sesión

Para crear una clave de API de Fullstory:

  1. En Fullstory, ve a Settings > API Keys.
  2. Selecciona el nivel de permiso Standard.
  3. Copia el valor de la clave inmediatamente, ya que solo aparece una vez.

Paso 1.2: Crear un ID de perfil de resumen de sesión

Siguiendo las instrucciones de Fullstory, crea un perfil de resumen de sesión utilizando el endpoint dedicado. Aquí es donde defines qué tipo de datos quieres que la respuesta del resumen de sesión proporcione a Braze.

En la respuesta a esta solicitud, Fullstory proporciona un ID de perfil de sesión. Este ID de perfil es un componente clave del cuerpo de la solicitud de contenido conectado utilizado en el siguiente ejemplo.

Paso 2: Crear la autenticación por token de contenido conectado

  1. En Braze, ve a Configuración > Configuración del espacio de trabajo > Contenido conectado > Añadir credencial > Autenticación por token.
  2. Nombra la autenticación fullstory.
  3. Añade la clave de encabezado “Authorization”. Proporciona el valor del encabezado que Fullstory te dio en el paso anterior.
  4. En Dominio permitido, introduce api.fullstory.com.

Captura de pantalla de Braze mostrando los campos de edición de credenciales

Ejemplos

Crear recorridos de mensajes dinámicos

Mediante los Activation Streams de Fullstory, puedes desencadenar Canvas de Braze inmediatamente después de interacciones clave del usuario. El poder de esta integración reside en el client_session_id único (accesible mediante {{canvas_entry_properties.${client_session_id}}}), que el sistema pasa automáticamente de Fullstory a Braze. Este ID actúa como clave, permitiendo a Braze obtener el Resumen de sesión completo de exactamente lo que experimentó el usuario.

Aprovechando los pasos de Contexto de Canvas y el contenido conectado, puedes usar este ID para hacer una solicitud de API a Fullstory, recuperar los datos de la sesión y almacenarlos como variable para su uso posterior en el recorrido.

Paso de Contexto de Canvas en Braze que muestra la variable de contexto "summary_result" siendo creada y completada con una llamada de contenido conectado a Fullstory para recuperar un resumen de sesión

Con el token de autorización creado anteriormente, usa la siguiente estructura de solicitud para obtener los datos del resumen de sesión.

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 }}

En esta etapa, el Canvas puede acceder a la respuesta de la llamada de contenido conectado, que contiene toda la carga útil del mensaje para la sesión de un usuario.

Ejemplo de carga útil de la API de resumen de sesión
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"
        ]
    }
}

Puedes aprovechar cualquiera de los datos disponibles en el objeto anterior usando la etiqueta de Liquid de contexto más adelante en el recorrido del usuario en Canvas. Los siguientes pasos muestran cómo puedes usar estos datos en un paso de Agente.

Producir textos apropiados

Al crear un paso de Agente en un Canvas desencadenado por Fullstory e incluir el paso de Contexto descrito en esta sección, puedes hacer referencia a los datos del resumen de sesión de Fullstory en el agente.

En este ejemplo, usas estos datos para permitir que el agente de Braze genere textos de mensaje apropiados para su uso en una tarjeta de contenido, que puede animar al usuario a volver a su carrito abandonado.

Captura de pantalla del creador de Contexto de Agente de Braze con el prompt

Usa el mismo nombre para la etiqueta de Liquid de Contexto creada en este paso que la etiqueta de Liquid de contexto usada en el paso de Agente de IA creado anteriormente.

El prompt necesario para tu caso de uso varía. Para conocer las mejores prácticas sobre la creación de prompts efectivos para agentes, consulta Instrucciones de redacción.

En tu Canvas, selecciona un paso de Agente de IA, luego selecciona el agente Session Context del menú desplegable. Guarda la salida como una variable, en este caso “message”, que puedes colocar en el texto del mensaje usando la etiqueta de Liquid {{context.${message}.message}}.

Captura de pantalla del paso de Canvas de Contexto de Agente de Braze con el prompt

Crea un paso de Mensaje que aproveche el texto creado por el Agente de IA. Usa la etiqueta de Liquid en este paso.
New Stuff!