Getting Started

Install Behavior Intelligence on WordPress, enable tracking, verify data collection, and learn the dashboard so your team analyzes visitor behavior fast.

What is Behavior Intelligence?

Behavior Intelligence is a privacy-first analytics module for WordPress built into Imaginit Core. It captures how visitors move through your site—page views, button clicks, form interactions, scroll depth, and custom events—without session replay or heatmap coordinates. Data flows from a lightweight JavaScript collector through a REST ingest endpoint into aggregated tables that power every dashboard page.

Unlike generic pageview counters, Behavior Intelligence focuses on actionable behavior: which CTAs get clicked, where users drop off in multi-step processes, which landing pages convert, and whether traffic spikes are normal or anomalous. The Overview dashboard gives you a daily pulse; deeper pages let you inspect sessions, build segments, and export reports.

Prerequisites

Before you begin, confirm the following:

  • WordPress 6.0 or newer with Imaginit Core and the Behavior Intelligence module active.
  • A user account with manage_options or a custom capability configured under Settings → Roles.
  • HTTPS on your public site (recommended for secure cookie handling and REST ingest).
  • Optional: Google Search Console OAuth credentials if you plan to use Organic Search reports.
  • Optional: A Groq API key if you want AI Intelligence and the Aria assistant.

Roles and access

By default, only administrators can view reports and manage settings. You can lower the view capability to edit_posts or another role if editors need read-only analytics access. Management capabilities (Settings, Tracking Plan writes, GSC connect) should stay restricted to trusted admins.

Initial setup checklist

  1. Open Behavior Intelligence → Settings and confirm tracking is enabled.
  2. Review the Privacy tab: choose an IP storage mode, decide whether to honor Do Not Track, and connect consent integration if you use the WP Consent API.
  3. Set exclusions for bots, staff roles, and admin paths so internal traffic does not skew metrics.
  4. Visit your public homepage in a private browser window and confirm events appear on the Realtime page within one to two minutes.
  5. Open the Tracking Plan and run a site crawl or SiteAnalyze job to discover untracked buttons and links.
  6. Define at least one conversion goal under Settings → Marketing if you measure form submissions or key clicks.
Tip: After enabling tracking, open Realtime in one tab and browse your site in another. You should see your session appear in the active visitors table within 15 seconds—the fastest way to confirm the collector is firing.

Understanding the dashboard

The left navigation groups pages by workflow:

  • Home — Overview and Realtime for at-a-glance and live monitoring.
  • Analyze — Traffic, Sessions, Journeys, Funnels, Segments, Content, Organic Search, and Marketing for deep dives.
  • Improve — Growth Plan, Anomalies, and AI Intelligence for prioritized actions.
  • Reports — Saved exports and the Report Builder.
  • System — Data Quality, Tracking Plan, Settings, and Details for configuration and pipeline health.

Most report pages share a global toolbar at the top: date range picker, comparison toggle, saved views, and segment filter. Changes apply across the current page and persist when you navigate if you save a view.

Verify tracking is working

Go to Data Quality and check the health score and event coverage panels. You should see page_enter, click, and other core event types with recent timestamps. If coverage is empty, verify that tracking is enabled, consent is not blocking the collector, and no exclusion rule matches your test URL.

The collector assigns a visitor cookie (imaginit_bi_vid) and a session cookie (imaginit_bi_sid) that expires after 30 minutes of inactivity. Sessions persist across page loads within that window, which is why Journeys and Funnels can reconstruct multi-page paths.

Next steps for your team

Once baseline data is flowing, work through these milestones in order:

  1. Read the Overview guide to understand KPI cards and the intelligence feed.
  2. Instrument high-value CTAs in the Tracking Plan so click metrics are reliable.
  3. Create one funnel in Process Builder for your primary conversion path (e.g. landing → product → contact).
  4. Connect Google Search Console to unlock Organic Search and marketing attribution insights.
  5. Enable AI analysis in Settings if you want automated growth recommendations and Aria chat.

Bookmark this help center and press Ctrl+K (or ⌘K on Mac) from any help page to search documentation instantly.

Frequently asked setup questions

Does Behavior Intelligence work with caching plugins? Yes, but the collector script must load on cached HTML pages. Exclude the collector from aggressive JS bundling or deferral plugins that strip inline config. Purge cache after changing tracking settings.

Will it slow my site? The adaptive collector loads a manifest of tracked components for the current page only. Events batch to REST ingest asynchronously. Server-side tracking mode removes client page_enter for configured sites at the cost of losing some interaction granularity.

Is it GDPR-friendly? You control IP storage, consent gating, DNT, and retention. Run the Privacy assessment in Settings and document your lawful basis. Behavior Intelligence avoids session replay and never captures sensitive form field values by design.

Collaboration tips for teams

Assign one owner for Tracking Plan coverage, one for funnel definitions, and one for Growth Plan triage. Weekly 15-minute reviews of Overview + Anomalies keep the system actionable. Link help docs from your internal wiki using stable URLs from the public help center.

Related guides