Tip: To improve the accuracy and speed of copy/pasting text, we have enabled “click to copy” in tables:

Click this text to automatically copy it to clipboard
  1. Configure Measurement ID
  2. Configure Measurement Protocol API secrets (Optional)
  3. Configure Search Term Query Parameters
  4. Configure BigCommerce CDN Domains
  5. Configure Custom Dimensions
  6. Configure Custom Metrics
Measurement ID

Analytics 4 uses the Measurement ID to identify your store


  1. Under Admin->Data Streams->[Your Web Data Stream], Copy the Measurement ID by clicking the copy () icon
  2. Paste the ID into the Tag Rocket->Analytics 4->Settings->Measurement ID field
Measurement Protocol API Secret (Optional)

Most of the data sent to GA4 is sent via the user’s browser. Certain server-related events, such as order status changes and refund processing cannot be captured via this method. If you would like send this information, an API secret is required to authenticate Tag Rocket.

  1. Under Admin->Data Streams->[Your Web Data Stream]->Measurement Protocol API Secrets, click Create
  2. Enter “Tag Rocket” as the Nickname
  3. Click the copy icon () for the Secret value
  4. Paste the ID into the Tag Rocket->Analytics 4->Settings->Measurement Protocol API Secret field
Search Term Query Parameters

For BigCommerce Default Search:

The BigCommerce default search results in a URL that looks like this: [Your Domain]/search.php?search_query=[Search Term]. The search term query parameter in this instance is “search_query” (in advanced search, it uses search_query_adv)

Search Term Query Parameter:

search_query, search_query_adv

Additional Query Parameters:


Other Search Systems

If you are using a custom search system, you will likely have a different parameter, such as this example using Searchanize: [Your Domain]/search-results-page?q=[Search Term]. In this example, the search term query parameter is “q“. The Searchanize documentation is unclear on additional parameters.

Configure Parameters

Google Analytics 4

Enter the correct Search Term Query Parameter and if applicable, Additional Query Parameters, in GA4 under Admin->Data Streams->[Your Web Data Stream]->Enhanced Measurement Settings->Site Search Advanced Settings, then click Save

Tag Rocket

Enter the correct Search Term Query Parameter In Tag Rocket under Global Tag Values->Settings->Search Term Query Parameter

BigCommerce CDN domains

BigCommerce uses its own CDN system for your sites resources such as images. By default these are considered external to your own domain. We recommend telling GA4 that they are internal. This fixes up issues like clicks to your images being classed as outbound clicks.

In GA4, click Admin->Data Streams->[Your Web Data Stream]->More tagging settings->Configure your domains->Add condition. Choose Match type “Matches RegEx” and Enter the following text:

Custom Dimensions

Custom User Dimensions

If a customer is logged in, the system can track that user across devices. It also tracks custom User properties once you have added them into GA4:

To track the following user dimensions you need to add them to your GA4 Account in the ‘Custom definitions’ section as dimensions of scope ‘User’. Once added they will start reporting on the data provided.

Dimension NameScopeDescriptionUser Property
Customer IDUserBigCommerce’s ID for customerscustomer_id
Customer groupUserThe name of the customer group this user is in. Blank if no group or not a customercustomer_group_name
User currencyUserThe current currency selected by the user. A 3 letter codeuser_currency_code

Other custom properties that we set are: customer_group_id

Custom Event Dimensions

Tag Rocket adds custom dimensions to certain events, providing more data to report or filter with

To track the following event dimensions you need to add them to your GA4 Account in the ‘Custom definitions’ section as dimensions of scope ‘Event’. Once added they will start reporting on the data provided.

Dimension NameScopeDescriptionEvent Parameter
Page typeEventBigCommerce’s page types. The home page is set to ‘home’. Also added to the content_group dimensionpage_type
Meta descriptionEventThe meta description for the page. This could be of use to a/b test changesmeta_description
Active currencyEventThe currency selected by the user at the time of the event. A 3 letter codeactive_currency_code
Date and timeEventUTC time of an event in ISO formatdatetime
DescriptionEventUsed by the exception event to explain the error. Tends to be a verbose version covering other dimensions. Good for real time inspectiondescription
Error typeEventUsed by the exception event to explain the type of error (javascript, console, jsonld, network)error_type
Error messageEventThe explanation for an exceptionerror_message
Error filenameEventUsed by the exception event to provide the file where the error happenederror_filename
Error line numberEventUsed by the JavaScript exception event to provide the line where the error happenederror_lineno
Error column numberEventUsed by the exception event to provide the column in the line where the error happenederror_colno
Effective connection typeEventUses the Network Information API to get the effective connection speed of the user. 4g, 3g, 2g, slow-2g and unknowneffective_connection_type

GA4 itself generates dimensions for all events, some of which are worth adding to the custom dimensions list so that you can access them in your reports.

Dimension NameScopeDescriptionEvent Parameter
Page locationEventThe current URL. Can be useful in Data Studio to blend GA4 data with GSC datapage_location
Page referrerEventThe referrer URL (or empty string if not available). The previous pages URLpage_referrer

There properties are sometimes added to events by the system:

Dimension NameScopeDescriptionEvent Parameter
Link URLEventUsed by click, click_outbound, click_phone, click_download, click_social and click_email events to indicate the link involvedlink_url
Search termEventUsed by search and view_search_result events to indicate the search term usedsearch_term

If you enable server events, one event event tracks your order status changes (order_status_update) and includes the following dimensions:

Dimension NameScopeDescriptionEvent Parameter
Transaction IDEventThe transaction id assigned by BigCommercetransaction_id
Order statusEventThe new order statusorder_status

Web Vitals sets the following dimensions and metrics:

Dimension NameScopeDescriptionEvent Parameter
Debug targetEventThis identifies the selector path to the element that contributed most to the metricdebug_target
Web Vitals statusEventGood, Needs Improvement or Poor. Based on the scores set by web.dev. Used in the relevant web vitals events (LCP, CLS, FID)metric_status

Other custom dimension properties that we set are: metric_id, debug_timing, event_time

Custom Metrics

This custom metric is required to specify the web vitals metric values for use in reports. Click on the “Custom Metrics” tab and enter the following:

Metric NameScopeDescriptionEvent ParameterUnit of measure
Web Vitals valueEventThe value of a web vital. Used in the LCP, FID and CLS events.metric_valueStandard

Other custom metric properties that we set are: metric_delta

There are more dimensions and metrics used, but that covers the core ones which we think may be of use in custom reports. To see other events that are automatically collected, refer to Tag Rocket Automatically Collected Events.

The following dimensions are no longer supported and can be removed:
Page view ID, Event ID, Core Web Vitals status, Web Vitals TTFB status, Web Vitals FCP status, Web Vitals CLS status, Web Vitals FID status, Web Vitals LCP status, Position

The following metrics are no longer supported and can be removed:
Web Vitals TTFB, Web Vitals FCP, Web Vitals CLS, Web Vitals FID, Web Vitals LCP