Using the SurveyGizmo Salesforce Marketing Cloud Integration you can pull information from and push information to Salesforce Marketing Cloud.
Set Up the Salesforce Marketing Cloud Integration
1. Make sure API access is enabled in your Marketing Cloud account first. If you don't know if it's enabled, it probably isn't. Call Salesforce Marketing Cloud and ask the fine folks there to please enable it.
2. From Account > Integrations > 3rd Party Integrations, click Configure next to the Salesforce Marketing Cloud integration. Input your Marketing Cloud username and password to link your account. Once you're done, click Save.
Enterprise 2.0 Account Setup
If you have a Salesforce Marketing Cloud Enterprise 2.0 account, go to the Preferences tab and select Yes in the E2.0Account dropdown.
Note: If you do not have a Salesforce Marketing Cloud Enterprise 2.0 account, please do not attempt to set up your SurveyGizmo Plugins as an ET2.0 account, it will cause your push and pull actions to freeze up. Do not add the ET2.0 flag until you are certain that your SF Marketing Cloud account has that functionality.
Check out the E2.0 section below to learn more!
If you need to link another account, follow the same steps. If you have more than one account linked, we recommend utilizing the Account Label field so you can easily differentiate between accounts.
Action Modes: Push and Pull
Once you have linked your account, you can go back to the Build tab and click Add New Action on the page where you need your Marketing Cloud action. There are two action modes available: Pull or Push.
The Pull action allows you to pull subscribers from SF Marketing Cloud and populate survey questions from attributes in your Marketing Cloud account.
The Push action allows you to add and/or update subscribers and/or data extensions and set custom attributes.
Pull Example 1: Format a Salesforce Marketing Cloud Email to Pass Info to SurveyGizmo
In order to tell SurveyGizmo how to get information from your Marketing Cloud account, you need to pass the Marketing Cloud subscriber's email address. Specifically, we need to create a link to the SurveyGizmo survey that includes a URL parameter, then merge in the personalization code from SF Marketing Cloud.
The screen shot below comes from the Marketing Cloud email editor. Notice the orange highlight?
That's where we:
- created a URL parameter called etemail and
- specified that the SF Marketing Cloud Email Address should be merged in using the merge code %%emailaddr%%
When the recipient clicks on this URL, they are essentially telling SurveyGizmo "I received this message from SF Marketing Cloud and my email address is _________." You can use any parameter name, but they must match in both SF Marketing Cloud and SurveyGizmo, which we'll show you next).
Pull Example 2: Lookup Info in Your SF Marketing Cloud Email List
Now that we've passed the email address via a link, we can turn to SurveyGizmo's SF Marketing Cloud Pull action to fill in survey data from the SF Marketing Cloud database.
1. Click Add New Action, select SF Marketing Cloud - Pull, then give it a name like "ExactTarget subscriber lookup" and click Add and Edit Action.
2. Select your SF Marketing Cloud Account and indicate you'd like to Populate from Subscriber Attributes.
3. Now, input the URL parameter that contains the SF Marketing Cloud Email Address, which we specified in the example above. We named the parameter etemail. You can use any parameter name, but they must match in both SF Marketing Cloud and SurveyGizmo.
NOTE: Make sure you put the lookup before any survey questions that will use the data. Otherwise, the SF Marketing Cloud data will not be available when rendering the questions.
Push Example 1: Push Info from SurveyGizmo to Salesforce Marketing Cloud
1. Click Add New Action in the survey builder, give it a name, then choose SF Marketing Cloud - Push. Click Add Action and Edit.
NOTE: Because a form submission is necessary to initiate the call to ExactTarget's API, this type of Trigger only works on the second page or later.
2. The goal is to add a survey respondent to an ExactTarget list, so we need to specify which list the subscriber should belong to, and the question that captures their email address.
3. (Optional) You can select an ExactTarget email to trigger using the Triggered Send option. To learn more about the ExactTarget Triggered Sends, please visit ExactTarget Triggered Email.
5. (Optional) In the Set Subscriber Status you can choose from Active, Unsubscribe from this list only or Unsubscribe from all lists. If you do not wish to change the subscriber's status leave it set to Do not change.
6. (Optional) You can also populate the subscriber's profile with other data collected in the survey by matching questions from SurveyGizmo to ExactTarget Attributes:
Enterprise 2.0 Push Actions
If you have an Enterprise 2.0 account make sure it is set up properly, go back to your survey.
1. Create a new, or edit an existing SF Marketing Cloud action.
2. Select the account that has E2.0 enabled.
3. Select the appropriate Business Unit you'd like to update from and continue on as normal!
Troubleshooting
Is your action not working? Below are the most sources of this trouble.
- API access is not turned on in your Salesforce Marketing Cloud account.
- Your Salesforce Marketing Account does not have Read/Write API access.
- The WSDL / E2.0 account / Subscriber Key settings are wrong.
- Your Salesforce Marketing Cloud account is using the Restrict Logins by IP Address (IP Whitelisting). If so, reach out to us for the IP that must be whitelisted to use this integration. Learn more.
Admin
— Bri Hillmer on 12/04/2015
@Alia: I'm not sure how I missed this. I'll look into updating our documentation with details on how to push to data extensions! In the meantime, I recommend reaching out to our support team with questions as you set up your push to data extension.
My apologies for the oversight!
Bri
Documentation Coordinator/Survey Sorceress
SurveyGizmo Customer Support
— Alia.formoy on 12/04/2015
@Bri: I can't find any info on the help pages about specifically setting up a successful Push action to a data extension as all the examples are either about pull from a data extension or a push to subscriber attributes/lists.
Also, what happens if the push action isn't passing any data through to a the data extension?
Thanks,
Alia
Admin
— Bri Hillmer on 07/14/2015
@David: Thanks for taking a look at our documentation! Data Extensions are covered in this tutorial at the very bottom:
http://help.surveygizmo.com/help/article/link/exacttarget#data-extensions
That said, they're a tricky thing to document as there's a ton of variation in how they are set up. If you need some assistance jump on a chat with one of our support heroes to get this up and running!
Bri
Documentation Coordinator/Survey Sorceress
SurveyGizmo Customer Support
— David Cox on 07/13/2015
Hi Bri,
I have been trying to set up an ExactTarget Push Action that utilizes Data Extensions. I feel both the above instructions as well as the tutorial videos don't show anything to do with specifically pushing to a Data Extension and all of the setup revolving around that. In case i missed it somewhere, could you point me in the right direction for this specific need?
Thank you!
- David
Admin
— Bri Hillmer on 05/11/2015
@Edescamps1: Thanks for taking a look at our documentation and videos! Here is the push action video you are looking for:
http://help.surveygizmo.com/help/article/link/video-exacttarget-add-a-push-action
Bri
Documentation Coordinator/Survey Sorceress
SurveyGizmo Customer Support
— Edescamps1 on 05/11/2015
Next video about the push action ? Thanks !