Survey connector connects Acoustic Campaign with best-of-breed survey tools, including SurveyMonkey, Alchemer (formerly SurveyGizmo), Qualtrics, or Typeform. You can configure surveys to pass responses to a Campaign database and relational table. Optionally, you can get an added level of behavior survey data passed to the Acoustic Campaign through Acoustic Exchange.

You can perform the following tasks:

• Monitor a survey.
• Map survey questions to Campaign.
• Add a survey link to an email, a mobile app message, or an SMS message.
• View survey responses and segment contacts based on participation and responses
• Map behavior data into Exchange

The survey connector is accessible in the applications menu. 

How it works

1. In the survey connector, you will use Campaign and a supported survey account to complete the connection. You can use a SurveyMonkey, Alchemer, Qualtrics, or Typeform account. Optionally, you can connect the survey connector to Acoustic Exchange.
2. Then, you will use a survey connector to map survey responses to your Campaign database fields and generate a trackable survey link that can be distributed via Campaign channels, such as email, SMS, and mobile app messages.
3. Finally, in Campaign, you can augment contact profiles and segment contacts who were sent a survey.

Link survey connector

Your Campaign organization administrator must complete a one-time setup to successfully link the survey connector to Campaign, your survey vendor, and Acoustic Exchange accounts.

Before you begin, ensure that these applications are active and you have all relevant login credentials.

• Acoustic Campaign
  • Update database fields,
  • Create a relational table (survey connector responses),
  • Add universal behaviors.
• Survey account users can integrate their surveys with a survey connector to pass responses to the Campaign.
• Acoustic Exchange account users can query behaviors from your survey vendor.

Ensure you have the appropriate license for the survey tools you'd like to connect. 

• SurveyMonkey users must have an active Team Premier account or higher.
• Alchemer users must have an active Professional or Full access account.
• Qualtrics users must have an account with API access enabled. Contact your Qualtrics representative to ensure this is enabled.
• Typeform users must have an active Professional or Premium account.

Set-up survey connector

Connect Acoustic Campaign to Survey Connector.

The Acoustic Campaign organization administrator obtains a refresh token for the survey connector application. The refresh token uses a secure oAuth integration to connect your survey vendor with Campaign.

1. Log in to Campaign an organization administrator.
2. Go to Settings > Administration > Organization Settings > Application Account Access.
3. Click Add Account Access.
4. Select the Survey Connector application.
   
5. Select the user account that communicates with Campaign from the survey connector.
6. Add a description. Adding a description is optional but preferred if multiple Campaign org admins use the system and need to know why the user has the specified access.
7. The Campaign generates an email and sends the notification email address of the user selected. The email contains the refresh token you will paste into the survey connector.
8. The next step is to connect your survey vendor to the survey connector.

If access is already set for the application and Campaign user, but you cannot locate the original email with the token, then select the user and click Revoke Account Access. Proceed to generate a new token by clicking Add Account Access.

Connect your survey vendor to the survey connector

If you don't already have a survey vendor account, you can sign up for a Typeform, Qualtrics, SurveyMonkey, or Alchemer (formerly known as SurveyGizmo) account.

Sign up for an account

Typeform

In the survey connector, you can sign up for a Professional or Premium Typeform account by using the Create a Typeform Account button. This task applies only to users who do not have a Professional or Premium Typeform Account.

In Typeform, go to Plans & Pricing https://www.typeform.com/pricing/ or click the Create a Typeform Account button in the survey connector.

Qualtrics

In Qualtrics, you can sign up for an account with API Access by using the Create a Qualtrics Account button. This task applies only to users who do not have an API access Qualtrics account.

In Qualtrics go to Contact Sales https://www.qualtrics.com/contact/ or click the Create a Qualtrics Account button in the survey connector.

SurveyMonkey

In survey connector, you can sign up for a Team Premier or higher SurveyMonkey account by using the SurveyMonkey Account button. This task applies only to users who do not have an Advantage or Premier SurveyMonkey account.

In SurveyMonkey go to Plans & Pricing, https://www.surveymonkey.com/pricing/, or click the Create a SurveyMonkey Account button in the survey connector.

Alchemer

In the survey connector, you can sign up for a Professional or Full Access Alchemer account by using the Create an Alchemer Account button. This task applies only to users who do not have a Professional or Full Access account.

In Alchemer go to Plans & Pricing https://www.alchemer.com/plans-pricing/or click the Alchemer Account button in the survey connector.

Connect your account

A Campaign organization administrator can complete the following steps to authorize a survey account in the survey connector.

Typeform

On the Connect Survey Vendor page, click Connect Account. If prompted, log in to your Typeform Account. On the Authorize app page, review the app permissions. Select the I'm not a robot check box and Authorize.

You must verify authorization. You will see a green check next to the Typeform logo. Click Next Step.

Qualtrics

On the Connect Survey Vendor page, click Connect Account. If prompted, log in to your Qualtrics Account. Your Qualtrics Account must have Brand Admin permissions to successfully sync survey data. On the Authorize app page, review the app permissions. Select the I'm not a robot check box and Authorize.

You must verify authorization. You will see a green check next to the Qualtrics logo. Click Next Step.

SurveyMonkey

On the Connect Survey Vendor page, click Connect Account. If prompted, log in to your SurveyMonkey Account. On the Authorize app page, review the app permissions. Select the I'm not a robot check box and Authorize.

You must verify authorization. You will see a green check next to the SurveyMonkey logo. Click Next Step.

Alchemer

On the Connect Survey Vendor page, click Connect Account. Then, in the drop-down, select the data center location for your existing Alchemer Account. Once selected, you can click Authorize Alchemer. If prompted, log in to your Alchemer Account. On the Authorize app page, review the app permissions. Select the I'm not a robot check box and Authorize.

You must verify authorization. You will see a green check next to the Alchemer logo. Click Next Step.

Now you're ready to connect your Acoustic Exchange account.

Connect Acoustic Exchange to survey connector (optional)

After you have connected your survey vendor account, you'll want to register a new survey connector endpoint in your Acoustic Exchange account.

First, paste the survey tool token from the Campaign survey connector into the survey connector endpoint in your Acoustic Exchange account.

Next, complete the following steps to connect an existing Acoustic Exchange account:

1. Copy the Survey tool token in Acoustic Campaign's survey connector's setup.
2. Log into your Acoustic Exchange.
3. Click Endpoint to open the Endpoints.
4. Click Register New Endpoint.
5. In Register an Endpoint, click Acoustic Survey Connector and then click Next.
6. In Endpoint Registration:
7. Select Production (to link your production pod) in the Deployment list.
8. Paste the Survey Tool Token (see step 1.)
9. Click Next.
10. After you receive a confirmation in Acoustic Exchange that the endpoint is Active, return to survey connector's Acoustic Exchange Setup page and click Finish.

Decide what to connect

Acoustic Campaign and Survey	Acoustic Campaign/Survey/Acoustic Exchange
Populate database fields with survey responses	Populate database fields with survey responses
Update relational tables with survey data	Update relational tables with survey data
	Obtain behavioral information for use in queries

Applications

These applications are used to set up survey connector. Before you begin, ensure that the applications are active and you have all relevant login credentials.

• Campaign: Update database fields and add universal behaviors.
• Survey vendor users can integrate their surveys with survey connector to pass responses to the Campaign.
• Acoustic Exchange account users can query behaviors from your survey tool.

Map survey questions to Campaign database fields

When you create a survey, it's essential to map your survey questions to database fields in Campaign. This way, when you set up a survey, contacts' responses will be tied to their content records, and you'll be able to use these responses to segment data, personalize content, create dynamic content, and more.

In Campaign, set up your database to map the survey questions to fields: 

1. Click the Configure icon to open the Configure Survey page.
2. In the Select Database list, select a database from a list of shared databases in your Campaign.
3. Check the box to store all responses in a relational table.
4. In Field Mappings, map each question to Campaign. You can only map one database field per question.
5. In Select Field Name, begin typing a database field name and select a database field.
6. Click Save Mappings.

Add a survey link to your message

After mapping the Campaign database fields, it's easy to copy the survey connector web link and paste it into your messages. The survey connector link includes parameters (recipient_id) identifying the contact in the Campaign database.

First, go to the survey list page and follow these steps: 

1. Click the Survey Link icon in the monitored survey's Actions column. The Survey Link pop-up opens.
2. Click the paste icon to copy the survey link.

Next, navigate to your message and follow these steps: 

Email

In Campaign, paste the link into a new or existing email template.

After you send your email, contacts who complete the survey will have their responses stored in your survey vendor and Campaign.

Mobile app message

In Campaign, open a new or existing mobile app message draft and paste the link into the Notification Message.

After you send your message, contacts who complete the survey will have their responses stored in your survey vendor. and in Campaign.

SMS Message

In Campaign, open a new or existing SMS message draft and then paste the link into the Enter SMS Message If you're set up to use Bitly to track links, you can select the option Track links using Bitly URL shortener. Parameters that identify the contact, such as the recipient ID, are included inside the shortened URL.

After you send your message, contacts who complete the survey will have their responses stored in your selected survey vendor and Campaign.

Key tasks

How do I...	Go to...
Authorize my account	Authorizing an existing survey vendor account
Get a Survey vendor account	Signing up for a survey vendor account
Connect Acoustic Exchange to survey connector	Connect an existing Acoustic Exchange account to Survey Connector
Subscribe to survey Acoustic Exchange events	Subscribing to Acoustic Campaign survey events
Add link(s) to the Campaign email, SMS messages, or mobile app messages	Adding a survey link to an email Adding a survey link to a mobile app message Adding a survey link to an SMS message
Map survey questions to the Campaign database fields	Mapping survey questions to Acoustic Campaign database fields
Segment survey contacts in the Campaign	Segmenting survey contacts in Acoustic Campaign