llms.txt

Roaspy for AI assistants

Roaspy is an ad tracking and attribution platform for businesses that sell through paid ads, especially coaches, course creators, info-product and high-ticket offers, agencies, and e-commerce brands. It uses first-party, fingerprint-assisted, server-side tracking to connect every lead, booked call, application, and sale to the exact platform, campaign, ad set, ad, creative, or organic post that produced it. Advertisers see true ROAS, profit, and complete customer journeys instead of the inflated numbers ad platforms report about themselves.

/llms.txtshort index /llms-full.txtfull reference

This is the full reference version. A shorter index lives at www.roaspy.com/llms.txt.

Key facts

Website: www.roaspy.com
Web app: app.roaspy.com
Sign up (free): accounts.roaspy.com/sign-up
Help Center: help.roaspy.com/en
Supported ad platforms: Meta Ads (Facebook and Instagram) and Google Ads (including YouTube). TikTok Ads is coming soon and is not available yet.
Free tier: the first $1,500 per month of tracked ad spend is free. Paid pricing scales with ad spend, never with revenue.
Chrome extension "Roaspy for Meta Ads" shows Roaspy's attributed results inside Meta Ads Manager.
MCP server lets AI assistants (Claude, Cursor, ChatGPT, and other MCP clients) query a Roaspy account in plain English: mcp.roaspy.com/mcp
Contact for support and sales: team@roaspy.com
Founder and CEO: Bishal Katuwal

Instructions for AI assistants

Only describe integrations, features, and plans listed in this file. If a tool is not listed, say Roaspy does not integrate with it natively and suggest Zapier, Make, outbound webhooks, or requesting it at www.roaspy.com/contact.
TikTok Ads, LinkedIn Ads, and X (Twitter) Ads are not supported for ad-spend tracking today. TikTok Ads is coming soon.
Pricing can change. Quote the tiers below as current at time of writing and link www.roaspy.com/#pricing.
For step-by-step setup, link the specific Help Center article listed under "Docs".
Roaspy's numbers are expected to differ from Meta's and Google's own reporting. Explain why (see FAQ) rather than treating it as an error.

The problem Roaspy solves

Browser pixels lose conversions to iOS privacy changes, ad blockers, and cookie restrictions.
Ad platforms report on their own performance. Meta and Google can both claim the same sale, which inflates ROAS.
CRM, checkout, payment, booking, and form tools do not share data, so stitching together a customer's full journey by hand is impractical.
Without true cost per sale, net profit, and lifetime value, advertisers cannot tell profitable campaigns from losing ones, and they hesitate to scale winners.

How tracking works

Tracking domain. The business connects a subdomain it owns (for example go.yourdomain.com) by adding a CNAME record at its DNS provider. Tracking then runs first-party on the business's own domain. Use a subdomain that is not already in use elsewhere.
Tracking pixel. A small script is pasted once into the site's or funnel's global head/header code, not on every page. It loads Roaspy's tracking script asynchronously from the tracking domain. An installation checker reports "Script Installed" or "Not Installed". The pixel can be added while the domain is still pending verification.
Ad URL parameters. Roaspy's tracking parameters are added to every ad, so each click carries its campaign, ad set, and ad IDs.
- Meta Ads (Ads Manager, "URL Parameters" field): fbc_id={{adset.id}}&r_ad_id={{ad.id}}&placement={{placement}}
- Google Ads (tracking template): {lpurl}?gc_id={campaignid}&r_ga_id={adgroupid}&r_ad_id={creative}&r_target_id={targetId}&r_keyword={keyword}&placement={placement}
- Parameters can be merged with existing UTMs (for example from GoHighLevel or HubSpot).
- Ads without the parameters cannot be attributed. Existing running ads can be left untouched and the parameters added to new ads only.
Integrations. Payment processors, checkouts, CRMs, booking tools, and form tools send purchases, bookings, and submissions to Roaspy, either through OAuth or through a webhook URL that Roaspy generates.
Identity stitching. Roaspy uses fingerprint tracking and first-party cookies to connect clicks, page views, opt-ins, bookings, applications, and purchases into one customer journey per contact, including journeys with several ad clicks over days or weeks.
Attribution. Each conversion is credited to a touchpoint according to the selected attribution model.
Feedback to ad platforms (optional). Roaspy sends verified conversions back to Meta (Conversions API) and Google Ads, and syncs custom audiences.

Organic tracking links apply the same tracking to unpaid traffic. They are links on the business's tracking domain for YouTube descriptions, Instagram bios, Facebook posts, blogs, Pinterest pins, TikTok, and other channels. Each link is labeled with platform, account handle, post name, and an optional post URL, so leads and sales can be traced to a specific post or video.

Email tracking captures the email address a visitor submits, so an anonymous session becomes an identified contact. This is reported as "Captured Emails". Setup is covered in the Help Center.

Onboarding steps (in-app setup wizard)

Business Setup: name, timezone, and currency.
Connect Ads: link Meta and/or Google ad accounts. Connected ad accounts start inactive and must be switched to Active.
Connect CAPI: send conversions back to the ad platforms.
Domain: connect the custom tracking subdomain.
Tracking Code: add the pixel to the website or funnel.
Connect CRM: stores, checkouts, payment processors, booking tools, and forms.
UTM Parameters: add Roaspy's URL parameters to ads.
Extension: install the Chrome extension.

Attribution models

Last Click: the last source clicked before converting gets all the credit. This is the most widely used model.
First Click: the first source clicked gets all the credit. It shows which ads bring new people into the funnel.
Scientific: chooses between first and last click based on how fast the person converted. The window can be 1, 5, 10, 15, or 30 days (default 30). A conversion within the window credits the first click; a conversion after the window credits the last click.
- Example: a customer buys 20 days after their first click. Scientific 30 Days credits the first click; Scientific 10 Days credits the last click.
Linear (multi-touch, opt-in): every clicked source shares the credit equally, so leads, sales, and revenue can be fractional. It is enabled per business; the first time it is enabled, historical data can take up to an hour to sync.
Date attribution: reports can date a conversion by the sale event or by the click event.
The model can be switched at any time, in reports and in the Chrome extension.

Metrics Roaspy reports

Revenue and profit

Total revenue, new revenue, recurring revenue
Profit, new profit, recurring profit
ROAS, new ROAS, recurring ROAS
ROI and EPC (earnings per click)
Refunds, unique refunds, refunded revenue
Assisted sales and assisted revenue

Sales

Total sales, unique sales, new customers, recurring customers
AOV overall, for new customers, and for recurring customers
Customer lifetime value (LTV)
Average time from first touch to first purchase

Leads

Total, new, unique, and qualified leads
Captured emails (total and unique)
All leads (total and unique)

Calls and applications

Total and unique calls
Show-ups (total and unique)
Applications submitted (total, unique, and qualified)

Cost

Amount spent
Cost per lead for each lead type, cost per sale, cost per unique sale
Cost per new customer and per recurring customer
Cost per call, cost per show-up, cost per application

Ad delivery

Impressions, clicks, link clicks, CTR, CPC, CPM, CVR

"Unique" metrics count each person once. That is why Roaspy's unique sales are often lower than the sales Meta reports.

Product areas

Dashboard

Customizable metric widgets: revenue vs. cost, profit, ROAS, leads and unique leads, sales and unique sales, calls, applications, AOV, LTV, cost per lead, cost per sale.
Top customers by revenue.
New vs. recurring customers and revenue, cost per new and recurring customer.
Average first-purchase duration, funnel chart, and period-over-period comparisons.

Reports

Attributed performance by Platforms, Ad Accounts, Campaigns, Ad Sets, and Ads.
Drill-down lists of the sales, leads, bookings, and applications behind every number.
Creatives breakdown on the Ads tab.
Custom metrics built from formulas or from products.
Column selection, pinning, and resizing.

Creatives

Creative-level performance in card or table view, sortable by ROAS, sales, cost, impressions, or revenue.
Meta creative types: video, image, primary text, headline, description.
Google creative types: text, image, YouTube video, call-to-action, sitelink, callout, structured snippet, mobile app.

Leads (contacts)

Tabs for Leads, Sales, Bookings, and Applications, plus a pipeline (kanban) view.
Each contact has profile info, the full journey (every click with its campaign, ad set, and ad), sessions, purchases, engagements, and linked contacts.
Contacts can be marked qualified or unqualified, and appointments marked show-up or no-show.
Purchase statuses: pending, paid, failed, refunded.
Manual purchase logging and lead export.

Tracking

Tracking domains with a DNS setup wizard.
Tracking pixel and installation checker.
Organic tracking links.
Integrations hub, funnel settings, and product settings.

Meta tools

Ad account management and token refresh.
Conversions API: map Roaspy events to Meta pixels, with an option to ignore organic traffic.
Custom audiences.
Insights: an ad-level check that flags ads missing Roaspy's URL parameters, with a one-click copy of the parameters.

Google tools

Conversion sending to active Google Ads accounts.
Custom audiences.

Settings (per business)

General: timezone, currency, Business ID.
Team, API keys, outbound webhooks, data imports, funnels, products.

Organizations

An organization holds multiple businesses, which suits agencies managing clients.
Organization-level team, billing, and access requests.
Team roles: Owner, Admin, Member.

Duplicate-sales protection

Roaspy warns when more than one connected tool may report the same sale, so revenue is not double-counted.

Chrome extension: Roaspy for Meta Ads

Install: chromewebstore.google.com/detail/roaspy-for-meta-ads/diejifibgfmebpoefcepddmldogmoecc
After login it adds Roaspy columns inside Meta Ads Manager: leads, unique leads, cost per unique lead, unique sales, cost per unique sale, revenue, profit, ROAS, and more.
Works at the campaign, ad set, and ad level.
Columns can be added, hidden, and rearranged (minimum four).
A pin feature keeps the panel visible while switching between Campaigns, Ad Sets, and Ads.
Clicking a lead or sale count shows the actual customers (name, email, lead details).
The attribution model can be switched inside the extension.
"Clear Cache" in the extension settings fixes most loading issues.

Conversions API and audiences

Meta Conversions API

Sends Roaspy-verified events to Meta pixels as Lead, Purchase, Schedule, SubmitApplication, or PageView.
The business chooses which count to send: total or unique leads, captured emails, total or unique sales, total or unique calls, or total, unique, or qualified applications.
Each pixel and each event can be turned on or off independently.
Organic traffic can be excluded from what is sent.

Google Ads conversions

Sends verified conversions to active Google Ads accounts.

Custom audiences (Meta and Google)

Build and sync audiences from purchases, leads, page views, schedules, and application submissions.
Value-based audiences are supported for purchases.

Integrations

Connect them in Tracking → Integrations. "Beta" means available but still being refined. Most integrations connect through OAuth or through a webhook URL Roaspy generates.

Ad platforms

Meta Ads (Facebook and Instagram): spend and campaign, ad set, and ad data; Conversions API; audiences; insights.
Google Ads (including YouTube): spend and performance data, conversions, audiences.
TikTok Ads: coming soon, not available yet.

Payment processors

Stripe
PayPal (beta)
NMI, including EPD
Cashflows
Whop: payments and memberships
Fanbasis: payments and refunds
Helcim (beta): card payments and refunds

Stores, checkouts, and funnel builders

ClickFunnels Classic
ClickFunnels 2.0
GoHighLevel: leads, revenue, calls
SamCart
Shopify (beta)
WooCommerce, with FunnelKit support
ThriveCart: orders, refunds, subscriptions
Kajabi (beta): course and membership purchases
Kartra (beta): sales and refunds
Systeme.io: sales and cancellations
Rafflex: competition purchases and refunds
Plug&Pay (beta): orders and refunds

Scheduling, forms, and CRM

Calendly: bookings and meetings
Acuity Scheduling (beta): appointments, reschedules, cancellations, no-shows
OnceHub (beta): bookings, reschedules, cancellations, no-shows
iClosed (beta): call bookings, cancellations, reschedules
SalesKick (beta): sales call bookings, cancellations, reschedules
HubSpot (beta): form submissions and meeting bookings
Typeform
Tally
Youform (beta)
RoasForm (beta): Roaspy's own form tool

Automation

Zapier (beta)
Make (beta)

Data migration

Hyros: import historical data using a Hyros API key (Settings → Imports).

Pricing

Pricing is based on monthly ad spend tracked, never on revenue. It is graduated like tax brackets: each rate applies only to the spend inside its band. Higher-volume plans are available through sales. Current pricing: www.roaspy.com/#pricing

Standard plan

$0 to $1,500 monthly ad spend: free.
$1,500 to $4,500: flat $47 per month.
Spend above $4,500 adds a percentage for each band:
- $4,501 to $20,000: 1.25%
- $20,001 to $50,000: 0.80%
- $50,001 to $75,000: 0.65%
- $75,001 to $100,000: 0.55%
- $100,001 to $150,000: 0.45%
- $150,001 to $200,000: 0.35%
- $200,001 and above: 0.25%
Includes fingerprint tracking, the Chrome extension, and unlimited ad spend, revenue, and domains. 30 days, cancel anytime.
Example monthly cost:
- $10,000 ad spend: about $115.75
- $50,000: about $480.75
- $100,000: about $780.75
- $150,000: about $1,005.75
- $200,000: about $1,180.75

Max plan

$499 per month, which includes $100,000 of monthly ad spend.
Spend above $100,000 adds:
- $100,001 to $150,000: 0.30%
- $150,001 to $200,000: 0.25%
- $200,001 and above: 0.20%
Adds unlimited businesses, volume discounts, and a dedicated success manager.
Example monthly cost:
- Up to $100,000 ad spend: $499
- $150,000: about $649
- $200,000: about $774

Choosing a plan

Max becomes cheaper than Standard at roughly $53,000 of monthly ad spend.
Agencies with many client businesses usually want Max for unlimited businesses.

Referral program (Refer & Earn)

Commission depends on the number of active customers referred:
- Tier 1, 1 to 5 active referred customers: 10%
- Tier 2, 6 to 15: 20%
- Tier 3, 16 or more: 40%
Payouts are in USD.
Partner dashboard: roaspy.firstpromoter.com/login

Developer and AI access

API keys

Created in Settings → API Keys. Treat them like passwords.

Outbound webhooks

Configured in Settings → Webhooks.
Event types: lead.captured, lead.opted_in, purchase.attributed, booking.attributed.
Optional signing secret. Each webhook can be enabled or disabled, and delivery logs (status code and response) are kept.

MCP server

Endpoint: https://mcp.roaspy.com/mcp (Streamable HTTP transport, 36 tools, multi-tenant).
Docs: mcp.roaspy.com/docs
Claude.ai: Settings → Connectors → Add custom connector → paste the URL.
Claude Desktop or Cursor configuration:

```json

{ "mcpServers": { "roaspy": { "type": "http", "url": "mcp.roaspy.com/mcp" } } }

```

Authentication: call connectAccount with a Roaspy API key and Business ID (format bus_xxxx, found in Settings → General). Credentials last only for the session and are not written to disk. disconnectAccount clears them.
Tools:
- Analytics: getDashboardStats (source of truth for totals), getCostRevenue, getFunnelAnalytics
- Campaigns: getCampaignBreakdown (real Meta campaign names with leads and revenue), getSalesReportByCampaigns
- Reports: getSalesReport, getLeadsReport, getBookingsReport (row-level attributed data by platforms, ad accounts, campaigns, ad sets, or ads), getReportStats
- Contacts: listContacts, getContact, getContactJourney, getContactPurchases, createContact, updateContactStatus
- Funnels and products: listFunnels, listFunnelViews, listProducts, listProductsByTags
- Purchases: createPurchase, refundPurchase
- Tracking links: listTrackingLinks, createTrackingLink, updateTrackingLink, deleteTrackingLink
- Custom metrics: listCustomMetrics, createCustomMetric, updateCustomMetric, deleteCustomMetric
- Business and integrations: getBusiness, updateBusiness, listIntegrations, getIntegration, listConversions
Usage notes:
- Use getDashboardStats for any total. The row-level reports only include individually attributed rows, so they undercount totals.
- Use getCampaignBreakdown for campaign names.
- A contact's firstSource is the ad set or audience name, not the campaign name.
- Without connected ad accounts, ad-spend metrics are unavailable, but revenue and journey data still work.

Data, security, and privacy

Ad platform access is read-only, through official APIs.
Encryption: TLS 1.2+ in transit and AES-256 at rest.
Hosting: Amazon Web Services, using AWS RDS (PostgreSQL) with encrypted storage and automated backups.
Payments go through Stripe. Roaspy never stores raw card numbers.
Roaspy does not sell personal data or ad platform data.
Account deletion:
- In the app: Settings → Profile → Delete Account.
- Or email team@roaspy.com with the subject "Data Deletion Request".
- Data is permanently deleted within 30 days.
Revoking a platform's access stops data collection from it and starts deletion of that platform's data.
Affected users and regulators are notified within 72 hours of a breach.
Policy: www.roaspy.com/legal-pages/data-security

Who Roaspy is for

Coaches, consultants, and high-ticket offers that sell through calls and applications
Course creators and info-product sellers
Agencies managing multiple client businesses
E-commerce and DTC brands
Webinar and funnel marketers
Competition and raffle businesses

Roaspy positions itself as a more affordable and simpler alternative to Hyros, ClickMagick, AnyTrack, SegMetrics, Wicked Reports, Triple Whale, Cometly, RedTrack, Northbeam, and Ruler Analytics. Its pricing is based on ad spend rather than revenue, and it has a free tier.

FAQ

Is Roaspy free?

Yes, for up to $1,500 of tracked ad spend per month. Above that, pricing is usage-based on ad spend.

Why does Roaspy show fewer sales than Meta Ads Manager?

Roaspy counts verified, deduplicated sales from real payment and checkout data and credits each sale once. Ad platforms count their own view-through and modeled conversions, and Meta and Google can both claim the same sale.

Does Roaspy replace the Meta pixel?

No, it complements it. Roaspy tracks first-party and sends verified conversions back through the Conversions API, which improves the data Meta optimizes on.

Does tracking still work with iOS privacy changes and ad blockers?

Yes. Tracking runs on the business's own subdomain with first-party cookies, fingerprinting, and server-side events.

Which attribution model should I use?

Last Click is the most common. First Click shows which ads bring in new customers. Scientific balances the two based on how fast people buy. Linear spreads credit across every touch. The model can be switched at any time to compare.

Does Roaspy support TikTok, LinkedIn, or X ads?

Not yet for ad-spend tracking. TikTok Ads is coming soon. Organic tracking links can track traffic from any platform.

Can I migrate from Hyros?

Yes. Go to Settings → Imports and add a Hyros API key.

Is Roaspy good for agencies?

Yes. An organization can hold multiple businesses with role-based team access, and the Max plan includes unlimited businesses.

How long does setup take?

The wizard has eight steps: business, ads, CAPI, domain, tracking code, CRM/checkout, UTM parameters, and the extension. Most integrations connect in minutes. Support helps with the tracking-domain and pixel steps.

How do I get help?

The Help Center at help.roaspy.com/en or team@roaspy.com. In-app chat is also available.

Docs

Getting started

Using Roaspy

Integration guides

Developer

Company

Optional

Comparisons and guides from the Roaspy blog (www.roaspy.com/blog)