イベントアナリティクス

この機能は、すでにペイステーションを統合 し、少なくとも 1 つのアカウントを設定している場合に利用できます:

注意

GoogleアナリティクスとMetaは、ユーザーがGDPRバナーですべてのクッキーの使用に許可を与えたか、分析およびパフォーマンスクッキーの使用に同意した場合にのみデータを収集します。

アナリティクスプラットフォームとの統合

ユーザーが決済UIを操作したときに発生するイベントを追跡するには、パブリッシャーアカウントで分析プラットフォームを接続します:

Googleアナリティクス

アナリティクスプラットフォームを接続するには:

  1. パブリッシャーアカウントでプロジェクトを開き、決済ソリューション > 決済インタフェース > 設定セクションに移動します。
  2. アプリセクションで、「Googleアナリティクス」を選択します。
  3. 接続」をクリックします。

Googleアナリティクスに接続すると、対応するイベントがGoogleアナリティクスアカウントに送信されます。これらのイベントは、Engagement > Events > Top EventsGoogleアナリティクスで確認できます。

以下のイベントを追跡できます:

アクション説明
open-{state_name}決済UIでページを開く
click-btn-pay請求日入力フォームで今すぐ支払うをクリックする。
returnストアに戻る/もう一度開始ボタンをクリック。
create-invoiceトランザクションの作成。
purchaseインボイスを作成する(トランザクションIDを割り当てる)。イベントパラメータには、アイテム価格や税金などの購入に関する詳細情報が含まれます。パラメータの説明はGoogleアナリティクスドキュメントを参照してください。

イベントは、アイテムカタログセクションのパブリッシャーアカウントでカタログを構成した場合にのみ送信されます。
open-payment-credit-cardカード情報を入力するための決済UIを開きます。
open-payment-saved-methods決済方法を保存したページを開きます。
open-payment-payment-methodsその他をクリックすると、利用可能なすべての決済方法のリストが開きます。
open-payment-{id}idが決済方法IDである特定の決済方法のページを開きます。
open-status決済状態のページを開きます。
open-status-processing決済状態(processing)のページを開きます。処理終了後、successまたはerrorに変更することができます。
open-status-error決済状態(error)のページを開きます。
open-status-success決済状態(success)のページを開きます。
choose-methodその他リストを開いたときに支払い方法を選択します。
Googleアナリティクスのカスタムディメンション
寸法ID名前説明
1version有料ステーション版。
2purchase_invoice_idエクソーラシステムでの支払請求書ID。
3external_idパートナーシステムでの支払請求書ID。
5total_sum購入金額の合計。全ての料金が含まれています。
6total_sum_currency購入金額の通貨の合計。
7pid決済システムのIDです。
8projectIdプロジェクトID。
9country支払い国。
10projectNameプロジェクトの名前。

Metaアナリティクス

アナリティクスプラットフォームを接続するには:

  1. パブリッシャーアカウントでプロジェクトを開き、決済ソリューション > 決済インタフェース > 設定セクションに移動します。
  2. アプリセクションで、「Metaピクセル」を選択します。
  3. 接続」をクリックします。

Metaピクセルに接続すると、対応するイベントがMeta広告マネージャーに送信されます。これらのイベントは、Advertising settings > Datasets and pixelsMeta広告マネージャーで確認できます。

以下のイベントを追跡できます:

イベント説明
open-{state_name}決済UIでページを開く。状態の名前がparametersに渡されます。
click-btn-pay請求日入力フォームで今すぐ支払うをクリックする。決済方法の名前がparametersに渡されます。
returnストアに戻る/もう一度開始ボタンをクリック。ステータス名がparametersに渡されます。
change-status-{status_name}支払いステータスを変更する。
ユーザーが決済UIを閉じるかページを離れると、ステータスが変わります。イベントメッセージは送信されません。
create-invoiceトランザクションの作成。
open-payment-credit-cardカード情報を入力するための決済UIを開きます。
open-payment-saved-methods決済方法を保存したページを開きます。
open-payment-payment-methodsその他をクリックすると、利用可能なすべての決済方法のリストが開きます。
open-payment-{id}idが決済方法IDである特定の決済方法のページを開きます。
open-status決済状態のページを開きます。
open-status-processing決済状態(processing)のページを開きます。処理終了後、successまたはerrorに変更することができます。
open-status-error決済状態(error)のページを開きます。
open-status-success決済状態(success)のページを開きます。
choose-methodその他リストを開いたときに支払い方法を選択します。

GoogleアナリティクスMetaピクセルを統合すると、対応するイベントがGoogleアナリティクスやMeta広告マネージャーアカウントに送信されます。

GameAnalytics

アナリティクスプラットフォームを接続するには:

  1. パブリッシャーアカウントでプロジェクトを開き、決済ソリューション > 決済インタフェース > 設定セクションに移動します。
  2. アプリセクションで、「GameAnalytics」を選択します。
  3. 接続」をクリックします。

  1. GameAnalyticsゲームキー」フィールドに、ゲームキーを入力します。この情報は、GameAnalyticsのアカウントで確認できます:
    1. トップパネルのドロップダウンメニューで、ゲームを選択します。
    2. Keysセクションで、Game keyの横にあるコピーアイコンをクリックします。

お知らせ
複数のプラットフォームでゲームがリリースされている場合、GameAnalyticsにはそれぞれのプラットフォーム用に専用のプロジェクトがあります。パブリッシャーアカウントでこれらのプラットフォームのいずれかに対するゲームキーを入力できます。

  1. 接続」をクリックします。

現在、GameAnalyticsプラットフォームとの統合により、支払いが成功したイベントに関する情報を受け取ることができます。このデータは、GameAnalyticsアカウントのダッシュボードのMonetizationセクションで見つけることができます。

決済UIイベント

決済インターフェースのイベントは、ペイステーションをiframe、新しいウィンドウ、またはPay Station Embedで開いたときに、postMessageメカニズムによって処理されます。

postMessage経由で送信されたメッセージを処理するシナリオの例:

  1. postMessage経由で送信されたメッセージを受信するには登録してください。
  2. イベントのデータをJSON形式に解析します。
  3. 処理が必要なイベントの有無のチェックを実装します。
  4. 必要なイベントを受信したら、それを処理するロジックを実装します。以下の例では、テキストがコンソールに出力されます。独自のロジックを追加できます。

例:
Copy
Full screen
Small screen
1window.addEventListener('message', (event) => {
2  const eventData = JSON.parse(event.data);
3
4  if (eventData.command === 'open-payment') {
5    console.log('hello!')
6  }
7});
イベント説明
add_saved_account決済アカウントの保存に成功しました。
add_saved_account_error決済アカウントの保存中にエラーが発生しました。
cancel_save_accountユーザーによる決済アカウントの保存のキャンセル。
cart_display決済UIの列としての表示。valueパラメータは下記通り:
  • 決済UIが2カラムで表示される場合は1
  • 決済UIが1カラムで表示される場合は0、例えば、保存した決済方法を管理するページで
{“command”:“cart_display”,“data”:{“value”:“1”,“version”:“Pay Station 4”}}
change-status支払いステータスを変更する。ユーザーが決済UIを閉じるかページを離れると、ステータスが変わります。イベントメッセージは送信されません。
choose-methodその他リストを開いたときに支払い方法を選択します。
click-custom-package-continue続けるボタンをクリックして任意の量の仮想通貨を購入する。
click-commentボタンをクリックしてコメントを投稿する。
click-buy-packageパッケージの購入ボタンをクリックして、仮想通貨のパッケージを購入する。
click-buy-gift-packageボタンをクリックして、仮想通貨のパッケージをギフト用に購入する。
click-buy-gift-custom-packageボタンをクリックして、任意の量の仮想通貨をギフト用に購入する。
click-btn-pay請求日入力フォームで今すぐ支払うをクリックする。
click-btn-continueボタンをクリックしてサブスクリプションを購入する。
click-btn-apply適用ボタンをクリックして、クーポンを引き換える。
click-btn-activate有効化ボタンをクリックして、ゲームキーを有効にする。
click-btn-acceptボタンをクリックしてデジタルコンテンツを購入する。
create-invoiceトランザクションの作成。
dimensionsペイステーションがiframeで開くときに、widthheightパラメータにiframeの幅と高さが渡されます。
error支払い処理中に発生するエラー。エラーコードはdata.codeパラメータで渡され、決済UIのエラーの説明はdata.messageパラメータで渡されます。
external-link-open外部リソースへのリダイレクト。urlパラメータには、リダイレクト先のアドレスが渡されます。
external-payment-open決済UIから外部の決済システムまたは3-D安全性検証へのリダイレクト。
focus-changeペイステーションウィジェットの要素のフォーカスを変更します。フォーカスの状態はhasFocusパラメータに渡され、trueまたはfalseです。
open-{state_name}決済UIでページを開く。
open-payment-credit-cardカード情報を入力するための決済UIを開きます。
open-payment-saved-methods決済方法を保存したページを開きます。
open-payment-payment-methodsその他をクリックすると、利用可能なすべての決済方法のリストが開きます。
open-payment-{id}idが決済方法IDである特定の決済方法のページを開きます。
open-status決済状態のページを開きます。
open-status-processing決済状態(processing)のページを開きます。処理終了後、successまたはerrorに変更することができます。
open-status-error決済状態(error)のページを開きます。
open-status-success決済状態(success)のページを開きます。
order-status注文状態をdoneに変更する。このイベントは、以下のAPIコールのいずれかで注文が作成された場合、決済状況ページから送信されます:
ユーザー、トランザクション、注文に関するデータはdataオブジェクトで渡されます。

例: {“command”:“order-status”,“data”:{“user_id”:“123abc-456”,“invoice_id”:123456,“price”:{“amount”:“12.96”,“currency”:“USD”},“order_id”:123456,“items”:[{“id”:123456,“sku”:“booster_min”,“quantity”:2,“amount”:“3.99”,“price”:{“amount”:“3.99”,“currency”:“USD”},“tax_category”:“DG00001”},{“id”:123456,“sku”:“boots_1”,“quantity”:1,“amount”:“2.99”,“price”:{“amount”:“2.99”,“currency”:“USD”},“tax_category”:“DG00001”},{“id”:1234567,“sku”:“xsolla_gloves”,“quantity”:1,“amount”:“1.99”,“price”:{“amount”:“1.99”,“currency”:“USD”},“tax_category”:“DG00001”},{“id”:12345678,“sku”:“reward_vp_a”,“quantity”:5,“amount”:“0”,“price”:{“amount”:“0”,“currency”:“USD”},“tax_category”:“DG00001”}],“version”:“Pay Station 4”}}
resize決済UIのサイズの変更。開いた決済UIの幅と高さは、dataオブジェクトで渡されます。
{“command”:“resize”,“data”:{“dimensions”:{“width”:924,“height”:754},“version”:“Pay Station 4”}}
show-error-pageページを開くとエラーが発生します。valueパラメータにエラーコードが渡されます。
status決済状況のページに移動します。以下のパラメータを渡すことができます:
  • status — 決済状況
  • email — ユーザーのメール
  • invoice — トランザクションID
  • virtualCurrencyAmount — 購入した仮想通貨の金額
  • userId — ユーザーID
  • discount — 決済に適用される割引
status-redeem決済フォームでのクーポン引き換えです。
close決済UIを閉じる。
postMessageから各メッセージにイベントパラメータが渡されます。パラメータ情報がまだ収集されていない場合は、空の文字列が表示されます。
パラメータ種類説明
actionstringイベント名。
valuestring追加パラメータ。ユーザーの選択に応じて変化する特定のイベントパラメータを含みます。
statestringアクションが実行された決済UIページ。
datestring日付と時刻をGMT形式で表示します。
millisecondsnumber日付と時刻をUnix時間形式で表示します。
timezonestringユーザーのタイムゾーン。
session_idstringセッションID。セッションには、30分以内、または決済UIが閉じるまでに実行されたすべてのユーザーアクションが含まれます。セッションは、決済UIが開かれた瞬間から開始され、決済UIのあるページがリフレッシュされた後に保存されます。
payment_countrystring支払い国。
purchase_invoice_idnumberエクソーラシステムでの支払請求書ID。
purchase_external_idstringパートナーシステムでの支払請求書ID。
purchase_typestring購入のタイプは:virtual itemvirtual currencypay2playsubscription
purchase_sumnumber名目購入額。
purchase_currencystring通貨を購入します。
purchase_skustring購入した商品のSKU。
purchase_digital_content_skustring購入したゲームキーのパッケージのSKU。
purchase_descriptionstring購入説明書。
virtual_currency_amountnumber仮想通貨の金額。
coupon_codestringクーポンコードです。
subscription_package_external_idnumber購読ID。
subscription_package_namestring購読名。
subscription_package_descriptionstring購読の説明。
total_sumnumber購入金額の合計。全ての料金が含まれています。
total_sum_currencystring購入金額の通貨の合計。
user_idstringユーザーID(v1)。
user_countrystringユーザーの国。
payment_instance_namestring決済方法の名前。
イベントは、アイテム購入時にユーザーがすべてのアクションを行うページにリンクしています。
状態説明
cart仮想通貨で購入した選択したアイテムと購入確認のページ。
couponクーポン入力フォームです。
giftcardギフトカード一覧ページ(ギフトカードウィジェット)。
giftrecipientプレゼント購入ページです。
history購入履歴ページ。
indexアプリケーションを開いた後にリダイレクトされるサービスページ。ユーザには表示されません。
legal法的文書へのリンクがあるページのモバイル版。
list決済方法のリスト。
paybycashキャッシュキオスクで購入する際の支払い方法一覧ページ(現金でのお支払いウィジェット)。
paymentお支払いフォームです。
paymentaccount保存されている支払い口座のページです。
paymentreturn決済後にユーザーがリダイレクトされるサービスページで、そこからステータスページに送られます。ユーザーには表示されません。
pincartデジタルコンテンツプラットフォームの一覧ページ。
pricepoint仮想通貨ストア。
savedmethod保存されている支払い方法の一覧です。
shippingaddress宅配便の住所録用紙。
statusステータスページ。
subscription定期購読プランのお店。
subscriptionchange購読プランの変更。
useraccount今後のアイテム購入設定の確認画面を無効にする設定にしたアカウント情報ページ(ユーザー名、残高)です。
userinventoryユーザーのインベントリ。
usermenuユーザーメニューページのモバイル版。
usersubscriptionユーザーのサブスクリプション管理。
usersubscriptioninfo購読の詳細ページです。
virtualitem仮想アイテムストア。

イベントをGoogleアナリティクスおよびMeta広告マネージャーアカウントに送信するには、これらのアナリティクスプラットフォームを統合する必要があります。
この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
最終更新日: 2025年9月19日

誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。

問題を報告する
当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
フォローアップ用のメールをご提供してください
ご意見ありがとうございました!
フィードバックを送信できませんでした
後でもう一度お試しいただくか、doc_feedback@xsolla.comまでお問い合わせください。