Troubleshooting

​

Attribution Not Working

​

Symptoms

• Low join coverage in Data Quality Console
• Form submissions missing attribution_id
• CTA clicks not linking to form submissions

​

Solutions

1. Verify Attribution Script is Loaded
   • Open browser console
   • Check for window.getAttributionId function
   • Verify no JavaScript errors
2. Check Cookie/Storage
   • Open browser DevTools → Application → Cookies
   • Verify cr_attrib cookie exists
   • Check localStorage for cr_attrib key
3. Verify CTA Link Rewriting
   • Inspect CTA links on page
   • Verify cr_attrib parameter is in URL
   • Check that links are being rewritten (idempotent)
4. Check HighLevel Custom Field
   • Verify cr_attrib custom field exists
   • Verify form hidden field reads from URL parameter
   • Test form submission and check webhook payload

​

Low Join Coverage

​

Symptoms

• Data Quality Console shows < 50% join coverage
• Many form submissions without attribution_id

​

Solutions

1. Check Coverage By Source Tile
   • Identify which source is leaking (CTA clicks, form submits, asset resolution)
   • Focus on the lowest percentage
2. Verify GTM Instrumentation
   • Check GTM container is deployed
   • Verify events include attribution_id
   • Check Data Quality Console → Freshness for GTM events
3. Check Form Sources
   • Some forms may arrive from other sources (not CTAs)
   • This is expected - check “Form Submits (No Prior CTA Click)” tile
   • If high, verify CTA rewrite + GTM is working

​

Missing Events

​

Symptoms

• No events in Data Quality Console
• Freshness shows “No events”

​

Solutions

1. Check GTM Events
   • Verify GTM container is deployed
   • Check browser console for dataLayer events
   • Verify server-side endpoint is receiving events
2. Check HighLevel Webhook
   • Verify webhook is enabled in HighLevel
   • Check webhook URL is correct
   • Verify webhook secret matches
   • Test form submission and check webhook logs
3. Check API Endpoints
   • Verify /api/integrations/gtm/events is accessible
   • Verify /api/integrations/highlevel/webhook is accessible
   • Check server logs for errors

​

Performance Data Not Updating

​

Symptoms

• Asset performance shows zero or stale data
• Rollup job not running

​

Solutions

1. Check Rollup Job
   • Verify cron job is configured
   • Check job endpoint is accessible
   • Review job logs for errors
2. Verify Snapshots
   • Check GA4/GSC snapshots are being created
   • Verify snapshot dates match expected dates
   • Check timezone configuration
3. Check Asset Resolution
   • Verify canonical_path is set on assets
   • Check Data Quality Console → Coverage → “Form Submits Tied to Asset”
   • If low, verify asset paths match page paths

​

Scoring Issues

​

Symptoms

• Optimization scores not calculating
• Confidence badges not showing

​

Solutions

1. Check Scoring Rules
   • Verify scoring rules exist for your objective
   • Check weights sum to 1.0
   • Verify metric keys match metric registry
2. Check Confidence Calculation
   • Review join coverage (should be > 50% for medium confidence)
   • Check freshness (should be < 48 hours for medium confidence)
   • Verify sample size (should be >= 50 for medium confidence)
3. Verify Performance Data
   • Check asset_performance_daily has data
   • Verify metrics are being aggregated correctly
   • Check for null/zero values