目標の追跡

目標の追跡

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

trackGoal APIは、フルスタックA／Bテストにおける目標コンバージョンを追跡するために使用します。次の2つの方法で呼び出すことができます。

メソッド。

  1. String variationName = pageSenseClient.trackGoal(experimentName, userId, goalName, userAttributes);

パラメーター。

パラメーター

種類

説明

experimentName

String

有効化されたテスト名です。

userId

String

ユーザーを識別する一意のIDです。

goalName

String

追跡する目標の名前です。

userAttributes

HashMap<String, String>

オーディエンスのターゲティングとセグメント化に使用するユーザー属性のマップです。

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

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

これにより、目標の追跡が正確かつ一貫して行われ、テストに実際に参加しているユーザーのみが対象となります。

サンプルコード。

trackGoal APIを使用してユーザーのコンバージョンを追跡する方法については、次のコードを参照してください。
  1. import java.util.HashMap;
  2. // ユーザー属性オブジェクトを作成
  3. HashMap<String, String> userAttributes = new HashMap<>();
  4. // ユーザー属性の値を追加
  5. userAttributes.put('Browser', 'Chrome');
  6. userAttributes.put('Device', 'Desktop');
  7. userAttributes.put('OS', 'Windows 10');
  8. // フルスタックA/Bテストを有効にする
  9. String variationName = 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を使用する方法

trackGoal APIは、ユーザー属性を指定せずに呼び出すこともできます。次のコードは、ユーザー属性のパラメーターを渡さずにAPIを呼び出す方法を示しています。

メソッド。

  1. String variationName = pageSenseClient.trackGoal(experimentName, userName, goalName);

パラメーターの詳細

パラメーター

種類

説明

experimentName

String

有効にしたテストの名前です。

userId

String

ユーザーを識別する一意のIDです。

goalName

String

追跡する目標の名前です。

APIの仕組み

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