Exporting session data is an integral feature to a session archive solution. The session data that is exported with Data Export can be used to resolve various problems and help settle disputes with customers.
You must purchase Data Export separately. Upon purchase, the feature is enabled and displayed in the Manage data navigation.
If Data Export is not listed, it means that your organization did not purchase the feature.
The Data Export feature exports data only, it is not an archive solution. Where, why, and how you store exported session data depends on standards and guidelines at your site. For example, for exported sessions you might archive exported session data with IBM® Cloud Object Storage, Amazon Web Service, or your own on-premise storage systems.
- Data Export
- Data export tasks
- Creating a data export task
- Exporting data from an uploaded session list (CSV) file
About Data Export
Data Export is a separately purchasable add-on for creating, managing, and monitoring tasks that export session data to long term storage.
With Data Export you can extract session data, which can then be stored for retrieval later. You can also use Data Export to monitor and manage Session list export tasks.
When using Data Export to export sessions, users with OrgAdmin authorization can select sessions of interest to export based on defined criteria. For example, a user can export customer sessions that include specific types of Events or Session Attributes.
A tool for tracking visitor interactions is provided in the user interface. The tool calculates and tracks million monthly interactions (MMI) data for sessions, which can help you determine the resources that are needed to meet your session export requirements. An OrgAdmin can view and export MMI data for exported sessions from the MMI Report.
To export sessions, a user creates a task that exports sessions to a specified file format (CSV or LTS).
If you choose LTS as the format for the exported session, the output is a PDF file for metadata and electronic signature with an embedded
lts attachment. The metadata contains all the captured data so that you can retrieve the session data exactly as it was seen in .
- A PDF file that includes some metadata and one LTS file attachment.
The LTS contains the following artifacts:
- An archive (TLA) file (customer sessions, images, css)
Formerly known as a Tealeaf Archive file.
- Replay rules
- Log file (if generated)
- An archive (TLA) file (customer sessions, images, css)
If you choose CSV as the format for the exported session, the output is a
dat file (in CSV format). The first row contains the headers and the following rows contain the session data. You can open
dat files with a standard text file editor. Each file contains data from 25 sessions (25 sessions are exported in a batch).
- BulkFacts: Events and Dimensions
- BulkAttributes: Session details
- BulkCookies: Hit cookies
- BulkHeaders: Http headers
- BulkURLs: URLs
Before the selected sessions are archived, the data is compressed to significantly reduce data storage requirements. Sessions that are not marked for export are eventually discarded in accordance with data retention values.
In addition to exporting sessions by task, you can export sessions extemporaneously using the Download Session option from the session search list.
Data export tasks
You can also use Data Export to monitor and manage session list export tasks that can be created from the session search results page. After you create a Data Export task, it runs according to the time and schedule specified. The size limitations can be configured on a customer-by-customer basis. For an LTS export, the allowed maximum session size is 50 MB. The session size is based on the value that is attributed to the
Session size (MB) event, which does not account for static resources. Sessions that are larger than 50 MB are skipped.
You can remain on the interface to monitor the progress of the task. Refresh the page to see progress.
The success or failure of the task is noted in the user interface. If the task fails, you can hover over the Failed icon to get information about what caused it to fail.
- With Data Export, you can create export tasks and track the initiation, progress, and completion of each task.
- With Data Export, you can export sessions to the following file formats:
- .pdf, with embedded .lts attachment
- .dat, which is in .csv format
- Users can retrieve the file that contains the exported session and view the session metadata or use Session Upload to replay the session. Sessions exported in .pdf format are re-playable using the Session Upload feature. Sessions exported in .dat format are not re-playable.
- You can also use Data Export to manage and monitor the session list export tasks that you create from you session search results page.
- You can use Data Export to view and delete session list export tasks that you create from you session search results page.
- As a Data Export administrator, you can export session data from an uploaded session list (CSV file).
Creating a data export task
Expand Manage Data from the navigation and select Data Export. Then, select + New task and complete the configuration steps. You can also create an export task for a session list from the Session Search results page.
- Schedule the task.
- Provide a name and description.
- Activate or deactivate the task.
Activating the task means that the task is triggered automatically at the time that is specified in Run export at.
Deactivating the task means that the task is not triggered automatically. The session export task remains dormant until you activate it manually.
You can activate or deactivate tasks from the Actions menu in the Session Export user interface.
- Specify an output format for the session that you are exporting.
Sessions that are exported in the CSV format are not replayable. If you select CSV as the format, the output for the exported session data is a
.DATfile in .CSV format.
When you select a CSV format, an additional step for configuring the output of the .DAT file is displayed.
If you want users to be able to upload and replay the exported session, select LTS. The output is a .pdf file with an embedded
- Set the time and schedule to run the task.
If you select the session export period retrospectively, the time must be within your purchased retention period for Acoustic Experience Analytics (Tealeaf). For example, if today is November 14 and your organization has 14 days of retention for Acoustic Experience Analytics (Tealeaf), you can select the period that starts November 1.
- Select the application from which you want to export session data.
- Set filters for the export task.
Using the radio buttons, specify the type of data to include or exclude and then further refine your filter.
If you select more than one type of data, the exported sessions meet any of criteria that you selected. For example, you might want to filter by a "purchase" event or by a customized event for a "promo code". If you are filtering by a purchase event, the exported session can be used as record for the returning customer, if that customer disputes the 30-day return policy. For the case of a "promo code", the exported session might be used for returning customers who dispute the promo code.
You can also select Saved searches and apply the existing search conditions from a saved search as a filter for the session export task.
- For CSV format type only: Configure the output of the .DAT file.
Specify which bulk attributes to include your session export by selecting the .DAT file(s).
By selecting only the .DAT file(s) you need, you can reduce the size of the .DAT file, which can lower your Export MMI costs.
If you are exporting BulkEvents.dat, select the events to include.
- Configure notifications by adding email addresses of the users who you want to notify when the task completes.
Exporting data from an uploaded Session list (CSV) file
As a Data Export administrator, you can use Data Export to export data from an uploaded Session list (CSV file).
Use the following procedure to export data from a Session list (CSV file).
- From Data Export, select the Session data tab.
- Click + New task and configure the task.
To export data from a session list, you must select Run once from the Session export options.
If you select CSV as the format, an option to Configure outputs is added to the form.
- Click Next.
- Select the application and click Next.
- From the Filter the data step, select the radio button for Session list.
You can download the CSV file template.
- Browse to the CSV file that you want to upload and select it.
If the file meets the size and format guidelines, it is uploaded.
- Click Next
- Set notifications and click Save.