セッション特性の定義、保存、およびアクセス

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

このトピックでは、顧客として識別されたゲストのセッション特性をキャプチャして保存する方法について説明します。これには、JavaScriptを使用して属性を取得および計算するセッション特性のロジックを定義すること、ゲストに対して属性を保存すること、およびSitecore CDP内でそれらの値にアクセスすることが含まれます。

JavaScriptを使用したセッション特性の定義

セッション特性は、各顧客のWebセッションの終了時に実行されるJavaScriptコードを使用して定義されます。カスタムコードは、Webセッション内のすべてのイベントと、ゲストプロパティ、データエクステンション、注文データなどの利用可能な顧客データに基づいて特定の値を計算します。

例えば、顧客のページビューを追跡するセッション特性を作成できます。以下は、ページビューイベントをカウントするためのJavaScriptスニペットの例です。

(function () {
  var counter = 0;
  triggerSession.events.forEach(event => {
    if (event.type == "VIEW") {
      counter++;
    }
  })
  return counter;
})();

セッション特性をアクティブ化すると、各顧客のWebセッションの終了時にJavaScriptコードが実行され、カスタムロジックが適用され、目的の値が計算されます。この例では、顧客が閲覧したページ数を取得し、後で使用するために保存します。

ゲストに対するセッション特性の保存

セッショントレイトによってキャプチャされた値は、ゲストコンテキストのルートレベルにあるtraitsオブジェクト内の属性として保存されます。各顧客は、最大10個のセッション特性を保存できます。以下は、traitsオブジェクトを持つゲストコンテキストの例です。

{
    "email": "[email protected]",
    "emails": [
        "[email protected]"
    ],
    "ref": "99378e77-34e8-477d-bc82-4951082fc1f0",
    "clientKey": "<client_key>",
    "createdAt": "2024-02-07T09:21:57.764Z",
    "modifiedAt": "2024-02-07T09:24:13.295Z",
    "title": "Ms",
    "firstName": "Jane",
    "lastName": "Doe",
    "identifiers": [],
    "firstSeen": "2024-02-07T09:21:57.764Z",
    "lastSeen": "2024-02-07T09:21:57.764Z",
    "guestType": "customer",
    "subscriptions": [],
    "dataExtensions": [],
    "sessions": [],
    "orders": [],
    "segmentMemberships": [],
    "traits": {
        "session": {          
            "count_views": {
                "name": "Count_views",
                "createdAt": "2024-07-26T10:38:39.688Z",
                "value": 4,
                "modifiedAt": "2024-07-26T10:44:58.788Z"
            },
            "countpageviews": {
                "name": "Count-page-views",
                "createdAt": "2024-07-26T10:38:39.688Z",
                "value": 4,
                "modifiedAt": "2024-07-26T10:44:58.788Z"
            }
        }
}

traitsオブジェクト内には、sessionサブオブジェクトに、顧客に関連するすべてのセッション特性が格納されます。各セッション特性オブジェクトは、作成時に自動的に生成されるfriendlyIdによって一意に識別され、次の属性が含まれます。

name - セッショントレイトの作成時にユーザー定義の名前。
createdAt - セッション特性がいつ作成されたかを示す、自動的に生成されたタイムスタンプ。
modifiedAt - セッション特性が最後に変更された日時を示す、自動的に生成されたタイムスタンプ。
value - 計算されたセッション特性値(JavaScriptロジックに応じて、文字列、数値、ブール値、または文字列のリストにすることができます)。

セッション特性は、modifiedAtタイムスタンプに基づいてtraitsオブジェクト内で降順に並べ替えられ、最後に更新されたセッション特性はtraitsオブジェクトの先頭に配置されます。

セッション特性値へのアクセス Sitecore CDP

CDPで顧客のセッション特性にアクセスするには、ゲストプロファイルを表示し、ゲストプロパティにアクセスします。

Sitecore CDP内でセッショントレイトの保存された値を使用または取得するには、既知の構造を使用してゲストコンテキストからその値を参照できます。例えば：

guest.traits.session.sessionTrait1.value.

sessionTrait1をセッション特性のfriendlyIdに置き換えて、顧客のセッションの終了時に計算された保存された値を取得します。

この記事を改善するための提案がある場合は、お知らせください!