You can find detailed information about your apps' revenue, installations, and reviews on the **Apps** page in your Partner Dashboard. From there, you can see at a glance how each of your apps is performing, how merchants are using your apps, and how much revenue your apps have generated.

## View app analytics

Analytics for each app appear on its **Overview** page in your Partner Dashboard.

For data that includes a percentage change, the change compares data for the date range shown in the dashboard with the cumulative data prior to the start of that date range.

For example, when you look at the number of app installs for the last 90 days, the percentage change compares the number of installs during the past 90 days to the total number of installs from the day that your app was created up to the start of that 90-day period. If your app was installed 1000 times during its first year, and then was installed 100 times during the following 90 days, then the percentage change for that 90-day period would be 10% (100/1000).

To view analytics for an app:

1. Log in to your [Partner Dashboard](https://app.shopify.com/services/partners/auth/login).

2. Click **Apps**.

3. Click the name of the app whose details you want to view. You'll see a range of metrics on its **Overview** page:

   <figure class="figure"><img src="https://cdn.shopify.com/shopifycloud/shopify_dev/assets/apps/store/success/tracking-usage/app-analytics-dashboard-1bae83a21faba21b0f6f13ea5f1620e307d8e759af88d7f7c5941299d03751c3.png" class="lazyload" alt="An example app analytics dashboard, showing the merchant growth, installs, earnings, and uninstalls for an app." width="922" height="2117"></figure>

   By default, the dashboard shows data for the last 30 days. If you want to see data for a different date range, then select one from the date picker. To learn more about the metrics that appear on this page, see [App metric definitions](#app-metric-definitions).

4. If you want to export your data to a CSV file, then click **Export** and select the data to export:
  - **Current merchants**
  - **Earnings**
  - **History**

> Note:
> The data that appears on the app’s **Overview** page reflects a delay of up to 10 minutes. You can refresh your browser page to show the most recent available data.


## View active merchant installs

To view your active merchant installs, complete the following steps:

1. From your [Partner Dashboard](https://partners.shopify.com/organizations), click **Apps**.
1. Click the name of the app that you want to view.

On the app **Overview** page, the number of **Merchants with your app** is displayed in the top right corner.

## Export active install data

For a more detailed list of the merchants who have installed your app, you can export install data:

1. From your [Partner Dashboard](https://partners.shopify.com/organizations), click **Apps**.
1. Click the name of the app that you want to view.
1. Click **Export** and select **Export Current Merchants**.
1. Check your email inbox for a message indicating that the export was completed.
1. Open the email and click **Download CSV file** to save the CSV.

The CSV file can be imported to most spreadsheet programs and provides additional details, such as the type of plan merchants are on, when the app was installed, and whether it was organic or attributed to a paid ad campaign.

## App metric definitions

The following table includes definitions for the metrics that appear on the **Overview** page:

<table>
<tr>
<th width="30%">Total earnings to date</th>
<td>The sum of an app's pending payments and payments received.</td>
</tr>
<tr>
<th>Merchants with your app</th>
<td>The total number of active stores with the app installed. Active stores include any stores currently on a paid or trial plan, staff stores, and development stores. This number excludes stores that are canceled or frozen.</td>
</tr>
<tr>
<th>Merchant growth</th>
<td>The cumulative number of active stores with the app installed over the selected date range. </td>
</tr>
<tr>
<th>Installs</th>
<td>The total number of installs over the selected date range. An install occurs after a merchant approves the permissions shown on the OAuth grant screen. This number excludes stores that are canceled or frozen.</td>
</tr>
<tr>
<th>Uninstalls</th>
<td>The total number of uninstalls over the selected date range. An uninstall occurs after a merchant has removed an app from their store.</td>
</tr>
<tr>
<th>Time to uninstall</th>
<td><p>The number of stores that have uninstalled an app over the selected date range. Time periods are:</p>
<ul>
<li>Same day as install</li>
<li>1-14 days from install</li>
<li>15-90 days from install</li>
<li>91+ days from install</li>
</ul>
</td>
</tr>
<tr>
<th>Re-opened stores</th>
<td>The number of previously closed stores that have been activated again. All apps that were installed prior to closing are considered to be active again when the store is re-opened.</td>
</tr>
<tr>
<th>Closed stores</th>
<td>The number of stores that have closed (the merchant is no longer an active Shopify customer) with your app installed at the time of closing. This number includes stores that are canceled or frozen.</td>
</tr>
<tr>
<th>Earnings</th>
<td><p>The sum of the app's pending and previous payouts, minus any application credits that have been deducted, for the selected date range. The amount doesn't include any payments from merchants who have yet to pay an outstanding balance to Shopify. To learn more about how earnings are calculated, see <a href="#earnings"><em>Earnings</em></a>.</p>
<p><strong>Application credits</strong> will be subtracted from this amount for any payments.</p></td>
</tr>
<tr>
<th>Payouts you received</th>
<td>The amount you have received from Shopify after fees and adjustments have been deducted.</td>
</tr>
<tr>
<th>Next payout</th>
<td>The amount that you will receive for your next payout from Shopify.</td>
</tr>
<tr>
<th>Pending payment</th>
<td>The total of all payments that Shopify has collected, before credits.</td>
</tr>
<tr>
<th>One-time charges</th>
<td>The sum of an app's earnings through the <a href="/docs/api/admin-rest/latest/resources/applicationcharge">ApplicationCharge</a> API. It includes all pending and previous payments made through the API.</td>
</tr>
<tr>
<th>Recurring application charges</th>
<td>The sum of an app's earnings through the <a href="/docs/api/admin-rest/latest/resources/recurringapplicationcharge">RecurringApplicationCharge</a> API. It includes all pending and previous payments made through the RecurringApplicationCharge API, but excludes payments made through the <a href="/docs/api/admin-rest/latest/resources/usagecharge">UsageCharge</a> API.</td>
</tr>
<tr>
<th>Usage charges</th>
<td>The sum of an app's earnings through the <a href="/docs/api/admin-rest/latest/resources/usagecharge">UsageCharge</a> API. It includes all pending and previous payments made through the API.</td>
</tr>
<tr>
<th>Application credits</th>
<td>The sum of an app's earnings through the <a href="/docs/api/admin-rest/latest/resources/applicationcredit">ApplicationCredit</a> API. Application credits should always be negative.</td>
</tr>
<tr>
<th>Average rating</th>
<td>The average of all the app's merchant ratings from the Shopify App Store. </td>
</tr>
</table>

> Note:
> The data in the dashboard might vary slightly from the data gathered by other reporting tools and services. For information on why the data can vary, see [Report discrepancies](https://help.shopify.com/manual/reports-and-analytics/discrepancies).

## Earnings

The earnings amount refers to how much an app developer has been paid. It includes both paid out amounts and pending payments, and it reflects the deduction of Shopify's revenue share and any application credits. Your share of the revenue is defined in the [Shopify Partner revenue share](https://help.shopify.com/partners/how-to-earn#shopify-apps) agreement.

Payments occur after a merchant has paid their Shopify invoice. The payment schedule depends on the type of charges made by the app:

* For a RecurringApplicationCharge, it can take up to 37 days from the time a merchant agrees to the charge to the time that the charge appears as an earning in your Partner Dashboard.
* For an ApplicationCharge, merchants are invoiced immediately and the charge will appear as an earning in your Partner Dashboard within 7 days.

## App history

Important user interactions with your app are tracked as events, which you can view in the app history log in your Partner Dashboard. The app history log displays all the tracked events for your app, with the most recent events appearing at the top. The following events are available:

- [Application charge events](#application-charge-events)
- [Application credit events](#application-credit-events)
- [Application install events](#application-install-events)
- [Recurring charge events](#recurring-charge-events)
- [Usage charge events](#usage-charge-events)

### View app history

1. From your [Partner Dashboard](https://partners.shopify.com/), click **Apps**.
2. Click the name of your app.
3. In the sidebar, click **Insights** > **App history**.

### Application charge events

The following table includes definitions of application charge events:

<table>
<tr>
<th width="30%">Charge accepted</th>
<td>The ApplicationCharge has been accepted by the merchant but not activated by the developer.</td>
</tr>
<tr>
<th>Charge activated</th>
<td>The ApplicationCharge has been activated by the app developer and will appear on the merchant's next invoice.</td>
</tr>
<tr>
<th>Charge declined</th>
<td>The ApplicationCharge has been declined by the merchant.</td>
</tr>
<tr>
<th>Charge expired</th>
<td>The merchant has taken no action 48 hours after being presented with an ApplicationCharge (for example, the merchant has not accepted or declined the charge).</td>
</tr>
</table>

### Application credit events

The following table includes definitions of application credit events:

<table>
<tr>
<th width="30%">Credit applied</th>
<td>The ApplicationCredit has been added to the store. Funds are deducted from the app developer's upcoming payment. </td>
</tr>
<tr>
<th>Credit failed</th>
<td><p>The ApplicationCredit was not added. Reasons why a credit could not be added include:</p>
<ul>
<li>ApplicationCredit amount exceeds the amount paid from the store owner to the app developer in the last 30 days</li>
<li>App developer does not have available funds to credit the store (pending receivables is less than credit amount)</li>
</ul>
</td>
</tr>
<tr>
<th>Credit pending</th>
<td>The ApplicationCredit has been created but it has either failed or not yet been applied.</td>
</tr>
</table>

### Application install events

The following table includes definitions of application install events:

<table>
<tr>
<th width="30%">Installed</th>
<td>The app was installed on the store. An install occurs after a merchant approves the permissions shown on the OAuth grant screen.</td>
</tr>
<tr>
<th>Uninstalled</th>
<td>The app was uninstalled from the store. An uninstall occurs after a merchant has removed an app from their store.</td>
</tr>
</table>

### Recurring charge events

The following table includes definitions of recurring charge events:

<table>
<tr>
<th width="30%">Recurring charge accepted</th>
<td>The RecurringApplicationCharge has been accepted by the merchant but not activated by the developer.</td>
</tr>
<tr>
<th>Recurring charge activated</th>
<td>The RecurringApplicationCharge has been activated by the app developer and will appear on the merchant's next invoice.</td>
</tr>
<tr>
<th>Recurring charge canceled</th>
<td><p>The merchant has canceled the existing RecurringApplicationCharge. Examples of a canceled charge event include:</p>
<ul>
<li>merchant has uninstalled the app</li>
<li>merchant has changed app plan type</li>
<li>merchant no longer wants to pay for the app</li>
</ul>
</td>
</tr>
<tr>
<th>Recurring charge declined</th>
<td>The RecurringApplicationCharge has been declined by the merchant.</td>
</tr>
<tr>
<th>Recurring charge expired</th>
<td>The merchant has taken no action 48 hours after being presented with an RecurringApplicationCharge (for example, the merchant has not accepted or declined the charge).</td>
</tr>
<tr>
<th>Recurring charge frozen</th>
<td><p>The RecurringApplicationCharge has been suspended. Future payments for the app are on hold until the charge is unfrozen. Examples of a frozen charge event include:</p>
<ul>
<li>merchant no longer has an active Shopify subscription</li>
</ul>
</td>
</tr>
<tr>
<th>Recurring charge unfrozen</th>
<td><p>The RecurringApplicationCharge has been reactivated. A new billing cycle will commence on the day the RecurringApplicationCharge is unfrozen. Examples of an unfrozen charge event include:</p>
<ul>
<li>merchant has resumed an active Shopify subscription</li>
</ul>
</td>
</tr>
</table>

### Usage charge events

The following table includes definitions of usage charge events:

<table>
<tr>
<th width="30%">Usage charge applied</th>
<td>After a merchant has agreed to a UsageCharge, a UsageCharge is applied after the charge is created.</td>
</tr>
</table>