FAQ: BlueConic Timeline events

BlueConic Timeline FAQ

How are Timeline events created?

Timeline events are not recorded by default. You need to tell BlueConic which types of events to collect and where/how to store them. To add events, you first create a Timeline event type. Contact your BlueConic Customer Success Manager at support@blueconic.com for details.

How do I add events to a profile's Timeline?

In order to add events to a  BlueConic profile's Timeline, you need to first decide what types of events you want to record and define a Timeline event type to record this event. To add product orders, for example, you can use the prebuilt Order Timeline event type by installing the Event type: Order plugin from BlueConic. Contact your Customer Success Manager for details on how to add or create Timeline event types.

Contact your Customer Success Manager for information on working with Timeline events.

How does the default Order Timeline event type work?

BlueConic provides a default Order Timeline event type you can use for importing product orders via the SFTP Connection.

To use this Order event information to enhance your product recommendations, you need to do two things:

  1. In the Order details, you need to store the BlueConic product store ID in a property called "bcStoreId".
  2. The Product IDs in the Order event must exactly match the product IDs in your BlueConic product store. You select the product store name in Step 5 of the order data import via the SFTP Connection.

In addition, keep the following guidelines in mind when creating product recommendations based on the default Order event type:

  • Products need to be present in the product or content store, in order to be recommended.
  • If you add an Order of this event type, and BlueConic matches the product id, BlueConic will add Order events to a profile's timeline.
  • Bought products for this order are added to a profile property that stores products ordered by this profile.
  • Also, product stores and related statistics are updated with new Order events. This additional product data lets you create better personal recommendations, because there is more product information available for the current profile.

Which Timeline event types are available by default?

BlueConic provides several Timeline event types out of the box, which you can use to store customer events in a profile's Timeline. These event types are available by in BlueConic default:

  • Order event type
  • Email delivered event type
  • Email opened event type
  • Email link clicked event type
  • Abandoned basket event type
  • Order refund event type, with three statuses: refund requested, returned, refunded

How can I use Timeline events for data activation in BlueConic?

Timeline events make it possible for you to store customer order data in the BlueConic product store. You can use this information to:

  • Create better, more personal product recommendations.
  • Improve overall product recommendation statistics by using product order data.
  • Use the Python package in AI Workbench to retrieve events along with visitor profile. (Note that you can use the Python package to retrieve but not to store events.)
  • Use the BlueConic REST API to retrieve events.

What are Timeline events in BlueConic?

Timeline events let you store time-based data for a profile, such as product orders, page views, clicks, etc. Events are stored on each profile's Timeline to capture information about timing and sequence of events. 

How can I deduplicate Timeline events?

To prevent duplicate events being added to a timeline, you can set an "externalID" field. It is not possible to add an event with an externalID that already exists.

How does BlueConic handle Timeline event storage and priority?

Events are data points tied to the BlueConic Timeline of a profile, containing for example an order the customer placed. BlueConic comes out of the box with several predefined BlueConic Timeline event types. Events can be HIGH or LOW priority. In a standard BlueConic subscription, there is a maximum number of 250 events per profile allowed. LOW-priority events have a time to live of 30 days. HIGH-priority events are constrained by the total number of events and take precedence over LOW-priority events, which are capped at 50 if there are 200 or more HIGH-priority events. Learn more about priority settings for BlueConic Timeline events.

Is there an extra cost to use Timeline events?

By default, there is currently no extra cost to use Timeline events, but events being stored are added to your BlueConic total data storage. If you have a lot of events to store, you may need to buy more data storage to be able to use Timeline events under your current contract. Contact your Customer Success Manager to discuss your data storage needs.