> ## Documentation Index
> Fetch the complete documentation index at: https://help.goodnative.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Recommendations tracking

> Send Bloom recommendation views, clicks and add to carts to GA4, GTM, Klaviyo, Meta and Google Ads, and track recommendation checkouts and purchases in GTM with a Shopify checkout pixel.

Bloom tracks every step from a recommendation being shown to the order. Results on **Recommendations → Overview** need no setup. Tracking to GA4, GTM, Klaviyo and Meta is **on by default** - change settings only to turn an event off or send checkouts and purchases to GTM.

## Results

**Recommendations → Overview** shows the funnel - **Shown**, **Selected**, **Add to cart**, **Checkout**, **Order** and **Revenue** - plus two tables:

* **Sold-out variants showing recommendations** - the sold-out variants shoppers were looking at, ranked by views.
* **Recommendations bought** - the recommended variants shoppers went on to buy, ranked by orders.

Checkouts and orders are recorded by Bloom from Shopify, so they count even without the checkout pixel. See [Results](/bloom/results).

## Events

* **Recommendations shown** - cards appear for a sold-out variant (`bloom_recommendation_view` in GTM). Klaviyo metric: **Recommendations: Alternatives Shown**.
* **Recommendation clicked** - a shopper opens a card (`bloom_recommendation_click`). Klaviyo metric: **Recommendations: Alternative Clicked**.
* **Upsell added to cart** - a shopper adds a recommended product to cart (`bloom_recommendation_add_to_cart`). Klaviyo metric: **Recommendations: Alternative Added to Cart**.

Destinations: **GA4**, **GTM**, **Klaviyo**, **Meta Ads** and **Google Ads**.

<Note>
  Storefront events fire only after the shopper grants analytics consent. Klaviyo only records events for shoppers it can identify.
</Note>

## Configure

1. In Shopify admin, open **Apps → Bloom**.
2. Go to **Recommendations → Settings → Tracking**.
3. For each event row, toggle the platforms you want it sent to.
4. For Google Ads, paste the per-event `send_to` value, e.g. `AW-XXXXXXXXXX/AbCdEfGh`. Leave blank to skip.
5. Click **Save**.

## GTM and GA4

Your storefront can't see checkout, so checkouts and purchases reach GTM through a Shopify custom pixel.

1. In **Recommendations → Settings → Tracking**, click **Download container file**.
2. In GTM, go to **Admin → Import Container**, pick the file and your workspace, then **Merge**.
3. Set the **Bloom - GA4 Measurement ID** variable to your own, then **Publish**.
4. Back in Bloom, enter your **GTM container ID** (`GTM-XXXXXXX`) and click **Copy code**.
5. In Shopify admin, go to **Settings → Customer events → Add custom pixel**, name it *Bloom recommendations*, paste the code, click **Save**, then **Connect**.

The pixel pushes `bloom_recommendation_begin_checkout` and `bloom_recommendation_purchase` with the recommended lines. The container maps every event to GA4 `items` keyed by SKU.

## Related

* [Recommendations overview](/bloom/recommendations/overview)
* [Results](/bloom/results)
* [Notify Me tracking](/bloom/notify-me/tracking)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.