> Portal Navigation: > > - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version. > - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages). > - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`). > - Top-level index of all portals: https://dev.wix.com/docs/llms.txt > - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt ## Resource: Google Analytics ## Article: Google Analytics ## Article Link: https://dev.wix.com/docs/build-apps/manage-your-app/data-and-analytics/google-analytics.md ## Article Content: # Google Analytics Integrate Google Analytics to gain insights into user interactions with your Wix App Market app page. Help your app stand out and attract the right audience by utilizing Google Analytics 4 to track your App Market listing, keywords, and user interactions, track traffic, and monitor user behavior. By integrating with Google Analytics, you can track and optimize your app's performance: - **Where your users are coming from**: Identify traffic sources, whether from search, direct visits, or external links, and decide whether to add more external links or adjust your app category for better visibility. - **How users interact with your app listing**: Analyze search keywords that lead users to your app and optimize them based on real user data to improve discoverability. - **App page views**: Track parameters such as traffic sources, search keywords, and whether users are premium or free. This helps you understand who your audience is, how different user types discover your app, and where your most valuable users are coming from. - **Add to site clicks**: Track which users actively add your app to their site. Understanding this behavior by user type (premium vs. free) helps you analyze engagement patterns and optimize your acquisition strategy. - **Conversion funnel insights**: Identify drop-off points and improve the user journey. If users visit your app page but don’t install, you can consider adjusting your description, screenshots, or pricing model. Wix sends events to Google Analytics, which can be found in Google Analytics' Real-time view, and can be used to build reports. Note that the custom event parameters can take up to 48 hours to propagate in your reports. ## Set up Google Analytics for your Wix App Market listing Set up Google Analytics for your Wix App Market listing in 2 parts: first in Google Analytics, then in your Wix app dashboard. ### Part A | In your Google Analytics account 1. Follow [Google's instructions](https://support.google.com/analytics/answer/9304153) to set up a Google Analytics 4 property, add a data stream, and set up data collection. 2. For the data stream, apply `www.wix.com/app-market/web-solution/` in the STREAM URL field. You can copy the URL from your app’s listing in the Wix App Market at [wix.com/app-market](https://www.wix.com/app-market). 3. Enable **Enhanced measurement**. 4. Disable page changes based on browser history events: - Under **Enhanced measurement**, select **settings**. - Under **Page views > Show advanced settings**, deselect the **Page changes based on browser history events** checkbox. - Click "Save". ![Deselect the page changes based on browser history events checkbox](https://wixmp-833713b177cebf373f611808.wixmp.com/images/b80a20033d0a8e38d66e959a0397d288.png)
**Important:** Failing to disable page changes based on browser history events will result in Google Analytics collecting wrong data for your Wix App Market listing. For example, counting events twice.
5. Collect your GA4 Measurement ID (`G-` followed by a combination of numbers and letters, such as `G-PSW1MY7HB4`), as you will need to provide it in your Wix app dashboard. 6. Set up the custom event parameters as [event-scoped custom dimensions](https://support.google.com/analytics/answer/14239696) for your reports. ![custom-dimension](https://wixmp-833713b177cebf373f611808.wixmp.com/images/e4d035c205c3a956498526b5be8b6236.png) > **Note:** Event data can take up to 48 hours to propagate. Data sent before events are set up will not be visible. ### Part B | In your Wix app dashboard 1. Go to the Get Found & Tracking page in your app's dashboard. You can navigate to your app's dashboard from the [custom apps page](https://manage.wix.com/account/custom-apps). 2. Enter the GA4 Measurement ID collected in Part A and click "Save". Once the setup is complete, Wix sends data to your Google Analytics account. There’s no need to republish your app. ## Custom events for Google Analytics Wix sends the following events to Google Analytics, which can be found in Google Analytics' Real-time view, and can be used to build reports: - page_view event: Fired when a user views your app's listing page in the App Market. - install_button_click event: Fired when a user clicks the **"Add to site"** button on your app's listing page. Note that in order to add the event data to reports, you must add them as [event-scoped custom dimensions](https://support.google.com/analytics/answer/14239696). ### Event parameters The following custom parameters are sent with all events: |Parameter | Description | Parameter Availability | Supported values| |---|---|---|---| |`app_market_platform`| The platform of the App Market where the user accessed your app page. | Always included. | - `dashboard`: The App Market available within a site’s dashboard.
- `editor`: The App Market available within a site’s editor.
- `standalone`: The App Market available outside of site context.
| |`wix_referring_page`| Identifier of the page the user was visiting before navigating to your app page. | Always included.| - `app_market_homepage`: App Market homepage.
- `app_market_search_result`: App Market search.
- `app_market_collection`: App Market collection page.
- `app_market_category`: App Market category page.
- `app_market_subcategory`: App Market subcategory page.
- `other`: The user navigated to the app page from another source (includes other pages within Wix, direct URLs, external links, or non-tracked referrer) | |`wix_referring_page_details`| Details about the page that the user last visited, as defined in `wix_referring_page`. | Excluded when `wix_referring_page`: `other`. | - For `app_market_homepage`, the section in the homepage where the user found the app (collection/category name) is returned.
- For `app_market_search_result`, the user's search query is returned.
- For `app_market_collection`, the title of the collection where the user found the app is returned.
- For `app_market_category` and `app_market_subcategory`, returns the subcategory the user navigated from. | |`app_position_in_source`| Your app's position in the list of apps displayed on the page that the user last visited. Positions are numbered left to right, top to bottom, starting with 0. | Excluded when `wix_referring_page`: `other`. | |`premium_wix_site` | Whether the user has a Wix Premium site. | Included when site context is available. | - `true`: The user has a Wix Premium site.
- `false`: The user doesn't have a Wix Premium site.| |`wix_site_id`| The unique identifier (GUID) of the specific Wix site the user was working on while accessing your app page. | Included when site context is available. | |`wix_user_id`| The unique identifier (GUID) of the Wix user account accessing your app page. | Included when user is logged in to Wix.|