Skip to content

Fullstory

Fullstory의 행동 데이터 플랫폼은 기술 리더가 더 나은 정보에 기반한 의사 결정을 내릴 수 있도록 지원합니다. Fullstory의 특허 기술은 디지털 행동 데이터를 분석 스택에 주입하여 양질의 행동 데이터를 대규모로 활용함으로써 모든 디지털 방문을 유용한 인사이트로 전환합니다.

이 통합은 Fullstory에서 유지 관리합니다.

이 통합 정보

Braze에서 Fullstory 인사이트를 활용하여 사용자의 웹사이트 또는 앱 경험에 대한 순간순간의 그림을 구축하고 고도로 상황별 메시징을 전달할 수 있습니다. Fullstory의 세션 요약 API를 사용하면 사용자의 브라우징 행동에 대한 상세한 메타데이터를 캡처하여 Braze 메시징에 사용할 수 있으며, 이는 특히 Canvas와 같은 다단계 메시징 여정에서 활용할 때 강력합니다.

Fullstory의 세션 요약 데이터의 실시간 가치는 연결된 콘텐츠를 통해 가장 잘 활용됩니다. Canvas 컨텍스트 단계에서 연결된 콘텐츠를 사용하면 사용자의 Canvas 여정 전반에 걸쳐 Fullstory의 데이터를 저장하여 이후의 모든 캔버스 단계에서 사용할 수 있습니다. 이렇게 하면 커스텀 이벤트나 속성을 통해 이 데이터를 Braze 고객 프로필에 기록할 필요가 없습니다.

다음 예시에서는 Canvas 컨텍스트 데이터를 에이전트 AI Canvas 단계에서 활용하여 사용자가 유기한 장바구니를 다시 집어들도록 유도하는 최적의 메시지를 생성합니다. 그러나 데이터를 활용하여 메시지를 직접 개인화하거나, 오디언스 경로를 통해 사용자의 여정을 결정하거나, 후속 메시징 단계에서 사용되는 카피 또는 자산을 결정할 수도 있습니다.

필수 조건

시작하기 전에 다음이 필요합니다:

Fullstory 통합하기

1단계: 세션 요약 API 활성화를 위한 Fullstory 설정

1.1단계: 세션 요약 API 엔드포인트에 대한 인증 토큰 가져오기

Fullstory API 키를 생성하려면:

  1. Fullstory에서 Settings > API Keys로 이동합니다.
  2. Standard 권한 수준을 선택합니다.
  3. 키 값은 한 번만 표시되므로 즉시 복사합니다.

1.2단계: 세션 요약 프로필 ID 생성

Fullstory의 안내에 따라 전용 엔드포인트를 사용하여 세션 요약 프로필을 생성합니다. 여기에서 세션 요약 응답이 Braze에 제공할 데이터의 종류를 정의합니다.

이 요청에 대한 응답으로 Fullstory는 세션 프로필 ID를 제공합니다. 이 프로필 ID는 다음 사용 사례에서 사용되는 연결된 콘텐츠 요청 본문의 핵심 구성요소입니다.

2단계: 연결된 콘텐츠 토큰 인증 생성

  1. Braze에서 Settings > Workspace Settings > Connected Content > Add Credential > Token Authentication으로 이동합니다.
  2. 인증 이름을 fullstory로 지정합니다.
  3. 헤더 키 “Authorization”을 추가합니다. 이전 단계에서 Fullstory가 제공한 헤더 값을 입력합니다.
  4. Allowed Domain 아래에 api.fullstory.com을 입력합니다.

자격 증명 편집 필드를 보여주는 Braze 스크린샷

활용 사례

동적 메시지 여정 생성

Fullstory의 Activation Streams를 사용하면 주요 사용자 인터랙션 직후에 Braze Canvases를 트리거할 수 있습니다. 이 통합의 핵심은 고유한 client_session_id({{canvas_entry_properties.${client_session_id}}}를 통해 액세스 가능)에 있으며, 시스템이 Fullstory에서 Braze로 자동으로 전달합니다. 이 ID는 키 역할을 하여 Braze가 사용자가 경험한 전체 세션 요약을 정확하게 가져올 수 있도록 합니다.

Canvas 컨텍스트 단계와 연결된 콘텐츠를 활용하면 이 ID를 사용하여 Fullstory에 API 요청을 보내고 세션 데이터를 검색하여 나중에 여정에서 사용할 수 있도록 변수로 저장할 수 있습니다.

세션 요약을 검색하기 위해 컨텍스트 변수 "summary_result"가 생성되고 Fullstory로의 연결된 콘텐츠 호출로 채워지는 것을 보여주는 Braze Canvas 컨텍스트 단계

앞서 생성한 승인 토큰을 사용하여 다음 요청 구조로 세션 요약 데이터를 가져옵니다.

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

이 단계에서 Canvas는 사용자 세션에 대한 전체 메시지 페이로드가 포함된 연결된 콘텐츠 호출에 대한 응답에 액세스할 수 있습니다.

세션 요약 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"
        ]
    }
}

나중에 사용자의 Canvas 여정에서 컨텍스트 Liquid 태그를 사용하여 위 오브젝트에서 사용 가능한 모든 데이터를 활용할 수 있습니다. 다음 단계에서는 에이전트 단계에서 이 데이터를 사용하는 방법을 보여줍니다.

적절한 카피 생성

Fullstory가 트리거한 Canvas에 에이전트 단계를 생성하고 위에서 설명한 컨텍스트 단계를 포함하면 에이전트에서 Fullstory의 세션 요약 데이터를 참조할 수 있습니다.

이 예시에서는 이 데이터를 사용하여 Braze 에이전트가 콘텐츠 카드에 사용할 적절한 메시지 카피를 생성하도록 하여 사용자가 유기한 장바구니로 돌아오도록 유도합니다.

프롬프트가 표시된 Braze 에이전트 컨텍스트 크리에이터 스크린샷

이 단계에서 생성한 컨텍스트 Liquid 태그의 이름은 앞서 생성한 AI 에이전트 단계에서 사용한 컨텍스트 Liquid 태그와 동일한 이름을 사용합니다.

사용 사례에 따라 필요한 프롬프트는 다릅니다. 효과적인 에이전트 프롬프트를 만들기 위한 모범 사례는 작성 지침을 참조하세요.

Canvas에서 AI 에이전트 단계를 선택한 다음 드롭다운에서 Session Context 에이전트를 선택합니다. 출력을 변수(이 경우 “message”)로 저장하면 Liquid 태그 {{context.${message}.message}}를 사용하여 메시지 카피에 배치할 수 있습니다.

프롬프트가 표시된 Braze 에이전트 컨텍스트 Canvas 단계 스크린샷

AI 에이전트가 생성한 카피를 활용하는 메시지 단계를 생성합니다. 이 단계에서 Liquid 태그를 사용합니다.
New Stuff!