目標を追跡する

目標を追跡する

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

trackGoal APIは、FullStack A/B テスト実験におけるゴールコンバージョンの追跡に使用します。呼び出し方法は2通りあります：

方法：

  1. String variationName = 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コールが無視され、ゴールコンバージョンの詳細は記録されません。

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

例 コード:

以下のコードを参照して、trackGoal 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の動作について

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

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

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

ユーザーの資格判定

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

トラッキングと分析

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

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

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

方法：

  1. String variationName = pageSenseClient。trackGoal(experimentName, ユーザー名, goalName);

パラメーター詳細

パラメーター

種類

説明

experimentName

String

有効化された実験の名前。

userId

String

ユーザーの一意の識別子。

goalName

String

トラッキングしているゴールの名前。

APIの仕組み

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