Events in Agillic serve two primary purposes. You can track actions with Events and also trigger actions. Each Event has a starting value of 0 (for each recipient).
Each time an Event is activated, the value goes up by one (for the individual recipient). Therefore, you're able to track the number of times an Event takes place and set up actions that trigger after a given number of activations.
Event 'send_coupon' configured to execute a Flow when triggered the first time
In the example above, we've created an Event named 'send_coupon'. We've attached this Event to an external link in an email, directing the recipient to our website. Next, we configured an Event to execute a second Flow. The second time they click the link, the second Flow will not execute because the Event now has a value greater than 1.
By enabling the 'reset' functionality, we can reset the event counter back to 0, after the event was triggered x amount of times.
In the example below, we want to trigger the side effect each time our event 'send_comment' is triggered. Therefore, we have configured it to reset back to 0, the first time it is triggered.
The 'After day(s)' allows us to further customise this, by defining that after being triggered once, it should wait x amount of days before resetting.
An event configured to reset immediately after being triggered once
Events Used For Tracking
Links in outbound communication direct recipients through to Agillic before redirecting them to their final destination. This allows Agillic to track traffic and trigger Actions based on behaviour.
When creating a link, Agillic will generate and attach an Event by default. This Event is typically named 'Event' followed by a space and a timestamp.
A link with no Event at all has no tracking. You may want to either rename the automatically generated Event or create a new Event with a more memorable name.
External Link in an Email with an Event attached for tracking purposes
Reporting on Event Data
You may have noticed that a Condition type 'Event' exists. This allows you to build Target Groups locating recipients who've activated a specific Event.
In the example below, we're looking back at our email send out containing the 'send_coupon' link. As the default value of the Event is zero, we simply have to build a Condition that says: 'Event "send_coupon" is greater than 0'.
Target Group locating all recipients who have activated the Event 'send_coupon' one or more times
Events Used for Triggering Actions
You may have come across Side Effects in the articles All You Need to Know About Steps where they're used as part of Flows. Much like Steps, Events can be configured to update Data Fields or execute flows.
We're creating a double opt-in campaign and have created three Person Data fields for this purpose. This ensures that the recipient must actively confirm their sign-up by clicking the link in the opt-in email. We won't set the Email Permission to true until the address has been confirmed so it's definitely a deliberate sign-up.
- A permission (true/false) field for determining whether the address is confirmed or not.
- A timestamp for saving exactly when the 'confirm my address' button was clicked.
- A timestamp for saving exactly when the 'email permission' was modified.
Event configured to update two Person Data timestamps and a Person Data boolean