Install on v0

v0 builds Next.js apps, so the tag goes in the root layout. Ask v0 to add it or edit the file yourself, then publish.

Ask v0

1. Send this prompt in the chat

   Replace YOUR_SITE_ID with the public site ID from your site's Settings → Install card. The site ID is public and safe in browser code; never put your secret key in a page.

   Prompt

   Copy

   1

   2

   3

   4

   5

   Add this analytics script to every page of the app. Load it once for the whole app,
   in index.html or the root layout (with next/script in a Next.js app), never from a single
   page or component. Keep the src and data-site-id attributes exactly as written:
   
   <script defer src="https://metricraven.com/js/script.js" data-site-id="YOUR_SITE_ID"></script>

2. Publish

   Choose Publish (or Publish Changes later). The chat preview isn't your production site.

Or edit the code

1. Open app/layout.tsx in the code editor

   Add the Script import and element, keeping the rest of your layout. Replace YOUR_SITE_ID with the public site ID from your site's Settings → Install card. The site ID is public and safe in browser code; never put your secret key in a page.

   app/layout.tsx

   Copy

   1

   2

   3

   4

   5

   6

   7

   8

   9

   10

   11

   12

   13

   14

   15

   16

   17

   // app/layout.tsx
   import Script from "next/script";
   
   export default function RootLayout({ children }: { children: React.ReactNode }) {
     return (
       <html lang="en">
         <body>
           {children}
           <Script
             src="https://metricraven.com/js/script.js"
             data-site-id="YOUR_SITE_ID"
             strategy="afterInteractive"
           />
         </body>
       </html>
     );
   }

2. Publish and open the live URL

   The same code works after you sync the project to GitHub. See the Next.js guide for details.

Notes

• Only hostnames listed in your site's Settings → General → Site domains (and their subdomains) are accepted. To also count visits on a platform address such as your-app.vercel.app, add it there; otherwise those requests are refused with domain_not_allowed.
• Each preview deployment gets its own URL. Leave those hostnames out of your allowed domains if you only want production traffic.
• AI edits can drift. After each publish, open your live app, view the page source and check the tag is still in <head> with its data-site-id unchanged.
• Click between a few pages and check the Network panel shows one /api/v1/collect pageview per navigation. Two per click means the tag is loaded twice.

Optional script attributes are listed in Install & verify. To exclude your own visits, see Exclude your visits.