Install the tracking script

Clakta records the visits to your site through a script: a small piece of code you create in your project and add to your pages. A project can have several, for example one per site.

1. Create the script

Go to Project settings → Script and click Create script.

Name

Any name that helps you tell your scripts apart later, such as Main site.

Domains

The sites allowed to send data with this script. Add each one without https://:

example.com
shop.example.com

Data from any other site is rejected, so a copy of your site can't mix fake data into yours.

Events recorded automatically

Choose what the script records on its own:

Keep Page views on: attribution depends on it. You can turn the others on or off at any time.

2. Add it to your site

Save the script and click Install instructions on its row. The code there already has your script id filled in.

Paste the code

Copy the code and paste it inside the <head> of every page of your site:

<script
  src="https://cdn.clakta.com/script.js"
  data-id="YOUR_SCRIPT_ID"
  data-auto-init
  defer
></script>

data-auto-init starts recording as soon as the page loads. Remove it only if you want to start recording yourself, for example after the visitor accepts a consent banner, by calling clakta.init({ id: "YOUR_SCRIPT_ID" }).

Next.js

Install the SDK:

npm install @clakta/nextjs

Then add the provider once, in your root layout:

import { ClaktaProvider } from "@clakta/nextjs"

export default function RootLayout({ children }) {
  return (
    <html>
      <body>
        <ClaktaProvider id="YOUR_SCRIPT_ID" />
        {children}
      </body>
    </html>
  )
}

Pass the id directly. The provider starts only once per page, so a value that arrives later is ignored.

React or plain JavaScript

Install the package:

npm install @clakta/javascript

import clakta from "@clakta/javascript"

clakta.init({ id: "YOUR_SCRIPT_ID" })

While setting up, add debug: true to see what the script is doing in the browser console. For consent banners, see Consent management.

3. Check that it loads

In the install instructions, click Test your website and type one of your domains. Clakta opens the page and looks for the script. A green result means the script is on that site.

This only proves the script is there. To check that data is arriving, go to Verify your setup.

Common mistakes

Next step

Verify your setup.