PageSenseユーザーコンテキスト

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

PageSenseUserContextは、FullStack A/Bテストに参加する訪問者を表します。訪問者の識別子と、実験の評価、オーディエンスのターゲティング、パターンの割り当て、目標の追跡に使用する任意のカスタム属性を保持します。一意の訪問者ごとにPageSenseUserContextインスタンスを作成し、その訪問者のリクエストライフサイクル中は、すべてのSDK APIで同じインスタンスを再利用してください。これにより、実験の評価と目標の関連付けに一貫性が保たれます。同じPageSenseUserContextオブジェクトが、以下に渡されます。

activate_experiment()
get_variation_name()
track_goal()

訪問者ごとに、すべてのSDK APIで同じユーザーコンテキストを使用することで、SDKは実験の評価、割り当てられたパターンの取得、目標コンバージョンと正しい訪問者との関連付けを一貫して行えます。

コンストラクター

PageSenseUserContext(
user_id: str,
user_attributes: dict[str, str] = None
)

パラメーター

パラメーター	型	必須	説明
user_id	str	はい	訪問者の一意の識別子です。SDKはこの識別子を使用して訪問者を決定論的にグループ分けし、複数のリクエストにわたって同じパターンが割り当てられるようにします。
user_attributes	dict[str, str]	いいえ	オーディエンスのターゲティングと訪問者のセグメント化に使用する、訪問者のカスタム属性のコレクションです。

戻り値

型	説明
PageSenseUserContext	SDKで使用する訪問者と、その訪問者に関連付けられた属性を表します。

使用例

from pagesense import PageSenseUserContext

# Create visitor attributes
user_attributes = {
'Browser': 'Chrome',
'Device': 'Desktop',
'OS': 'Windows 11',
'Country': 'India'
}
# Create the user context
user_context = PageSenseUserContext(
	user_id='USER_001',
    	user_attributes=user_attributes
)

ユーザー属性

ユーザー属性は訪問者に関する追加情報を提供するもので、主にオーディエンスのターゲティングに使用されます。たとえば、次のような属性に基づいて、実験の対象となる訪問者を指定できます。

ブラウザー
デバイス
OS
国
会員ランク
サブスクリプションプラン
顧客種別
アプリケーションのバージョン

オーディエンスのターゲティング

実験の評価時に、SDKはPageSenseUserContext内の訪問者属性を、実験に設定されたオーディエンスのターゲティングルールと照合します。設定されたターゲティング条件を満たす訪問者のみが、実験に参加できます。たとえば、実験の対象として次の訪問者を指定できます。

プレミアム顧客
モバイルユーザー
特定の国からの訪問者
特定のバージョンのブラウザー
特定のバージョンのアプリケーション

ベストプラクティス

安定した不変の訪問者識別子を使用してください。パターンの割り当てはMurmurHashアルゴリズムに基づくため、訪問者識別子を変更すると、訪問者が別のパターンに割り当てられる場合があります。
訪問者に対するすべてのSDK API呼び出しで、同じPageSenseUserContextインスタンスを再利用してください。
実験の有効化または目標の追跡を行うAPI関数を呼び出す前に、利用可能なすべてのターゲティング属性を指定してください。
追跡対象のすべての訪問者で、属性名を統一してください。
同じユーザーからのリクエスト間で、訪問者識別子を変更しないでください。