Dotdigital

Get the most out of Zigpoll and Dotdigital

Step #1: Create your integration

• In Dotdigital, create a dedicated API user. Go to Settings → Access → API users and add a new user: https://developer.dotdigital.com/docs/setting-up-an-api-user. Dotdigital will give the API user its own email address (something like [e-mail]) and you set its password.

Use the API user's email and password — not your normal Dotdigital login. Zigpoll auto-detects your account's region (EU, US or APAC) for you, so there's no endpoint to configure.

• In Zigpoll: Click Settings → Manage Integrations → Enable the Dotdigital Integration

• Paste the API user email and password into the input fields and press save.

Step #2: Pick an address book (optional)

Toggle Auto Subscribe to add respondents to a Dotdigital address book automatically. You can map specific surveys to specific address books, or choose a single address book for All Surveys. Your address books load from your account once your credentials are saved.

Step #3: Collect Your Data

Once Auto Subscribe is enabled and an address book is selected, Zigpoll will create or update a Dotdigital contact in that address book each time a respondent submits a survey (provided we have an email for them — either from a Zigpoll email field, or from your Shopify customer data if you use our Shopify integration).

The following contact data fields are sent on every submission:

• SENTIMENT — the respondent's average sentiment score (numeric)

• SENTIMENT_LABEL — positive, neutral, or negative

• ZIGPOLL_PARTICIPANT_URL — a deep link to the participant's record in Zigpoll

• One data field per slide, named after the slide's handle (uppercased, with non-alphanumeric characters converted to underscores)

Important: Dotdigital only stores data fields that have been pre-defined in your account. Any data field Zigpoll sends that doesn't already exist in Dotdigital is ignored — and the whole contact update is rejected if a field is missing, so Zigpoll automatically retries without the extra fields (the contact is still added to the address book, but the survey data won't be saved until the fields exist).

Before you go live, head to Settings → Data fields in Dotdigital and create the fields above (SENTIMENT, SENTIMENT_LABEL, ZIGPOLL_PARTICIPANT_URL) plus one entry per slide handle you want to capture. Use type Text for most fields, Numeric for SENTIMENT, and Date for date slides.

Conditional subscribes via slide and survey logic

You can also subscribe respondents to an address book based on how they answered a particular question. In any slide's editor, open the Logic section (or open Behavior → Actions on the survey), add a condition, and choose Subscribe to Dotdigital address book as the action. The contact is added to the chosen address book only when the condition is met — useful for routing happy customers and detractors to different books, or for opt-in flows triggered by a specific answer.

Using the data

Dotdigital will treat the new contact like any other — you can build segments off the data fields Zigpoll syncs (e.g. everyone with SENTIMENT_LABEL = negative), trigger programs from address book membership, or include the survey data as personalization in your campaigns.