Track app usage metrics with the Partner Dashboard

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.

Anchor to View app analyticsView 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.

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:

   

   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.

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.

Anchor to View active merchant installsView active merchant installs

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

1. From your Partner Dashboard, click Apps.
2. 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.

Anchor to Export active install dataExport 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, click Apps.
2. Click the name of the app that you want to view.
3. Click Export and select Export Current Merchants.
4. Check your email inbox for a message indicating that the export was completed.
5. 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.

Anchor to App metric definitionsApp metric definitions

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

Anchor to EarningsEarnings

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 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.

Anchor to App historyApp 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 credit events
• Application install events
• Recurring charge events
• Usage charge events

Anchor to View app historyView app history

1. From your Partner Dashboard, click Apps.
2. Click the name of your app.
3. In the sidebar, click Insights > App history.

Anchor to Application charge eventsApplication charge events

The following table includes definitions of application charge events:

Anchor to Application credit eventsApplication credit events

The following table includes definitions of application credit events:

Anchor to Application install eventsApplication install events

The following table includes definitions of application install events:

Anchor to Recurring charge eventsRecurring charge events

The following table includes definitions of recurring charge events:

Anchor to Usage charge eventsUsage charge events

The following table includes definitions of usage charge events: