Skip to content

Fullstory

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

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

この統合について

BrazeでFullstoryのインサイトを活用して、ユーザーのWebサイトやアプリ体験の一瞬一瞬を捉えた画像を構築し、文脈に応じたメッセージングを配信できます。FullstoryのセッションサマリーAPIにより、ユーザーの閲覧行動に関する詳細なメタデータをキャプチャしてBrazeメッセージングで使用できます。これは、Canvasのような複数ステップのメッセージングジャーニーで活用する際に特に威力を発揮します。

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

以下の例では、エージェント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をトリガーできます。この統合の威力は、システムがFullstoryからBrazeに自動的に渡す固有のclient_session_id（{{canvas_entry_properties.${client_session_id}}}でアクセス可能）にあります。このIDがキーとして機能し、Brazeはユーザーが体験した内容の完全なセッションサマリーを取得できます。

Canvasコンテキストステップとコネクテッドコンテンツを活用することで、このIDを使用してFullstoryにAPIリクエストを行い、セッションデータを取得し、ジャーニーの後半で使用するために変数として保存できます。

Brazeのキャンバスコンテキストステップ。コンテキスト変数「summary_result」が作成され、Fullstoryへのコネクテッドコンテンツコールでセッションサマリーが取得されている

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

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!