Skip to main content

Integrate Quiz Kit: Personalized Quizzes with Omnisend

Learn how to integrate Quiz Kit: Personalized Quizzes with Omnisend

Written by Edgaras Vaninas

Quiz Kit is a guided commerce quiz app that helps you convert website traffic and increase sales. By connecting Quiz Kit to Omnisend, you can automatically pass quiz answers and contact details to Omnisend – and use them to segment your audience and send targeted emails.

Quiz Kit


Benefits

With Quiz Kit connected to Omnisend, you can:

  • Collect contact details (email, phone, name, and more) directly through quizzes.

  • Automatically pass quiz answers to Omnisend as custom contact properties.

  • Segment your audience based on quiz responses.

  • Send personalized emails based on what each contact answered.

Setup Process

Step 1. In Omnisend, go to Apps and search for Quiz Kit: AI Product Finder. Click Connect Now and copy your API Key.

Step 2. In your Shopify admin, open the Quiz Kit app. Go to the Integrations tab and click Connect under Omnisend.

Step 3. Paste the API key into the pop-up box and click Save.

Step 4. Back in Omnisend, check the confirmation box to confirm all steps are done and save your changes.

The integration is now enabled. Any contact who completes a quiz from this point on will be automatically passed to Omnisend.

Note: Contacts who completed a quiz before the integration was enabled will not be synced with their quiz answers. However, their email addresses should be automatically synced from Shopify.

What Data Is Passed

To sync contacts to Omnisend, your quiz must collect at least an email address or a phone number.

Collect Both Email and Phone in One Quiz

To collect both email and phone number through a single quiz:

  1. In Quiz Kit, go to Settings and enable the Capture form to collect either email or phone number.

  2. Add a separate quiz question to collect the other property.

  3. Enable validation on that question:

    • For phone numbers: check Enable phone number validation (E.164), e.g., +12125551212

    • For email addresses: check Enable email validation

  4. Set the Marketing property name for that question to phone (to collect phone numbers) or email (to collect email addresses).

Mapping Questions to Omnisend Default Properties

If you collect contact details that match Omnisend's default properties (such as First Name or Address), set the Marketing property name in Quiz Kit to match the Omnisend parameter name. This ensures the data maps to the correct contact fields in Omnisend.

Omnisend Property Name

Parameter name (set as Marketing property name)

Email address

email

Phone number

phone

First name

firstName

Last name

lastName

Country

country

State

state

City

city

Address

address

Postal code/zip code

postalCode

Gender

gender (Can be: m - male, f - female)

Birthdate

birthdate (should be collected in YYYY-MM-DD format)

When a contact completes a quiz, the following data is passed to Omnisend:

  • Email address (subscribed status);

  • Phone (subscribed status);

  • First name (if mapped correctly, as explained here);

  • Last name (if mapped correctly, as explained here);

  • Country (if mapped correctly, as explained here);

  • State (if mapped correctly, as explained here);

  • City (if mapped correctly, as explained here);

  • Address (if mapped correctly, as explained here);

  • Postal/zip code (if mapped correctly, as explained here);

  • Gender (if mapped correctly, as explained here);

  • Birthdate (if mapped correctly, as explained here);

  • QuizCompletionDate - custom property with the date when the customer has filled out the quiz;

  • Result_subtitle - you set the result subtitle yourself, but since customers will receive different results, they'll see different subtitles;

  • Result_title - you set the result subtitle yourself, but since customers will receive different results, they'll see different titles;

  • All the question headings will be passed as custom properties along with the value the customer has chosen/provided (e.g., What is your skin type will be passed as what_is_your_skin_type: option the customer has chosen. If multiple options are selected by your customer for one question, all of them will be listed like this: option1, option2, option3 under one custom property, unless you set the Question Marketing Property Name to one of the default Omnisend properties;

  • id - Quiz Kit assigns a unique contactID to each collected contact;

  • quizName - the name of the quiz that the contact has filled out;

  • Tags: source: QuizKit, quiz: unique_quiz_code (it can be found on the Publish step of the Quiz setup).

Send Automated Emails to Quiz Kit Contacts

To send automated emails to contacts collected through Quiz Kit:

  1. Create a segment in Omnisend using the source: QuizKit tag.

    • To target contacts from a specific quiz, build the segment using that quiz's custom properties instead.

  2. Create an Automation with the Contact enters a segment trigger.

  3. Select your Quiz Kit segment as the trigger filter.

💡 For more on segmenting by custom properties, see Tags and custom properties: key differences.

Use Cases

All quiz answers are passed to Omnisend as custom properties, so you can build highly targeted segments. For example, if your quiz collects data about a customer's skin type, you can:

  1. Create a segment for contacts who answered Oily under the what_is_your_skin_type property.

  2. Set up an Automation triggered when a contact enters that segment.

  3. Send a personalized email with product recommendations for oily skin.

Repeat this for each result to deliver tailored content to every quiz respondent.


Didn't find the answer to your question? Reach out to our support team through the in-app chat or at [email protected] – our team is available 24/7.

Did this answer your question?