Link Builder
Last updated
Last updated
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:
You can use the text= parameter to capture free text responses.
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.
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.
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.
You can use preview_mode=true if you want to test draft surveys. //survey.pulseinsights.com/q/1665/a/9163?identifier=PI-81960852&preview_mode=true
Note: Expired or Paused surveys won’t be able to collect data via API and will show an error message if attempted.
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.
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.
