> ## Documentation Index
> Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Portal のダッシュボードと分析

> 加盟店 Portal のダッシュボードの読み方：ホーム画面のデータ更新タイミングと精算カレンダー、Payments Analytics の指標定義、Chargeback Analytics の比率と対象期間、そして取引・返金・精算エクスポートの背後にあるルール。

このページでは、加盟店 Portal の各ダッシュボードが何を、どの期間で集計しているのか、そしてそれらの数値の背後にある
エクスポートがどう構築されているかを説明します。精算の仕組みは
[加盟店の精算](/docs/ja/essentials/merchant-settlement) にあります。

## 今日の実績がホームのダッシュボードに表示されないのはなぜですか？

ホームのダッシュボードは **T-1 のビュー**です：昨日までの直近 2 週間を表示し、今日以降は選択できません。数値は
**注文通貨ごと**にグループ化されます — 契約上の決済通貨を切り替えて表示します（10 件以上になるとドロップダウンになります）。
指標は、成功した決済の金額と件数、成功した返金の金額と件数（一部返金・全額返金を含む）で、それぞれトレンドチャートが付きます。
前日のデータの更新が完了していない場合は、不完全な数値を表示するのではなく、その旨が表示されます。

## ホームの未精算金額には何が含まれますか？カレンダーはどう読めばよいですか？

未精算金額は通貨ごとに、これまでに契約したすべての決済通貨について表示され、\*\*パッケージ済みのすべての精算書類の精算金額の合計
（手数料を除く）\*\*に等しくなります。今日の取引はまだパッケージ化されておらず — パッケージ化前には手数料を計算できません —
そのため、この数値はリアルタイムではなく、今日の取引一覧とは一致しません。マイナスの値はそのまま表示されます。
ホームには次回以降 3 回の精算の金額と精算予定日も表示されます。

カレンダーは今後 3 暦月をカバーし、今日以降の日付は選択でき、それ以前は選択できません。選択した日は、精算日ではない、
まだ精算されていない精算日（予定金額、または「精算対象金額なし」を表示）、精算成功、失敗、のいずれかです。予定金額は
その日に予定されているパッケージ済みの精算書類から算出され、**ある日の差引がマイナスになる場合、その不足分は繰り越され**、
次の精算日と相殺されて、その日は差引後の数値が表示されます。

## Payments Analytics は何を対象とし、その各率はどう定義されていますか？

**Transactions → Payments Analytics** はワンタイム決済と Direct Payment を対象とし、サブスクリプションは対象外です。
契約でマルチ通貨の注文が許可されている場合は注文通貨の指定が必須です。時間間隔（30 分、1 時間、日、週）はデフォルトでは分割なしです。
決済手段タイプは単一選択、決済手段は複数選択で、Active な決済手段に限られ、選択した通貨とタイプによって決まります。
全体ビュー、単一のタイプ、単一の決済手段については**ファネル**が、複数の決済手段を選択すると**テーブル**が表示され、
1 つの通貨と決済手段が複数の設定に解決される場合は国ごとに分割されます。

ファネルには 3 つの件数 — 作成された注文の総数、チェックアウトで正常に作成された決済注文、成功した注文 — があり、
各率は指標のツールチップが述べるとおりに、それらの上に構築されます。

| 指標 | 定義 |
| - | - |
| Checkout Conversion Rate (CCR) | チェックアウト成功注文 ÷ 総注文数 |
| Payment Conversion Rate (PCR) | 成功した注文 ÷ チェックアウト成功注文 |
| Success Rate | 成功した注文 ÷ 総注文数 |

つまり CCR は作成された注文のうちどれだけが決済の試行に到達したか、PCR は試行のうちどれだけが支払われたかを測り、
Success Rate はこの 2 つの積です。サブスクリプションのプロダクトは、初回期間と更新に分けて確認できます。

## Chargeback Analytics の比率カードは何を測っていますか？

**Analytics → Chargeback Analytics** には 4 つの比率カードが表示され、それぞれのカードのツールチップに分子と分母が示されています。

| カード | 分子 | 分母 |
| - | - | - |
| Visa Chargeback Rate | 不正利用レポート（TC40）＋ 初回チャージバック（TC15） | 精算済みの成功したカード取引 |
| Visa Fraud Rate | 不正利用レポート（TC40）＋ 不正コード付きの初回チャージバック（Visa 理由コード 10.4） | 精算済みの成功したカード取引 |
| Mastercard Chargeback Rate | 初回チャージバック（理由コードを問わない） | 精算済みの成功したカード取引 |
| Mastercard Fraud Rate | 不正フラグ付きの初回チャージバック（理由コード 4837 のみ） | 精算済みの成功したカード取引 |

各カードにはカードネットワークの早期警告のしきい値が表示され、それを超えると値が赤くなり、どれだけ上回っているかが表示されます。
ページには 2 つの注意書きが表示されます。これらは**運用上の早期警告の数値であり、カードネットワークのコンプライアンス計算ではありません** —
それらのプログラムはずれた月次の期間を使い、不正利用レポートのカバー範囲も網羅的ではないため、実際のコンプライアンス比率は
表示されているものより高くなる可能性があります。また、チャージバックのデータは案件が決着するにつれて修正されるため、
以前に控えた値ではなく最新の値を読んでください。

## Chargeback Analytics はどの期間を対象としていますか？

日付フィルターのデフォルトは当月 1 日から今日までなので、カードは\*\*月初からの累計（month-to-date）\*\*です。カスタム範囲を指定すると、
連動するすべてのカード、トレンドチャート、理由コードチャートがその範囲の累計値に切り替わりますが、これは月次のコンプライアンスビューではありません。
開始日と終了日が同じ場合は、その月の 1 日からその日までとして扱われます。Chargeback Count はその期間に作成されたすべての案件
（キャンセルされたものを除く）を対象とします。

* **Chargeback Amount** は異議申し立て金額とチャージバック手数料の合計で、表示用に USD に換算され（ホバーで 2 つの内訳を表示）、
  勝訴と敗訴を区別しません。
* **Expiring Soon** はリアルタイムで、**すべてのフィルターを無視します**（カードブランドを含む）：常に、お客様の応答待ちで期限が近い
  すべての異議申し立てを表示し、クリックするとそのフィルターが適用された状態で Disputes 一覧が開きます。
* **Reason Code distribution** は上位 10 コードと「Others」を表示し、チャート内のタブで全ブランド・Visa・Mastercard を、
  ページのフィルターとは独立して切り替えられます。

## 取引・返金・精算エクスポートのルールは何ですか？

エクスポートは見たままが得られるもの（what-you-see-is-what-you-get）です：一覧に現在適用されているフィルターから生成されます。
[消込レポート](/docs/ja/developer-docs/tools-and-references/references/reconciliation-reports) で説明されている、
スケジュールされた精算レポートファイルとは別のものです。

* **期間は 31 日が上限**です。それより広い範囲はファイル生成前にブロックされます。
* ファイル名は `payments_{mid}_{from}_{to}.csv` と `refunds_{mid}_{from}_{to}.csv` で、いずれも日付は UTC+8 の `YYYYMMDD` 形式です。
  精算履歴は `Settlements_{MID}_{download time}.csv` としてエクスポートされます。
* **結果が空でもファイルは生成され**、ヘッダー行のみを含みます。そのため「該当する取引なし」とエクスポート失敗を区別できます。
* ファイルには一覧より多くの列が含まれます — `Original Order Id`、`Merchant Id`、`Transaction Type`、`Order Description`、
  `Product Name`、`Merchant User Id`、`Settlement Status` を含む — そして一覧の 1 つの `Order Amount` セルを
  `Order Amount` と `Order Currency` に分割します。
* タイムゾーンは列名に明示されます：`Created Datetime(UTC+8)`、`Payment Request Datetime(UTC+8)`、`Payment Datetime(UTC+8)` で、
  形式は `YYYY-MM-DD hh:mm:ss` です。Portal では、精算関連のラベルはすべて UTC+8 と明記され、それ以外のタイムスタンプは
  お客様のローカルタイムゾーンに従います。
* `Settlement Status` が `-` の場合、精算が失敗したのではなく、その取引がまだ精算されていない（値が null）ことを意味します。
  精算が実行されると `SETTLE_SUCCESS`、`SETTLE_FAIL`、`SETTLE_FAIL_NEED_RETRY` のいずれかになります。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.