This feature is in preview
This feature is in public preview and therefore is available to be used however it may be subject to change.
You must have a CXDP account to access this API
Collate and upload events to Dotdigital from your platforms which can be shown on a contact's Single customer view. The data is also available as an Insight data collection for use in segmentation and personalization.
Events
Each event must be associated with an existing contact within Dotdigital using any contact identifier type you want, including Custom identifiers.
Each event has:
| Field | Description |
|---|---|
| type | The notional type of the event which is displayed on the contact's timeline on the Single customer view. |
| id | A unique ID for the event, for example, a GUID. |
| eventTimestamp | The UTC date and time the event occurred in ISO 8601 format. |
| timelineDetails.summary | If specified, this is the description of the event to be shown in the contact's timeline on the Single customer view. |
| eventData | The actual data for the event as a JSON object. |
Insight data for events
We create a contact-scoped Insight data collection for each event type raised.
The collection name is the event's type, with any non-alphanumeric characters replaced by _ .
For example:
"Holiday booking" becomes "Holiday_booking"
The Insight data collection type is event
The structure of the records in the collection is:
| Field | Data type | Description |
|---|---|---|
| id | string | The unique ID of the event. |
| event | string | The event type. |
| created_date | string | The time and date in UTC ISO-8601 format that the event occurred. |
| event_data | object | The event data. |
You can use these Insight data collections of events in your segment rules and for personalization using Liquid script. Learn more in our Help Centre.