Export Responses: field descriptions and request delivery status
Interpret delivery statuses and understand the fields included in exported responses.
This guide can help you to understand the fields included in exports from the Export Responses page, with additional information on the email request delivery statuses.
Field descriptions
Fields in exported responses follow the naming conventions used in the Data Return API and the API status page export.
Field | Description |
---|---|
request_id | Unique feedback request ID |
request_sent_at | UTC timestamp of request creation* |
request_delivery_status | The state of the delivery of the email for this response, typically "Sent" (see below for more information) |
response_received_at | UTC timestamp of response receipt* |
star_rating | 1-5 star response from customer |
comments | Indicates whether the response included comments or not |
reward_name | Name of the reward that was given |
areas_for_improvement | An indication that this particular area of improvement (AOI) was given in response |
additional_question_response | The answer |
ext_interaction_id | Unique ID created for the survey request |
external_url | Unique ID provided from the integrated CRM source |
channel | Indicates the interaction source (phone, email, chat, etc.) |
tags | A collection of categories under which this interaction can be classified (provided via API) |
brand | The brand the respondent experienced for this response |
customer_name | Respondent name configured for the survey |
request_sent_to | Respondent email address configured for the survey |
employee_first_name | Employee first name |
employee_last_name | Employee last name |
employee_email | Employee email address |
employee_custom_id | External (client) identifier for the employee |
employee_status | Employee status of account (Active, Confirmed, or Unconfirmed) |
employee_employment_status | Employment status of the employee (full time or part time) |
employee_start_date | Employee start date (from the user profile) |
team_leader | Name of the team leader or manager associated with this request |
team_leader_email_address | The client-supplied email address of the employees' manager |
team_leader_employee_custom_id | The client-supplied custom ID of the employees' manager |
requested_via | Indicates whether this request was submitted via API or manually through the user interface |
reward_eligible | Indicates whether this response was eligible for a reward grant from the customer or not |
additional_question_eligible | indicates whether the question was seen by the respondent or not |
additional_question_id | Unique ID created for each question |
additional_question_text | The text of the question |
twitter_share_eligible | Indicates whether Twitter sharing was enabled at the time of response submission or not |
twitter_share_initiated | Indicates whether the respondent began a Twitter share after their response or not |
facebook_share_eligible | Indicates whether Facebook sharing was enabled at the time of response submission or not |
facebook_share_initiated | Indicates whether the respondent began a Facebook share after their response or not |
twitter_follow_eligible | Indicates whether Twitter following was enabled at the time of response submission or not |
twitter_follow_initiated | Indicates whether the respondent followed on Twitter after their response or not |
facebook_follow_eligible | Indicates whether Facebook following was enabled at the time of response submission or not |
facebook_follow_initiated | Indicates whether the respondent followed on Facebook after their response or not |
custom_link_eligible | Indicates whether this interaction was eligible to show a custom link to the respondent or not |
custom_link_initiated | Indicates whether the respondent clicked on a custom link or not |
language | Language of the survey (provided via API) |
country | Name of the respondent's country (provided via API) |
areas_of_excellence_selected | Indicates which area of excellence (AOE) was given in the response |
areas_of_excellence_shown | List of areas of excellence shown to the respondent on the survey |
*ISO 8601 format includes date and time in UTC time zone
Request delivery status
The request delivery status is an attribute that provides more clarity around the status of any request. Below are the different statuses that can occur and are visible in an export responses report:
- Not sent: suppression period
- The email was not sent because this customer has already been sent a request within a specified number of days. The number of days is defined in the Suppression period (in days) field on the Company Info page.
- Not sent: do not send flag
- The email was not sent because the API request defined
do_not_send
as true. - Not sent: consumer unsubscribed
- The email was not sent because this email address has been unsubscribed.
- Not sent: rejected
- This email was not sent because we have recently received a bounce message from the address.
- Soft bounce
- The email was sent, but may not have been delivered due to a soft bounce from the receiving email server. There will be an attempt to re-deliver. Soft bounces typically indicate a temporary delivery issue. While there are many reasons an email address may soft bounce, common reasons include:
Mailbox is full (over quota)
Mailbox is not configured correctly
Mailbox is inactive
Recipient email server is down or offline
Recipient email server has been sent too many emails during a period of time
Email message is too large
- Hard bounce
- The email was sent, but may not have been delivered due to a hard bounce from the receiving email server. There will not be an attempt to re-deliver. A hard bounce indicates a permanent reason an email cannot be delivered. In most cases, bounced email addresses are cleaned from your audience automatically and immediately. Cleaned addresses will be excluded from all future campaigns. Here are some common reasons an email may hard bounce:
Recipient email address doesn't exist
Recipient email server has completely blocked delivery
- Sent
- This email has been sent. There is no way to confirm delivery into an actual inbox, but we have not received any indication otherwise from the mail server.
- Sent: unsubscribed
- The email was sent, but has subsequently been unsubscribed via this request.