História completa
A plataforma de dados comportamentais da Fullstory ajuda os líderes de tecnologia a tomar decisões melhores e mais bem informadas. Ao injetar dados comportamentais digitais em seu stack de análises, a tecnologia patenteada da Fullstory libera o poder dos dados comportamentais de qualidade em escala, transformando cada visita digital em insights práticos.
Essa integração é mantida pela Fullstory
Sobre essa integração
Você pode aproveitar os insights da Fullstory no Braze para criar imagens momento a momento da experiência de um usuário no site ou no app para fornecer mensagens hipercontextuais. A API de resumo de sessão da Fullstory possibilita a captura de metadados detalhados sobre o comportamento de navegação de um usuário para uso no envio de mensagens do Braze, o que é particularmente poderoso quando aproveitado em uma jornada de mensagens de várias etapas, como um Canva.
O valor em tempo real dos dados do Resumo da Sessão da Fullstory é melhor aproveitado por meio do Conteúdo Conectado. Ao usar o conteúdo conectado em uma etapa do Canvas Context, é possível armazenar os dados da Fullstory durante toda a jornada do usuário no Canvas para uso em qualquer etapa subsequente do Canvas. Isso também evita a necessidade de gravar esses dados em um perfil de usuário do Braze por meio de eventos ou atributos personalizados.
No exemplo a seguir, os dados do Canvas Context são aproveitados em uma etapa do Canva da IA do agente para gerar a mensagem ideal para incentivar um usuário a pegar de volta um carrinho abandonado. No entanto, é possível aproveitar os dados para personalizar a mensagem diretamente, para determinar a jornada do usuário por meio de jornadas do público ou para determinar a cópia ou os ativos usados nas etapas subsequentes do envio de mensagens.
Casos de uso

Pré-requisitos
Antes de começar, você precisa dos seguintes itens:
| Requisito | Descrição |
|---|---|
| Um token de autorização da API da sessão Fullstory | Consulte a etapa 1 abaixo. |
| Um token de autorização de conteúdo conectado Braze ativado | Veja a nota abaixo sobre o Acesso Antecipado |
| Etapa do contexto do Braze Canvas | Veja a nota abaixo sobre o Acesso Antecipado |
| Etapa de capacitação do Braze IA Agent | Veja a nota abaixo sobre o Acesso Antecipado |
Integrando o Fullstory
Etapa 1: Configure o Fullstory para ativar a API de resumo de sessão
A: Recuperação do token de autenticação para o ponto de extremidade da API Session Summary
Para criar uma chave de API da Fullstory, navegue até a plataforma da Fullstory e, em seguida, Configurações > Chaves de API. Selecione o nível de permissão Standard e copie imediatamente o valor da chave, pois ele aparece apenas uma vez.
B: Criação de um resumo da sessão ID do perfil
Seguindo as orientações da Fullstory, crie um perfil de resumo da sessão usando o endpoint dedicado. É aqui que você define o tipo de dados que deseja que a resposta do Resumo da sessão forneça ao Braze. Na resposta a essa solicitação, a Fullstory fornece um “ID de perfil” de sessão. Esse ID de perfil é um componente-chave do corpo da solicitação de conteúdo conectado usado no seguinte caso de uso.
Etapa 2: Criar a autenticação do token de conteúdo conectado
-
No Braze, navegue até Configurações > Configurações do espaço de trabalho > Conteúdo conectado > Adicionar credencial > Autenticação por token.
-
Nomeie a autenticação como “fullstory”.
-
Adicione a chave de cabeçalho “Authorization”. Forneça o valor do cabeçalho Fullstory fornecido na etapa anterior.
-
Em Allowed Domain (Domínio permitido), envie “api.fullstory.com”.

Caso de uso: Aproveite os dados de resumo da sessão do Fullstory e as etapas do contexto do Braze Canvas e os agentes de IA para criar jornadas dinâmicas de mensagens
Usando os fluxos de ativação da Fullstory, é possível disparar Braze Canvases imediatamente após as principais interações do usuário. O poder dessa integração está no site exclusivo client_session_id (acessível via {{canvas_entry_properties.${client_session_id}}}), que o sistema passa automaticamente do Fullstory para o Braze. Esse ID funciona como uma chave, permitindo que o Braze busque o resumo completo da sessão, exatamente o que o usuário experimentou.
Ao aproveitar as etapas do Canva Context e o Connected Content, você pode usar essa ID para fazer uma solicitação de API à Fullstory, recuperar os dados da sessão e armazená-los como uma variável para uso posterior na jornada.

Com o token de autorização criado anteriormente, use a seguinte estrutura de solicitação para extrair os dados do resumo da sessão.
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 }}
A resposta é armazenada como a tag Liquid {{context.${summary_result}.response}}. Usamos essa tag Context nas etapas subsequentes do Canva.
Nesse estágio, a tela pode acessar a resposta à chamada Connected Content, que contém toda a carga útil da mensagem para a sessão de um usuário.
Example Payload from Session Summary API
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"
]
}
}
É possível aproveitar qualquer um dos dados disponíveis no objeto acima usando a tag Liquid do contexto posteriormente na jornada do usuário no Canva. As etapas a seguir mostram como você pode usar esses dados em uma etapa do Canva do IA Agent.
Para evitar comportamentos inesperados, inclua uma jornada do público após a etapa Context, que pode retirar os usuários do contexto se a tag Context estiver vazia, indicando que a chamada de conteúdo conectado falhou ou não retornou nenhuma informação.

Crie um IA Agent que possa analisar as cargas úteis da Fullstory e produzir uma cópia apropriada para seu caso de uso
O guia de agentes do Braze descreve como os usuários do Braze podem criar agentes de IA. Ao inserir uma etapa do IA Agent em um Canvas disparado pelo Fullstory e incluir a etapa do Canvas Context descrita acima, os usuários podem alimentar o IA Agent com dados de resumo da sessão do Fullstory, para uma ampla gama de finalidades.
Neste exemplo, usamos esses dados para permitir que o IA Agent gere uma cópia de mensagem apropriada para uso em um cartão de conteúdo, o que pode incentivar o usuário a retornar à cesta abandonada.

Use o mesmo nome para a tag Context Liquid criada nesta etapa que a tag Context Liquid usada na etapa IA Agent criada anteriormente.
O prompt necessário para o seu caso de uso varia, mas para conhecer nossas práticas recomendadas para a criação de prompts de agente eficazes, consulte Instruções de redação na criação de agentes.
Em sua tela, selecione uma etapa do IA Agent e, em seguida, selecione o agente “Session Context” criado no menu suspenso. Salve a saída como uma variável, nesse caso “message”, que pode ser colocada na cópia da mensagem usando a tag Liquid {{context.${message}.message}}.

Crie uma etapa de mensagem que aproveite a cópia criada pelo IA Agent. Use a tag Liquid nessa etapa.
A API Session Summary da Fullstory pode retornar dados de usuários identificáveis e confidenciais. Para garantir a conformidade ao lidar com IPI (informações de identificação pessoal), certifique-se de que as regras de captura de dados do Fullstory excluam IPI antes de usar esse caso de uso.
Editar esta página no GitHub