Using Data About Your Contacts in Invite Messages and Surveys

The data uploaded with your contacts will be stored and available in the Email Campaign Contact Fields to set up logic in your surveys and to use in filtering in your reports. This data will also be available in your Individual Responses and will export with the data collected in your survey.

Email Contact Data In Survey

Using Contact Data in Invite Messages

Any data uploaded along with your contacts' email addresses can be used in your email campaign invite messages. Say, for example, you upload your contacts' first and last names; you can then personalize the greeting of your invite message with this data using a merge code.

Follow these steps to use data about your contacts to personalize your invite messages.

  1. Within your Email Campaign, go to the Campaign Designer and edit the message you wish to customize. The default message text already includes the merge code for first name.

    Default Contact Merge Codes
    Let's imagine we deleted the default text in order to write our own custom message. To add the first name back...
  2. Place your cursor where you wish to insert the contact's fist name and, using the Merge Code dropdown on the editor toolbar, select the merge code with the data you wish to use.

    In the below example, we inserted the merge code for first name in the salutation. This merge code will populate with each contact's first name when they access their unique survey link.

    Insert Merge Code Into Email Message
    For a complete list of fields available for storing data with email campaign contacts and their associated fields check out the merge code reference.

Using Contact Data in Question Text

You may want to use your contact data in your question text. For example, you can display the current contact information and ask the respondent to confirm that the contact information is correct.

Email Contact Information Example

Follow these steps to use data about your contacts in question text.

  1. Simply place your cursor where you would like to insert the contact information and use the Merge Codes dropdown menu.
  2. Select the contact data field you would like to display in the question text from the Merge Codes dropdown.

    In the below example, we inserted the merge codes for all contact information. These merge codes will populate with the specific information for each contact when they access their unique survey link.

    Include Email Data In Survey Content
    For a complete list of fields available for storing data with email campaign contacts and their associated fields check out the merge code reference.

Using Contact Data as Default Answer Text

You can also use your contact data as default text. For example, you can display the current contact information in a Contact Form and ask the respondent to make any necessary changes. 

Pre-Fill Contact Data In Questions

Follow these steps to display contact information as the default answer.

  1. Add a Contact Form question to your survey.
  2. Click the pencil icon next to edit the first subquestion and go to the Layout tab.
  3. Scroll to the Default Answer field.
  4. Click Insert merge code.
  5. Select the contact data field you would like to display and click Insert.

    Use Merge Code For Default Answer

For a complete list of fields available for storing data with email campaign contacts and their associated fields check out the merge code reference.

Using Contact Data in Logic

You can also use your contact data in logic rules. There are all sorts of possibilities for setting up logic using contact data. It is a great opportunity to save asking questions that you already know but need to use in logic conditions.

For example, you may have certain questions that you only ask for a certain department in your organization. Since you already know this information upload it to the Department field in your email campaign or contact management and base logic of this field.

Using the custom fields available within email campaigns and contact management the possibilities are endless! Start saving your respondents time by uploading the data you already have!

As a simple example, let's imagine we are sending out a survey to our existing list of customers contacts. We'll also be sharing a link to the survey on our website to collect contact information from new potential customers. For our existing customers, we set up a question that verifies each respondent's contact information. For new potential customers, this question won't make sense. We can leverage our email campaign contact fields in logic to ensure that this question only displays to respondents for whom we have contact information!

Confirm Contact Data

To set up logic using your contact data follow these steps.

  1. Edit your question and go to the Logic tab.
  2. Select the option to Only show this question based on answers to previous questions or other logic conditions.
  3. Select the contact field you wish to use to set up logic rules.
  4. Next, select the operator and operand to complete the logic conditions. In our example, we chose to display the question only when the email address field "is answered" which means when the field has data.

    Contact Data In Logic

For a complete list of fields available for storing data with email campaign contacts and their associated fields check out the merge code reference.

Using Contact Data in Send Email Actions

If you are using an Email Campaign to distribute your survey and you wish to send an email notification to each respondent it can be a little tricky to figure out how. In this tutorial, we'll cover how to make the email addresses from your Email Campaign available in the Send Email action.

To make the email addresses from your Email Campaign available in the Send Email action, you'll need to set up a Hidden Value within the survey to store them. Follow these steps to do so.

  1. On the first page of the survey, click the Action option and select Hidden Value.
  2. Change the name to "Respondent email address."
  3. Click the Insert Merge Code link below the Populate with the following field.
  4. Select Email under Email Invite Variables in the menu and click Insert.
  5. Click Save Action.

    Contact Data In Hidden Values
    Now this new Hidden Value field "Respondent email address" will be available in the Survey Taker menu of a Send Email action.

    Contact Data In Email Action

Exporting Your Contact Data

Once your responses start rolling in you'll likely want to get a report of your contacts' responses. The easiest way to review this information is to create a CSV/Excel Export and select the option to Include Email Invitation & Contact Fields.

Include Contact Data In Exports


Reference: Available Contact Fields and Their Merge Codes

Below is a list of each email campaign contact field and its corresponding merge code. These merge codes can be used in your email campaign messages as well as throughout the survey to dynamically populate with the unique value for each contact.

For instance, the merge code [contact("first name")] placed in your survey will populate with the contact's first name.

Throughout the survey builder you will notice an option to Insert merge code; use this to reference your contact data in your survey.

Global Contact Fields
 Global Contact Field Merge Codes
Custom Contact Fields
Custom Contact Fields Merge Codes
Email
[contact("email")]
Invite Custom Field 1
[invite("custom 1")]
First Name
[contact("first name")]
Invite Custom Field 2
[invite("custom 2")]
Last Name
[contact("last name")]
Invite Custom Field 3
[invite("custom 3")]
Organization
[contact("organization")]
Invite Custom Field 4
[invite("custom 4")]
Department
[contact("department")]
Invite Custom Field 5
[invite("custom 5")]
Phone (Home)
[contact("home phone")]
Invite Custom Field 6
[invite("custom 6")]
Phone (Fax)
[contact("fax")]
Invite Custom Field 7
[invite("custom 7")]
Phone (Work)
[contact("work phone")]
Invite Custom Field 8
[invite("custom 8")]
Address
[contact("street")]
Invite Custom Field 9
[invite("custom 9")]
Suite/Apt
[contact("suite")]
Invite Custom Field 10
[invite("custom 10")]
City
[contact("city")]


Region
[contact("region")]


Country
[contact("country")]


Postal Code
[contact("postal")]


Job Title
[contact("job title")]


Website
[contact("website")]


Contact Custom Field
[contact("customfieldname")]


Need More Fields?

As you can see there are a number of standard contact fields available as well as 10 custom fields. We recommend against uploading non-contact data into the contact fields.

For example, say you have a customer ID you wish to upload but each of your custom invite fields are already storing other custom invite data. So, since you are not using the Phone (Fax) field you decide to upload the customer ID into this field. This is a BAD idea. First, because this field is a global field so for ALL other surveys where this contact email address has been uploaded this information will display in this field. Second, it can get confusing.

Instead, consider using our Email List feature under the Account menu. One of a number of advantages of the Email List is that you can create as many custom contact fields as you wish.

Creating Merge Codes for Email List Custom Fields

For custom fields set up within Email Lists, you can construct merge codes to capture and use this data in your surveys. 

The basic structure for custom field merge code is: [contact("customfieldname")] where "customfieldname" is replaced with the actual custom field name you created in your contact list. For example, if you have a custom field in your contact list called "customerid" then the corresponding merge code would be [contact("customerid")].


Basic Standard Market Research HR Professional Full Access Reporting
Free Individual Team & Enterprise
Feature Included In