目標の追跡

目標の追跡

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

TrackGoal APIは、フルスタックA／Bテストの目標のコンバージョンを追跡するために使用します。呼び出し方法は2通りあります。

ユーザー属性を使用したActivateExperiment

メソッド

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

パラメーターの詳細

パラメーター
種類
説明
experimentName
文字列
有効化されたテスト名
userId
文字列
ユーザーを識別する一意のID
goalName
文字列
追跡する目標名
userAttributes
HashMap<String,String>
オーディエンスのターゲティングとセグメント化に使用するユーザー属性のマップ

フルスタックA/Bテストでは、次の条件を満たした場合にのみ、特定の目標に対するユーザーのコンバージョンイベントが追跡されます。
  1. オーディエンスのターゲット条件とテストのトラフィックに基づき、ユーザーがテストの対象となっている
  2. ユーザーが指定された目標アクションを完了している
前提条件として、テストに関連付ける目標の一覧を設定し、各目標を完了済みとみなす条件を明確に設定する必要があります。ユーザーがテストの対象となり、特定の目標の条件を満たしたら、TrackGoal APIを呼び出して、コンバージョンイベントをPageSenseサーバーに報告する必要があります。

ユーザーがテストの対象となる場合、APIは目標のコンバージョンの詳細をPageSenseサーバーに送信します。対象とならない場合、API呼び出しは無視され、目標のコンバージョンの詳細は記録されません。

これにより、目標の追跡を正確かつ一貫したものにし、テストに参加しているユーザーのみに限定できます。

使用例

  1. / ユーザー属性オブジェクトを作成
  2. Dictionary<string, string> userAttributes = new Dictionary<string, string>();
  3.  
  4. // ユーザー属性の値を追加
  5. userAttributes['Browser'] = 'Chrome';
  6. userAttributes['Device'] = 'Desktop';
  7. userAttributes['OS'] = 'Windows 10';
  8.  
  9. // フルスタックA/Bテストの目標を追跡 pageSenseClient.TrackGoal(experimentName, userId, goalName, userAttributes);


API機能の概要

TrackGoal APIが呼び出されると、体系的なプロセスに従って、ユーザーにバリエーションを割り当てるかどうかが決定されます。以下は、このプロセスの詳細です。

オーディエンスのターゲット設定

APIはまず、テストの設定時に指定されたオーディエンスのターゲット条件に基づいて、ユーザーがテストの対象となるかどうかを評価します。これらの条件は通常、ブラウザー、デバイスの種類、OS、またはuserAttributesで渡された個別指定のユーザーデータなどのユーザー属性に基づきます。
  1. ユーザーの属性がオーディエンスのターゲット条件に一致する場合、APIは次の手順に進みます。
  2. ユーザーがこれらの条件を満たさない場合、APIは直ちにnullを返します。これは、ユーザーがテストの対象外であることを示します。

ユーザーの適格性判定

次の手順では、テストのトラフィックの割り当て設定に基づいて、ユーザーがテストの対象となるかどうかを判定します。
  1. APIは、ユーザーストレージサービスが有効かどうかを確認します。有効な場合、ユーザーについて保存済みのバリエーションがあるかどうかを確認します。ユーザーストレージサービスですでにユーザーにバリエーションが割り当てられ、保存されている場合、APIはそのバリエーションを取得して返します。
  2. 保存済みのバリエーションがない場合、APIはバリエーションのバケット分けを使用して新しいバリエーションを割り当てます。
  3. APIは、ユーザーID（userId）にMurmurHashアルゴリズムを適用します。このハッシュアルゴリズムは、各ユーザーIDに対して一貫して0から9,999までの一意の数値を生成し、これがユーザーのハッシュ値となります。
  4. テスト内の各バリエーションには、割り当てられたトラフィックの割合（%）に対応する特定のハッシュ値の範囲が割り当てられます。
  5. APIは、ユーザーのハッシュ値が設定済みのいずれかの範囲内にあるかどうかを確認します。範囲内にある場合、ユーザーはテストの対象とみなされます。ハッシュ値が割り当て済みのすべての範囲外にある場合、ユーザーはテストの対象外となり、目標は追跡されません。

追跡と分析

ユーザーがテストの対象となり、目標を達成すると、APIは対応する目標のコンバージョンの詳細をPageSenseサーバーに送信します。このデータは、分析、レポート作成、テストのパフォーマンス評価に使用されます。

ユーザー属性を指定せずにTrackGoalを使用するには

メソッド
  1. pageSenseClient.TrackGoal(experimentName, userId, goalName);

パラメーターの詳細

パラメーター
種類
説明
experimentName
文字列
有効化したテスト名
userId
文字列
ユーザーの一意の識別子
goalName
文字列
追跡する目標の名前

​API機能の概要

  1. このバージョンのAPIでは、テスト名とユーザーIDのみが必要です。
  2. オーディエンスのターゲット設定も実行されます。ただし、ユーザー属性が指定されていないため、オーディエンスのターゲット条件が「すべての訪問者」に設定されているテストのみが対象となります。
  3. テストにデバイスの種類、場所、個別指定の属性など、追加のオーディエンスのターゲット条件が含まれている場合、評価に必要なユーザー属性データがないため、ユーザーは自動的に適格性判定に不合格となります。
  4. 「すべての訪問者」を許可するテストでは、ユーザーIDにMurmurHashアルゴリズムを適用し、テストのトラフィックの割り当てに基づいてユーザー固有のハッシュ値を取得します。ユーザーのハッシュ値がいずれかのバリエーションに設定された範囲内にある場合、そのユーザーはテストの対象となり、目標のコンバージョンの詳細がPageSenseサーバーに送信されます。
  5. テストのトラフィックの割り当て設定により、ユーザーのハッシュ値が設定済みのすべてのバリエーションの範囲外にある場合、そのユーザーはテストの対象外となり、目標のコンバージョンの詳細はPageSenseサーバーに送信されません。
このドキュメントが、処理を円滑に進めるうえでお役に立てば幸いです。さらに詳しい説明が必要な場合や質問がある場合は、support@zohopagesense.comにメールを送信して、いつでもお気軽にお問い合わせください。