Troubleshooting

Fix common Behavior Intelligence issues: missing data, zero Realtime counts, tracking blocked by consent, geo gaps, funnel mismatches, and REST ingest errors.

No data appearing

Start with Settings → General and confirm tracking is enabled. Then verify you are browsing the public site—not an excluded admin path or role. Open browser devtools → Network and filter for behavior/events; POST requests should return 200/204.

Common blockers: consent banner not granting analytics, ad blockers (try bypass mode), caching plugins serving pages without the collector script, or staging domains not whitelisted.

Realtime shows zero visitors

1. Confirm events in Data Quality → Event coverage with timestamps within the last hour.
2. Check processor cron is running (health score in Data Quality).
3. Ensure server clock and timezone are correct—aggregates use UTC internally.
4. Test in a private window to avoid admin exclusions.

Clicks not recorded

Clicks require Tracking Plan targets with stable component UUIDs. If a button was replaced in the theme, re-run SiteAnalyze or manually add a target. Verify the element is not inside an excluded iframe and that CSS does not block pointer events.

Funnel steps not matching

Process Builder steps match event names and optional URL patterns. A step expecting click on component UUID X will not fire if the visitor clicked an untracked duplicate button. Use dry-run against recent events to see which step fails.

Geo or channel unknown

Unknown country usually means the MaxMind database is missing or stale—refresh it in Data Quality. Unknown channel often means missing UTMs and no referrer; use the UTM builder on Marketing page for campaigns.

AI features unavailable

AI Intelligence requires ai_analysis_enabled in Settings → Advanced plus a valid Groq API key in Imaginit Core AI settings. Without both, Aria and growth jobs show a configuration notice rather than failing silently.

Getting help

Collect before escalating: screenshot of Data Quality health, browser network log of failed ingest POST, active Settings toggles, and last theme/plugin update time. Check Troubleshooting ↔ Glossary for term mismatches in internal tickets.

Preventive maintenance

Monthly: verify geo database, rerun technical SEO scan, review exclusion lists, test one funnel dry-run. Quarterly: audit goals and segments for stale URLs after site restructures.

Additional best practices

Behavior Intelligence works best when tracking coverage, funnel definitions, and team review rituals stay aligned. Revisit this guide after major site changes—new theme, consent plugin, or checkout provider—and confirm Realtime, Data Quality, and Tracking Plan still agree.

Share direct help links from the in-app help panel so teammates read the same canonical definitions. Press Ctrl+K in the help center to jump between related guides quickly.

• Align date ranges before comparing metrics across pages.
• Document segment names when sharing screenshots.
• Verify fixes in Realtime before closing Growth Plan items.
• Keep UTM conventions consistent for Marketing and Traffic.
• Schedule AI analysis after enough post-change data accumulates.

Working with the global toolbar

Every major Behavior Intelligence report page shares a global toolbar controlling date range, comparison mode, saved views, and active segments. Understanding this toolbar prevents the most common reporting mistake: discussing metrics that look contradictory because two pages use different ranges or filters.

Date ranges support presets (last 7, 28, 90 days) and custom intervals. Comparison mirrors the prior period of equal length. When comparison is off, KPI deltas hide—do not assume zero change. Saved views capture all toolbar state; teach teammates to check the view name in the header before screenshotting for leadership.

Connecting insights to action

Analytics value appears when insights change behavior. Behavior Intelligence routes findings through Growth Plan, Anomalies, and AI Intelligence into prioritized work. A metric without an owner becomes wallpaper. Assign DRI (directly responsible individual) per Growth Plan card and set verification dates.

Cross-link investigations: Traffic anomaly → Sessions sample → Journeys path → Tracking Plan coverage → Funnel step fix. This sequence resolves most conversion mysteries without external tools.

Data freshness expectations

Raw events ingest in near real time on Realtime. Daily aggregates power most dashboard KPIs and typically finalize after processor cron completes overnight in site timezone. Intraday numbers on Traffic are directional, not audit-final. Export via Report Builder after period close for finance-adjacent reporting.

Security and access control

Report data stays inside WordPress authenticated admin. REST endpoints require configured capabilities. Do not expose API keys or disable capability checks for convenience. View-only roles should not access Settings, Tracking Plan writes, or AI job triggers unless policy explicitly allows.

Module updates and compatibility

After Imaginit Core or Behavior Intelligence updates, revisit Getting Started verification steps: Realtime test, Data Quality health, one saved report run. Release notes may add event types or metrics—refresh Report Builder definitions if preview validation fails. Theme changes always trigger Tracking Plan re-crawl before trusting click metrics.

Keyboard shortcuts and help search

From any Behavior Intelligence admin page, open in-app help links to jump to the matching guide on the public help center. Within the help site, press Ctrl+K or Cmd+K to open Spotlight search across all articles, headings, and keywords. Search for metric names, page titles, or tasks like "export CSV" to find the right workflow without browsing the sidebar.

Bookmark frequently used guides for your role: content editors often need Content Performance and Organic Search; engineers need Tracking Plan and Data Quality; leadership prefers Overview and Reports email summaries.