ROI Insights installs in minutes, wherever you build. Find your platform below and follow the steps.
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.
A unique identifier connecting your website to your ROI Insights dashboard. Required; without it, data has nowhere to go.
roi_a1b2c3d4Google Tag Manager container ID. Optional; skip if you don't use GTM, ROI Insights connects Analytics and Search Console directly.
GTM-ABC1234Enables 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).
true or false(defaults disabled)Enable if business receives phone calls as leads.
| Value | Required? | Where to get it | Example |
|---|---|---|---|
| Site ID | Yes | roiknowledge.com → Add Site | roi_a1b2c3d4 |
| GTM Container ID | No | tagmanager.google.com | GTM-ABC1234 |
| Call Tracking | No | Your choice: enable or disable | true or false |
Once you have your Site ID, you're ready to install. Find your platform below.
Plugin install
npm package via prompt
npm package via prompt
API integration via prompt
npm package via terminal
npm package via terminal
npm package via terminal
npm package via shell
npm package via terminal
npm package via prompt
Plugin install
npm package via terminal
The world's most popular website platform, used by millions of businesses and agencies.
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.
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
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.
An AI-powered app builder that generates full React applications from natural language prompts.
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.
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:
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.
Paste this into your project's custom knowledge to help the AI configure ROI Insights correctly in the future:
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/docsA browser-based AI development environment that builds full-stack apps from prompts, powered by StackBlitz WebContainers.
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.
Have your Site ID ready (see "Before You Start" above). Paste this prompt into your Bolt project chat:
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)
An AI-powered all-in-one app builder with built-in database, authentication, and hosting. Backed by Wix.
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.
Have your Site ID ready (see "Before You Start" above). Paste this prompt into your Base44 project chat:
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>m=GTM-XXXXXXX Replace YOUR_SITE_ID with my ROI Insights Site ID. Replace GTM-XXXXXXX with my GTM container ID (or remove the >m= 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.
An AI-powered code editor built for developers who want AI assistance while maintaining full control of their codebase.
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.
In Cursor's integrated terminal, run:
npm install @roiinsights/core
Then ask Cursor's AI to configure it (replace the placeholder values with your own, see "Before You Start" above):
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:
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>
);
}Anthropic's command-line tool for agentic coding. Delegate development tasks to Claude directly from your terminal.
Claude Code can install and configure ROI Insights in a single command. Full marketing attribution with zero manual setup.
Have your Site ID ready (see "Before You Start" above). Run this in your project directory, replacing the placeholder values:
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.
An AI-powered IDE by Codeium that combines code editing with an AI assistant for writing, debugging, and refactoring.
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.
In Windsurf's integrated terminal, run:
npm install @roiinsights/core
Then use Cascade (Windsurf's AI) to configure it, replacing placeholder values with your own (see "Before You Start" above):
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)A cloud-based development platform where you can build, test, and deploy apps entirely in the browser. Popular with beginners and indie hackers.
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.
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:
npm install @roiinsights/core
Then ask Replit's AI assistant to configure it, replacing placeholder values with your own (see "Before You Start" above):
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)Vercel's AI-powered development tool that generates production-quality React and Next.js components from prompts.
ROI Insights works with any Next.js or React project generated by v0. Once installed, your marketing attribution data flows into one dashboard.
After exporting your v0 project, run in your 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):
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>
);
}OpenAI's cloud-based coding agent that can write, test, and fix code in a sandboxed environment.
Codex can install and configure ROI Insights in a single task. Hand it the instruction with your values and let it run.
Have your Site ID ready (see "Before You Start" above). Give Codex this task, replacing the placeholder values:
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.
A modern, full-stack TypeScript CMS built on Astro by Cloudflare. Open source, serverless, and designed as a next-generation alternative to WordPress.
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.
From your EmDash project directory:
npx emdash add @mosierdata/emdash-plugin-analytics
Or install manually:
npm install @mosierdata/emdash-plugin-analytics
Then add it to your astro.config.mjs:
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
Building with a framework, tool, or platform not listed above? If your project uses React and supports npm packages, ROI Insights works there too.
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.
Run in your 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):
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):
<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.
Sign in to your ROI Insights dashboard at roiknowledge.com
Connect your Google account; this links your Analytics, Search Console, Ads, and Business Profile
Data starts flowing within 24-48 hours. Your dashboard will populate automatically
Upgrade to Professional when you're ready for the Weekly Advisor Briefing, call transcription, and advanced attribution
Our team can audit your entire marketing operation and configure everything for you: tracking, attribution, call routing, all of it.