実験の有効化

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

概要

「実験の有効化」APIは、指定されたFullStack A/B Test実験に対して訪問者を評価し、訪問者にバリエーションを割り当て、PageSenseサーバーに実験のインプレッションイベントを記録して、割り当てられたバリエーション名を返します。

訪問者が実験のオーディエンスターゲティングルールとトラフィック配分条件を満たす場合、SDKはMurmurHashアルゴリズムを使用して、設定されたバリエーションのいずれかを訪問者に決定論的に割り当てます。これにより割り当てが維持され、複数の要求にわたって同じ訪問者には常に同じバリエーションが割り当てられます。一度割り当てられると、それ以降の評価でも同じ訪問者には常に同じバリエーションが返されます。アプリケーションで訪問者に実験内容を提供する準備ができた時点で、このAPIを使用します。

使用するタイミング

「実験の有効化」APIは、バリエーション固有の内容を表示したり、アプリケーションロジックを実行したりする前に呼び出します。主な使用例は次のとおりです。

異なるUIレイアウトの表示
異なるレコメンドアルゴリズムの提供
アプリケーション機能の有効化または無効化
アプリケーション体験のパーソナライズ

メソッドシグネチャ

activate_experiment(
experiment_name: str,
user_context: PageSenseUserContext
) -&gt; str

パラメーター

パラメーター	型	必須	説明
experiment_name	str	はい	FullStack A/B Test実験の名前です。
user_context	PageSenseUserContext	はい	実験の評価とバリエーションの割り当てに使用する訪問者情報です。

戻り値

型	説明
str	訪問者に割り当てられたバリエーションを返します。訪問者が実験の対象外である場合、またはバリエーションが割り当てられていない場合は、空の文字列を返します。

使用例

from pagesense import PageSenseUserContext
# Create the user attributes
user_attributes = {
'Browser': 'Chrome',
'Device': 'Desktop'
}
# Create the PageSenseUserContext object
user_context = PageSenseUserContext(
user_id='USER_001',
user_attributes=user_attributes
)
# Activate the Experiment
variation_name = pagesense_client.activate_experiment(
experiment_name,
user_context
)

動作の仕組み

「実験の有効化」が呼び出されると、SDKは次の処理を実行します。

指定された実験を検証します。
設定されたオーディエンスターゲティングルールに基づいて訪問者を評価します。
訪問者が実験のトラフィック配分範囲内に該当するかどうかを判定します。
MurmurHashアルゴリズムによる決定論的なバケット分けを使用して、訪問者にバリエーションを割り当てます。
PageSenseサーバーに実験のインプレッションイベントを記録します。
割り当てられたバリエーション名を返します。

SDKは、MurmurHashアルゴリズムを使用し、訪問者識別子と実験の組み合わせに基づいて決定論的なハッシュ値を生成します。これにより、特定の実験では同じ訪問者に常に同じバリエーションが割り当てられ、複数の要求やアプリケーションセッションにわたって、信頼性の高い一貫した実験体験を提供できます。SDKは、同期されたメモリ内のプロジェクト設定を使用して、実験をローカルで評価します。

注意事項

バリエーションを一貫して割り当てるため、固定の訪問者識別子を使用してください。
訪問者の要求ライフサイクル全体を通じて、同じPageSenseUserContextを再利用してください。
オーディエンスターゲティングは、PageSenseUserContextで利用可能な属性を使用して評価されます。
返されたバリエーション名は、バリエーション固有のアプリケーションロジックの実行に使用できます。

実験を有効化する前に、関連する訪問者属性をすべて指定してください。