Conversion Insights Agent

Summary: Track privacy-safe visitor behavior, analyze conversion funnels and user journeys, uncover drop-off points, and get actionable AI suggestions to boost conversions.

Conversion Insights Agent is an analytics workspace built into Antimanual that captures anonymous visitor behavior and turns it into actionable conversion-rate optimization (CRO) suggestions. It provides an Overview, Funnels, Journeys, Retention, Cohorts, and AI Insights — all inside your WordPress admin, with no data leaving your own server.

---

Availability

[!IMPORTANT]
Conversion Insights Agent is available exclusively on the Antimanual Pro Max plan. Users on Antimanual free or standard Antimanual Pro will see an upgrade teaser instead of the workspace.

Both the Antimanual (free) and Antimanual Pro plugins must be installed and active. The free plugin provides the admin UI and AI provider services; the Pro plugin provides the backend tracking, analytics engine, and API.

---

How Conversion Insights Agent Works

1. Behavior capture — When tracking is enabled, a lightweight frontend script is enqueued on every page of your site. It records anonymous interaction events (page views, scroll depth, clicks, form steps, and more) and sends them to a dedicated table in your WordPress database via a REST API endpoint. No IP addresses, no personal data, and no cookies are stored. A random, anonymous identifier kept in the browser’s localStorage is used to recognize returning visitors for retention data.
2. Data storage — All events are stored in the {prefix}_antimanual_behavior_events table in your own database. AI suggestions are stored in {prefix}_antimanual_conversion_suggestions. Data never leaves your server.
3. Reporting — The admin workspace reads and aggregates the raw events in real time to populate all reports: Overview, Funnels, Journeys, Retention, and Behavioral Cohorts.
4. AI analysis — When triggered (manually or on the daily schedule), the AI agent reads a 30-day summary of behavior signals, sends them to your configured AI provider (OpenAI, Anthropic, Gemini, etc.), and receives back a prioritized list of CRO suggestions. The raw event data is never sent to the AI — only anonymized, aggregated counts and page-performance summaries are included in the prompt.
5. Do Not Track — The tracker respects the browser’s Do Not Track (DNT) signal. Visitors with DNT enabled are not tracked.

---

Where to Find Conversion Insights Agent

In your WordPress admin, navigate to:

Antimanual → Conversion Insights Agent

The page opens to the Overview tab. A User Guide button is available in the page header.

---

Getting Started

Step 1 — Enable Behavior Tracking

Behavior tracking is off by default. To turn it on:

1. Go to Antimanual → Conversion Insights Agent.
2. If tracking is off, an info notice titled “Behavior tracking is off” appears below the page header.
3. Click Enable tracking in that notice, or navigate to Analytics → Settings and toggle on Track visitor behavior.
4. Settings are saved immediately — no separate Save button is required.

Once enabled, the frontend script begins collecting visitor events. Reports populate as visitors interact with your site.

Step 2 — Select a Conversion Goal

The conversion goal determines which event drives the headline Conversion Rate shown in the page hero and weekly digest.

1. Go to Analytics → Settings (inside Conversion Insights Agent).
2. Under Conversion Goal, select the Primary conversion goal event from the dropdown.

Available goal events and when each fires:

Event	When it fires
Purchase	On the WooCommerce order-received page, once per order. Default when WooCommerce is active.
Form submit	When any form on the page is submitted. Default when WooCommerce is not active.
CTA click	On clicks on <button> elements, elements with a btn, button, or cta class, and any element marked data-atml-cta.
Add to cart	When a shopper adds an item to their cart, including WooCommerce AJAX add-to-cart.
Begin checkout	When a shopper lands on the checkout page or clicks a checkout button.
Link click	On clicks on ordinary links not styled or marked as calls to action.
Form start	The first time a visitor focuses a field in a form.
Scroll depth	As a reader passes 25%, 50%, 75%, and 100% of the page length.
Page view	On every page load.

[!NOTE]
The events Form abandon, Rage click, and Page exit cannot be selected as a conversion goal — they are friction signals, and counting them as conversions would invert the headline metric.

Step 3 — Wait for Visitor Data

As visitors interact with your site, events are captured automatically. The Funnels, Journeys, Retention, Cohorts, and Overview reports populate progressively. There is no minimum required before the dashboard loads, but the AI analysis requires at least 30 events in the last 30 days before it will run.

Step 4 — Run AI Analysis

See AI Insights below.

---

Settings

All settings are in Analytics → Settings inside the Conversion Insights Agent workspace.

Behavior Capture & Privacy

Setting	Description
Track visitor behavior	Master on/off switch for all behavior capture. Disabling it also disables daily AI analysis. Enqueues a frontend script that captures anonymous page views, scroll depth, CTA clicks, form funnel steps, and eCommerce conversions.

Badges displayed when tracking is enabled confirm: No cookies, no IP stored · Respects Do Not Track (DNT) · Data stays on your server.

[!NOTE]
To recognize returning visitors, the tracker stores a random anonymous identifier in the browser’s localStorage. No cookie is set and nothing identifies the individual. Some privacy frameworks treat localStorage as browser storage requiring consent — verify your own consent policy before enabling tracking.

Conversion Goal

Setting	Description
Primary conversion goal event	The event counted as a primary conversion. Drives the headline Conversion Rate shown in the hero banner and the weekly digest.

A Goal Setup & Integration Guide button opens the User Guide modal at the Conversion Goals section.

Autonomous AI Analysis

Setting	Description
Run daily AI analysis	When enabled, automatically analyzes captured visitor behavior once per day via WP-Cron and generates prioritized CRO suggestions. Requires Track visitor behavior to be on. Disabled automatically when behavior tracking is turned off.

Weekly Email Digest

Setting	Description
Send weekly email digest	Delivers an HTML summary email to the site administrator email address every week via WP-Cron. Includes last 7-day KPIs (Conversion rate, Events, Sessions, Visitors) with period-over-period deltas, and up to 5 open suggestions. Requires Track visitor behavior to be on.
Send a test now	Immediately sends a preview of the digest to the current admin email. Visible only when the weekly digest is enabled.

Data Retention & Storage

Data retention is automatic and not configurable in the UI. The following defaults apply:

Data	Retention
Raw behavior events	Purged after 90 days (adjustable with the atml_behavior_retention_days WordPress filter).
Applied & dismissed suggestions	Purged after 60 days (adjustable with the atml_suggestion_retention_days WordPress filter).
Open (new) suggestions	Not automatically purged.

Pruning runs on the daily WP-Cron schedule, regardless of whether the AI agent is enabled.

---

What Events Are Tracked

The tracker records the following event types. Only these are accepted; anything else is rejected.

Event type	What it captures
page_view	Each page load.
scroll_depth	Scroll percentage milestones. The value_num field stores the percentage reached.
cta_click	Clicks on <button> elements, elements with a btn / button / cta class, or any element with a data-atml-cta attribute.
link_click	Clicks on ordinary anchor links not identified as CTAs.
form_start	First focus on a form field.
form_abandon	Leaving a partially filled form without submitting.
form_submit	Successful form submission.
add_to_cart	Adding an item to the WooCommerce cart.
begin_checkout	Landing on the WooCommerce checkout page or clicking a checkout button.
purchase	Completing a WooCommerce order (fires on the order-received page).
rage_click	Rapid repeated clicks on the same element.
page_exit	Visitor leaving the page.

Each event record includes: session ID, anonymous visitor ID, URL path (query string stripped), post ID (if resolved), element label, numeric value (e.g. scroll percentage or cart value), device type, referrer host/path, and an optional small metadata payload. No IP address is stored.

---

Overview Tab

The Overview tab is the default view when opening Conversion Insights Agent.

Hero KPIs

Five headline stats appear in the page banner for the selected date range, each with a period-over-period delta indicator:

Stat	Description
Conversion	Session-level conversion rate to the configured goal event. Shown as a percentage. Delta is expressed in percentage points (e.g. +1.2pp). Displays “—” when no valid goal event is configured.
Events	Total events recorded.
Sessions	Distinct sessions recorded.
Visitors	Distinct anonymous visitors identified by their persistent localStorage ID.
Page views	Total page_view events.

Date Range

A toggle in the toolbar controls the date range applied to all analytics views:

Option	Period
7d	Last 7 days
14d	Last 14 days
30d	Last 30 days (default)
90d	Last 90 days

Segment Filter

A segment filter can be applied to all analytics views from the toolbar. Segments narrow the data to a subset of visitors. Filters are composable (AND logic).

Dimension	Available values
Device	Desktop, Mobile, Tablet
Traffic	Direct (no referrer), Referral (has referrer)

When no filter is set, all visitors are shown (“All visitors”).

Overview Charts

• Activity over time — A daily chart of events and sessions across the selected period.
• Top events — The most frequently recorded event types, highest count first (up to 12).
• Devices & traffic — Session share by device type and traffic channel (Direct vs. Referral).

Empty State

If tracking is on but no events have been recorded yet: “Once tracking is on and visitors browse your site, metrics will appear here.”

---

Funnels

The Funnels section is accessed from Analytics → Funnels.

What Funnels Show

A conversion funnel shows how many visitors completed each step of a sequential path — and where they dropped off. A session “reaches” a step only if it fired all preceding steps in chronological order.

Building a Funnel

1. Open Analytics → Funnels.
2. Click Customize to open the funnel builder.
3. Use Add a step… to pick event types.
4. Reorder steps using Move step up / Move step down.
5. Remove a step with Remove step.
6. At least two steps are required to display a funnel.

Funnel Metrics

For each step:

Metric	Description
Count	Sessions that reached this step.
% of start	Share of sessions that entered the funnel (step 1) and reached this step.
% from prev	Share of the previous step’s sessions that continued to this step.
Drop-off	Sessions lost between the previous step and this one.
Median time	Median time visitors took from the previous step to this step.

Overall conversion and Entered (total sessions entering step 1) are shown above the funnel. The step with the largest absolute session loss is labeled Biggest drop-off.

Time to Convert

A histogram below the funnel shows how long converting sessions took from first to last step. Buckets: under 1 min, 1–5 min, 5–30 min, 30–60 min, 1–6 hr, 6–24 hr, over 1 day. The median conversion time and sample count are shown.

Segment Comparison

Click Compare in the toolbar to overlay a second segment. A Compare against segment picker appears and both segments are shown side by side.

Explain Drop-off (AI)

From step 2 onward, an Explain drop-off button on each step sends the drop-off context to the AI and returns an explanation with suggested improvements. Requires an AI provider API key.

Data Note

Funnels are based on a capped sample of recent sessions. When the cap is reached: “Note: based on a capped sample of recent sessions.”

Empty State

“No [event] events have been recorded yet for this segment. Pick another funnel or let more visitor data accumulate.”

---

Journeys

The Journeys section is accessed from Analytics → Journeys.

What Journeys Show

The most common page-to-page navigation moves, where visitors first arrive (entry pages), and the last page they see before leaving (exit pages).

Top Page Paths

The most common page-to-page transitions (From → To), sorted by frequency (up to 15).

Top Entry Pages

Pages where visitors most frequently start their sessions (up to 8).

Top Exit Pages

Pages visitors most frequently leave from (up to 8).

Data Note

Based on a capped sample of recent page_view events: “Note: based on a capped sample of recent page views.”

Empty States

• “No page-to-page flows for this segment yet. Try ‘All visitors’ or a wider date range.”
• “Page-to-page flows appear once visitors navigate across multiple pages.”

---

Retention

The Retention section is accessed from Analytics → Retention.

What Retention Shows

A day-N retention grid: for each cohort day (visitors who first appeared on that day), the grid shows what percentage returned on each subsequent day (Day 1 through Day 7).

• Day 0 is each visitor’s first visit.
• Cells for future dates within a cohort are left blank, not shown as 0%.
• Only visitors with a persistent anonymous visitor ID (stored in localStorage) are counted.

The grid supports the segment filter and segment comparison.

Data Limits

Retention is bounded to the last 30 days and up to 7 day-offsets, regardless of the date range selected.

Empty State

“Retention needs returning visitors across multiple days — check back after tracking has run a while.”

---

Cohorts

The Cohorts section is accessed from Analytics → Cohorts.

What Cohorts Show

A behavioral cohort answers: “Of visitors who did X, how many later did Y?” Unlike funnels (session-scoped), cohorts track behavior across sessions using the persistent anonymous visitor ID.

Building a Cohort

1. Under Visitors who did, pick the anchor event.
2. Set at least to the minimum occurrences of the anchor (default: 1).
3. Under then, choose did or never did.
4. Pick the follow-up event (must differ from the anchor).
5. Set a conversion window: any time later, within 1 day, within 7 days, or within 30 days.

Quick Starts

Pre-built cohort templates:

• Cart → Purchase — Visitors who added to cart and then purchased.
• Added but didn’t buy — Visitors who added to cart but never purchased.
• Engaged → Lead — Visitors who engaged and then submitted a form.
• Form started, not sent — Visitors who started a form but never submitted.

Cohort Metrics

Metric	Description
Base	Visitors who performed the anchor event.
Converted	Visitors who also performed the follow-up (or did not, in negated mode).
Rate	Percentage of base that converted.
Median time between	Median time from anchor to follow-up (not shown in negated mode).

A time-between distribution histogram is shown for positive (non-negated) cohorts.

Segment Comparison

Use Compare to compare two segments on the same cohort definition.

Explain This Cohort (AI)

An Explain this cohort button asks the AI to interpret the result and suggest what could be changed. Requires an AI provider API key.

Empty State

“No identified visitors have done ‘[event]’ in this window for the current segment.”

---

AI Insights

The AI Insights section is accessed from Analytics → AI Insights.

Requirements

• Track visitor behavior must be enabled.
• An AI provider API key must be configured in Antimanual’s AI settings (OpenAI, Anthropic, Gemini, DeepSeek, or xAI).

Running an Analysis

1. Open Analytics → AI Insights.
2. Click Analyze now.
3. The analysis can take up to a minute. Status line: “Analyzing… this can take up to a minute.”
4. Click Stop to cancel.
5. On completion: count of new suggestions, or “Analysis complete — no new suggestions this time.”

The analysis uses the last 30 days of behavior data and requires at least 30 events in that window. If fewer events exist, the run is skipped.

What the AI receives: Aggregated, anonymous data only — total event count, event type counts, funnel summary (distinct sessions per stage for page views, add-to-cart, begin checkout, purchase, form start, and form submit), and per-page performance summaries (URL path, page views, average scroll depth, exit count, CTA click count). No raw event rows, individual session data, or personal information is sent.

What the AI returns: Up to 6 suggestions with a title, explanation, category, priority, and optionally an applicable action.

Daily Automatic Analysis

Enable Run daily AI analysis in Settings to have the analysis run automatically once per day via WP-Cron.

Suggestions

Each suggestion card shows:

Field	Description
Priority badge	High (red), Medium (amber), or Low (grey).
Category badge	One of: cta, copy, layout, funnel, trust, speed, navigation, or general.
Title	A short, actionable headline (up to 90 characters).
Body	1–3 sentences explaining the issue, the recommended change, and why it should help, citing the relevant behavior signal.
Page path	The affected page path, if page-specific.
Created	How long ago the suggestion was generated.

Suggestion Actions

For New suggestions:

• If the suggestion has an automatically applicable action → Apply button → confirmation modal showing action type and arguments → Apply change executes the action and marks the suggestion Applied.
• If no automatic action → Mark as done marks it Applied without executing a change.
• Dismiss moves it to Dismissed.

For Applied suggestions: Shown with Applied or Done label. No further actions available.

For Dismissed suggestions: Restore moves it back to New.

Automatically Applicable Action Types

Action type	Effect
add_internal_link	Adds an internal link to a post.
update_cta_text	Updates the text of a call-to-action element.
add_faq_block	Adds an FAQ block to a post.

Actions outside this list are stripped before a suggestion is saved.

Filtering Suggestions

Filter	Shows
New (N)	Open, unacted suggestions.
Applied (N)	Applied or marked-as-done suggestions.
Dismissed (N)	Dismissed suggestions.

The count of each status is shown in the filter tab label.

Duplicate Prevention

Suggestions with the same title and page path as an existing open suggestion are skipped during analysis to prevent duplicates.

Status Messages

Condition	Message
Tracking off	“Enable tracking below to gather data.”
No AI provider key	“Add an AI provider key to run analysis.”
Tracking on, key present	“Last analyzed: [time ago]”
Suggestions list empty, tracking off	“Enable tracking and let visitors browse to start gathering data.”
Suggestions list empty, tracking on	“Run an analysis once enough visitor data is collected.”

---

Ask Your Data

The Ask your data card is on the right side of the AI Insights section.

Type a plain-language question about your analytics and click Ask (or press Enter). The AI answers using your behavior data for the selected window. Requires an AI provider API key.

Data Window

An “Answering from” dropdown controls how many days of data are included in the answer: Last 7 days, Last 14 days, Last 30 days, or Last 90 days.

Example Questions

Clickable chips are shown when an AI key is configured:

• “Where are visitors dropping off before checkout?” (WooCommerce active) or “Where are visitors dropping off in the funnel?”
• “Which pages have the highest exit rate?”
• “How is engagement trending this period?”

Controls

Control	Action
Ask	Submit the question.
Stop	Cancel the in-progress request.
Clear	Clear the question and answer.
Copy	Copy the AI’s answer to clipboard.

Empty / Error States

Condition	Behavior
No AI provider key	Input disabled; “Add an AI provider API key in Settings to ask questions.”
Request in progress	“Analyzing your data…”
No answer returned	“No answer returned.”
Request error	Error notice displayed.

---

Refresh and Navigation

• Refresh in the toolbar reloads the current analytics view without changing the date range or segment.
• The active tab (Overview or Analytics) and active analytics section (Funnels, Journeys, Retention, Cohorts, AI Insights, Settings) are remembered across page reloads via localStorage.
• The segment filter and date range controls are hidden when the AI Insights or Settings sections are active.

---

User Guide

A built-in User Guide modal is accessible from the User Guide button in the page header. Sections:

• Quick Start — Setup steps and how anonymous behavior capture works.
• Features Walkthrough — Summary of each workspace section.
• Conversion Goals — Each goal event and how it is triggered.
• Freemius & Checkout — Code snippet for posting a purchase event from the Freemius SDK’s purchaseCompleted callback.

---

Troubleshooting

Tracking is off / No data appears

Enable Track visitor behavior in Analytics → Settings, or click Enable tracking in the notice that appears on the page when tracking is off.

“Analyze now” is disabled

Both conditions must be met: Track visitor behavior is enabled, and an AI provider API key is configured in Antimanual’s AI settings.

Funnel shows no data

• The funnel requires at least one recorded event matching the first step.
• With a narrow segment, try All visitors or a wider date range.
• Verify the event types in your funnel are triggered by your site’s pages.

Retention shows no data

Retention requires visitors with a persistent anonymous ID to return on different days. It populates after tracking has run for at least two days and returning visitors are observed.

Cohort shows no matching visitors

Cohorts use the persistent anonymous visitor ID. Visitors who clear their localStorage or use private browsing will not be matched across sessions.

AI analysis returns no new suggestions

• Fewer than 30 events in the last 30 days causes the run to be skipped.
• Existing open suggestions with identical titles and page paths are skipped as duplicates.
• The AI may return no new suggestions if no additional opportunities are identified.

Analysis cannot run

The error “The analysis could not run.” indicates the AI provider returned an error. Check your API key and provider usage limits.

Weekly digest not arriving

• Confirm Send weekly email digest and Track visitor behavior are both enabled in Settings.
• Use Send a test now to verify delivery to the admin email.

Conversion Insights Agent workspace not visible

Conversion Insights Agent requires Antimanual Pro Max. Users on the free plugin or standard Antimanual Pro see an upgrade page instead.

---

Frequently Asked Questions

Does tracking set cookies?
No. The tracker uses the browser’s localStorage to store an anonymous session and visitor ID. No cookie is set.

Is the visitor’s IP address stored?
No. No IP address is stored at any point.

Where is the data stored?
All behavior events and AI suggestions are stored in your own WordPress database. No data is sent to external servers except the aggregated, anonymous signal bundle sent to your configured AI provider during an analysis run.

Does the tracker respect Do Not Track (DNT)?
Yes. Visitors with DNT enabled are not tracked.

Can I use this without WooCommerce?
Yes. WooCommerce-specific events (add_to_cart, begin_checkout, purchase) will not fire if WooCommerce is not active. Use form_submit or cta_click as your conversion goal instead.

Can I track conversions from a third-party checkout (e.g. Freemius)?
Yes. You can post a purchase event manually from your checkout’s completion callback. The User Guide modal includes a code snippet for Freemius.

How often does the daily analysis run?
Once per day via WordPress’s WP-Cron system. The exact time depends on when WP-Cron was first scheduled after enabling daily analysis.

What happens to the data when I deactivate Antimanual Pro?
The WP-Cron jobs for the analysis, anomaly scan, and weekly digest are cleared on deactivation. The database tables and stored data remain until explicitly removed.

Need Further Assistance?

If you encounter any issues or have questions regarding Conversion Insights Agent, please visit our official support channels:

• Support Portal: https://helpdesk.spider-themes.net/ask/