Externe website tracking

Externe websites tracken met Voluit Suite

Doel van deze handleiding

Deze handleiding legt uit hoe je het External Tracking Script installeert en gebruikt om paginaweergaven te registreren en formulierinzendingen te tracken op externe websites zoals WordPress, Shopify, Wix, Webflow of custom HTML.

Gebruik deze setup als je:

• Een Voluit Suite formulier op een externe website embed
• Paginaweergaven en inzendingen wilt tracken voor attributie
• Workflows wilt triggeren wanneer deze events plaatsvinden

⚠️ Externe formulieren worden nog niet ondersteund. Het tracking script herkent en trackt alleen interne formulieren die extern geëmbed zijn.

Wat is het External Tracking Script?

Het tracking script is een klein stukje JavaScript dat uniek is voor je account. Wanneer je het op je externe site plaatst, doet het het volgende:

1. Registreert paginaweergaven
2. Trackt Voluit Suite formulierinzendingen die op die pagina's geëmbed zijn
3. Slaat anonieme activiteit op totdat de bezoeker bekend wordt
4. Stuurt die getrackte events naar je CRM voor rapportage en workflow automation

Het fungeert als de "brug" waarmee je paginaactiviteit kunt zien van sites die niet binnen het platform gehost worden.

Belangrijk gedrag

⚠️ Er verschijnt geen contact of activiteitenlog totdat een Voluit Suite formulier wordt ingevuld.

Dit is wat er gebeurt:

• Paginaweergaven zijn anoniem totdat iemand een formulier indient.
• Alle eerdere anonieme activiteit wordt gekoppeld aan het aangemaakte/bijgewerkte contact
• Zodra een formulier wordt ingediend, wordt een contact aangemaakt of bijgewerkt in de CRM.

Dit script doet niet:

• Contacten aanmaken vanuit externe of custom HTML formulieren
• Third-party formulieren tracken (WPForms, Gravity Forms, CF7, Elementor, etc.)
• Interacties of clicks tracken
• Formulieren tracken die in iframes of popups zitten

Waarom je het nodig hebt

Zonder het tracking script kunnen we niet:

• Paginaweergaven op externe websites registreren
• Leads of conversies aan campagnes toewijzen
• Workflows triggeren op basis van externe activiteit

Met het tracking script geïnstalleerd:

• Kun je onze formulieren op externe websites tracken
• Kun je paginaprestaties meten in het Attribution Report
• Kun je automations triggeren voor bezoekers die een formulier indienen

Wat het doet

Trackt:

• Paginaweergaven
• Formulierinzendingen
• Workflow triggers (gebaseerd op bovenstaande events)

Trackt niet:

• Scrollen, clicks of time-on-page
• Sessie-niveau analytics
• Cross-domain gedrag

Voordat je begint

• Het site domein moet verbonden zijn met je account.
• Het formulier moet een Voluit Suite formulier embed zijn
• Formulieren in iframes of popups worden niet getrackt.

Stap 1: Haal je tracking script op

In je account:

1. Ga naar Settings → External Tracking
2. Klik op Copy Script

Je snippet ziet er zo uit:

<script
src="<https://link.jouwdomein.nl/js/external-tracking.js>"
data-tracking-id="tk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"&gt;
&lt;/script&gt;

Wijzig je data-tracking-id niet. Het is uniek voor je account.

Stap 2: Installeer het script

Plak het script voor de sluitende </body> tag op je website.

Optie A: Direct toevoegen (aanbevolen)

Voorbeeld:

<!--ExternalTrackingScript-->
<script
src="<https://link.jouwdomein.nl/js/external-tracking.js>"
data-tracking-id="tk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"&gt;
&lt;/script&gt;
&lt;/body&gt;
&lt;/html&gt;

Werkt voor:

• Custom HTML sites
• WordPress
• Wix / Squarespace / Webflow

Optie B: Installeren via Google Tag Manager (GTM)

⚠️ Bekend probleem: GTM kan het data-tracking-id attribuut verwijderen, waardoor de initialisatie niet werkt. Als je console errors ziet zoals LC Tracking: Missing data-tracking-id attribute, verwijdert je GTM setup de ID.

Tijdelijke fix / workaround:

1. Maak een Custom HTML Tag in GTM.
2. Plak je volledige tracking code (wijzig deze niet).
3. Stel de trigger in op All Pages.
4. Preview de pagina, open DevTools → Elements tab.
5. Controleer of het data-tracking-id attribuut nog steeds aanwezig is in de script tag.
   • Als het ontbreekt → installeer de code handmatig in je site footer.

Stap 3: Zorg dat je formulier compatibel is

⚠️ Externe formulieren worden nog niet ondersteund. Het tracking script herkent en trackt alleen interne formulieren die extern geëmbed zijn.

Stap 4: Bekijk inzendingen

In de CRM:

1. Ga naar Sites → Forms → Submissions
2. Filter op External Form Name
3. Inzendingen verschijnen met een tag: external form: {form_name}

Stap 5: Workflow triggers

Je kunt acties automatiseren op basis van:

• Page View Trigger: Wordt getriggerd wanneer een bezoeker een pagina bekijkt met het tracking script, zelfs als deze anoniem is. Anonieme activiteit wordt opgeslagen en later gekoppeld aan het contact wanneer ze een Voluit Suite formulier indienen.
• Form Submission Trigger: Wordt getriggerd wanneer een compatibel formulier wordt ingediend.

Beschikbare filters:

• Domein
• Paginapad
• Externe formuliernaam
• UTM parameters (Campaign, Source, Medium, etc.)

Geavanceerde probleemoplossing

1. Debug modus inschakelen

Voeg data-debug="true" toe aan je script:

<script
src="<https://link.jouwdomein.nl/js/external-tracking.js>"
data-tracking-id="tk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
data-debug="true"&gt;
&lt;/script&gt;

Open dan DevTools → Console en check op [LC Tracking] logs.

2. Netwerk checks

• Zoek naar succesvolle 2xx responses.
• Zorg dat er geen CORS errors verschijnen.

3. Cookie verificatie

• Ga naar Application → Cookies
• Bevestig dat er een sessie cookie is aangemaakt. Als deze ontbreekt → browser privacy of third-party restricties blokkeren deze mogelijk.

4. Veelvoorkomende problemen

Voorbeeld volledig formulier

<formname="signup">
<label>Email</label>
<inputtype="email"name="email"required/>
<label>Voornaam</label>
<inputtype="text"name="first_name"/>
<buttontype="submit">Verzenden</button>
</form>

Platform-specifieke installatie

WordPress

1. Kopieer de tracking code.
2. Ga naar Appearance → Theme Editor → Footer (of gebruik de Insert Headers and Footers plugin).
3. Plak voor de </body> tag.
4. Sla de wijzigingen op.

Vermijd page builders of plugins die formulieren vervangen door <div> widgets.

Belangrijk voor WordPress gebruikers

Veel WordPress page builders en plugins gebruiken non-form elementen (zoals <div> containers of JavaScript-gebaseerde widgets) in plaats van echte <form> tags. Die formulieren zijn niet compatibel met het tracking script voor het tracken van inzendingen.

Als je formulieren geen echte <form> tags gebruiken:

• Paginaweergave tracking werkt nog steeds, maar
• Formulierinzendingen worden niet gesynchroniseerd naar je CRM.

Om compatibiliteit te garanderen:

• Gebruik plugins die valide HTML formulieren uitvoeren (bijvoorbeeld WPForms, Gravity Forms of Contact Form 7).
• Bevestig dat het formulier <form> en <input type="email"> elementen bevat.
• Vermijd formulieren in iframes of popups.

Wix

1. Ga naar Settings → Advanced → Custom Code → + Add Custom Code
2. Plak je script
3. Stel in op All Pages → Load code on each new page → Place in Body (end)
4. Pas toe en publiceer.

Squarespace

1. Ga naar Settings → Advanced → Code Injection
2. Plak het script in het Header of Footer veld
3. Sla op en publiceer.

Shopify

1. In Shopify Admin → Online Store → Themes → Edit Code
2. Open theme.liquid
3. Plak de code voor </body>
4. Sla op.

HubSpot

1. Ga naar Settings → Website → Pages → Templates of Site Footer HTML
2. Plak je script voor </body>
3. Sla op en publiceer.

Drupal

1. Ga naar Structure → Blocks → Add Block
2. Plak je script in de block body
3. Sla op.

Magento

Volg Magento's Design Guide voor het toevoegen van third-party JavaScript in de Header of Footer HTML.

Joomla

1. Ga naar Extensions → Templates → Templates → index.php
2. Plak voor </body>
3. Sla op.

Veelgestelde vragen

V: Kan ik tracking activiteit zien in contactrecords? Niet tenzij een formulier wordt ingediend en het contact wordt aangemaakt.

V: Waarom worden mijn externe formulieren niet getrackt? Momenteel worden alleen Voluit Suite geëmbedde formulieren ondersteund voor tracking. Externe custom of third-party formulieren worden nog niet vastgelegd.

V: Verwerkt dit analytics of attribution reporting? Ja, getrackte data verschijnt in het Attribution Report, niet in contact timelines of analytics dashboards.

V: Kan ik Google Tag Manager gebruiken? Dat kan, maar alleen als het data-tracking-id attribuut behouden blijft. Directe installatie wordt aanbevolen.