You can measure your storefront’s search performance and improve its relevance by collecting and leveraging customer interaction data. This guide shows you how to set up search tracking on your custom storefront using the [Storefront API](/docs/api/storefront) and [Shopify analytics functionality available in Hydrogen](/docs/storefronts/headless/hydrogen/analytics). > Note: > Search tracking is only supported in custom storefronts built with either [Hydrogen](/docs/storefronts/headless/hydrogen/getting-started) or other React frameworks using the [Hydrogen React](/docs/api/hydrogen-react) library. ## What you’ll learn In this tutorial, you’ll learn how to do the following tasks: - Set up Shopify cookies. - Extract and append search tracking parameters. - Send analytics to Shopify. ## Requirements - You've completed the [Getting started with the Storefront API](/docs/storefronts/headless/building-with-the-storefront-api/getting-started) guide. - You’ve learned [how to set up Shopify analytics in Hydrogen](/docs/storefronts/headless/hydrogen/analytics). - You’re using the Storefront API version `2023-07` or higher. ## Step 1: Set up Shopify cookies To enable search tracking, use Hydrogen’s [`useShopifyCookies`](/docs/api/hydrogen-react/latest/hooks/useshopifycookies) hook to create and refresh required Shopify cookies. It's up to you to decide how to obtain the value for `hasUserConsent`. Without `hasUserConsent` set to `true`, Shopify cookies are removed.

> Tip: > Learn more about [how to set up Shopify analytics](/docs/storefronts/headless/hydrogen/analytics). Shopify cookies are automatically added to Storefront API queries when Hydrogen’s [`createStorefrontClient`](/docs/api/hydrogen-react/latest/utilities/createstorefrontclient) utility function is used. - For Hydrogen storefronts, follow the [Hydrogen documentation](/docs/storefronts/headless/hydrogen/data-fetching). - For storefronts using other React frameworks and the Hydrogen React library, follow the [Hydrogen React documentation](/docs/api/hydrogen-react). ## Step 2: Extract and append search tracking parameters You can extract search tracking parameters from the `search` and `predictiveSearch` responses using the `trackingParameters` field. The following examples show how to return the tracking parameters and append them to the search result URLs. ### Example of `search`

### Example of `predictiveSearch`

### Example of appending tracking parameters The following example shows how to construct search result URLs using an array of products.

The following example shows how to construct search result URLs using an array of queries.

## Step 3: Send analytics to Shopify Follow the [Hydrogen analytics documentation](/docs/storefronts/headless/hydrogen/analytics/tracking) to learn how to send tracking events to Shopify. ## Next steps - Customize search, filters, and product recommendations using the [Shopify Search & Discovery app](https://help.shopify.com/manual/online-store/search-and-discovery).