Documentation / Product / Integrations / SurveyMonkey

SurveyMonkey: Import User and Survey Data

Import your SurveyMonkey contacts and their survey responses to add this information to your cross-channel user profiles in Lytics.

Integration Details

This integration utilizes SurveyMonkey's APIs to import user data. Once the import is started the job will:

  1. Read Custom contact fields for the account.
  2. Page through contacts in the SurveyMonkey Account and ingest them into the surveymonkey_contacts stream.
  3. After all contacts have been imported, it will page through all surveys. For each survey it will:
    1. Get the survey details to parse the questions and answer options.
    2. Get the responses to the survey.
    3. Parse the survey responses into a more usable form for ingestion into the surveymonkey_responsesstream.

Fields

The following fields are included in the default mapping of the surveymonkey_contacts stream:

Source FieldLytics User FieldDescriptionType
emailemail unique idEmailstring
idsm_id unique idSurveyMonkey IDstring
first_namefirst_nameFirst Namestring
last_namelast_nameLast Namestring
phone_numberphone_numberPhone Numberstring
custom_fieldssm_custom_fieldsSurveyMonkey Custom Fieldsmap[string]string

The following fields are included in the default mapping of the surveymonkey_responses stream:

Source FieldLytics User FieldDescriptionType
metadata.contact.email.valueemail unique idEmailstring
collection_modesm_collection_modeSurveyMonkey Collection Modestring
sm_last_responseTime of Last Survey Responsedate
question_answersm_question_answerSurveyMonkey Question Answermap[string]string
response_statussm_response_statusSurveyMonkey Response Statusstring

Configuration

Follow these steps to set up and configure an import job for SurveyMonkey in the Lytics platform. If you are new to creating jobs in Lytics, see the Jobs Dashboard documentation for more information.

  1. Select SurveyMonkey from the list of providers.
  2. Select the Import User and Survey Data job type from the list.
  3. Select the Authorization you would like to use or create a new one.
  4. Enter a Label to identify this job you are creating in Lytics.
  5. (Optional) Enter a Description for further context on your job.
  6. Complete the configuration steps for your job. survey-monkey-configuration-0521
  7. (Optional) In the Max Survey Age numeric field, enter how many days before Responses Since to look for surveys. Surveys older than Max Survey Age days before Responses Since will not have responses imported.
  8. (Optional) From the Responses Since input, select how far in the past to start importing responses, if left blank everything before Responses To will be imported.
  9. (Optional) From the Responses To input, select how far in the past to stop importing responses, if left blank everything before the import started will be imported. 10.(Optional) In the Survey ID text box, enter a survey ID to import responses to only that survey.
  10. (Optional) Select the Continuous checkbox to keep importing new responses, Responses To will be ignored. The last Import date will be used as Responses Since after the initial import.
  11. (Optional) Toggle Show Advanced Options.
  12. (Optional) From the Import Frequency input, select how often a repeated import should run.
  13. (optional) From the Time of Day input, select time of day to start the import, ignore for hourly imports.
  14. (optional) From the Timezone input, select a timezone for Time of Day.
  15. Click Start Import.