# アプリのアナリティクス

アナリティクスにアクセスしてアプリの稼働状態を確認します。

アプリのアナリティクスによって、アプリがどのように使用され、マーケットプレイスへの掲載がどのように行われているかをより詳しく把握できます。*公開アプリ* (A public app is discoverable on the Stripe App Marketplace)のインストール件数やリストの表示件数などのデータをエクスポートできます。このデータはダッシュボードまたは Stripe API で利用できます。

ダッシュボードには、アプリのパフォーマンスの把握に役立つ以下のような追加ツールが用意されています。

- 現在選択されている期間の単一数値のサマリー
  - レートに基づくレポート (%): 選択した期間の平均
  - レートに基づかないレポート: 選択した期間の合計
- 現期間と前の期間 (十分な履歴データを利用できる場合) をまとめたバッジ
- 選択した日付範囲に基づく解決策を使用した集計
  - 高解像度のデータをダウンロードするには、**CSV をダウンロード**をクリックします。
![アプリのアナリティクスの全チャートのダッシュボード](https://b.stripecdn.com/docs-statics-srv/assets/analytics-overview.646194fb349cbe6ef00b6bdbb83010d4.png)

## 始める

1. \**[開発者ダッシュボード](https://dashboard.stripe.com/developers) > [アプリ](https://dashboard.stripe.com/apps)\**から、アプリを選択します。
1. **分析**タブをクリックして、**CSV をダウンロード**をクリックします。
1. エクスポートするレポートを選択し、希望する日付範囲を設定します。

## 利用可能なレポート

以下のレポートは、CSV としてエクスポートして利用できます。

| 名前                          | 説明                                                                                    | レポートタイプ                       |
| --------------------------- | ------------------------------------------------------------------------------------- | ----------------------------- |
| **アプリのインストール数**             | インストール数/日                                                                             | `apps.install_events.1`       |
| **アプリのアンインストール数**           | アンインストール数/日                                                                           | `apps.uninstall_events.1`     |
| **累積純インストール数**              | これまでのインストール数 (`installs - uninstalls`)                                                | `apps.total_installs.1`       |
| **リストページビュー数**              | 毎日のアプリリストビュー数合計                                                                       | `apps.listing_views.1`        |
| **一意のリストページビュー数**           | アプリリストページにアクセスした一意の加盟店数合計                                                             | `apps.unique_listing_views.1` |
| **インストールからのコンバージョン率 (前月比)** | `# of new installs in the last 30 days` ÷ `# of leads in the last 30 days` x `100`    | `apps.lead_conversion_rate.1` |
| **リストページビューの成長率 (前月比)**\*   | (`# of leads this month` - `# of leads last month`) ÷ `# of leads last month` x `100` | `apps.lead_velocity_rate.1`   |
| **インストール解約率 (前月比)**         | `# of uninstalls in the last 30 days` ÷ `# of active installs 30 days ago` x `100`    | `apps.churn_rate.1`           |

\***リストページビューの成長率 (前月比)** では、早期のデータポイントでは高い値が示される場合があります。null 以外の最初のポイントから少なくとも 60 日後のデータを検討することをお勧めします。

### データの鮮度と定義

アナリティクスのデータは、レポートで利用可能になるまで 48 時間の時間差があります。リアルタイムの指標が必要な場合は、Stripe のプラットフォームプリミティブを使用して、ご自身の[カスタムアナリティクス](https://docs.stripe.com/stripe-apps/analytics.md#custom-analytics)を構築できます。

Stripe は「リード」をマーケットプレイスを訪れるログインしている加盟店として定義しています。

### Stripe API を使用してアクセスする

これらのレポートにプログラムでアクセスするには、[Reporting API](https://docs.stripe.com/api/reporting/report_run.md) を使用して、取得する特定の指標のレポートを実行します。指標はそれぞれレポートタイプとして利用でき、次の方法でリクエストできます。

```curl
curl https://api.stripe.com/v1/reporting/report_runs \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "report_type=apps.install_events.1" \
  -d "parameters[interval_start]=1680000000" \
  -d "parameters[interval_end]=1680100000"
```

## ユーザー

アプリの詳細ページの**ユーザー**タブには、現在インストールしているすべてのユーザーが一覧表示されます。ユーザーがアプリを再インストールした場合、`installed` 列は直近のインストール時の時刻に更新されます。
![アプリのユーザータブ](https://b.stripecdn.com/docs-statics-srv/assets/users_tab_dashboard.86c6ea2c19a5ad775ffa2d034f1582da.png)

## カスタムアナリティクス

提供された指標が十分ではない場合は、Stripe のプラットフォームプリミティブを活用して、次のソリューションを使用する一連の指標をご自身で作成できます。

### Webhook を使用する

Webhook を使用して、リアルタイムでアプリまたは拡張機能をインストールあるいはアンインストールしているユーザーを追跡して対応し、以下に関するインサイトを得ることができます。

- インストールしたユーザーのアカウント ID
  - インストールの日時
  - アンインストールしたユーザーのアカウント ID
  - アンインストールの日時
- Stripe アプリのユーザー
  - [拡張機能のユーザー](https://docs.stripe.com/stripe-apps/migrate-extension.md) (該当する場合)

詳細については、[アプリから Webhook イベントを受け取る](https://docs.stripe.com/stripe-apps/build-backend.md#receiving-events-webhooks)方法をご覧ください。

### Connect List API を使用する

Connect List API を使用して、現在アプリと[拡張機能](https://docs.stripe.com/stripe-apps/migrate-extension.md) (該当する場合) をインストールしているすべてのユーザーのリストが返されるようにします。

詳細については、[すべての連結アカウントをリスト](https://docs.stripe.com/api/accounts/list.md)のリファレンスをご覧ください。