メソッドパラメーター

返される値  

• ユーザーが Full Stack A/B テストの対象となる場合、割り当てられたバリエーションの名前を返します。

• ユーザーが実験の対象とならない場合は null を返します。これは、ユーザーが実験のオーディエンスターゲティングルールに一致しないか、実験に割り当てられたトラフィックの範囲外である場合に発生します。

API の動作について  

activateExperiment() メソッドが呼び出されると、バリエーションをユーザーに割り当てるべきかどうかを判断するために、次の手順で処理が行われます。

1. オーディエンスターゲティング  

まず API は、ユーザーが PageSense で定義された実験のオーディエンスターゲティングルールを満たしているかどうかを確認します。これらのルールには、ブラウザー、デバイスの種類、OS などのユーザー属性や、ユーザー属性で渡された任意のカスタムプロパティを含めることができます。

• ユーザーの属性がオーディエンスターゲティング条件と一致する場合、評価は次のステップに進みます。

• 一致しない場合、API はnullをすぐに返し、そのユーザーがこの実験の対象外であることを示します。

2. ユーザーストレージサービス  

ユーザー属性なしで activateExperiment() を使用する  
以下のように、ユーザー属性パラメーターを指定せずに API を呼び出すこともできます。

メソッドの呼び出し

1. //ユーザー属性なしで実験をアクティブ化する
2. $variationName= $pageSenseClient->activateExperiment($experimentName, $userId);

動作方法  

• 必須なのは、実験名とユーザー ID のみです。

• オーディエンスターゲティングは引き続き評価されます。ただし、
  実験のターゲットが「すべての訪問者」の場合、そのユーザーは実験の対象になります。
  実験に特定のオーディエンスターゲティング条件が含まれている場合は、ユーザー属性が指定されていないため、そのユーザーは実験の対象外となります。

• その後、API は MurmurHash アルゴリズムを適用して、割り当てるバリエーションを決定します。

• ユーザーのハッシュ値がいずれかのバリエーションの定義済み範囲内に入る場合は、その一致したバリエーションが返されます。そうでない場合は、バリエーションとしてNULLが返されます。

ベストプラクティス  

• 常に一貫性のある一意のユーザー ID（例：ログイン ID、メールアドレスなど）を使用してください。ユーザー ID にセッション ID を使用すると、頻繁に変更されるため、セッションごとに異なるバリエーションが配信されてしまう可能性があります。

• 常に NULL の返却を適切に処理してください。バリエーションが NULL として返された場合に備えて、フォールバック実装を追加しておきます。

• 頻繁にアクセスするユーザーについては、ハッシュの再評価を避けるために、バリエーションの割り当て結果をキャッシュすることをおすすめします。

アプリケーション全体で、ユーザー属性のキーには同じ名前を使用し、オーディエンスターゲティングとレポートのセグメントの一貫性を確保してください。