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

# 顧客管理

> マーチャントダッシュボードから顧客を表示・追跡

## 顧客管理

マーチャントダッシュボードの顧客ページでは、ストアから購入したすべての消費者を一覧で確認できます。収益の追跡、サブスクリプションの監視、個別の顧客詳細の確認が可能です。

***

## 顧客データ

各顧客レコードには、バックエンドの `Customer` 型から取得された以下のフィールドが含まれます：

| フィールド               | 説明                    |
| ------------------- | --------------------- |
| `id`                | 一意な顧客識別子（UUID）        |
| `email`             | 顧客のメールアドレス            |
| `name`              | 顧客名                   |
| `country`           | 顧客の国                  |
| `totalRevenue`      | この顧客からの累計収益（表示形式の文字列） |
| `mrr`               | この顧客に帰属する月間経常収益       |
| `subscriptionCount` | サブスクリプション数（有効および過去）   |
| `paymentCount`      | 総支払い回数                |
| `createdAt`         | 顧客レコードの作成日時           |
| `updatedAt`         | 顧客レコードの最終更新日時         |
| `storeId`           | この顧客が属するストア           |

<Note>
  バックエンドの `Customer` 型には `status` フィールドがありません。ダッシュボード UI に表示されるステータスラベル（「アクティブ」や「サブスクリプション中」など）は、顧客のサブスクリプションおよび支払いアクティビティから導出されたものであり、顧客レコード自体のプロパティとして保存されているものではありません。
</Note>

***

## 顧客一覧

ダッシュボードでは、以下のカラムを持つソート・フィルター可能なテーブルで顧客を表示します：

| カラム       | 説明            |
| --------- | ------------- |
| メール       | 顧客のメールアドレス    |
| 国         | 顧客の国（国旗絵文字付き） |
| 収益        | 累計生涯収益        |
| MRR       | 月間経常収益        |
| サブスクリプション | サブスクリプション数    |
| 支払い       | 支払い回数         |
| 作成日       | 顧客が初めて表示された日  |

### 検索とフィルタリング

顧客一覧では以下の機能をサポートしています：

* **テキスト検索** -- 顧客のメールアドレスまたは名前で検索
* **ステータスフィルタリング** -- サブスクリプションおよび支払いアクティビティに基づく導出ステータスカテゴリでフィルタリング
* **日付範囲フィルタリング** -- 顧客の作成日でフィルタリング

***

## 顧客詳細

顧客の行をクリックして、フルプロフィールを表示します。

### 概要

* メールアドレスと名前
* 国（国旗絵文字付き）
* アカウント作成日
* 累計生涯収益
* 現在の MRR
* サブスクリプション数と支払い回数

### サブスクリプション

この顧客に関連するすべてのサブスクリプションを表示：

* サブスクリプションステータス
* 商品とティアの情報
* 請求期間
* 日付と金額

### 支払い

この顧客の完全な支払い履歴を表示：

* 支払いステータス
* 金額と通貨
* 関連する注文と商品
* 返金ステータス（該当する場合）

***

## カスタマーポータル

顧客はセルフサービスの**カスタマーポータル**にもアクセスでき、自分のサブスクリプションの管理や支払い履歴の閲覧が可能です。ポータルは別機能です -- 詳細は[カスタマーポータル](/ja/features/customer-portal)ページをご覧ください。

ポータルで顧客が利用できる主な機能：

* サブスクリプションと支払いの表示
* サブスクリプションティアの変更（アップグレードまたはダウングレード）
* サブスクリプションのキャンセル
* 請求先情報の更新
* 請求書と領収書のダウンロード

<Tip>
  カスタマーポータルは安全なメール認証を使用します。消費者はメールに送信される確認リンクで認証します。
</Tip>

***

## 関連

<CardGroup cols={2}>
  <Card title="カスタマーポータル" icon="user" href="/ja/features/customer-portal">
    消費者が注文やサブスクリプションを管理するためのセルフサービスポータル。
  </Card>

  <Card title="注文と支払い" icon="receipt" href="/ja/features/orders-payments">
    注文と支払いレコードの表示と管理。
  </Card>
</CardGroup>