Link Builder

For situations where you can’t use the Pulse Insights code snippet to render surveys and collect data, you can use the Pulse Insights Survey Response API instead.

Pulse Insights integrates into email by placing clickthrough links that record the appropriate response along with other data such as the recipient’s userID. Then optionally, you can redirect the user to a page of your choice. If the page has a Pulse Insights tag, you can optionally collect additional information or just display a Thank You message that the response has been received.

The easiest way to get links is to create the survey/poll in the Console and then use the Link Builder tab to copy the clickthrough URLs.

While in the survey's Editor or Results page, click on the "Link Builder" tab at the top of the page.

Survey responses are passed in the following format: ‍

//[question ID]/a/[answer ID]?identifier=PI-XXXXXXXX 
For example:

Capturing Free Text Responses

You can use the text= parameter to capture free text responses.

Free Text Example:

Redirecting The User To Another Page Post-Submit

Use the redirect parameter if you want to configure a custom redirect URL. By default, it will redirect to the referrer if there’s any, otherwise, it will just display a thank you message.

Redirect Example:

Note: special characters should be encoded in the redirect so portion of the URL as shown above.

The domain of the redirect URL must be whitelisted. This is configured in the Console's Global Targeting.

To Configure: Click "Settings", then "Global Targeting", scroll to "Redirect Domain Whitelist" and enter the domain(s), 1 per line. Click "Update" to save.

Saving Custom Data with Responses Via API

Any other query string parameter will be saved as custom data within Pulse Insights. This is often used to store things like:

  • The recipients userID so you can tie responses back to an individual

  • Details of the email campaign such as name, campaign date, or whether it’s a test or production email drop.

Custom Data Example:

Testing Surveys In Draft Mode Via API

You can use preview_mode=true if you want to test draft surveys. //

Note: Expired or Paused surveys won’t be able to collect data via API and will show an error message if attempted.

Showing Poll Results From Poll In-Email

If you’re asking a question in-email and want to show the results upon answering, you can append: pi_poll=true to the URL.

This will force Pulse Insights to show poll results for the question.

Note: polls results only work for the first single choice question within a survey.

Pro Tips:

  • If a survey/poll is only intended for email, make sure that the targeting is configured to prevent firing on web or mobile.

  • You can append pi_present=[thank you message ID] in the redirect URL to force a thank you message or follow-up questions to appear on click.

Last updated