Traffic sources
The Traffic Sources report reveals the complete story of your customer acquisition - tracking merchants from their first interaction with your App Store listing through to becoming a paid subscriber. By connecting pre-install behavior with conversion data, you can identify exactly which channels bring your most valuable customers.
Traffic source data syncs automatically with your App Store listing, giving you a complete picture of your acquisition funnel. More than just visitor analytics, Mantle helps you turn traffic insights into actionable marketing strategies across your entire business.

Understanding your sources
Shopify URL parameters
After you’ve set up analytics for your app listing, Shopify passes additional URL parameters when a merchant clicks on your app listing from the Shopify App Store. These parameters provide detailed information about how merchants found your app, including:
The language selected by the merchant
The type of page they came from (home, search, category, etc.)
The specific section of the page where they found your app
The exact position of your app within that section
These parameters give you valuable insights into your app’s visibility and discoverability in the Shopify App Store.
For a complete reference of all URL parameters and their possible values, see the official Shopify documentation on tracking listing traffic.
Campaign tracking: In addition to these automatic Shopify parameters, you can add UTM parameters to any external links pointing to your app listing (ads, social media, emails) to track your marketing campaigns in this report.
Traffic dimensions
Each dimension reveals different aspects of your acquisition:
Source | Description |
|---|---|
apps.shopify.com | App Store traffic |
google.com | Search engine traffic |
facebook.com | Social media traffic |
yourwebsite.com | Direct site traffic |
(direct) | Untracked visits where Google Analytics couldn’t detect a specific referrer or UTM tag |
Source medium | Description |
|---|---|
organic | Natural search and App Store browsing (e.g., merchants finding you in Shopify search) |
cpc | Paid advertising clicks (e.g., Google Ads, Facebook Ads) |
referral | Website link traffic (e.g., blog mentions, partner sites) |
cpa | Cost-per-action campaigns (e.g., affiliate marketing links) |
Forums | Community discussions (e.g., Reddit, Shopify Community) |
Search terms | Description |
|---|---|
Branded terms | e.g., “your app name” |
Feature terms | e.g., “inventory management” |
Problem terms | e.g., “fix out of stock issues” |
Referrer sites | Description |
|---|---|
Partner websites | e.g., integration partner blogs |
Review sites | e.g., merchant review platforms |
Content platforms | e.g., Medium articles |
Campaign type | Description |
|---|---|
Seasonal promotions | e.g., “black_friday_2024” |
Feature launches | e.g., “new_feature_march” |
Partner campaigns | e.g., “agency_referral” |
Surface types | Description |
|---|---|
Search results pages | App Store search results |
Category listings | Category-based listings |
Collection features | Featured collections |
Surface details | Description |
|---|---|
”Top Inventory Apps” | Featured in top apps section |
”Staff picks” | Selected by Shopify staff |
”Trending in Marketing” | Trending apps section |
Surface inter position: The numbered section on the page where the merchant found your app (e.g., if your app appears in both section 1 and section 2 of the page, you can see which section drove more traffic)
Surface intra position: The position within a section, numbered left to right and top to bottom starting at 1 (e.g., position 1 is top left, position 4 starts the second row)
Understanding (direct) traffic
When you see (direct) as a traffic source, it means Google Analytics couldn’t detect a specific referrer or UTM tag for that visit. The system couldn’t attribute the traffic to a known source like Google, Shopify, Facebook, etc.
This usually happens when visitors:
Type your app’s URL directly or use a bookmark
Click a link in an email without tracking parameters
Come from a private browsing session
Arrive from a site that strips out referrer information
So, (direct) traffic represents untracked or organic visits where the original source couldn’t be identified.
Performance metrics
Metric | Description |
|---|---|
Listing view volumes | How many merchants discover your app through this source |
Install click rates | The percentage of viewers who click to install from this source |
Installation completion | How many merchants actually finish the installation process |
Subscription conversion | The number of installations that turn into paying subscriptions |
Source-specific LTV | The average lifetime value of customers from each source |
MRR | Monthly recurring revenue metrics showing active MRR / total MRR generated from each source |
Available funnel events
The Traffic Sources report tracks customer journey events from discovery to revenue. Available events depend on your integrations:
Pre-Install Events
Require Google Analytics 4 with BigQuery integration
Event | Description |
|---|---|
App Listing Page View | Customer views your app’s listing page |
Add App Button Clicked | Customer clicks “Add app” button |
Post-Install Events
Available to all customers
Installation & Setup
Event | Description |
|---|---|
Installed | Customer installs your app |
Reinstalled | Customer reinstalls your app after previously uninstalling |
Uninstalled | Customer removes your app from their store |
Trial & Conversion
Event | Description |
|---|---|
Trial Started | Customer begins free trial (trial apps only) |
Trial Converted | Trial customer becomes paying subscriber |
Subscription Management
Event | Description |
|---|---|
Subscribed | Customer activates a paid subscription |
Unsubscribed | Customer cancels their subscription |
Resubscribed | Previously cancelled customer reactivates their subscription |
Upgraded | Customer moves to a higher-tier plan |
Downgraded | Customer moves to a lower-tier plan |
Subscription Frozen | Customer’s subscription is temporarily paused |
Subscription Unfrozen | Customer’s subscription is reactivated after being frozen |
Revenue Events
Event | Description |
|---|---|
One-time Charge | Customer makes a one-time purchase |
First Transaction | Customer completes their first revenue-generating transaction |
Charge Abandoned | Customer starts but doesn’t complete a billing process |
Account Management
Event | Description |
|---|---|
Customer Account Reactivated | Previously inactive customer becomes active again |
Customer Account Deactivated | Active customer account becomes inactive |
Event selection nuances
Adding Events
Choose from the funnel events dropdown to add events to your chart
Events automatically appear based on your app configuration (e.g., trial events only show for trial-enabled apps)
This report requires Google Analytics 4 + BigQuery integration to function - without it, no traffic source data will be available
Event Order Matters
Use “Change event order” to reorder events in your funnel
Order affects conversion rate calculations (each step converts from the previous step)
Pre-install events automatically appear first when available
Recommended order for apps with trials:
Installed → Trial Started → Subscribed → Trial ConvertedWhy: Subscribed = subscription activated (often at install while the trial is still running). Trial Converted = trial ended and rolled into paid. Placing Subscribed after Trial Converted can yield 0 because the subscription usually happens before conversion.
Chart Display
Events appear as columns on your chart in the order you’ve selected
You can switch between “Count” and “Conversion rate” views
Conversion rate shows the percentage converting from one step to the next
You must have at least one event selected (can’t remove all events)
Traffic categories
Your acquisition channels typically fall into three groups:
App Store organic
Type | Description |
|---|---|
Search result placement | e.g., “inventory management” search results |
Category browsing | e.g., found in “Inventory Management” category |
Direct listing visits | e.g., merchants typing your app URL directly |
Collection features | e.g., “Staff Picks” or “Trending Apps” |
External sources
Type | Description |
|---|---|
Direct traffic | e.g., merchants typing your website URL |
Search engines | e.g., Google, Bing search results |
Website referrals:
Type | Description |
|---|---|
Blog posts | e.g., tutorials mentioning your app |
Integration partners | e.g., complementary app websites |
Review platforms | e.g., third-party app review sites |
Community forums | e.g., Reddit, Facebook groups |
Campaign traffic
Marketing initiatives:
Type | Description |
|---|---|
Email campaigns | e.g., newsletter promotions |
Content marketing | e.g., blog post campaigns |
Seasonal promotions | e.g., holiday specials |
Referral programs:
Type | Description |
|---|---|
Partner referrals | e.g., agency recommendations |
Customer referrals | e.g., word-of-mouth programs |
Integration partnerships | e.g., app integration launches |
Paid advertising:
Type | Description |
|---|---|
Search ads | e.g., Google Ads campaigns |
Social media ads | e.g., Facebook, LinkedIn campaigns |
Display advertising | e.g., banner ad campaigns |
Making the most of traffic data
Report filters and pivots
The report offers powerful filtering and pivot capabilities:
Option | Description |
|---|---|
Time period | Analyze performance over custom date ranges |
Pivots | Choose from 11 available pivot dimensions to segment your traffic data |
Funnel events | Track from 22 available funnel events along the customer journey |
The extensive pivot options include Source, Source medium, Search term, Affiliate, Referrer site, Traffic source name, Campaign, Page/Surface type, Surface detail, Surface inter position, and Surface intra position.
The Affiliate pivot is particularly valuable for identifying which affiliate partners drive the most valuable traffic to your app, enabling you to optimize your affiliate relationships based on both conversion metrics and MRR impact.
Performance analysis
The breakdown table provides actionable insights:
Source-specific conversion rates - see exactly how many visitors from each source become paying customers
Full funnel progression tracking - watch how visitors from different sources move from discovery to subscription
Visual trend identification - spot patterns with color-coded bars that make changes easy to spot
LTV by traffic source - understand which channels bring your highest-value customers, not just the most visitors
Revenue attribution - use the MRR column to identify which sources generate the most revenue, with both active and total MRR metrics shown as “active MRR / total MRR”
Multi-dimensional analysis - leverage the extensive pivot options to uncover deeper insights, such as which search terms perform best with specific affiliates
Individual customer journey details - click through to see the actual customers behind the numbers and explore their complete path
Smart analysis
Common ways teams leverage traffic data:
Time period analysis: Establish baselines with 30-day windows and track seasonal patterns to identify growth trends
Source impact: Track platform-specific conversion rates and monitor performance across search engines and social media
Channel performance: Compare how different traffic types convert - from steady organic growth to campaign-driven spikes
Search insights: Analyze search terms to understand merchant discovery patterns and identify listing optimization opportunities
Referral quality: Identify which sites send your best-converting visitors and measure the impact of partnerships
Revenue impact assessment: Use the MRR metrics to determine which traffic sources contribute most to your revenue
Affiliate program optimization: Pivot by affiliate to monitor partner performance and better manage your affiliate relationships
Campaign tracking: Compare marketing initiative effectiveness and optimize spending based on customer lifetime value
Store presence: Track performance across different App Store sections and understand how listing position affects conversion
These insights help teams identify their most effective acquisition channels and optimize their marketing strategy for both immediate results and long-term growth.
Advanced traffic source optimization
Ready to take your traffic analysis to the next level? Our comprehensive guide on mastering your traffic sources shows you how to move beyond basic reporting to double down on what drives real growth. Learn advanced techniques for LTV analysis, affiliate optimization, and strategic budget allocation.