Event Maps

Event Stream is a platform service used by Marigold applications and microservices to exchange event data with one another in real time. Event Stream broadcasts new events to other Marigold products that subscribed to the type of event.

Engage+ streams campaign related events,some of which are readily available out-of-box to use and others must be configured. Event Stream categorizes types of events into a consistent schema. This provides all Marigold apps with context for what the event is, and makes it easier to determine data for further processing.

Events are categorized by Event Types. An Event Type is a way of grouping all similar events (e.g. a purchase), and Engage+ Event Stream has a list of pre-defined Event Types. Event Maps are used to trigger events when data is added or updated in Engage+. Multiple triggers can be mapped to an Event Type using different Event Maps, for instance, when there are multiple online stores, multiple triggers can be mapped for a Purchase Event.

Note: Event Map is not enabled by default. If you would like this feature enabled on your account, contact your Marigold representative, so they can configure access and set up relevant Event schema and Event Types.

The Event Map screen is accessible by selecting Data > Integration  Event  Maps From the main menu.

Create a New Event Map

To create an Event Map:

  1. Above the list of existing Event maps, click + New Event Map button. The Create New Event Map pop-up window is displayed.

  2. Enter the following details:

    • Name: Your unique name for the Event Map

    • Data Source: The data source or table you wish to use. For more information see Tables.

    • Event Schema: Select the event schema corresponding to the Event map being created. The schemas that are available are: Ecommerce, Lifecycle and Profile.

    • Event Type: Select the event type you wish to use. You can select from the list of Event types configured for your account. The options available depend on the schema selected above.

    • Trigger Type: Select from the options: Regular one-time, Event triggered or Date triggered, to define how the Event map is triggered to send data.. For more information on how the mechanism works, see Campaign Types.

  3. Select Create. An Event Map is created and opened as a new tab.

Once the Event map is created, you can configure and mapping the schema attributes as explained in the following section.

Event map setup: Define audience filter and triggers as described here.

Event map data: Define the mapping between schema attributes and data sources as described here.

Event map review: Define the scheduling option as described here.

Event map status: After you have published your Event map as per the instructions below, you can view the Event map status as described here.

Event map Management

Publish Event map

After you've created the Event Map, you must publish it to make it live. Select More Actions > Publishto publish your Event map.

Note: All the mandatory attributes must be mapped for publishing.

The Event Map mode will be updated to “Published”. In “Published“ mode, you can only Save As, Suspend and Delete an Event Map.  

Copy an Event Map

To copy an existing map to use as the basis for a new map:

  1. Open the desired Event map from the Event Map screen. .

  2. Select More Actions > Copy Event Map .

  3. In the displayed Copy Event Map popup window, enter the name for the new map and select the desired location.

  4. Click Copy. The new Event map is opened in a new tab.

Delete an Event Map

To delete an existing map:

  1. Open the desired Event map from the Event Map screen. .

  2. Select More Actions > Delete Event Map .

  3. In the displayed confirmation dialog click Delete.