バリエーション名の取得

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

概要

バリエーション名取得APIは、指定されたテストを評価し、テストのインプレッションを記録せずに、訪問者に割り当てられたバリエーションを返します。このAPIは、テストを閲覧済みとして扱わずに、割り当てられたバリエーションを確認する必要がある場合に役立ちます。

使用するタイミング

「バリエーション名取得」APIは、テストを有効にせずに訪問者に割り当てられたバリエーションを取得する必要がある場合に使用します。たとえば、次のような場合です。

バリエーションの割り当てをプレビューする場合。
バックエンドで意思決定を行う場合。
ホームページでテストを有効にし、その他のページでバリエーションを使用する場合。
テストのインプレッションを記録しない内部アプリケーションロジックで使用する場合。

メソッドシグネチャー

get_variation_name(
experiment_name: str,
user_context: PageSenseUserContext
) -> str

パラメーター

パラメーター	種類	必須	説明
experiment_name	str	はい	フルスタックA／Bテストの名前。
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
)
# Get the variation details
variation_name = pagesense_client.get_variation_name(
experiment_name,
user_context
)

処理の仕組み

SDKは、テスト有効化APIと同じ訪問者評価プロセスを実行しますが、テストのインプレッションイベントは追跡しません。

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

「テスト有効化API」とは異なり、このAPIはテストのインプレッションイベントを記録しません。

注意事項

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