On-site searches can be tracked and will appear in the platform as search events. These contribute to the Searches metric, with searched terms available under the Search Term dimension when search tracking is enabled.

How Search Tracking Works

Search tracking happens automatically when a visitor arrives at a URL containing a query parameter listed in the Search Query Parameters setting at the measurement level. You can find this setting in: Settings > Search Parameters This setting accepts a comma-separated list of query parameters. The default value is: q,search,query If any of these parameters are present in the URL, the Nimvue script logs a search event and captures the search term.

Disabling Search Tracking

To disable automatic search tracking, clear the Search Query Parameters setting by setting it to an empty value.

Manual Search Event Tracking

If your site’s search does not expose search terms in the URL (e.g., using POST requests or client-side routing), you can manually send a search event including the search term. Example:
nv_create_event({
  event_name: "search",
  parameters: {
    search_term: "Smart Thermostats"
  }
});