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

Steps:

  1. Log in to your Partner Dashboard.
  2. Click Apps.
  3. Click the name of your app.
  4. Click More actions, then click Edit Shopify App Store listing.
  5. In the Tracking section, under Google Analytics code, enter your Google Analytics Tracking ID.
  6. Click Save.

Set up Facebook pixel for your app listing

Steps:

  1. Log in to your Partner Dashboard.
  2. Click Apps.
  3. Click the name of your app.
  4. Click More actions, then click Edit Shopify App Store listing.
  5. In the Tracking section, under Facebook Pixel code, enter your Facebook Pixel Tracking ID.
  6. Click Save.

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.