App analytics

App analytics enables you to better understand how your apps are used and how your marketplace listings perform. You can export data, such as the number of installs and listing views, for your public app. This data is available in Dashboard or the Stripe API.

The Dashboard provides additional tools to help you understand your app’s performance, such as:

• Single-number summaries for the currently selected period
  • Rate-based reports (%): Average for the selected period
  • Non-rate-based reports: Sum for the selected period
• Badges that summarize the current period with the previous period (if sufficient historical data is available)
• Aggregation using a resolution based on your selected date range
  • To download higher-resolution data, click Download CSV.

Get started

1. From the Developer’s Dashboard > Apps, select your app.
2. Click the Analytics tab, then click Download CSV.
3. Choose the report to export and select your preferred date range.

Available reports

The following reports are available to export as a CSV.

Data freshness and definitions

The analytics data lags up to 48 hours before it’s available in reports. If you’re looking for real-time metrics, you can build your own custom analytics using our platform primitives.

We define “leads” as logged-in merchants who visit the marketplace.

Accessing using the Stripe API

To access these reports programmatically, you can use the Reporting API to run a report for the specific metrics you want to fetch. Each of the metrics is available as report types, which you can request in the following way:

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

Users

The Users tab in your app’s details page lists all the currently installed users. If a user reinstalls your app, the installed column updates to the most recent install time.

Custom analytics

If the provided metrics aren’t sufficient, you can leverage the platform primitives of Stripe to build your own set of metrics using the following solutions:

Using webhooks

Use webhooks to track and respond to users who install or uninstall your app or extension in real time, where you can get insights about:

• Installed user’s account ID
  • Date and time of install
  • Uninstalled user’s account ID
  • Date and time of uninstall
• Stripe app users
  • Extension users (if applicable)

For more information, see how to receive webhook events from your app.

Using Connect List API

Use the Connect List API to return a list of all the users who’ve currently installed your app and extension (if applicable).

For more information, see the List all connected accounts reference.