Events | custom
Het custom event is een flexibel event dat je zelf kunt triggeren via de REST API of de SDK.
In tegenstelling tot standaard events heeft het custom-event geen vooraf gedefinieerde betekenis. Je bepaalt zelf waarvoor je dit event wilt gebruiken. Dit maakt het bijzonder geschikt voor het triggeren van gebeurtenissen die niet standaard worden ondersteund door Copernica. Het event wordt zowel in de logbestanden opgeslagen als gebruikt om opvolgacties uit te voeren.
Let op: als je het custom event wilt triggeren met de copernica.trigger() functie
van de webtracker SDK, moet je het event eerst activeren in de website tracker. Zie
copernica.trigger() voor meer uitleg.
Parameters
Dit event beschikt over de volgende standaardparameters:
| Sleutel | Verwachte waarde | Voorbeeld | Vereist |
|---|---|---|---|
| subtype | het door de gebruiker bedoelde event | mijn-custom-event | ja |
Deze parameter is direct beschikbaar via de {$event}-variabelen in
opvolgacties en mailings, onder: {$event.subtype}.
Naast de vereiste parameters ben je vrij om andere parameters mee te geven die je vervolgens kunt gebruiken in jouw opvolgacties in de 'attributes'-eigenschap.
Voorbeeld
In dit voorbeeld gebruiken we het custom event MijnTrigger die je hebt
aangemaakt in de 'Triggers'-tab van de website tracker met onze JavaScript-SDK:
copernica.trigger('custom', {
subtype: 'MijnTrigger',
info: 'meer informatie dat je in je opvolgactie wilt gebruiken',
extra: 'nog wat extra info'
});
In opvolgacties kun je de waarde van de verplichte parameter subtype ophalen
met {$event.subtype} en de waarde van de vrije parameters met
{$event.attributes.info} en {$event.attributes.extra}.