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 |
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). |
|
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.