Review app performance
In Marketplace Analytics, you can review reporting on install, listing page, and search performance.Analyze installs
- In your HubSpot account, navigate to Development.
- In the left sidebar menu, navigate to App Listings.
- Click the name of your app.
- To change how the data is grouped, click the Frequency dropdown menu in the top left and select a frequency.
- To set a general date range, click the first date picker in the Date range section and select a general date range in the left column.
- To use a specific date range:
- In the Date range section at the top of the page, click the first date picker and select a start date.
- Click the second date picker and select an end date.
- Review the following install data:
- Active Installs
- App Installs
- App Uninstalls
- Free vs Paid Installs
- Free vs Paid Uninstalls
- Installs by Country
- Installs by Hub
Analyze listing page performance
- In your HubSpot account, navigate to Development.
- In the left sidebar menu, navigate to App Listings.
- Click the name of your app.
- In the left sidebar, navigate to Listing analytics.
- To change how the data is grouped, click the Frequency dropdown menu in the top left and select a frequency.
- To set a general date range, click the first date picker in the Date range section and select a general date range in the left column.
- To use a specific date range:
- In the Date range section at the top of the page, click the first date picker and select a start date.
- Click the second date picker and select an end date.
- To view performance for a specific localized listing page, click the Language dropdown menu and select a language.
- Review the following data on the visitors viewing your listing page:
- Pageviews: number of pageviews plotted by frequency.
- Pageview Source: percentage of pageviews attributed to a specific source, such as public or in-app.
- CTA Usage: number of clicks of your listing page CTAs, plotted by frequency.
- Free vs Paid Pageviews: percentage of pageviews attributed to paid and free users.
- Pageviews by Country: number of pageviews associated with specific countries.
- Pageviews by Hub: number of pageviews from users in specific hubs.
- Pageviews by Domain: number of pageviews from users associated with a particular company domain. You can see the following info for these pageviews:
- Domain name: company domain associated with the user who viewed the page.
- Installed: whether an account associated with that domain has installed the app.
- First seen: first date that any user associated with this domain viewed the page.
- Last seen: most recent date that any user associated with this domain viewed the page.
- Pageview count: total number of times users associated with this domain viewed the page.
Analyze search result performance
- In your HubSpot account, navigate to Development.
- In the left sidebar menu, navigate to App Listings.
- Click the name of your app.
- In the left sidebar, navigate to Search analytics.
- To change how the data is grouped, click the Frequency dropdown menu in the top left and select a frequency.
- To set a general date range, click the first date picker in the Date range section and select a general date range in the left column.
- To use a specific date range:
- In the Date range section at the top of the page, click the first date picker and select a start date.
- Click the second date picker and select an end date.
- Review the following data:
- Impressions vs Clicks: number of times your app listing has appeared in search results plotted alongside the number of times visitors have clicked that search result.
- Top search terms: search terms that returned your app as a result. For each search term, you can see impressions (number of times it appeared in search results), clicks (number of times users clicked on your listing from search results), and its average position in search results (lower numbers are better).
Analyze app performance using Breeze Assistant
- In your HubSpot account, navigate to Development.
- In the left sidebar menu, navigate to App Listings.
- Click the name of your app.
- In the left sidebar, navigate to Breeze Assistant.
- In the right panel, click a suggested prompt or enter a custom prompt in the field. Learn more about using Breeze Assistant.
Customer Feedback
To view all reviews that customers have submitted for your app, click the Customer Feedback tab.
- Below the review, click Reply.
- In the dialog box, enter your reply to the customer, then click Send. This reply will be publicly visible on your app listing.
- To edit notifications for reviews received:
- In the top right, click the Actions dropdown menu and click Edit notifications.
- On the Notifications page, search for Marketplace and select Listing New Reviews to get notified when a customer leaves a review.
- To send your review link to a customer:
- In the top right, click the Actions dropdown menu and click Copy review link.
- Email or send this link to your customer for them to leave a review.
- To review all survey responses:
- In the left sidebar menu, click the Uninstall Survey Responses tab.
- To export the responses, in the top left, click Export. In the dialog box, click the File format dropdown menu and select XLSX, XLS, or CSV.. Then, click Export.
- To review any private feedback responses to your team, in the left sidebar menu, click the Private Feedback tab.
Key Resources
In the Key Resources section, review the following resources:- App partner program benefits: the App Partner Program Benefits guide will lists all benefits that you get as a partner with a listed app on Hubspot Marketplace.
- Feedback survey: a feedback survey to provide feedback about the app partner experience.
- App partner manager: the contact information for your app partner manager.
App Activity & Usage
In the App Activity & Usage section, you can review usage data for your app:- In the Installation report, you can view how many active installs your app has, measured by how many accounts have generated a successful API call in the past rolling 30 day period.
- In the Top portals report, click View top portals to see the accounts that have the highest usage of your app.
- On the right, under Feature usage, you can measure the usage of different actions and API requests over time:
- To include an additional action, click the dropdown menu at the top of the report, then select an action.
- To remove an action, click the x to the right of the action at the top of the report.
- To change the time period, click the dropdown menu at the top right of the report, then select a time period.
- Under the Feature usage report, you can also review recent errors that’ve occurred:
- To change the time period, click the dropdown menu at the top right, then select a time period.
- Errors are categorized into the following types:
- Client errors: issues usually caused by a malformed request from your app.
- Server errors: issues from processing a request on the backend or a problem on HubSpot’s backend.
- Unauthorized errors: authentication or missing scope issues.
- Rate limit errors: caused by making too many requests in a given time period.
Measure engagement with UTM parameters
In addition to the above metrics, you can further measure engagement by including UTM parameters in the URLs on your app listing page. This lets you view how much traffic is coming to your website from your listing page. It’s recommended to add UTM parameters to the following URLs included on your listing page:- Supporting content on your HubSpot Marketplace listing page, such as your company website, supporting documentation, case study, and privacy policy.
- The OAuth install URL that customers use when installing the app.
?utm_campaign=appmarketplacelisting&utm_medium=referral&utm_source=hubspot
Please note:It’s recommended to use UTM parameters that are consistent with other UTM tracking you or your marketing team may be using. Learn more about creating tracking URLs.
- In your app developer account, navigate to Apps.
- Click the name of the app to edit its details.
- In the left sidebar, navigate to Basic info.
- At the top, click the Auth tab.
- In the Redirect URLs section, update your redirect URL to contain your UTM parameters. This will update the app’s install URL after saving, so you’ll need to be sure you’ve updated any user-facing links to use the new URL.
- In the bottom left, click Save.
- In your app developer account, navigate to Development.
- In the left sidebar menu, click App Listings.
- In the Marketplace Listings table, click the name of the app.
- In the top right, click Edit listing.
- On the Listing info tab, update the URL in the Install button URL field with your UTM parameters.
- At the top, click the Support info tab.
- In the Contact info, Support resources, and Terms of Service and Privacy Policy sections, update the URLs with your UTM parameters.
- Once you’ve updated your URLs, click Submit for review in the top right corner.
- Once reviewed and approved, the URLs on your app’s listing page will be updated with your UTM parameters. You can then use analytics tools, such as HubSpot or Google Analytics, to view traffic coming from your URLs as categorized by your UTM parameters.
