Tracking your listing traffic with Google Analytics

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

After you've set up Google Analytics for your app listing, Shopify passes additional URL parameters when merchants visit your app listing from the Shopify App Store. You can see these parameters in your Google Analytics dashboard:

The additional parameters shown in the Google Analytics 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.
  • de: German
  • es: Spanish
  • fr: French
  • it: Italian
  • ja: Japanese
  • pt-BR: Portuguese (Brazilian)
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 search page 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 postions are numbered from the top, starting with 1.
  • For collection, this is the position of your app on the collection page. The postions are numbered from the top, starting with 1.
  • For category, this is the position of your app on the category page. The postions are numbered from the top, starting with 1.

Sign up for a Partner account to get started.

Sign up