If you are using EventStore/EventStream Legacy (ESL) to export live events and data, we recommend upgrading to EventStore. EventStore is powered by the Tealium Collect tag and offers many benefits over ESL.

In this article:

Table of Contents Placeholder

Why Upgrade from ESL to EventStore?

There are several reasons to switch to EventStore:

  • ESL is deprecated
    The ESL feature is deprecated. This means that there will be no further updates or improvements to it. The ESL tag is no longer be available in the tags marketplace.
  • Ability to create Filtered Event Feeds
    Filtered feeds contain events that matter the most to you. Data from every event feed is compressed in a gzip file and made available for download. This makes it easy to export data from events you select without having to download extraneous data.

    The downloaded JSON file will have a .gz extension as of August 4, 2017. All files downloaded before August 4, 2017 will have the .gzip extension. Learn more about this change here.

  • Cleaner data structure
    Event data collected by EventStore is structured in a flattened JSON format, as opposed to the legacy space-delimited format. The old format combined the data points in your data layer into one long string, which you then had to parse. The new format provides these data points as individual key/value pairs, which allows you to easily view and access the data. The the new structure is better organized and more easily ingested by other Tealium products.
  • More frequent uploads to Tealium's S3 bucket
    Events that you feed to EventStore are uploaded to Tealium's S3 bucket once every hour or when at least 5 MB of compressed files are queued, whichever comes first. ESL only uploads data to the bucket once per day.
  • Compatibility with EventDB
    You cannot feed events directly to EventDB without first sending them to EventStore. The data structure of EventDB is similar to that of the new EventStore. In contrast, the legacy data structure is space-delimited, which is not fit for use with EventDB.

Legacy vs New: At a Glance

EventStore Feature Legacy New
Tag in charge of fetching live events EventStore Tealium Collect
Ability to create and export filtered event feeds
Compatible with EventDB
Frequency of upload to Tealium's S3 bucket Once a day Once per hour
File format available for download log file (*.tgz) compressed (*.gz)
Structure of event data space-delimited (unstructured) flattened JSON (structured)

Upgrading from ESL to EventStore

Use the following steps to upgrade from ESL to EventStore:

  1. Request your account or deployment manager to enable EventStore/EventDB for your account and to provide with the server URL for the tag.
  2. Add and configure the Tealium Collect Tag.
    Once the Tag is up and running, it will start feeding data from your site.
    TiQ_Collect Tag Configuration with server URL example.jpg
  3. Click Delete to delete or disable the tag or delete the legacy EventStore/EventStream tag in the same profile.

    Confirm that the Collect Tag is working properly before you delete or deactivate ESL, as you cannot add the ESL tag back from the tag marketplace.

    When complete, the Current Published Locations should display Unpublished.
  4. Save/Publish the changes to your profile.
  5. Go to the Live Events tab in the matching AudienceStream profile.
  6. Click to open the event feeds of your choice and use the slider to enable EventStore.

    You can select "All Events" or choose only the filtered event feeds that are important to you and your organization.

    Edit Event Feed_Show_EventStore Slider.jpg

Getting the S3 Access Key for EventStore

If you have the access key for ESL, it will not work for EventStore. You must get a new Amazon S3 access key. For additional information, contact your account manager.