Iterate (Actions) Destination
Iterate helps you harness customer insights across your whole business with the world’s leading Customer Insights Manager. Put customer insights at the center of your business with user-friendly research tools that look and feel like your brand. With mobile, website and email surveys that are highly targeted, user-friendly, and on-brand, you can learn directly from your visitors, customers, and users.
Iterate maintains this destination. See Iterate’s documentation or contact support@iteratehq.com with any questions.
Benefits of Iterate (Actions)
Iterate (Actions) provides the following benefits:
- Simple setup - Iterate (Actions) has a streamlined default setup process making it easier to get started in a way that “just works”.
- More control - Actions-based destinations enable you to define the mapping between the data Segment receives from your sources, and the data Segment sends to Iterate.
- Default property mappings - Default mappings from the Segment like userId, userTraits, and more, allow data to be mapped correctly without any setup required.
Getting started
- From the Segment web app, navigate to Connections > Catalog > Destinations.
- Click the Destination Actions category item in the left navigation.
- Search for Iterate (Actions) and select it.
- Click Configure Iterate (Actions).
- Select an existing Source to connect to Iterate (Actions).
- Set your Embed API Key. See Getting your Embed API Key for details.
Destination Settings
Setting | Description |
---|---|
Embed API Key | Required. The Embed API Key for your account. You can find this on your settings pages. |
Available Presets
Iterate Web (Actions) has the following presets:
Preset Name | Trigger | Default Action |
---|---|---|
Track Event | Event type = "track" |
Track Event |
Identify User | Event type = "identify" |
Identify User |
Available Actions
Build your own Mappings. Combine supported triggers with the following Iterate Web-supported actions:
Mapping limits per destination
Individual destination instances have support a maximum of 50 mappings.
Identify User
Sets user identity
Identify User is a Web action. The default Trigger is: type = "identify"
Field | Description |
---|---|
Identity | Type: STRING The user’s identity. |
Traits | Type: OBJECT The Segment traits to be forwarded to Iterate. |
Track Event
Track events
Track Event is a Web action. The default Trigger is: type = "track"
Field | Description |
---|---|
Name* | Type: STRING The name of the event. |
Get your Embed API Key
To get your Embed API Key:
- Log in to Iterate.
- Create a Website survey.
- Click Preview and publish.
- In the ‘Embed your survey script’ section, select the value of the ‘apiKey’ property in the embed code.
Create and configure your Iterate survey
Once the Iterate (Actions) destination is configured, you’re ready to create your survey and display it in response to an event. To create and configure your Iterate survey:
- Log in to your Iterate account.
- Create a new website survey. Learn more about setting up your website survey.
- Add questions to your survey.
- Customize your survey.
- Enable event targeting.
- Click the targeting options tab.
- In the Where the survey is displayed section select In response to an event.
- Enter the name of the event(s) you would like to trigger this survey to be displayed.
- Choose the rest of your your targeting options.
- Test your survey.
- Click Preview and publish.
- Copy the
iterate_preview
parameter from the Test your survey section. - Go to your website and add the
iterate_preview
parameter to the url. - Trigger one of the events you are targeting to get the survey to display.
- Publish your survey.
Associate user data with your survey
You can associate user data with the responses to your survey by using the Segment Identify call. Any data sent in this call associates with that user’s responses to all surveys.
This page was last modified: 14 Dec 2023
Need support?
Questions? Problems? Need more info? Contact Segment Support for assistance!