Skip to main content

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

The date and time when the event occurred.

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

Event Type

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

The external ID of the account that the event is associated with. This unique identifier must be present in Zuora Insights as an account-level unique ID attribute (e.g. Zuora Account Number).


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.


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