Hue - Google Analytics Integration

📌 Overview

This article covers how to integrate Hue's custom events into Google Analytics (GA) and, optionally, Google Tag Manager (GTM), along with a full breakdown of each event and its properties.

💡 When Might You Want to Use This?

You want Hue engagement data (video views, quiz completions, add-to-carts) to show up in your GA reporting.
You're setting up GTM to manage and trigger Hue-related tags.

🪜 GA Integration Steps

Add custom dimensions to your GA.
Notify the Hue team — we'll enable GA in your configuration to start sending events.

🪜 GTM Integration Steps

Notify the Hue team to enable GTM in your configuration.
Add every unique event custom property to GTM.
Create a trigger for an event.
Create a tag using the trigger and event custom properties.
Publish your changes.

📊 Events and Properties

Every event includes two shared properties:

event_category — always HUE
product_id — the current product ID

Each unique custom property must also be added to your GA custom dimensions.

hue_video_watched

Triggers when a video is paused in the quiz or review modules.

Property	Description
`creator_name`	First and last name of the video creator
`playback_duration`	How long the video played before pausing
`duration`	Total length of the video

hue_quiz_completed

Triggers on the first view of the quiz results page.

Property	Description
`quiz_matched_variant_id`	Variant ID of the quiz result
`quiz_undertone`	Selected undertone
`quiz_depth`	Selected depth

hue_quiz_add_to_cart

Triggers when a product is added to cart from within the quiz.

Property	Description
`variant_id`	Variant ID added to the cart
`price`	Price of the variant
`currency`	Store's current currency

hue_video_add_to_cart

Triggers when a product is added to cart from the review module.

Property	Description
`variant_id`	Variant ID added to the cart
`price`	Price of the variant
`currency`	Store's current currency

hue_quiz_upsell_add_to_cart

Triggers when a recommended product is added to cart from within the quiz module.

Property	Description
`variant_id`	Variant ID added to the cart
`product_id`	Recommended product's ID
`quiz_matched_product_id`	Product ID matched by the quiz
`quiz_matched_variant_id`	Variant ID matched by the quiz
`price`	Price of the variant
`currency`	Store's current currency

🛠️ Troubleshooting

I'm not seeing Hue events in GA

Confirm the Hue team has enabled GA in your configuration.
Make sure you've added the relevant custom dimensions in GA.

Events are firing in GTM but properties are missing

Double-check that every unique custom property for the event has been added to GTM and to your GA custom dimensions.

GTM changes aren't reflecting on my site

Make sure you clicked Publish after setting up your triggers and tags — unpublished changes won't go live.