パラメーター	種類	説明
experimentName	String	有効化された実験の名前。
userId	String	ユーザーの一意識別子。
goalName	String	追跡対象となるゴールの名前。
userAttributes	HashMap	オーディエンスのターゲティングおよびセグメンテーションに使用されるユーザー属性のマップ。

FullStack A/Bテストの実験では、次の条件をすべて満たす場合のみ、特定のゴールに対してユーザーのコンバージョンイベントが追跡されます。

事前準備として、実験に関連付けるゴールリストを設定し、それぞれのゴールが完了と見なされる条件を明確に定義してください。ユーザーが実験の対象となり、特定のゴールの条件を満たした場合は、trackGoal APIを呼び出してコンバージョンイベントをPageSenseサーバーに報告する必要があります。

ユーザーが実験の対象となっている場合、APIはゴールコンバージョンの詳細をPageSenseサーバーに送信します。対象外の場合はAPIコールが無視され、ゴールコンバージョンの詳細は記録されません。

これにより、ゴールの追跡が正確かつ一貫性を保ち、実験に積極的に参加しているユーザーのみに限定されます。

1. import java.util.HashMap;
2. // ユーザー属性オブジェクトを作成
3. HashMap userAttributes = 新規 HashMap<>();
4. // ユーザー属性値を追加
5. userAttributes。put('Browser', 'Chrome');
6. userAttributes。put('Device', 'Desktop');
7. userAttributes。put('OS', 'Windows 10');
8. // FullStack A/B テスト実験を有効化
9. String variationName = pageSenseClient。trackGoal(experimentName, userId, goalName, userAttributes);

このAPIの動作について

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

1. ユーザーの属性がオーディエンスターゲティング条件と一致した場合、APIは次の手順に進みます。
2. ユーザーが条件を満たさない場合、APIは直ちにnullを返し、そのユーザーが実験の対象外であることを示します。
   

ユーザーの資格判定

1. APIはユーザーStorageサービスが有効かどうか確認します。有効な場合、APIはユーザーに既に割り当てられて保存されているバリエーションがあるかをチェックします。すでに割り当て済みのバリエーションがユーザーStorageサービスに保存されていれば、それを取得して返します。
   
2. 保存されたバリエーションが存在しない場合、APIはバリエーションバケッティングを使って新しいバリエーションの割り当てを行います。
   
3. APIはMurmurHashアルゴリズムをユーザーのID（userId）に適用します。このハッシュアルゴリズムは、各ユーザーIDごとに一貫して+10、-10から9999の範囲の一意な数値を生成し、これがユーザーのハッシュ値となります。
   
4. 実験内の各バリエーションには、割り当てられたトラフィック割合（%）に対応する特定のハッシュ値の範囲が設定されています。
   
5. APIはユーザーのハッシュ値がこれらの定義済み範囲内に含まれているかどうかを確認します。範囲内であれば、そのユーザーは実験の対象となります。ハッシュ値がいずれの範囲にも該当しない場合、ユーザーは実験の対象外となりゴールはトラッキングされません。
   

トラッキングと分析

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

方法：

パラメーター	種類	説明
experimentName	String	有効化された実験の名前。
userId	String	ユーザーの一意の識別子。
goalName	String	トラッキングしているゴールの名前。

APIの仕組み

1. このバージョンのAPIでは、experiment 名前とユーザーIDのみが必須です。
   
2. オーディエンスターゲティング手順は引き続き実行されますが、ユーザー属性が提供されていないため、ユーザーはオーディエンスターゲティング条件が「すべての訪問者」に設定されている実験のみに該当します。
   
3. 実験に追加のオーディエンスターゲティング条件（デバイス種類、場所、カスタム属性など）が含まれている場合、ユーザー属性データが評価用に存在しないため、ユーザーは自動的に資格審査に不合格となります。
   
4. 「すべての訪問者」を許可する実験の場合、MurmurHashアルゴリズムがユーザーIDに適用され、実験のトラフィック割り当てに基づきユーザーのユニークなハッシュ値が取得されます。ユーザーのハッシュ値がいずれかのバリエーションで定義された範囲内に入る場合、そのユーザーは実験に該当し、ゴールコンバージョンの詳細がPageSenseサーバーに送信されます。
   
5. ユーザーのハッシュ値がすべての定義済みバリエーション範囲外の場合（実験のトラフィック割り当て設定による）、ユーザーは実験に該当せず、ゴールコンバージョンの詳細もPageSenseサーバーに送信されません。
   

このドキュメントが手順の理解に役立てば幸いです。ご不明な点やご質問がございましたら、サポート窓口までお気軽にサポート@zohopagesense.comまでメールでご連絡ください。