One Dashboard. Every Platform.

ROI Insights installs in minutes, wherever you build. Find your platform below and follow the steps.

Before You Start

Before installing on any platform, you'll need a couple of values. Here's what they are, why they matter, and how to get them.

Required

Your Site ID

A unique identifier connecting your website to your ROI Insights dashboard. Required; without it, data has nowhere to go.

Looks like:roi_a1b2c3d4
How to get it:
  1. Create free account at roiknowledge.com
  2. Click Add Site
  3. Copy Site ID
Optional

Your GTM Container ID

Google Tag Manager container ID. Optional; skip if you don't use GTM, ROI Insights connects Analytics and Search Console directly.

Looks like:GTM-ABC1234
How to get it:
  1. Go to tagmanager.google.com
Optional

Call Tracking

Enables Dynamic Number Insertion (DNI). Provisions local tracking number forwarding to real number. Professional plan adds recording, transcription, AI lead scoring. Uses prepaid credits (starting at $10, separate from subscription).

Values:true or false(defaults disabled)
When to enable:

Enable if business receives phone calls as leads.

ValueRequired?Where to get itExample
Site IDYesroiknowledge.com → Add Siteroi_a1b2c3d4
GTM Container IDNotagmanager.google.comGTM-ABC1234
Call TrackingNoYour choice: enable or disabletrue or false

Once you have your Site ID, you're ready to install. Find your platform below.

WP

WordPress

What it is

The world's most popular website platform, used by millions of businesses and agencies.

What to expect

Once activated, ROI Insights adds Google Tag Manager, Google Analytics and Search Console connections, UTM tracking, and call tracking to your WordPress site. Your dashboard starts populating with data within 24-48 hours.

How to install

In your WordPress admin, go to Plugins → Add New

Search for "ROI Insights"

Click Install Now, then Activate

Go to Settings → ROI Insights

Enter your Site ID (from your ROI Insights account, see "Before You Start" above)

Enter your GTM Container ID if you use Google Tag Manager (optional)

Toggle Call Tracking on if you want to track inbound phone calls

Click Connect Google Account to link your Analytics, Search Console, and Ads

Or install via WP-CLI:
wp plugin install roi-insights --activate

After activating via WP-CLI, go to Settings → ROI Insights in your admin to configure your Site ID, GTM ID (optional), Call Tracking, and connect Google.

Lovable

What it is

An AI-powered app builder that generates full React applications from natural language prompts.

What to expect

ROI Insights wraps your Lovable app with full marketing attribution. Every visitor, every form submission, and every call is tracked back to the source that produced it. Your dashboard starts populating within 24-48 hours.

How to install

You'll need your Site ID from your ROI Insights account (see "Before You Start" above). If you use Google Tag Manager, have your GTM Container ID ready too.

Paste this prompt into your Lovable project chat, replacing the placeholder values with your own:

Prompt:
Install the @roiinsights/core npm package. Wrap the root App component
in the ROIInsights provider with these settings:

- siteId: "YOUR_SITE_ID" (replace with the Site ID from your ROI Insights dashboard)
- gtmId: "GTM-XXXXXXX" (replace with your GTM container ID, or remove this line if you don't use GTM)
- callTracking: true (set to false if you don't need phone call tracking)

Lovable will automatically install the package, update your app's root component, and deploy the changes.

Custom knowledge snippet (optional)

Paste this into your project's custom knowledge to help the AI configure ROI Insights correctly in the future:

Knowledge
When adding analytics or marketing tracking, use the @roiinsights/core npm package. Wrap the app root in <ROIInsights siteId="..." gtmId="..." callTracking={true}>. Use the useROIInsights() hook for form tracking and lead attribution. Documentation: https://roiknowledge.com/docs

Bolt.new

What it is

A browser-based AI development environment that builds full-stack apps from prompts, powered by StackBlitz WebContainers.

What to expect

ROI Insights integrates directly into your Bolt project. All tracking scripts are injected automatically, no manual file editing required. Your dashboard starts populating within 24-48 hours.

How to install

Have your Site ID ready (see "Before You Start" above). Paste this prompt into your Bolt project chat:

Prompt:
Add the @roiinsights/core npm package. In the main App component,
wrap the entire app in the ROIInsights provider with these settings:

- siteId: "YOUR_SITE_ID" (replace with your Site ID from ROI Insights)
- gtmId: "GTM-XXXXXXX" (replace with your GTM container ID, or remove if not using GTM)
- callTracking: true (set to false if you don't need phone call tracking)
B44

Base44

What it is

An AI-powered all-in-one app builder with built-in database, authentication, and hosting. Backed by Wix.

What to expect

ROI Insights connects to your Base44 app via a lightweight script injection. Your marketing data flows into one dashboard alongside every other channel you're running.

How to install

Have your Site ID ready (see "Before You Start" above). Paste this prompt into your Base44 project chat:

Prompt:
Add a script tag to the head of the app that loads the ROI Insights
tracking script from this URL:

https://cdn.roiknowledge.com/tracker.js?site=YOUR_SITE_ID&gtm=GTM-XXXXXXX

Replace YOUR_SITE_ID with my ROI Insights Site ID.
Replace GTM-XXXXXXX with my GTM container ID (or remove the &gtm=
parameter entirely if I don't use Google Tag Manager).

Also add a meta tag with name="roi-insights" and content="YOUR_SITE_ID".

Note: Base44 uses a proprietary build system that handles npm packages differently than other platforms. The script injection approach works reliably across all Base44 apps without requiring direct npm access.

Cursor

What it is

An AI-powered code editor built for developers who want AI assistance while maintaining full control of their codebase.

What to expect

ROI Insights installs as a standard npm dependency. Cursor's AI can help you configure it, or you can set it up manually. Full marketing attribution across every channel, with data flowing into your dashboard within 24-48 hours.

How to install

In Cursor's integrated terminal, run:

Terminal:
npm install @roiinsights/core

Then ask Cursor's AI to configure it (replace the placeholder values with your own, see "Before You Start" above):

Code
I just installed @roiinsights/core. Wrap my app's root component in
the ROIInsights provider with:
- siteId="YOUR_SITE_ID" (my ROI Insights Site ID)
- gtmId="GTM-XXXXXXX" (my GTM container ID — remove if I don't use GTM)
- callTracking={true} (enable phone call tracking)

Or add it manually to your root component:

Code
import { ROIInsights } from '@roiinsights/core';

function App() {
  return (
    <ROIInsights
      siteId="YOUR_SITE_ID"       {/* required — your ROI Insights Site ID */}
      gtmId="GTM-XXXXXXX"          {/* optional — remove if you don't use GTM */}
      callTracking={true}           {/* optional — set to false or remove if you don't need call tracking */}
    >
      {/* Your existing app */}
    </ROIInsights>
  );
}
CC

Claude Code

What it is

Anthropic's command-line tool for agentic coding. Delegate development tasks to Claude directly from your terminal.

What to expect

Claude Code can install and configure ROI Insights in a single command. Full marketing attribution with zero manual setup.

How to install

Have your Site ID ready (see "Before You Start" above). Run this in your project directory, replacing the placeholder values:

Terminal:
claude "Install the @roiinsights/core npm package and wrap the root
App component in the ROIInsights provider. Use these settings:
siteId is YOUR_SITE_ID, gtmId is GTM-XXXXXXX (skip gtmId if I don't
use Google Tag Manager), and callTracking is true."

Claude Code will install the dependency, locate your root component, and add the provider wrapper automatically.

WS

Windsurf

What it is

An AI-powered IDE by Codeium that combines code editing with an AI assistant for writing, debugging, and refactoring.

What to expect

ROI Insights installs as a standard npm package. Windsurf's AI Cascade feature can handle the configuration for you. Full attribution, same dashboard, data flowing within 24-48 hours.

How to install

In Windsurf's integrated terminal, run:

Terminal:
npm install @roiinsights/core

Then use Cascade (Windsurf's AI) to configure it, replacing placeholder values with your own (see "Before You Start" above):

Code
I installed @roiinsights/core. Wrap my root App component in the
ROIInsights provider with:
- siteId="YOUR_SITE_ID" (my ROI Insights Site ID)
- gtmId="GTM-XXXXXXX" (my GTM container ID — remove if I don't use GTM)
- callTracking={true} (enable phone call tracking)

Replit

What it is

A cloud-based development platform where you can build, test, and deploy apps entirely in the browser. Popular with beginners and indie hackers.

What to expect

ROI Insights installs through Replit's built-in package manager or shell. Once configured, every visitor to your Replit-hosted app is tracked with full attribution.

How to install

Option A: Package manager UI 1. Open the Packages panel in the left sidebar 2. Search for @roiinsights/core 3. Click Install

Option B: Shell Open the Replit shell and run:

Shell:
npm install @roiinsights/core

Then ask Replit's AI assistant to configure it, replacing placeholder values with your own (see "Before You Start" above):

Code
I installed @roiinsights/core. Wrap the root component in the
ROIInsights provider with:
- siteId="YOUR_SITE_ID" (my ROI Insights Site ID)
- gtmId="GTM-XXXXXXX" (my GTM container ID — remove if I don't use GTM)
- callTracking={true} (enable phone call tracking)
v0

v0 (Vercel)

What it is

Vercel's AI-powered development tool that generates production-quality React and Next.js components from prompts.

What to expect

ROI Insights works with any Next.js or React project generated by v0. Once installed, your marketing attribution data flows into one dashboard.

How to install

After exporting your v0 project, run in your terminal:

Terminal:
npm install @roiinsights/core

Then add the provider to your root layout (app/layout.tsx for Next.js), replacing placeholder values with your own (see "Before You Start" above):

Code
import { ROIInsights } from '@roiinsights/core';

export default function RootLayout({ children }) {
  return (
    <html>
      <body>
        <ROIInsights
          siteId="YOUR_SITE_ID"       {/* required — your ROI Insights Site ID */}
          gtmId="GTM-XXXXXXX"          {/* optional — your GTM container ID */}
          callTracking={true}           {/* optional — enable phone call tracking */}
        >
          {children}
        </ROIInsights>
      </body>
    </html>
  );
}
AI

Codex (OpenAI)

What it is

OpenAI's cloud-based coding agent that can write, test, and fix code in a sandboxed environment.

What to expect

Codex can install and configure ROI Insights in a single task. Hand it the instruction with your values and let it run.

How to install

Have your Site ID ready (see "Before You Start" above). Give Codex this task, replacing the placeholder values:

Prompt:
Install the @roiinsights/core npm package. Find the app's root
component and wrap it in the ROIInsights provider with these settings:

- siteId: "YOUR_SITE_ID" (my ROI Insights Site ID)
- gtmId: "GTM-XXXXXXX" (my GTM container ID — remove if I don't use GTM)
- callTracking: true (enable phone call tracking)

Commit the changes.

EmDash

What it is

A modern, full-stack TypeScript CMS built on Astro by Cloudflare. Open source, serverless, and designed as a next-generation alternative to WordPress.

What to expect

The ROI Insights plugin adds Google Tag Manager, analytics connections, UTM tracking, and call tracking to your EmDash site through the official plugin system. Configuration happens through a visual settings panel in your EmDash admin — no config files to edit.

How to install

From your EmDash project directory:

Terminal:
npx emdash add @mosierdata/emdash-plugin-analytics

Or install manually:

Code
npm install @mosierdata/emdash-plugin-analytics

Then add it to your astro.config.mjs:

Code
import emdash from "emdash/astro";
import roiInsights from "@mosierdata/emdash-plugin-analytics";

export default defineConfig({
  integrations: [
    emdash({
      plugins: [roiInsights()],
    }),
  ],
});

After installation, open your EmDash admin panel → Settings → ROI Insights: 1. Enter your Site ID (from your ROI Insights account, see "Before You Start" above) 2. Enter your GTM Container ID if you use Google Tag Manager (optional) 3. Toggle Call Tracking on if you want to track inbound phone calls 4. Click Connect Google Account to link your Analytics, Search Console, and Ads

Other / Any React App

What it is

Building with a framework, tool, or platform not listed above? If your project uses React and supports npm packages, ROI Insights works there too.

What to expect

The @roiinsights/core package is a standard React component library. It works in any React application regardless of how it was built or where it's hosted. Same dashboard, same attribution, same weekly intelligence.

How to install

Run in your terminal:

Terminal:
npm install @roiinsights/core

Add the provider to your app's root component, replacing placeholder values with your own (see "Before You Start" above):

Code
import { ROIInsights } from '@roiinsights/core';

function App() {
  return (
    <ROIInsights
      siteId="YOUR_SITE_ID"       {/* required — your ROI Insights Site ID */}
      gtmId="GTM-XXXXXXX"          {/* optional — your GTM container ID */}
      callTracking={true}           {/* optional — enable phone call tracking */}
    >
      {/* Your app */}
    </ROIInsights>
  );
}

Script tag fallback (for non-React sites):

Code
<script src="https://cdn.roiknowledge.com/tracker.js?site=YOUR_SITE_ID"></script>

That's it. Three props. Full marketing attribution. Don't see your platform? If your project runs JavaScript and can load a <script> tag, ROI Insights can work there, even without npm. Add the script tag fallback above to your site's <head>. This lightweight script handles GTM injection, UTM tracking, and attribution without requiring React or npm. It works on any website.

After You Install

1

Sign in to your ROI Insights dashboard at roiknowledge.com

2

Connect your Google account; this links your Analytics, Search Console, Ads, and Business Profile

3

Data starts flowing within 24-48 hours. Your dashboard will populate automatically

4

Upgrade to Professional when you're ready for the Weekly Advisor Briefing, call transcription, and advanced attribution

Need help getting set up?

Our team can audit your entire marketing operation and configure everything for you: tracking, attribution, call routing, all of it.