Knowledge Center

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

Event Record Type Files

When you send event data to Insights as part of a batch upload, you send the event data in a record type file that is formatted for event data. The procedure to send event data is the same as the procedure to send user data. See User Attribute and User Metric Record Type Files for the expected format of record type files for user data.

The following general guidelines apply to event record type files:

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

Fields in Event Record Type Files

Field Description

Event Timestamp
(required)

The date and time when the event occurred.

Format: ISO-8601 "standard" (YYYY-MM-DD HH:mm:SS Z)

Event Type
(required)

The name of the event.

External Session ID
(required if using Explicit Sessions)
The external ID of the session that the event occurred in.

External User ID
(required for user events)

The external ID of the user that the event is associated with.

External Account ID
(required)

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

Attributes

Fields containing attribute values for the event.

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

If an attribute is not applicable to an event, use null for the attribute value.

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 event data

Last modified
19:33, 9 Jan 2017

Tags

This page has no custom tags.

Classifications

(not set)