Skip to content

Fullstory

Fullstoryの行動データプラットフォームは、テクノロジーリーダーがより良い、より情報に基づいた意思決定を行えるよう支援します。デジタル行動データを分析スタックに注入することで、Fullstoryの特許取得済みテクノロジーは、質の高い行動データのパワーを大規模に引き出し、すべてのデジタル訪問をアクション可能なインサイトに変換します。

この統合はFullstoryによって維持されています。

この連携について

FullstoryのインサイトをBrazeで活用することで、ユーザーのWebサイトやアプリ体験をリアルタイムに把握し、状況に即したメッセージングを配信できます。FullstoryのSession Summary APIを使用すると、ユーザーの閲覧行動に関する詳細なメタデータをキャプチャし、Brazeのメッセージングで活用できます。これは、キャンバスのようなマルチステップのメッセージングジャーニーで特に効果を発揮します。

Fullstoryのセッションサマリーデータのリアルタイムな価値は、Connected Contentを通じて最大限に活用できます。キャンバスのコンテキストステップでConnected Contentを使用すると、ユーザーのキャンバスジャーニー全体を通じてFullstoryのデータを保持し、後続のキャンバスステップで利用できます。これにより、カスタムイベントや属性を通じてこのデータをBrazeのユーザープロファイルに書き込む必要がなくなります。

以下の例では、キャンバスのコンテキストデータをAgent AIキャンバスステップで活用し、ユーザーに放棄カートの購入を再開するよう促す最適なメッセージを生成しています。ただし、このデータを使用してメッセージを直接パーソナライズしたり、オーディエンスパスでユーザーのジャーニーを決定したり、後続のメッセージングステップで使用するコピーやアセットを決定したりすることもできます。

前提条件

始める前に、以下が必要です。

要件 説明
Fullstory Session API 認証トークン このガイドのステップ1を参照してください。
Braze Connected Content 認証トークンの有効化 このセクションの早期アクセスに関する注記を参照してください。
Braze キャンバスのコンテキストステップ このセクションの早期アクセスに関する注記を参照してください。
Braze AI エージェントステップの有効化 このセクションの早期アクセスに関する注記を参照してください。

Fullstoryの統合

ステップ1：セッションサマリーAPIの有効化のためにFullstoryをセットアップする

ステップ1.1：セッションサマリーAPIエンドポイントの認証トークンを取得する

Fullstory APIキーを作成するには、以下の手順に従います。

  1. Fullstoryで、設定 > API キー に移動します。
  2. Standard 権限レベルを選択します。
  3. キーの値は一度しか表示されないため、すぐにコピーしてください。

ステップ1.2：セッションサマリープロファイルIDを作成する

Fullstoryのガイダンスに従って、専用のエンドポイントを使用してセッションサマリープロファイルを作成します。ここで、セッションサマリーのレスポンスがBrazeに提供するデータの種類を定義します。

このリクエストのレスポンスで、Fullstoryはセッションプロファイルを提供します。このプロファイルIDは、以下のユースケースで使用するConnected Contentリクエストボディの重要なコンポーネントです。

ステップ2：Connected Contentのトークン認証を作成する

  1. Brazeで、設定 > ワークスペース設定 > Connected Content > 認証情報を追加 > トークン認証 に移動します。
  2. 認証に fullstory という名前を付けます。
  3. ヘッダーキー「Authorization」を追加します。前のステップでFullstoryから提供されたヘッダー値を入力します。
  4. 許可されたドメインに、api.fullstory.com と入力します。

Brazeの認証情報編集フィールドを示すスクリーンショット

ユースケース

ダイナミックなメッセージジャーニーを作成する

FullstoryのActivation Streamsを使用すると、主要なユーザーインタラクションの直後にBrazeキャンバスをトリガーできます。この連携の強みは、ユニークなclient_session_id（{{canvas_entry_properties.${client_session_id}}}でアクセス可能）にあり、システムがFullstoryからBrazeに自動的に渡します。このIDはキーとして機能し、Brazeがユーザーが体験した内容の完全なセッションサマリーを取得できるようにします。

キャンバスのContextステップとConnected Contentを活用することで、このIDを使用してFullstoryへのAPIリクエストを行い、セッションデータを取得し、ジャーニーの後続のステップで使用する変数として保存できます。

Brazeキャンバスのコンテキストステップ。コンテキスト変数「summary_result」が作成され、FullstoryへのConnected Contentコールによってセッションサマリーを取得し、データが入力されている様子

先ほど作成した認証トークンを使用して、以下のリクエスト構造でセッションサマリーデータを取得します。

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

この段階で、キャンバスはConnected Contentコールへのレスポンスにアクセスでき、ユーザーのセッションのメッセージペイロード全体が含まれています。

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

上記のオブジェクトで利用可能なデータを、ユーザーのキャンバスジャーニーの後半でコンテキストLiquidタグを使用して活用できます。以下のステップでは、このデータをエージェントステップでどのように使用できるかを示しています。

適切なコピーを生成する

Fullstoryによってトリガーされるキャンバスにエージェントステップを作成し、このセクションで説明したContextステップを含めることで、エージェント内でFullstoryのセッションサマリーデータを参照できます。

この例では、このデータを使用してBrazeエージェントがContent Cardで使用する適切なメッセージコピーを生成し、ユーザーに放棄カートに戻るよう促すことができます。

プロンプトが入力されたBrazeエージェントのコンテキストクリエイターのスクリーンショット

このステップで作成するコンテキストLiquidタグには、先ほど作成したAIエージェントステップで使用したコンテキストLiquidタグと同じ名前を使用してください。

ユースケースに必要なプロンプトはさまざまです。効果的なエージェントプロンプトを作成するためのベストプラクティスについては、指示の書き方を参照してください。

キャンバスでAIエージェントステップを選択し、ドロップダウンからSession Contextエージェントを選択します。出力を変数として保存します（この場合は「message」）。Liquidタグ{{context.${message}.message}}を使用してメッセージコピーに配置できます。

プロンプトが入力されたBrazeエージェントのコンテキストキャンバスステップのスクリーンショット

AIエージェントが作成したコピーを活用するメッセージステップを作成します。このステップでLiquidタグを使用します。
New Stuff!