Setup
Connect your data sources to start Lumen's automated monitoring. Each source you connect adds an annotation track to the timeline and more checks.
GA4
Connecting GA4 triggers an immediate configuration audit. Findings appear as annotations on the timeline and as warnings in the integrations area.
What Lumen audits:
| Check | What it looks for |
|---|---|
| Data retention | Set to 14 months (not the 2-month default) |
| Enhanced measurement | Key events enabled (scrolls, outbound clicks, file downloads) |
| Conversion marking | Purchase and lead events correctly marked as conversions |
| Referral exclusions | Payment processors excluded (PayPal, Stripe, Klarna, etc.) |
| Consent Mode v2 | Default consent state configured for each region |
| Cross-domain tracking | Domain groups configured if you use multiple domains |
How to connect:
- Go to Settings → Data Sources
- Click Add Data Source → Google Analytics 4
- Sign in with your Google account and grant read access
- Select the GA4 property to monitor
- Click Save
Lumen runs the initial audit immediately after connecting. Results appear within a few minutes.
GTM
Connecting GTM enables three monitoring capabilities:
Version monitoring: each time you publish a container, Lumen diffs it against the previous version and creates a timeline annotation that summarizes what changed (tags added, removed, or modified).
Tag audit: Lumen scans the active container for common issues:
- Tags firing without consent configuration
- Duplicate tags tracking the same event
- Triggers that are too broad (all pages, all clicks)
- Orphaned triggers not attached to any tag
- Missing dataLayer variable references
Consent audit: checks that Consent Mode v2 signals are present, default consent states are configured per region, and tags have the correct consent categories assigned.
How to connect:
- Go to Settings → Data Sources
- Click Add Data Source → Google Tag Manager
- Sign in with your Google account and grant read access
- Select the GTM account and container to monitor
- Click Save
Lumen runs the initial audit when you connect, then monitors new container versions automatically.
Shopify
Connect Shopify and Lumen detects store changes that commonly break tracking, with no code change on your part.
What Lumen watches:
| Event | How it's detected |
|---|---|
| Theme deploys | Shopify API / webhook |
| App installs and uninstalls | Shopify API / webhook |
| Checkout extensibility changes | Shopify API |
Each event creates a timeline annotation. If a conversion drop follows a theme deploy by less than an hour, Lumen surfaces that correlation directly in the investigation.
How to connect:
Shopify connects as a standard TrustData data source. If Shopify is already connected for revenue data, Lumen monitoring starts automatically. No additional setup is needed.
If Shopify is not yet connected:
- Go to Settings → Data Sources
- Click Add Data Source → Shopify
- Enter your Shopify store URL and follow the OAuth flow
- Click Save
Manual annotations
You can add your own annotations to the timeline for changes Lumen can't detect automatically: budget shifts, creative swaps, landing page updates, or anything else worth tracking.
- Click any point on the timeline
- Select Add annotation
- Enter a label and optional description
- Click Save
Manual annotations appear on the bottom track alongside automated change detections.