> ## Documentation Index
> Fetch the complete documentation index at: https://help.contentgrove.io/llms.txt
> Use this file to discover all available pages before exploring further.

# How contentgrove tracking works

> Understand how contentgrove tracking works: the click-to-conversion flow, what data gets recorded, and how clicks are linked back to conversions.

contentgrove tracking connects a click on one of your video links to a conversion on your site. This page explains the flow so the rest of the setup makes sense.

## The flow

<Steps>
  <Step title="A viewer clicks your link">
    Someone clicks one of your contentgrove short links (like `grve.to/free-course`) in your video description or comment. contentgrove records the click and which video it came from, then redirects the visitor to your destination.
  </Step>

  <Step title="Your landing page loads">
    The tracking script on your landing page picks up the attribution the short link passed along.
  </Step>

  <Step title="A click ID is stored">
    The script stores a click ID in the visitor's browser for 30 days, so a later conversion can be linked back to this click.
  </Step>

  <Step title="The visitor converts">
    They complete your action and reach your thank-you page.
  </Step>

  <Step title="The conversion is recorded">
    The script on your thank-you page records a conversion and links it back to the original click and video.
  </Step>
</Steps>

## What gets recorded

When someone clicks a tracked link, contentgrove records which video they came from, which landing page they visited, their device type, their city and country, and when the click happened.

When someone converts, it records which video led to the conversion, which offer they completed, the revenue (if you set it on the offer), and when it happened.

<Note>
  contentgrove doesn't collect personal information like names or emails. IP addresses are used only to derive city and country. Some thank-you page URLs include identifier values (for example a Stripe session ID), and contentgrove can surface a best-available identifier on a conversion. See [Conversion tracking](/concepts/conversion-tracking).
</Note>

## How clicks link to conversions

The click ID is stored for **30 days**. If a visitor clicks a link and converts within that window, the conversion is attributed to the original click and video. If they convert after 30 days, or in a different browser, the conversion can't be linked back.

If a visitor refreshes your thank-you page, the conversion isn't counted twice. Each click can result in at most one conversion.

## Consent mode

<Warning>
  The script does not wait for consent unless you turn on strict consent mode. If you're subject to GDPR or similar rules, add `data-require-consent="true"` so tracking only fires after the visitor opts in.
</Warning>

By default, the tracking script records clicks and conversions as soon as it loads, without waiting for a consent signal.

To make tracking wait for visitor consent, turn on **strict consent mode** by adding `data-require-consent="true"` to the script tag (or `requireConsent: true` in the window config):

```html theme={null}
<script
  src="https://cdn.contentgrove.workers.dev/cg-tracker.js"
  data-tracking-id="YOUR_TRACKING_ID"
  data-require-consent="true"
  async
></script>
```

In strict consent mode:

* The script tracks **only after** the visitor grants consent through a supported consent platform — Cookiebot, CookieYes, CookieScript, OneTrust, or the WordPress Consent API.
* Until consent is granted, nothing is recorded. The attribution is held in the browser's memory and tracking fires automatically the moment consent is given.
* If no supported consent platform is present on the page, tracking stays blocked.

## Subscription

Tracking runs only while your subscription is active. If it lapses, the script stops making tracking requests.

## Next step

Ready to add the script? See [Install the tracking script](/tracking/install-script), or jump to your platform's guide under [Supported platforms](/tracking/supported-platforms).