収益目標の追跡

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

概要

PageSense Python SDKでは、goal_propertiesパラメーターを使用して追加の目標情報を渡すことで、Track Goal APIによる収益目標の追跡が可能です。収益を追跡することで、FullStack A/B Test実験による金銭的な効果を測定し、実験の各パターンが生み出した収益を分析できます。プロジェクト単位で収益を記録するだけでなく、追跡対象の目標に関連し、訪問者が対象条件を満たしたすべての有効な実験に対して、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に渡す前に通貨の最小単位に変換する必要があります。収益目標の収益額を追跡するには、

収益額に100を掛けます。
計算結果を文字列に変換します。
変換した値を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
)
 
# Creae the Revenue Goal propety
goal_properties = {
GoalProperty.REVENUE: '1999'
}
# Track the Goal
pagesense_client.track_goal(
goal_name,
user_context,
goal_properties
)

仕組み

収益目標をトラッキングすると、SDKは次の処理を実行します。

プロジェクトレベルで収益目標を記録します。
指定した目標に関連付けられているすべての有効なFullStack A/Bテストを特定します。
訪問者が各テストの対象条件を満たしているかどうかを判定します。
該当するすべてのテストに収益コンバージョンを自動的に関連付けます。
レポート作成と分析のため、収益情報をPageSenseサーバーに送信します。

テストレベルで収益をトラッキングするために、追加のAPI呼び出しは必要ありません。

注意事項

収益のトラッキングには、同じtrack_goal() APIを使用します。
収益値はGoalProperty.REVENUEを使用して渡す必要があります。
目標プロパティの値は文字列にする必要があります。
収益は、トラッキングする前に必ず最小通貨単位に変換する必要があります。
テストへの収益の関連付けは、SDKによって自動的に行われます。

推奨事項

取引が正常に完了した直後に収益目標をトラッキングします。
テストの評価時に使用したものと同じPageSenseUserContextを再利用します。
設定した目標名が、PageSenseで設定した収益目標の名前と完全に一致していることを確認します。
収益値は、SDKに渡す前に必ず最小通貨単位に変換します。
正確な収益レポートを作成できるよう、有効な取引金額のみを渡します。