Formulierdata onderscheppen en naar Copernica sturen

Webtrackers kunnen formulieren op je website onderscheppen. Dit is handig als je al een website hebt waar formulieren op staan (zoals contactformulieren of bestelformulieren) en je deze informatie óók naar Copernica wil sturen. Met een paar kleine aanpassingen aan de HTML code van het formulier zorg je er voor dat het formulier voortaan ook naar Copernica wordt gestuurd als het door iemand wordt ingevuld. In Copernica kun je vervolgens een opvolgactie maken om bijvoorbeeld automatisch een profiel aan te maken of bij te werken, of om een bevestigingsmail te versturen.

Extra attributen

Om je formulierdata te onderscheppen en naar Copernica te sturen, voeg je het het attribuut copernica-intercept toe aan de <form>-tag van je formulier. In de broncode van je website moet je voor elk relevant formulier deze tag opzoeken, en het attribuut toevoegen. De waarde van het formulier bepaalt wat voor soort acties je wilt onderscheppen (dit is eigenlijk altijd de waarde submit), en wat voor soort opvolgacties je in Copernica wilt activeren (dit is vaak email-subscribe).

<form copernica-intercept="submit:email-subscribe">
    // hier staan de formuliervelden
</form>

Alle opvolgacties die in hun startbox naar het "email-subscribe"-event luisteren, die worden geactiveerd zodra het profiel wordt ingevuld. Je kunt natuurlijk ook andere events gebruiken.

Verplichte velden

Alle velden van het formulier worden doorgestuurd naar Copernica, en kun je dus in de opvolgactie gebruiken. Sommige events hebben echter een aantal verplichte velden, zo is voor het email-subscribe event het veld email verplicht. In je formulier moet dus een veld met de naam "email" zitten. Is dat niet het geval, dan is het onmogelijk om de bijbehorende opvolgacties uit te voeren. Als er wel een e-mailveld in het formulier staat, maar dat veld heeft toevallig een andere naam, dan moet je de naam van het veld veranderen. Als dat niet mogelijk is, omdat bijvoorbeeld je backend niet meer werkt, dan kun je ook aan copernica-name attribuut toevoegen om de veldnaam te overrulen:

<form copernica-intercept="submit:email-subscribe">
  <input type="email" name="emailaddress" copernica-name="email" required placeholder="Jouw e-mailadres">
  <input name="firstname" placeholder="Jouw voornaam">
  <input name="lastname" placeholder="Jouw achternaam">
  <button type="submit">Inschrijven</button>
</form>

In dit voorbeeld:

• Wordt een email-subscribe event verstuurd naar Copernica bij het verzenden van het formulier.
• Zit er geen veld "email" in het formulier (terwijl dat wel nodig is voor email-subscribe events).
• Wordt het veld "emailaddress" gekoppeld aan "email" met het copernica-name attribuut, zodat Copernica het veld toch herkent.
• En worden extra velden zoals "firstname" en "lastname" meegestuurd.

Gebruik in opvolgacties

De gegevens die je vanuit het formulier doorstuurt, kun je in de opvolgactie-editor gebruiken. Verplichte velden, zoals email in het email-subscribe event, zijn direct beschikbaar via {$trigger.email}. De naam van het veld is dus een rechtstreekse eigenschap van de {$trigger}-variabele.

Andere velden die met het formulier worden meegestuurd, maar niet verplicht zijn voor het event, kunnen worden opgehaald via {$trigger.attributes.veldnaam}. Dit is nodig omdat de {$trigger}-variabele van zichzelf al bepaalde eigenschappen bevat, zoals {$trigger.ip} en {$trigger.timestamp}. Als een formulier een veld met dezelfde naam zou bevatten, kan dit een conflict veroorzaken. Voor niet-verplichte velden gebruik je daarom:

• {$trigger.attributes.firstname} voor het veld "voornaam".
• {$trigger.attributes.lastname} voor het veld "achternaam".
• Enzovoort.

Overige aandachtspunten

Als je een bepaald event koppelt aan een formulier, dan moet de webtracker wel over voldoende privileges beschikken om dit event te triggeren. In de Marketing Suite kun je bij de configuratie van de webtracker invoeren welke events zijn toegestaan. Zorg er voor dat het door jou gekozen event, zoals email-subscribe, ook wordt ondersteund.

Om formulieren te onderscheppen, installeert de webtracker wat extra event-handlers op het formulier. Het kan gebeuren dat dit conflicteert met de javascript-code van je eigen website. In dat geval kun je het copernica-intercept attribuut niet gebruiken, en zul je op een andere manier de data naar Copernica moeten sturen. Dit kan bijvoorbeeld door zelf een javascript te schrijven en de copernica.trigger()-functie aan te roepen, of door vanuit je backend een call naar de Copernica REST API te doen.