PageSenseユーザーコンテキスト

PageSenseユーザーコンテキスト

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

PageSenseUserContextは、フルスタック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関数または目標を追跡するAPI関数を呼び出す前に、使用可能なすべてのターゲティング属性を指定してください。
  • 追跡するすべての訪問者で、属性名を統一してください。
  • 同じユーザーからの複数のリクエストの間で、訪問者識別子を変更しないでください。