目標の追跡
The trackGoal() methodは、PageSense のフルスタック A/B テスト実験でゴールコンバージョンを記録するために使用します。実験の対象となるユーザーに対してのみ、PageSense 内でコンバージョンを処理します。
この API は、実験のオーディエンスターゲティングルールの設定に応じて、ユーザー属性の有無にかかわらず呼び出すことができます。
メソッドの呼び出し
- // フルスタック A/B テスト実験のゴールコンバージョンをトラッキングする
- $pageSenseClient->trackGoal($experimentName, $userId, $goalName, $userAttributes);
メソッドパラメーター
|
Parameter |
種類 |
説明 |
|
experimentName |
string |
ゴールが定義されている実験の名前。 |
|
userId |
string |
ユーザーを一意に識別する ID。 |
|
goalName |
string |
トラッキングするゴールの名前。 |
|
userAttributes |
array |
(任意) オーディエンスのターゲティングとセグメンテーションに使用するユーザー属性の連想配列。 |
前提条件
この method を呼び出す際は、次の点を確認してください。
-
ゴールをトラッキングする Web ページで、対象の実験が有効になっていること。
-
ゴールに関連付けられたコンバージョン条件が満たされた場合にのみ、このメソッドを呼び出すこと。
返却時の動作
-
ユーザーが実験の対象条件を満たしている場合、ゴールコンバージョンが記録され、PageSense サーバーに送信されます。
-
ユーザーが対象条件を満たしていない、または実験のトラフィック配分外である場合、API はコンバージョンリクエストを無視します（何も処理しません）。
コード例
- use Zoho\PageSense\PageSenseClient;
- // ユーザー属性を定義
- $userAttributes= [
- 'Browser' => 'Chrome',
- 'Device' => 'Desktop',
- 'OS' => 'Windows 10'];
- // フルスタック実験のゴールコンバージョンをトラッキング
- $pageSenseClient->trackGoal($experimentName, $userId, $goalName, $userAttributes);
API の動作
trackGoal() メソッドが呼び出されると、PageSense にゴールコンバージョンを記録する前に、次のような構造化された検証プロセスを実行します。
1. オーディエンスターゲティング
API は、PageSense で定義されたオーディエンスターゲティング条件に基づき、ユーザーが実験の対象かどうかを確認します。
-
これらの条件には通常、ブラウザー、デバイスの種類、OS、またはユーザー属性で渡される任意のカスタム項目などのユーザー属性が含まれます。
-
ユーザー属性がオーディエンスターゲティング条件と一致する場合、評価が続行されます。
-
ユーザー属性がオーディエンスターゲティング条件と一致しない場合、目標コンバージョンの詳細は PageSense に送信されません。
2. ユーザーの適格性判定
次に API は、ユーザーが実験のトラフィック割り当て範囲内に含まれているかどうかを検証します。
-
ユーザーストレージサービスが有効な場合、SDK はユーザーに以前割り当てられたバリエーションを取得します（セッションをまたいだ一貫したトラッキングを保証します）。
-
バリエーションが保存されていない場合は、決定論的バケッティング（ハッシュに基づく）を使用して新しいバリエーションが割り当てられます。
-
その後 SDK は、ユーザーの ID（userId）に対してMurmurHash アルゴリズムを適用し、0～9999 の数値ハッシュを生成します。
-
実験内の各バリエーションには、そのトラフィック割合（%）に対応する一意のハッシュ範囲が割り当てられます。
|
バリエーション |
ハッシュ範囲 |
|
元の内容 |
0 – 2000 |
|
バリエーション 1 |
2001 – 4000 |
|
バリエーション 2 |
4001 – 6000 |
3. トラッキングと分析
ユーザーが条件を満たし、ゴール条件が達成されると:
-
SDK は、実験名、ユーザー ID、ゴール名、バリエーション ID をパッケージ化します。
-
このコンバージョンイベントを、安全な HTTPS リクエストで PageSense のバックエンドに送信します。
-
このデータは、コンバージョン指標、勝率、信頼度レポートを実験ダッシュボードで表示するために使用されます。
4. 戻り動作
|
条件 |
SDK の動作 |
|
ユーザーが条件を満たし、ゴールを達成した場合 |
ゴールイベントを PageSense に送信します |
|
ユーザーが条件を満たさない場合 |
呼び出しを無視し、何も行いません |
|
ネットワークエラー / 無効な SDK キー |
エラーをログに記録します（ログが有効な場合）。自動で再試行は行いません |
trackGoal() をユーザー属性なしで使用する
ユーザー属性を指定せずに、この API を呼び出すこともできます。
メソッドの呼び出し
- // ユーザー属性なしでゴールコンバージョンをトラッキング
- $pageSenseClient->trackGoal($experimentName, $userId, $goalName);
動作方法
-
必須なのは、実験名、ユーザー ID、および ゴール名のみです。
-
オーディエンスターゲティングは引き続き実行されますが、オーディエンスターゲティング条件が 「すべての訪問者」 の場合にのみ、ユーザーは実験の対象として判定されます。特定のオーディエンスターゲティングルール（例: device = モバイル）が設定されている実験では、ユーザー属性が渡されないため、ユーザーはその実験の対象として判定されません。
-
ユーザーが実験の対象として判定された場合、API は MurmurHash アルゴリズムを使用してバリエーションを決定し、そのバリエーションに対してゴールデータを記録します。
-
ユーザーが実験の対象として判定されない場合、コンバージョンイベントは発生しません。
ベストプラクティス
-
コンバージョンイベントが発生した直後に、必ず trackGoal() API を呼び出してください。
-
決定的な動作を得るため、すべての SDK メソッドで一貫した ユーザー ID を使用してください。
-
バックエンドでジョブやキューを使って非同期にコンバージョンを処理している場合は、後処理のステージに SDK の呼び出しを含めるようにしてください。
-
何も行わない（no-op）ケースも想定して、問題なく処理できるようにしてください。すべてのユーザーがトラッキング対象になるわけではありません。
Zoho CRM 管理者向けトレーニング
「導入したばかりで基本操作や設定に不安がある」、「短期間で集中的に運用開始できる状態にしたい」、「運用を開始しているが再度学び直したい」 といった課題を抱えられているユーザーさまに向けた少人数制のオンライントレーニングです。
日々の営業活動を効率的に管理し、導入効果を高めるための方法を学びましょう。
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
Zoho Campaigns Resources
Zoho WorkDrive Resources
Related Articles
Zoho SalesIQとPageSenseを統合する
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 Zoho SalesIQという有効なチャットソフトウェアを利用して顧客の問い合わせに対応している場合、Zoho ...ShopifyにPageSenseスニペットをインストールする
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 ...異なるURLマッチタイプを使用した高度なページターゲティング
お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。 ...