Attribution (vm.js)

Revenue in the VisibleMax OS is proven with a lightweight `vm.js` script. It attributes visits and conversions from AI referral traffic so you can connect recommendation wins to sessions, signups, customers, and revenue.

Install the snippet

Copy the snippet from Attribution at /app/p/[projectId]/attribution. It requires your workspace public key in data-key:

<script src="https://visiblemax.site/vm.js"
  data-key="vmk_…"
  defer></script>

Events you can send

Example conversion hooks

// after signup
window.VisibleMax?.signup({ meta: { plan: "trial" } });

// after first payment (amount in cents)
window.VisibleMax?.customer();
window.VisibleMax?.revenue(4900);

// optional survey
window.VisibleMax?.survey("ChatGPT recommendation");

How AI referrals are detected

The collector records referrer and UTM context with each event. Sessions that originate from assistant properties (or campaigns you tag) appear as AI-referred in the Attribution funnel: sessions → signups → customers → revenue.

Verify the install

1. 1

   Deploy the snippet

   Add vm.js to your marketing site layout (every page you care about attributing).

2. 2

   Load a page

   Open the site, confirm a pageview appears in Attribution within a few minutes.

3. 3

   Fire a test conversion

   From a staging page, call VisibleMax.signup() once and confirm the funnel increments.

4. 4

   Watch weekly

   As monitoring and probes show recommendation gains, Attribution should trend with AI-referred sessions.

FAQ