目標を追跡する

目標を追跡する

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

TrackGoal APIは、FullStack A/Bテスト実験の目標コンバージョンを追跡するために使用されます。これは2通りの方法で呼び出すことができます。

ActivateExperimentのユーザー属性との併用方法

方法

  1. pageSenseClient.TrackGoal(experimentName, userId, goalName, userAttributes);

パラメーター詳細

パラメータ
種類
説明
experimentName
String
有効化された実験の名前
userId
String
ユーザーの一意の識別子
goalName
String
トラッキングしているゴールの名前
userAttributes
HashMap
オーディエンスターゲティングやセグメンテーションに使用するユーザー属性のマップ

FullStack A/B テストの実験において、コンバージョンイベントは、以下の条件が満たされた場合にのみ特定のゴールに対してユーザーごとに記録されます。
  1. ユーザーがオーディエンスターゲティング条件および実験トラフィックに基づき、実験の対象として適格であること
  2. ユーザーが指定されたゴール操作を完了すること
前提として、実験に関連付けるゴールのリストを設定し、各ゴールが完了と見なされる条件を明確に定義する必要があります。ユーザーが実験の対象となり、特定のゴールの条件を満たした場合、TrackGoal APIを呼び出し、コンバージョンイベントをPageSenseサーバーに報告します。

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

これにより、ゴールのトラッキングは正確かつ一貫性を保ち、実際に実験に参加しているユーザーのみに限定されます。

使用例

  1. / ユーザー属性オブジェクトを作成
  2. Dictionary<string, string> userAttributes = 新規 Dictionary <string, string> (); </string,> </string,>
  3.  
  4. // ユーザー属性値を追加する
  5. userAttributes['Browser'] = 'Chrome';
  6. userAttributes['Device'] = 'Desktop';
  7. userAttributes['OS'] = 'Windows 10';
  8.  
  9. // FullStack A/B テスト実験のゴールをトラッキングpageSenseClient.TrackGoal(experimentName, userId, goalName, userAttributes);


API Functionality 概要

TrackGoal API が呼び出されると、バリエーションをユーザーに割り当てるべきかどうかを判断するための構造化されたプロセスに従います。以下はそのプロセスの詳細な内訳です：

Audience ターゲティング

API はまず、実験設定時に定義された Audience ターゲティング条件に基づき、ユーザーが実験の対象となるかどうかを評価します。これらの条件は通常、ブラウザやデバイス種類、オペレーティングシステム、または userAttributes で渡されるカスタムユーザーデータなどのユーザー属性に基づいています。
  1. ユーザーの属性が Audience ターゲティング条件と一致する場合、API は次の手順に進みます。
  2. ユーザーがこれらの条件を満たさない場合、API は直ちに null を返し、そのユーザーが実験に参加する資格がないことを示します。

ユーザー資格判定

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

トラッキングおよび分析

ユーザーが実験の対象となり、ゴールを達成した場合、API は該当するゴールのコンバージョン詳細を PageSense サーバーに送信します。このデータは分析、レポート、実験パフォーマンスの評価に利用されます。

ユーザー属性なしでの TrackGoal 利用方法

方法
  1. pageSenseClient.TrackGoal(experimentName, userId, goalName);

パラメータ詳細

パラメーター
種類
説明
experimentName
String
有効化された実験の名前
userId
String
ユーザーの一意な識別子
goalName
String
追跡対象となる目標の名前

​API Functionality 概要

  1. このAPIのバージョンでは、必須となるのは実験の名前とユーザーIDのみです。
  2. オーディエンスターゲティングの手順は引き続き実行されますが、ユーザー属性が提供されていないため、ユーザーはオーディエンスターゲティング条件が「すべての訪問者」として設定されている実験のみに該当します。
  3. もし実験にデバイス種類、場所、カスタム属性などの追加のオーディエンスターゲティング条件が含まれている場合、評価に使用する属性データが存在しないため、そのユーザーは自動的に資格判定を通過できません。
  4. 「すべての訪問者」を許可している実験の場合、MurmurHashアルゴリズムがユーザーIDに適用され、実験のトラフィック配分に基づいてユーザー固有のハッシュ値が取得されます。ユーザーのハッシュ値がいずれかのバリエーションで定義された範囲内に収まっている場合、そのユーザーは実験の対象となり、ゴールコンバージョンの詳細がPageSenseサーバーへ送信されます。
  5. ユーザーのハッシュ値が実験のトラフィック配分設定によってすべてのバリエーション範囲外となった場合、ユーザーは実験の対象外となり、ゴールコンバージョンの詳細はPageSenseサーバーへ送信されません。
このドキュメントがプロセスの円滑化にお役立ていただければ幸いです。追加の説明が必要な場合やご質問がある際は、いつでもサポート窓口までメールでご連絡ください。サポート@zohopagesense.com