Manage events
The Emarsys Add-on features two event types:
- Preconfigured events: ready-to-use events for standard integration use cases.
- Custom events: freely configurable events for all kinds of customer engagement use cases.
Preconfigured events
Preconfigured events are based on the SCAYLE webhook system. If a webhook is received the Add-on proxies this event to Emarsys to create or update a contact or an external Emarsys event. When you click on More, some of the events allow for adjustments of the field mappings between SCAYLE and Emarsys. Here you can find a list of preconfigured events:
| Event | Description |
|---|---|
| Sign-up Event | Create customer after sign-up in SCAYLE as contacts in Emarsys |
| Customer Deletion Event | Automatically delete customers in Emarsys, when they are deleted or anonymized in SCAYLE |
| Login-in Event | Creates an external event in Emarsys, if a customer logs via the Checkout frontend |
| Purchase Event | Creates an external event in Emarsys, if customer order is confirmed in SCAYLE |
Custom events
Custom events can be used to add contacts to an automated program or trigger mobile or email campaigns in Emarsys. All custom events configured in the Add-on create corresponding external Emarsys events. The trigger for a custom event can be a supported SCAYLE webhook or a POST request sent to the Add-on's custom events endpoint.
The JSON structure for a custom event send the to Add-on's endpoint can be freely defined in the Add-on UI.
Configure a custom event
- Go to
Add-Ons > Emarsys Add-On > Events. - Click on New Custom Event
- Enter a Name for the custom event
- Optionally: Enter a Description
- Select SCAYLE Event for the Event Type
- Choose a supported webhook from the dropdown as event trigger
- Select the option Generic for the Event Id
- Enter the Emarsys External Event ID
- Click SAVE.\
Create Custom Event
External events in Emarsys need to be send with an event Id. If you want to set up different automation flows for different shop countries, the Add-on provides the option to create a shop specific mapping between country shops and external Emarsys event Ids.
