📌 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.