概要
アナリティクスクエリは単一ストアの事前集計済み統計を返します。各アナリティクスクエリは以下を受け取ります:- ストア識別子 ——
storeIdまたはstoreSlug(トップレベル引数、いずれか一方が必須)。 - 必須の
filter(型はAnalyticsFilterInput!)。
granularity と currency です。時間の粒度は TimePeriodGranularity 列挙型を使用します:DAY、WEEK、MONTH、QUARTER、YEAR、ALL_TIME。
各アナリティクスクエリはスカラーの合計値ではなく構造化オブジェクトを返します。金額フィールドは表示用文字列として返されます。必要なネストされたフィールドを選択してください —— 以下の例で利用可能な構造を示します。
注文統計
注文数、デュアルソース収益、購入者メトリクス。revenueByCurrency / revenueByPeriod はデュアルソースです:pspTotalAmount は PSP の実際の金額、snapshotTotalAmount はスナップショットの予想金額、mismatchCount は両者が一致しない支払い件数です。支払い統計
成功率、失敗理由、返金、支払い方法の分布、税額サマリー。successRate はオブジェクト({ totalAttempts, succeeded, failed, pending, successRate })であり、スカラーではありません。商品統計
商品数、売れ筋ランキング、収益貢献度。トレンド分析
期間比成長率、累積収益、移動平均。分布分析
注文金額のパーセンタイル、AOV(平均注文額)トレンド、金額分布バケット。顧客分析
リテンション、LTV 分布、購入頻度、優良顧客。税務分析
税区分、税率グループ、国別の税額、および B2B/B2C 比較。サブスクリプション分析
請求期間の分布、キャンセル統計、トライアル転換、チャーン率。返金チケット分析
返金理由の分布、レビュー効率、承認率。清算分析
清算ファイルに基づく実際の入金額(手数料控除後・返金控除後)。これは照合のグラウンドトゥルースであり、paymentStatistics.settlementRevenueByCurrency(支払い時点の PSP 見積り換算値)とは口径が異なります。
settlementAnalysis の期間は created_at ではなく清算日に基づきます。ロールに応じて、deliveryAnalysis(Webhook/メール配信)や payoutAnalysis(出金チケット、マーチャント主体スコープ)など、他のアナリティクスクエリも利用できます。完全なフィールドセットは schema イントロスペクションで確認してください。