Delighted Source

Delighted is the fastest and easiest way to gather actionable feedback from your customers. Use the feedback you gather from customers in all of your decision making processes. Send your feedback to your BI and data warehouses automatically.

This is an Event Cloud Source which can not only export data into your Segment warehouse, but they can also federate the exported data into your other enabled Segment Destinations.

This source is maintained by Delighted. For any issues with the source, you may contact their team.

This document was last updated on October 19, 2018. If you notice any gaps, outdated information or simply want to leave some feedback to help us improve our documentation, please let us know!

Getting Started

  1. From your Segment UI’s Sources page click on “Add Source”.
  2. Search for Delighted within the Sources Catalog and confirm by clicking “Connect”.
  3. Give the Source a nickname and follow the setup steps to “Add Source”. The nickname is used as a label for the source in your Segment interface, and Segment creates a related schema name which you query against in your warehouse. The nickname can be anything, but we recommend sticking to something that reflects the source itself and distinguishes amongst your environments (Eg. SourceName_Prod, SourceName_Staging, SourceName_Dev).
  4. Sign in to your Delighted account and visit the Segment destination to connect.
  5. Once you connect with Segment you need to choose which ‘track’ events you’d like to use as triggers for surveys to be sent people. Then you can configure Delighted to send feedback back to Segment by following the next 2 steps.
  6. Enable the “Sync feedback to Segment” option.
  7. Copy the Write Key from your Delighted source within Segment and paste it into the provided box within Delighted

segment-delighted-setup

NOTE: We only send feedback back to Segment on surveys triggered from Segment initially. This ensures all feedback we send to Segment is identified and enriched with Segment information.

Components

Delighted uses our stream Source component to send events to Segment. These events are then available in any Destination that accepts server-side events, including your data warehouse.

Events

Below is a table of events that Delighted sends to Segment. These events will show up as tables in your warehouse, and as regular events in your other Destinations.

Delighted always sends the values received from Segment for the user_id and/or anonymous_id identifiers. All calls sent to Segment from Delighted will include the original value, Delighted never generates these.

Additionally, they also send email and delighted_person_id under context.traits.

Event NameDescription
Survey Question AnsweredA user answered a question on a survey they received.

Event Properties

Below are tables outlining the properties included in the events listed above.

Property NameDescription
survey_idThe Delighted identifier for the survey.
survey_nameThe name of the survey.
survey_typeThe type of the survey. For example, “NPS” or “CES”.
survey_mediumThe medium used for the survey. For example, “Email” or “SMS”.
survey_toolThe name of the survey tool. This will always be “Delighted”.
survey_question_idThe Delighted identifier for the question.
survey_question_nameThe name of the question.
survey_question_textThe exact text shown to the user for this question.
survey_permalinkA permanent URL to view the survey response on Delighted.
survey_tagsAn array of tags added to the survey response in Delighted.
survey_notesAn array of notes added to the survey response in Delighted.
survey_propertiesAn object containing optional data attached to the survey. This will include all properties sent in the triggering “track” call.

Adding destinations

Now that your Source is set up, you can connect it with Destinations.

Log into your downstream tools and check to see that your events are populating and they contains all the properties you expect. If all your events and properties are not showing up, refer to the Destination docs for troubleshooting.

If there are any issues with how the events are arriving to Segment, please contact the Delighted team.

Sending Data To Delighted

The Delighted Source works only when you also connect Delighted as a downstream destination within Segment. With the Delighted Destination, you can send Delighted user and event data, which you can use to trigger surveys. Head on over to our Delighted destination docs.


If you have any questions, or see anywhere we can improve our documentation, please let us know!