Documentation

Pro Features Guide

Tags, trend charts, conversion tracking, Insights, and How People Convert, on top of the free plugin's full attribution.

Pro Features Guide

Referrer Attribution Pro is a separate add-on, licensed independently from the free plugin. It does not unlock anything in Free; everything described here is new capability on top of the free plugin's full, unrestricted attribution.

Upgrading to Pro

Purchase a Pro license at referrerattribution.com/pro/. After purchase, enter your license key at WordPress Admin → Attribution → License. Pro features activate immediately.

Tags

Apply color-coded tags to sessions, either automatically by rule or manually one at a time:

  • Rule-based auto-tagging - match on UTM parameters, URL pattern, or date range
  • Retroactive bulk-apply - run a new rule against existing session history, safe to re-run
  • Manual tagging - apply a tag to an individual session from an inline picker on the Sessions report
  • Multi-tag support - a session can carry more than one tag

Tag filters on the Sessions report carry through to CSV export.

Trends

The Trends tab adds charts the free plugin's dashboard does not have:

  • Period selector - 7, 30, or 90 days
  • Daily sessions chart - per channel, over the selected period
  • Sessions vs. conversions - grouped bar chart per channel
  • Conversion rate by channel - horizontal bar chart
  • Channel drill-down - click any channel to see its top referring source domains, with session and conversion counts

Every chart on this tab has a Direct/Unknown exclusion toggle, the same pattern as the free plugin's Dashboard.

Conversion tracking

Record the attributed channel against conversion events. Supported sources:

  • WooCommerce - records attribution on order completion, including the real order total and currency
  • Contact Form 7 - records attribution on successful form submission
  • Approved comments - records attribution when a comment is approved
  • Custom hook - call cqip_attr_pro_record_conversion from any plugin or theme for any other event type

Conversions appear in the Trends charts and in the Conversions tab, which is filtered, paginated, and exportable as CSV. The Conversions tab also hosts the Estimated Conversion Values settings panel, used by Insights below.

Insights

Insights reports on attribution coverage, conversions, and revenue, with a deliberate focus on real numbers over estimates:

  • Attribution Coverage - the percentage of sessions with a usable attribution signal, with a period-over-period change figure
  • Conversions by Source - real counts per channel, and a separate breakdown by individual AI platform rather than the AI Tools channel as a whole
  • Attributed Revenue - real monetary totals, by currency, for conversions that recorded a genuine value. Currently populated automatically from WooCommerce order totals
  • Estimated Conversion Values - assign your own estimated value to a conversion type with no real value of its own, such as a comment or form submission. Always shown as a separate, clearly labeled figure, never combined with real revenue
  • Attribution Health Score - a single 0-100 score from three measured components (Coverage, UTM completeness, AI taxonomy activity), plus a fourth pass/fail check for whether conversion tracking is wired up at all

How People Convert

A plain-English panel built for reading at a glance: a sentence stating which channels convert visitors almost immediately and which need more browsing first, backed by two tables.

  • Average pages viewed before converting - by channel
  • First page viewed vs. last page viewed - each channel's typical landing page, compared against the page a visitor was on right before they converted. This is the closest equivalent to "first-touch vs. last-touch" this product offers, and it is real: it answers what a visitor looked at first and what they looked at last, by channel.

This relies on full visit path tracking, which is free, not Pro. What Pro adds here is the analysis: turning the recorded path data into a plain-English summary and the two tables above.

What "first vs. last" means here: the page a visitor lands on first and the page they view last before converting can be, and often are, different, and that comparison is real and already shown above. What does not exist, and will not, is a channel changing mid-visit: a visit's channel is fixed at the first page and stays the same for every page that follows, so "first-touch channel vs. last-touch channel" would always show zero difference, for every visitor, by design. If you came here looking for channel-level first/last-touch attribution, the page-level comparison above is the honest answer this product gives instead. Real revenue is currently limited to WooCommerce order totals.

Branded report

Open a branded HTML report in a new browser tab for a 7, 30, or 90-day period. Use your browser's own print dialog to save it as a PDF, no server-side PDF generation involved.

Content Attribution

Shows which pages appear in converting sessions. Three views:

  • Top converting pages - pages visited in sessions that included a conversion, ranked by frequency
  • Assisted pages - pages viewed before the conversion point, showing which content supports the path to conversion
  • Channel by content matrix - which channels send traffic to which pages, among converting sessions

Webhooks

Push attribution data to any URL as a JSON payload. Two event types, each with its own toggle:

  • Session webhooks - fire when a new session is logged. Dispatched via WP-Cron to avoid adding latency to the page request
  • Conversion webhooks - fire when a conversion is recorded. Dispatched inline, consistent with other conversion handling

Configure the destination URL, choose which events to send, and optionally test the connection from the Webhooks tab.

Branded short links

Create short links on your own domain in the format /go/{slug}. Campaign parameters are appended server-side at the moment of redirect, before any browser privacy filter can interfere. Each link tracks its own click count.

AIR Engine

The Attribution Intelligence Report evaluates all unclassified Direct sessions against 20 deterministic pattern rules. Each rule fires when session data on a page path meets a specific threshold. When a rule fires, a finding card is produced containing:

  • A classification and category (Dark Social, Cross-Device, Legacy URLs, B2B Authority, or Automated Traffic)
  • A confidence score from 0 to 100, derived from four measurable signals already in your session database
  • A fact base showing the raw database counts used to reach the conclusion
  • A specific recommended action

An Attribution Health Score (0-100) at the top of the report summarises the overall picture. Findings can be marked as reviewed. A Copy prompt button formats the full report for plain-English summary in any LLM.

Full AIR Engine documentation →

White-label branding

Replace the plugin's displayed name and logo in the WordPress admin with your own branding.

Debug logging

Enable a debug log toggle for troubleshooting conversion recording.

Common questions

CQIP (Content Quality and Intelligence Policy) is a methodology standard, not a technology stack. It defines how structured web content is authored and published. The implementation varies by platform; the standard does not.