Tracking your listing traffic

You can get more information about how merchants are finding your app listing in the Shopify App Store by tracking your listing traffic with Google Analytics or Facebook Pixel. Knowing how merchants find your app listing can help you optimize your listing for your merchants, as well as for the Shopify App Store search engine.

Set up Google Analytics for your app listing

Anchor link to section titled "Set up Google Analytics for your app listing"

Log in to your Partner Dashboard.
Click Apps.
Click the name of your app.
Click Distribution.
Click Create listing or Manage listing, and then click the listing that you want to edit.
In the E. Tracking section, next to 1. Google analytics code (optional), enter your Google Analytics tracking ID.

Note

By default, Google creates a Google Analytics 4 property, which isn't compatible with Shopify. Make sure you create a Universal Analytics property and use that for tracking.
Click Save.

Set up Facebook Pixel for your app listing

Anchor link to section titled "Set up Facebook Pixel for your app listing"

Log in to your Partner Dashboard.
Click Apps.
Click the name of your app.
Click Distribution.
Click Create listing or Manage listing, and then click the listing that you want to edit.
In the E. Tracking section, next to 3. Facebook Pixel (optional), enter your Facebook Pixel tracking ID.
Click Save.

URL parameters

Anchor link to section titled "URL parameters"

After you've set up Google Analytics or Facebook Pixel for your app listing, Shopify passes additional URL parameters when a merchant visits your app listing from the Shopify App Store. You can see the following parameters in your Google Analytics or Facebook Pixel dashboard:

The additional parameters shown in the Google Analytics or Facebook Pixel dashboard

There are five parameters that can appear in the URL:

Parameter	Description	Possible values
locale	The language that the merchant has selected in the Shopify App Store.	`zh-CN`: Chinese (Simplified) `zh-TW`: Chinese (Traditional) `cs`: Czech `da`: Danish `nl`: Dutch `fi`: Finnish `fr`: French `de`: German `hi`: Hindi `it`: Italian `ja`: Japanese `ko`: Korean `nb`: Norwegian (Bokmal) 193 `pl`: Polish `pt-PT`: Portuguese `pt-BR`: Portuguese (Brazilian) `es`: Spanish `sv`: Swedish `th`: Thai `tr`: Turkish
surface_type	The type of page the merchant came from to get to your app listing.	`home`: The home page of the Shopify App Store. `search`: The organic search result on the Shopify App Store. `search_ad`: The paid search result on the Shopify App Store. `category`: One of the category pages on the Shopify App Store. `collection`: One of the collection pages on the Shopify App Store.
surface_detail	Details about the page that the merchant came from.	For `home`, this is the title of the section where the merchant found your app. For `search`, this is the merchant's search query. For `collection`, this is the title of the collection where the merchant found your app. For `category`, this includes both the titles of the category and subcategory joined by a hyphen.
surface_inter_position	The section on the page where the merchant found your app.	For `home`, this is the section of the Shopify App Store home page where the merchant found your app. The sections are numbered from the top, starting with 1. For `search`, this is the page of search results where the merchant found your app. For `collection`, this parameter isn't returned. For `category`, this is the page of category results where the merchant found your app.
surface_intra_position	The position within the section where the merchant found your app.	For `home`, this is the position of your app within the section. The positions are numbered from the left, starting with 1. For `search`, this is the position of your app on the results page. The positions are numbered from the top, starting with 1. For `collection`, this is the position of your app on the collection page. The positions are numbered from the top, starting with 1. For `category`, this is the position of your app on the category page. The positions are numbered from the top, starting with 1.