# Checkivo conversietracking — GTM + GA4 + Google Ads

Updated: 2026-07-23

## Wat er al live staat (code)

| Laag | Status |
|---|---|
| GTM container | `GTM-NLXSB5PT` (official snippet in `<head>` + noscript after `<body>`) |
| GA4 | `G-MF78C5320Z` / property `546640549` |
| Consent | Usercentrics + Consent Mode defaults denied |
| Site helper | `/js/cv-conversions.js` op alle marketingpagina’s |
| Config | `/conversions-config.json` |
| Start free → `generate_lead` | Wired in `checkivo-home-interactions.js` |
| CTA clicks | `cta_shopify_install`, `cta_demo` |
| App signup → `sign_up` | `app.checkivo.com` root + `?cv_signup=1` na password set |
| gclid cookies | `cv_gclid` / `cv_gbraid` / `cv_wbraid` (90 dagen) |

## Events (dataLayer + GA4)

| Event | Wanneer | Ads-gewicht |
|---|---|---|
| **`generate_lead`** | Start free e-mail succesvol verstuurd | **Primary** conversie |
| **`sign_up`** | Account aangemaakt (password gezet) | Secondary |
| `cta_shopify_install` | Klik naar Shopify install | Micro |
| `cta_demo` | Klik naar demo | Micro |

## Stap A — GTM (jij in tagmanager.google.com)

Container: **GTM-NLXSB5PT**

### 1) Variables (Built-in aanzetten)
- Page URL, Page Path, Click URL, Event

### 2) Triggers (Custom Event)
1. `CE - generate_lead` → Event name = `generate_lead`
2. `CE - sign_up` → Event name = `sign_up`
3. `CE - cta_shopify_install` → Event name = `cta_shopify_install`
4. `CE - cta_demo` → Event name = `cta_demo`

### 3) Tags — GA4 Event (als nog geen GA4 Configuration tag bestaat: maak die met Measurement ID `G-MF78C5320Z`)
Voor elk event een **Google Analytics: GA4 Event** tag:
- Event name = `{{Event}}` of hardcode (`generate_lead` etc.)
- Trigger = bijbehorende CE trigger

> Site vuurt events ook al direct via gtag → GA4. GTM-tags zijn nodig voor Ads + als single source of truth.

### 4) Tags — Google Ads Conversion (nadat Stap B klaar is)
1. Tag type **Google Ads Conversion Tracking**
2. Conversion ID + Label uit Ads
3. Trigger: `CE - generate_lead`
4. Optioneel tweede tag op `CE - sign_up`

### 5) Publish
Submit → “Checkivo conversions week1”

## Stap B — Google Ads conversie-acties (account 655-134-9109)

API kan dit nog niet (Explorer token). Doe in de UI:

1. **Goals → Conversions → Summary → + New conversion action → Website**
2. Maak:
   - **Checkivo — Start free (generate_lead)**  
     Category: Submit lead form · Count: One · Click-through: 30 days · View: 1 day · Attribution: Data-driven
   - **Checkivo — Sign up**  
     Category: Sign-up · Count: One · zelfde windows
3. Kies **Use Google Tag Manager** (of “Event snippet”)
4. Kopieer **Conversion ID** + **Label**
5. Plak in GTM Ads tags **óf** zet in config:

```json
{
  "adsSendTo": "AW-XXXXXXXXX/YYYYYYYYYY",
  "adsSendToSecondary": "AW-XXXXXXXXX/ZZZZZZZZZZ"
}
```

Bestand: https://checkivo.com/conversions-config.json

6. Zet primary (`generate_lead`) als **account-default** voor bidding (Maximize Conversions).

## Stap C — GA4 key events + Ads-link

1. GA4 → Admin → **Events** → markeer `generate_lead` en `sign_up` als **Key events**
2. GA4 → Admin → **Product links → Google Ads links** → link account `655-134-9109`
3. Google Ads → Goals → **GA4 import** (backup naast native Ads tags)

## Stap D — Testen (Preview)

1. GTM Preview op https://checkivo.com
2. Vul Start free met testmail → zie `generate_lead` in dataLayer + GA4 DebugView
3. Voltooi signup op app → zie `sign_up` + URL `?cv_signup=1` (wordt weggehaald na fire)
4. Google Ads → Tools → **Conversion measurement** → “Recent conversions” / Tag Assistant

## Bestanden

- `/js/cv-conversions.js`
- `/conversions-config.json`
- Marketing: `checkivo-home-interactions.js` (generate_lead)
- App: `apps/shopify-app/app/root.tsx`, `signup.complete.tsx`
