Eigen formulier koppelen

Als je een website tracker op je website hebt geïnstalleerd, kun je deze ook gebruiken om je eigen formulieren te koppelen aan Copernica. Hiermee kun je bijvoorbeeld automatisch een profiel aanmaken of bijwerken, of een bevestigingsmail versturen zodra een bezoeker een formulier invult.

Formulieren koppelen met copernica-intercept

Om je formulier te koppelen aan Copernica, voeg je het attribuut copernica-intercept="submit:EVENT-NAAM" toe aan het <form> element. Dit attribuut zorgt ervoor dat Copernica het formulier onderschept en de ingevulde gegevens verwerkt. Je kunt hierbij verschillende event-namen gebruiken, zoals email-subscribe voor nieuwsbriefinschrijvingen. Een overzicht van alle beschikbare events vind je hier.

Events activeren in de website tracker

Voordat je formulieren kunt koppelen, moet je ervoor zorgen dat de juiste events zijn geactiveerd in de configuratie van je website tracker. Ga hiervoor naar de 'functies'-tab binnen je website tracker en vink de gewenste events aan, zoals email-subscribe. Zonder deze configuratie worden de events niet verwerkt.

Verplichte velden instellen

Elk event binnen Copernica vereist specifieke velden. Voor het email-subscribe event is bijvoorbeeld het veld email verplicht. Dit betekent dat er een invoerveld moet zijn dat als e-mailadres wordt herkend. Als je formulier een input-veld heeft met een andere naam (bijvoorbeeld emailaddress), kun je deze koppelen aan email door het attribuut copernica-name="email" toe te voegen. Hierdoor weet Copernica dat dit veld de vereiste waarde bevat.

Voorbeeld

Hieronder staat een voorbeeldformulier dat gebruikmaakt van deze instellingen:

<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.
• Wordt het veld emailaddress gekoppeld aan email met copernica-name, zodat Copernica het als verplicht veld herkent.
• Kunnen extra velden zoals firstname en lastname worden meegestuurd.

Gebruik in opvolgacties

De gegevens die je via het event doorstuurt, kun je in de opvolgactie-editor gebruiken. Verplichte velden, zoals email in het email-subscribe event, zijn direct beschikbaar via {$trigger.INPUT_NAME}. Bijvoorbeeld:

• {$trigger.emailaddress} voor het opgegeven e-mailadres.

Andere velden die met het formulier worden meegestuurd, maar niet verplicht zijn voor het event, kunnen worden opgehaald via {$trigger.attributes.INPUT_NAME}. Dit is nodig omdat het trigger-event van zichzelf al bepaalde standaardwaarden bevat, zoals {$trigger.ip} en {$trigger.timestamp}. Als een formulier een veld met dezelfde naam bevat, kan dit een conflict veroorzaken.

Voor niet-verplichte velden gebruik je:

• {$trigger.attributes.firstname} voor de voornaam.
• {$trigger.attributes.lastname} voor de achternaam.