取得する Variation 名前 API は、FullStack A/B テスト実験の名前を取得するために使用されます。ユーザーが実験の対象となるかを評価し、適切なバリエーションを割り当てます。

1. ユーザーがFullStack A/B実験の対象となる場合、割り当てられたバリエーションの名前を返します。
   
2. ユーザーがオーディエンスターゲティングの条件を満たさず、FullStack A/B Experimentの対象とならない場合はnullを返します。
   

1. // ユーザー属性オブジェクトを作成
2. Dictionary userAttributes = 新規 Dictionary ();
3.  
4. // ユーザー属性値を追加
5. userAttributes['Browser'] = 'Chrome';
6. userAttributes['Device'] = 'Desktop';
7. userAttributes['OS'] = 'Windows 10';
8.  
9. // FullStack A/BテストExperimentでユーザーに割り当てられたバリエーションを取得t
10. string variationName = pageSenseClient.GetVariationName(experimentName, userId, userAttributes);
11.  
12. // FullStack A/BテストExperimentの各バリエーションごとにコード変更を定義
13.  
14. if (variationName.Equals('元の内容')){
15. // コード: '元の内容'用の処理コードを記述
16. } else if (variationName.Equals('Variation 1')){
17. // コード: 'Variation 1'用の処理コードを記述
18. } else if (variationName.Equals('Variation 2')){
19. // コード: 'Variation 2' を処理するためのコードを記述
20. } else if (variationName.Equals('Variation 3')){
21. // コード: 'Variation 3' を処理するためのコードを記述
22. } else{
23. // コード: ユーザーがFullStack A/BテストExperimentのいずれの値にも該当しない場合の処理
24. } 

GetVariationName APIが呼び出されると、ユーザーにバリエーションを割り当てるかどうかを判断するための体系的なプロセスが実行されます。以下は、このプロセスの詳細な内訳です。

APIはまず、ユーザーが実験の構成時に定義されたAudience Targetingの条件を満たしているかどうかを評価します。これらの条件は通常、ブラウザ、デバイス種類、オペレーティングシステム、またはuserAttributesで渡されるカスタムユーザーデータなど、ユーザー属性に基づきます。

ユーザー Storage サービス

1. すでにユーザーに対してバリエーションが割り当てられ、ユーザー Storage サービスに保存されている場合、API はその保存されたバリエーションを取得して返却します。
   
2. 保存されたバリエーションが存在しない場合、API は以下で説明するバケッティングロジックを使用して新しいバリエーションの割り当てを進めます。
   

MurmurHash を用いたハッシュ化

1. API は、ユーザーの ID（userId）にMurmurHash アルゴリズムを適用します。このハッシュアルゴリズムは、各ユーザーIDごとに一貫して0 から 9999の間の一意な数値を生成し、これがユーザーのハッシュ値となります。
   
2. MurmurHash アルゴリズムは、同じ実験内で異なるセッションでも、ユーザーIDに対して常に同じハッシュ値を生成します。これにより、特定の実験におけるユーザーへのバリエーション割り当てが決定的かつ安定的に行われます。
   

バリエーションのマッピング

1. 「元の内容」バリエーションには、ハッシュ範囲 0～2000 が割り当てられます。
   
2. 「Variation 1」には、ハッシュ範囲 2001～4000 が割り当てられます。
   
3. 「Variation 2」には、ハッシュ範囲 4001～6000 が割り当てられる、というように続きます。
   

1. 範囲内であれば、該当するバリエーションがユーザーに割り当てられます。
   
2. ハッシュ値がいずれの割り当て範囲にも該当しない場合、ユーザーは実験のトラフィック割り当て内に含まれず、null が返却されます。
   

返却値

1. ユーザーが実験対象であり、バリエーションが正常に割り当てられた場合、API は割り当てたバリエーションの名前を返却します。
   
2. ユーザーがいずれかの段階で実験対象外となった場合、API はnull を返却します。
   

ユーザー属性なしで GetVariationName を利用する

方法

パラメーター詳細:

パラメーター	種類	説明
experimentName	String	有効化する実験の名前。
userId	String	ユーザーの一意な識別子。

このドキュメントが作業の手助けとなれば幸いです。ご不明点や追加の説明が必要な場合は、いつでもサポート窓口までメール（サポート@zohopagesense.com）でお問い合わせください。