収益目標の追跡

収益目標の追跡

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

概要  

PageSense Python SDKでは、goal_propertiesパラメーターを使用して目標に関する追加情報を渡すことで、目標追跡APIによる売上目標の追跡が可能です。売上を追跡することで、フルスタックA/Bテストがもたらす金銭的効果を測定し、テストの各バリエーションで発生した売上を分析できます。SDKは、プロジェクト単位で売上を記録するだけでなく、訪問者が対象条件を満たした、追跡対象の目標に関連付けられているすべての有効なテストに、売上コンバージョンを自動的に関連付けます。売上の値はGoalProperty.REVENUEを使用して指定します。

使用するタイミング  

訪問者が取引を完了した場合や、測定可能なビジネス価値を生み出す操作を実行した場合に、売上目標の追跡を使用します。
一般的な例は次のとおりです。
  • 商品の購入
  • サブスクリプション料金の支払い
  • プレミアム機能へのアップグレード
  • 注文の確定
  • 予約の確定
  • 寄付金の支払い
  • 個別指定した売上発生イベント

メソッドシグネチャー  

track_goal(
goal_name: str,
user_context: PageSenseUserContext,
goal_properties: dict[GoalProperty, str]
)

パラメーター  

パラメーター
種類
必須
説明
goal_name
str
はい
設定済みの売上目標の名前です。
user_context
PageSenseUserContext
はい
目標の関連付けに使用する訪問者情報です。
goal_properties
dict[GoalProperty, str]
はい
売上目標のプロパティを含む辞書です。
 

戻り値  

種類
説明
None
このAPIは値を返しません。

売上目標のプロパティ  

現在、Python SDKでは次の目標プロパティをサポートしています。

目標プロパティ
値の種類
説明
GoalProperty.REVENUE
str
目標のコンバージョンに関連付けられる売上額です。
 
メモ:目標プロパティの値は、必ず文字列として指定してください。

売上の値の形式  

売上の値は、SDKに渡す前に通貨の最小単位に変換する必要があります。売上目標の売上の値を追跡するには、次の手順を実行します。
  1. 売上の値に100を掛けます。
  2. 計算結果の値を文字列に変換します。
  3. 計算結果の値をGoalProperty.REVENUEを使用して渡します。
この方法により、浮動小数点数の精度に関する問題を回避し、異なる通貨間でも売上を一貫して追跡できます。
例:
売上額
SDKに渡す値
$25.99
'2599'
€149.95
'14995'

使用例  

from pagesense import GoalProperty
from pagesense import PageSenseUserContext

# Create the user attributes
user_attributes = {
'Browser': 'Chrome',
'Device': 'Desktop'
}
# Create the PageSenseUserContext object
user_context = PageSenseUserContext(
user_id='USER_001',
user_attributes=user_attributes
)
 
# Create the Revenue Goal property
goal_properties = {
GoalProperty.REVENUE: '1999'
}
# Track the Goal
pagesense_client.track_goal(
goal_name,
user_context,
goal_properties
)

動作の仕組み  

売上目標を追跡すると、SDKによって次の処理が実行されます。
  1. 売上目標がプロジェクト単位で記録されます。
  2. 指定した目標に関連付けられている有効なフルスタックA/Bテストがすべて特定されます。
  3. 訪問者が各テストの対象条件を満たしているかどうかが判定されます。
  4. 売上コンバージョンが該当するすべてのテストに自動的に割り当てられます。
  5. レポート作成と分析のため、売上情報がPageSenseサーバーに送信されます。
テスト単位で売上を追跡するために、追加のAPI呼び出しは必要ありません。

注意事項  

  • 売上の追跡には、同じtrack_goal() APIが使用されます。
  • 売上の値は、GoalProperty.REVENUEを使用して渡す必要があります。
  • 目標プロパティの値は文字列である必要があります。
  • 売上は、追跡する前に必ず最小通貨単位に変換してください。
  • テストへの売上の割り当ては、SDKによって自動的に行われます。

ベストプラクティス  

  • 取引が正常に完了した直後に、売上目標を追跡します。
  • テストの評価時に使用したものと同じPageSenseUserContextを再利用します。
  • 設定した目標名が、PageSenseで設定されている売上目標と完全に一致していることを確認します。
  • 売上の値は、SDKに渡す前に必ず最小通貨単位に変換します。
  • 売上を正確にレポートするため、有効な取引金額のみを渡します。