Knowledge Center

Knowledge Center > Insights > Developer Reference > Insights File Format Guidelines > Session Record Type Files

Session Record Type Files

When you send session data to Insights as part of a batch upload, you send the session data in a file called a record type file.

The following guidelines apply to session record type files:

  • Include a header row with field labels
  • Include all required fields
  • Fields can appear in any order
  • Include one row per session

Fields in Session Record Type Files

Field Description

Session Timestamp
(required)

The age of the data in the record. All rows should have the same date.

Format: ISO-8601 "standard" (YYYY-MM-DD)
Expected value: any date

External Session ID
(required)
The external ID of the session.
External User ID
(required)
The external ID of the user that the session is associated with.

External Account ID
(required)

The external ID of the account that the session is associated with.

Attributes

Fields containing attribute values for the session.

Format: Text, Numeric, Boolean, Date, or Datetime

For example, you can set the Session Duration attribute.

Examples

The following file illustrates how to prepare a record type file in CSV format. Replace the sample values before uploading the file to Insights.

Sample record type file containing session data

Last modified

Tags

This page has no custom tags.

Classifications

(not set)