QSM ActiveCampaign Integration - WordPress Plugin

How to Set Up QSM ActiveCampaign Integration for WordPress Quizzes and Surveys

QSM ActiveCampaign Integration is not just another add-on to tick off in a feature list. It serves a specific purpose: a user completes a quiz or survey in Quiz and Survey Master, enters their contact details, and the site sends that contact, their answers, score, tags, and selected settings to ActiveCampaign. This guide covers more than installation. It explains how the integration works in practice: which data is worth sending, when automatic subscription makes sense, how to use a minimum score, where answer-based tags are useful, and why a user may fail to appear in the right list.

This article is written for WordPress site owners, marketers, online course managers, and webmasters who already use QSM and want to turn a quiz into a solid source of segmented leads. We will not cover purchasing, billing, or entering payment details. The focus here is different: connect an existing plugin safely, configure data transfer correctly, and verify the outcome before sending paid traffic to the quiz.

The guide includes a practical use case for a quiz that matches users to a training program, a troubleshooting section, an FAQ, a comparison with similar solutions, and planned spots for instructional images. The images in this article are diagrams and training-oriented reconstructions, not a promise of the exact appearance of every screen in your admin area. The QSM and ActiveCampaign interfaces may look different depending on the version, pricing plan, account language, and user permissions.

Where This Plugin Fits in the "Quiz - Contact - Automation" Flow

To configure QSM ActiveCampaign Integration correctly, it helps to separate the setup into three layers. The first layer is the quiz or survey itself in Quiz and Survey Master. This is where the user sees the questions, submits answers, earns points, and enters their name, email, phone number, or other contact details. The second layer is the add-on configuration inside a specific quiz: whether the integration is enabled, which list the contact should be sent to, whether a consent checkbox is required, what minimum score qualifies the lead, which answers should become tags, and which values should be mapped to custom fields in ActiveCampaign. The third layer is ActiveCampaign, where the contact is then used for segmentation, email campaigns, automation conditions, and follow-up work by sales or support.

A common mistake is thinking only about the first layer: "the form submitted, so everything works." That is not enough for a marketing workflow. You need to confirm that the email landed in the correct list, that the contact did not overwrite more important data from another source, that tags did not turn into a chaotic pile of long phrases, that custom fields match the right data types, and that the automation is triggered by the event you actually created. The plugin connects the systems, but the quality of the outcome depends on the structure of the quiz and the discipline of your data model.

The official QSM documentation confirms several key capabilities of the add-on: connecting through the ActiveCampaign API URL and API Key, configuring Event Tracking, choosing a subscription list, using Automatic or Optional subscription mode, applying a minimum score for subscription, creating tags from selected questions, mapping quiz scores to tags, sending questions and answers, passing the quiz result, URL parameters, and contact fields, and writing values into ActiveCampaign custom fields. The add-on changelog also mentions newer features related to custom fields, subscriber data updates, sending contact fields as tags, and improved security.

It is important to understand the boundary of responsibility. QSM stores the attempt, the result, and the contact form data on the WordPress side. QSM ActiveCampaign Integration takes selected values from that attempt and sends them to ActiveCampaign. ActiveCampaign then decides how to use the contact: apply tags, segment the audience, trigger an automation based on a list subscription, tag, or field change, or personalize email content. That is why verification should happen on both sides: first in the QSM results, then in the ActiveCampaign contact record.

For a typical site, this creates a clear workflow. A visitor takes a quiz such as "Which learning format is right for you," earns a score, selects interests, enters an email address, and agrees to receive emails. WordPress stores the attempt, while ActiveCampaign receives a contact with a tag like "interest: intensive," plus a score or result category. From there, the marketer can send more than one generic email blast. They can build a sequence based on that person’s actual interest and readiness level. That is exactly why this add-on is worth configuring carefully instead of stopping at uploading the ZIP file.

Who QSM ActiveCampaign Integration Is Best For, and When Another Option Makes More Sense

This plugin is especially useful when QSM is already your main data collection tool. If you build tests, diagnostic quizzes, satisfaction surveys, evaluation forms, online exams, or simple lead forms with questions, integrating with ActiveCampaign helps you avoid transferring results manually. It works best for sites where the answers themselves carry marketing value: skill level, topic interest, product type, budget, user role, city, traffic source, or readiness to book a consultation.

For an online school, the add-on is helpful because the minimum score and tags can separate a motivated lead from a casual participant. For consulting businesses, custom fields are especially valuable because they let you store service area, the user’s problem, company size, or another lasting attribute inside the contact record. For media and content-driven projects, a strong use case is interest-based segmentation: quiz answers become tags, and the subscriber receives materials tailored to the selected topic. For HR, testing, and certification workflows, the plugin can help send the result or result category into a CRM process, but only if you treat personal data carefully and do not rely on email automation as a substitute for a proper exam tracking system.

There are also cases where this solution may be unnecessary. If you only need a standard email signup form with no questions, it is usually simpler to use a native ActiveCampaign form or the official ActiveCampaign WordPress plugin. If the site does not use QSM and instead runs on Gravity Forms, Fluent Forms, Formidable Forms, or another form builder, you are usually better off using the integration for that specific builder because it will match your fields, conditions, and submission flow more closely. If you need a flexible workflow across many services, QSM Webhooks or a Zapier-based setup may be more suitable, though it will require more testing and more hands-on control.

You should also think carefully about consent requirements. ActiveCampaign’s own documentation emphasizes the importance of voluntary opt-in, and for many email workflows, double opt-in improves list quality. QSM ActiveCampaign Integration includes an Optional mode with a checkbox and customizable checkbox text. This is useful if you want quiz completion and email subscription to remain two separate actions. If you collect sensitive responses or work with audiences where consent matters, do not enable automatic subscription unless the user receives a separate, clear explanation.

The bottom line is straightforward: this add-on shines when the quiz does more than entertain and actually classifies the user. If the answers will not be used in email campaigns, segments, or automations, the integration becomes an unnecessary technical layer.

What to Check Before Installing It on a Live Site

Preparation matters more here than the installation itself. The add-on works on top of Quiz and Survey Master, so first make sure the base QSM plugin is installed, active, and able to record attempts correctly. Run a simple test quiz on a staging page, check the entry in QSM > Results, and confirm that the contact form is actually collecting an email address. If no email is captured or the field is disabled, ActiveCampaign will not receive a usable contact even if the API key is entered correctly.

The second set of checks belongs on the ActiveCampaign side. You need the API URL and API Key from Settings or Account Settings - Developer. These are integration credentials, so do not put them in public documents, screenshots, contractor emails, or chats with outside freelancers. If the key has been exposed, reset it in ActiveCampaign and update every integration that uses it. Also make sure the ActiveCampaign user whose API credentials are being used will not be deleted. ActiveCampaign’s help docs note that each user has their own API URL and Key, and deleting that user can break integrations that rely on those credentials.

The third area is lists, tags, and fields. Create or choose the list that should receive contacts from the quiz. Prepare your core tags in advance if you want a clean segmentation system. For custom fields, make sure they already exist in ActiveCampaign and match the right data type. For example, a score or number of correct answers is better stored in a numeric or text field, a stable interest type belongs in a separate field or tag, and a long free-form answer should not automatically become a tag. ActiveCampaign explains the distinction clearly: fields are better for persistent personal data and personalization, while tags are better for fast-changing attributes and segments.

The fourth area is the quiz itself. Before enabling the integration, answer a few questions:

• Does the QSM contact form include a required email field, and at what point is it shown - before the quiz or after the result.
• Which answers can safely be sent to ActiveCampaign, and which ones are better left only in the WordPress results.
• Do you need a subscription consent checkbox, and should the user opt in manually.
• What minimum score counts as qualified if only part of the audience should be subscribed.
• Which UTM parameters will you review after the ad campaign.
• Which test contact will you use for verification so real and sample data do not get mixed together.

Practical pre-launch check: create a separate test list in ActiveCampaign, enable the integration first only for a copy of the quiz, and run at least three attempts - one subscription with consent, one submission below the minimum score, and one submission with the target result.

You should also assess caching and optimization. Most submission problems are not caused by static page caching by itself, but by script conflicts, deferred loading, aggressive JavaScript optimization, or security layers blocking requests. If the quiz is already unstable, the integration will only add another symptom. First get the form submission and QSM result recording working reliably, then connect ActiveCampaign.

Installation and Initial Connection Without Unnecessary Risk

Technically, the add-on is installed like a standard WordPress plugin. In the admin panel, open Plugins, choose Add New, then Upload Plugin, upload the add-on ZIP file, and activate it. After activation, you should see QSM - ActiveCampaign Integration in the plugin list, and in the QSM add-on settings there should be an ActiveCampaign Integration tab or a similar ActiveCampaign tab. The labels may vary slightly, but the workflow is the same: first connect the account globally, then configure each quiz individually.

Do not start with a live quiz that is already receiving traffic. Create a duplicate or a separate test quiz. This is especially important if you plan to enable automatic subscription, send answers as tags, or update contact data. A mistake inside a test list is annoying but manageable. A mistake in your main database can create dozens of incorrect tags, overwrite phone numbers, or send people into the wrong automation.

Connecting the ActiveCampaign API

In ActiveCampaign, open Settings - Developer and copy the API URL and API Key. Paste them into the add-on fields in QSM. After saving, you should see either a successful connection check or a message confirming that the integration was saved. If no confirmation appears, do not move on to quiz configuration yet. First verify the key, the URL, the ActiveCampaign user permissions, and that no extra spaces were copied.

The QSM documentation also describes fields for Event Tracking Key, Event Tracking ID, and Event Name. These settings belong to ActiveCampaign event tracking. First enable the necessary options in ActiveCampaign itself: in Website - Site Tracking, turn tracking on, add your site domain to the approved list, and create or choose the event name if you plan to use events in automations. Then copy the key and ID into the add-on settings. If you do not need events for this rollout, do not invent a use case just to fill in the fields. Basic contact, list, tag, and field transfer already covers most real needs.

Initial Verification After Saving

Once the keys are entered, run a short validation check. Open the test quiz, enable the integration only for that quiz, choose a test ActiveCampaign list, and save the settings. Then complete the quiz using a unique email address that does not already exist in your ActiveCampaign account. Do not use your main address if it already has many tags and fields attached, because that makes it harder to see exactly what data came from QSM.

At the end of the test, you should see an attempt in QSM > Results, a contact in ActiveCampaign, and the expected list subscription. If the contact appears but there are no tags or fields, the issue is usually not the API connection. It is more likely to be inside the specific quiz settings: answer transfer is disabled, no question was selected for tag creation, the custom field does not exist, the wrong subscription mode is selected, or the minimum score filtered the attempt out.

At this stage, do not connect every quiz on the site at once. It is better to choose one workflow, get clean contact transfer working there, and only then roll the same logic out to other forms. That will help you avoid ending up with multiple quizzes that generate similar but inconsistent tags, quickly making your ActiveCampaign database hard to read.

Configuring a Specific Quiz: List, Subscription Mode, Score, and Fields

After the global connection is in place, the most important work happens not in the general settings but inside each individual quiz or survey. In the QSM editor, open the add-ons tab and go to the Active Campaign settings. This is where you enable the integration for the current quiz, choose the ActiveCampaign list, define the subscription mode, and decide which extra data should be sent with the contact.

The first switch is Enable for this quiz. It should be turned on only for quizzes where sending data to ActiveCampaign is genuinely needed. Do not enable the integration for technical tests, internal exams, employee surveys, or forms where the user did not consent to marketing communication. If QSM contains several similar quizzes, create a clear naming system in ActiveCampaign, use tags with a consistent prefix, and run a separate test submission for each one.

Choosing the List and Subscription Mode

The Subscribe user to list field defines where the contact will go. For the initial rollout, it is usually better to use a separate list or a tightly controlled segment so new data does not mix with your main newsletter. If you use one primary database, think through your tags in advance. They should make it obvious which quiz the person came from and what result they received.

Subscription Mode offers two fundamentally different approaches. Automatic subscribes the user automatically when the conditions are met. Optional shows a checkbox and lets the user decide whether to subscribe. For marketing forms where explicit consent matters, Optional mode is usually the safer choice: the user completes the quiz to get a result, and the subscription remains a separate, clearly understood action. The checkbox text should sound human. Instead of a generic "Subscribe," use plain language that explains the user will receive emails or useful materials.

If you enable automatic mode, review the legal copy on the page, your data policy, and the expectations of your audience. In some cases, the user enters an email only to get the quiz result, not to join a marketing list. In that situation, automatic subscription may lead not to list growth, but to complaints and unsubscribes.

Using Minimum Score as a Lead Quality Filter

The Minimum Score option lets you subscribe only users who reach a defined threshold. This is more than a technical filter. In marketing, it helps separate users who completed the quiz with genuine intent or reached the desired level from users who clicked through casually. For example, if the quiz measures course readiness, you might send only users who scored 60% or higher to ActiveCampaign, while leaving everyone else in QSM results or showing them a different outcome on the site.

Do not choose the threshold at random. First collect several test attempts: a low score, a mid-range score, and a high score. Check how QSM calculates points and percentages. Then decide what that threshold means for your business. A minimum score should never replace user consent. It is a quality or qualification filter, not a legal basis for email signup.

Answer-Based Tags and Score Mapping

The Select Question and Map Quiz Score fields handle segmentation. The first option creates tags based on the answers to a selected question. The second maps score ranges to an ActiveCampaign tag. These serve different purposes. Answers work well for interests and preferences: "interest: SEO," "role: instructor," "format: consultation." Scores work better for readiness level: "level: beginner," "level: ready to implement," or "score-high."

The official QSM documentation warns that answer-based tags can become long, especially if the question allows free-text responses. That is why tags should come from questions with short answer choices, while long comments are better sent to custom fields or left in QSM results. In ActiveCampaign, tags are useful for segments and automation triggers, but the tag database becomes messy very quickly if every user paragraph turns into a new tag.

Custom Fields, Answers, and UTM Parameters

The Send question and answer option setting sends questions and answers, Send quiz score sends the final score, and Send request parameters sends URL parameters, including UTM values if they were present on the quiz page. Send Contact Fields can send contact fields as tags, while Send Custom Fields maps QSM values to ActiveCampaign custom fields. For serious analysis, the "UTM + quiz outcome" combination is especially useful because it shows which traffic sources bring not just subscribers, but people with the right interest or readiness level.

The Update Contact Info setting requires caution. According to the documentation, it controls whether contact data should be updated. If you set it to No, the system will not overwrite values such as first name, last name, business name, or phone number with new data. This matters when the contact already exists in ActiveCampaign through a CRM, payment flow, webinar, or another form. If QSM collects unofficial or incomplete data, first make sure the integration will not overwrite more valuable information.

How a Quiz Attempt Becomes an ActiveCampaign Contact

The internal behavior of the add-on becomes easier to understand if you picture it as a data chain. At the start is the QSM attempt: answers, scores, contact form data, URL parameters, and the settings of the specific quiz. QSM ActiveCampaign Integration then checks whether the integration is enabled for that quiz, whether an email is present, whether a list has been selected, which subscription mode is active, whether the minimum score has been reached, and which additional data is allowed to be sent. Only after those checks does it build the request to ActiveCampaign.

The visible outcome depends on every condition in that chain. If the user did not enter an email address, no proper contact will be created in ActiveCampaign. If Optional mode is enabled but the checkbox is not selected, the user may complete the quiz and remain only in QSM Results. If the minimum score is higher than the user’s result, there will be no subscription. If the user already exists in ActiveCampaign, the final outcome depends on your contact update settings and on which fields or tags are being sent. That is why it is not enough to diagnose the integration with "the contact did not come through." You need to identify exactly where the chain stopped.

Processing Flow

1. The user opens a WordPress page with a published QSM quiz.
2. QSM displays the questions and the contact form in the configured position.
3. The user submits their answers, email, and, if Optional mode is used, the state of the subscription checkbox.
4. QSM stores the attempt and calculates the score or result.
5. The add-on checks the quiz settings: whether integration is enabled, which list is selected, which subscription mode is used, what the minimum score is, and which fields are configured for transfer.
6. If the conditions are met, the data is sent to ActiveCampaign as a contact, subscription, tags, fields, or event.
7. The administrator verifies the outcome in QSM > Results and in the ActiveCampaign contact record.

This flow is useful not only during setup, but also when explaining the system to your team. A marketer needs to understand that a tag like "interest: audit" does not appear by magic. It comes from a specific question, a specific answer choice, and an enabled transfer setting. A developer or webmaster needs to understand that the integration should not replace contact form validation. If the email is invalid or the field is disabled, there is no point checking ActiveCampaign afterward.

Where Different Types of Data Belong

Not every value is equally well suited to ActiveCampaign. Short categories and status labels work well as tags. Stable contact details are better stored in custom fields. Full responses, comments, long paragraphs, and questionable personal data are better sent selectively or left inside QSM if they are not needed for email communication. This approach reduces noise in the database and makes automations easier to manage.

If you build several quizzes, establish a tag naming convention. For example: qsm_source_lead_quiz, qsm_interest_email, qsm_score_high. You do not have to use exactly that pattern, but a consistent system matters. Without one, a few months later you may end up with dozens of nearly identical tags that differ only in spacing, capitalization, or wording, and your segments will become unreliable.

Tags, Answers, and Scores: How to Keep the Database from Turning into a Mess

Tags are the fastest and riskiest part of the setup. They are convenient for segmentation and automation triggers, but they are also the part most likely to become clutter. QSM ActiveCampaign Integration can turn answers into tags and map quiz scores to tags. This is a strong feature when the questions are intentionally designed for segmentation. But if you enable it on a free-text question like "Tell us about your situation," every long response may become its own tag, making ActiveCampaign much harder to use.

A good tag-friendly question has a limited set of short answer choices. For example: "Which format are you interested in?" with answers like "Course," "Consultation," and "Audit." A poor question for tags would be "Describe your situation." The first creates stable segments; the second creates unpredictable values. If the marketing team genuinely needs the free-form answer, send it to a custom field or review it in QSM results.

When to Use an Answer-Based Tag

Use an answer-based tag when the value answers the question "which group does this contact belong to?" For example, interest in a topic, role in the company, selected service format, readiness stage, or motivation source. A tag like that is easy to use in an ActiveCampaign condition: if the contact has the tag "interest: email," send an email marketing sequence; if they have "role: instructor," show examples relevant to education.

When to Use a Score-Based Tag

Score mapping is useful when the quiz outcome reflects a level, such as "low readiness," "medium readiness," or "high readiness." Unlike an answer to a single question, the score is calculated from the entire attempt. That makes it a better fit for qualification. In QSM, first verify the scoring system and the results pages, then map score ranges to tags. Do not create too many ranges. Three clear levels are usually more useful than ten nearly identical segments.

When to Use a Custom Field

A custom field makes sense when the value should live inside the contact record and be used for personalization. ActiveCampaign notes that custom fields are best for data that extends the standard contact profile: phone number, date, role, or other unique details that can be inserted into emails or used in conditions. In QSM, that might include the final result, selected category, company size, city, or skill level. Before mapping, create the field in ActiveCampaign, verify its type, and associate it with the correct list if your account limits field availability by list.

The most practical setup for most quizzes looks like this: source and quiz type as a tag; short interest as a tag; final level as a tag or field; score as a field; long answers as a field or only in QSM Results; UTM values as fields or separate technical tracking values. That structure keeps ActiveCampaign manageable while still giving the marketer enough information for segmentation and email personalization.

Tag quality check: after your test submissions, open the contact record and review the tag list. If you cannot understand within 10 seconds what each tag means and where it came from, simplify the setup before sending real traffic.

The QSM Contact Form as the Source of Clean Data for ActiveCampaign

The integration starts not with the API, but with the QSM contact form. If the form collects an incomplete email address, skips required fields, or appears at the wrong moment, ActiveCampaign will receive a weak contact. That is why it is worth reviewing the contact form tab on its own before configuring ActiveCampaign. In QSM, you can enable and customize standard fields such as name, email, business, and phone number, add new fields, define whether they are required, set helper text, set length limits, and apply rules for email domains. These features belong to the QSM core plugin, but they directly affect data quality in ActiveCampaign.

The first decision is where to display the contact form: before the quiz or after it. A pre-quiz form gives you a better chance of capturing the email, but it may reduce the number of quiz starts if the user has not yet seen the value. A post-quiz form usually feels softer because the user has already invested time and wants to see the result. For a lead magnet, showing the form closer to the result is often the better choice; for a gated test or exam, placing it before the start makes more sense so the attempt is tied to a specific participant from the beginning.

Email and Name

Email should be required if the result needs to go to ActiveCampaign. Whether to require a name depends on the workflow. If your email will be personalized, a name is useful. If the quiz is short and you only need the segment, an extra field may hurt conversion. Check not only that the field exists, but also how it behaves. If the user is already logged in, the contact form may work differently depending on your QSM settings. For testing, use a path that matches the real visitor journey as closely as possible.

Phone, Company, and Other Contact Fields

You should collect phone number and company only if someone will actually use them. If your sales team calls hot leads, a phone field may be justified. If this is a content newsletter after a lightweight quiz, a phone number is often unnecessary. In ActiveCampaign, this kind of data is better stored in fields rather than turned into tags. If you do choose to send contact fields as tags, first make sure your database will not end up with tags containing phone numbers, company names, or random text.

Validation Checks Before the Integration

QSM supports validation settings for contact fields, including required fields, allowed and blocked email domains, text length limits, and server-side validation if that is enabled in the form settings. This matters for ActiveCampaign because the earlier your site filters out invalid email addresses, the less junk enters the database. Run tests with an empty email, an invalid email, a name that is too short, and a blocked domain if you use those restrictions.

Quick takeaway: if the QSM contact form does not produce a clean email and clear field values, there is no point making ActiveCampaign more complicated. First get a reliable record in QSM Results, then turn on the transfer to lists, tags, and custom fields.

Event Tracking and UTM Parameters: When This Layer Actually Matters

The QSM ActiveCampaign Integration documentation specifically mentions Event Tracking Key, Event Tracking ID, and Event Name. These are not just three more settings fields. Event Tracking in ActiveCampaign is meant to record contact actions that can be used in marketing and automation workflows. If you are only configuring a list subscription after a quiz, this layer may be unnecessary. But if you want to build a workflow around an event like "completed diagnostic test," "requested a program recommendation," or "received a high score," the event can become a useful trigger point or automation condition.

Do not confuse Site Tracking with Event Tracking. Site Tracking shows page visits by known contacts when the domain and tracking code are set up correctly. Event Tracking refers to events sent to ActiveCampaign through the integration or API. In the QSM add-on settings, the event setup must already be prepared in ActiveCampaign: tracking enabled, domain added, event name created or allowed, and the required keys obtained. If any part is missing, the contact may still be added to a list, but the event itself will not behave the way your automation expects.

How to Choose an Event Name

Your event name should be short and stable. Do not use the ad campaign name or a long quiz title as the event name if you expect to change campaigns often. It is better to choose a general action label such as qsm_lead_quiz_completed or qsm_assessment_submitted. Pass the specific source, interest, and result through tags, fields, or UTM parameters. That way the event remains one clear anchor point instead of turning into dozens of near-duplicate event names.

Using UTM Values as Proof of Source, Not Report Decoration

The Send request parameters setting is useful when a visitor lands on the quiz page with campaign parameters in the URL. But UTM values do not appear by themselves. If the user opens the page without those parameters, or the site strips the URL during a redirect, there is nothing to send. That is why you should test UTM handling with a direct visit to the quiz page. In ActiveCampaign, decide in advance where those values should live: in custom fields, in technical tags, or only in external analytics. For the long-term contact profile, fields are usually the better option because a tag database can grow very quickly with every new campaign name.

How to Connect the Event, Tag, and Automation

A reliable setup does not depend on a single signal. For example, the event can indicate that the quiz was completed. A tag can reflect the user’s interest. A custom field can store the score. The automation might start on list subscription or tag addition, then check the result field inside the workflow. This approach is more resilient than trying to encode the entire workflow into one long tag or one event. If one value fails to arrive, you can still see the others and quickly understand where the problem happened.

When configuring Event Tracking, do not promise your team instant magic. First verify the base contact, then the tag, then the custom field, then the event. If you enable everything at once, every failure will look the same: "ActiveCampaign did not work." A staged validation process turns the problem into a clear list of conditions.

Custom Fields and Answers: What to Send to ActiveCampaign and What to Leave in QSM

Custom fields in ActiveCampaign let you keep much more context than a simple email list. In combination with QSM, that is especially useful because a quiz often collects more than just a name and email. It may capture answers, preferences, results, categories, scores, and campaign parameters. But that does not mean you should send everything. The more fields you create without a clear system, the harder it becomes to maintain automations, segments, and reports.

Start by splitting the data into four types. The first type is contact data: email, first name, last name, phone, company. These fields usually already exist or are easy to create. The second type is marketing segmentation: interest, role, selected service, readiness level. The third type is quiz analytics: score, percentage, result category, UTM tags. The fourth type is raw answer text. That last type is the most debatable. It may be useful to a manager, but it is rarely needed in broadcast email campaigns.

Preparing Fields in ActiveCampaign

Before setting up Send Custom Fields, open ActiveCampaign and create the custom fields you need. Do not begin with dozens of them. For the first working workflow, three to five values are enough: quiz result, score, main interest, campaign source, and possibly a free-form comment. Check the field type carefully. If you want to use a number in conditions, do not store it as an unpredictable text string. If the field should contain one of several possible values, define those choices in advance.

ActiveCampaign’s help docs specifically warn that a custom field type cannot always be changed as casually as email copy. If you choose the wrong type, you often have to create a new field. That is why it makes sense to test first with a small group of fields using a clear prefix, such as QSM Result, QSM Score, and QSM Interest.

Mapping a QSM Question to an ActiveCampaign Field

In the add-on settings, enable the use of custom fields for questions and answers, then map specific QSM questions to ActiveCampaign fields. If your interface or documentation includes Insert Variable, use QSM variables for values such as category-based score totals. The product page and the add-on documentation mention an example like %CATEGORY_POINTS_X%, where a category value can be sent into a custom field.

After saving, complete the quiz with test answers and check not just whether the contact appears, but whether the fields are filled correctly. If a field is empty, verify three things: the question was actually shown to the user, the user answered it, and the ActiveCampaign field exists and is available for the list or contact. If a value looks different from what you expected, review the question type and the data format. For example, multiple selected options may be stored differently from a single short answer.

Sending Questions and Answers Without Overloading the System

The Send question and answer option setting is useful when a manager or an automation genuinely needs response context. But for bulk email campaigns, full questions and answers are often too much. It is usually better to send only the key values that actually affect communication. The rest can stay in QSM > Results, where the administrator can review the original attempt.

A simple rule works well here: if a value is not used in a segment, an email, an automation condition, or manual qualification, it does not need to be sent to ActiveCampaign. Less unnecessary data means less risk of broken automations, outdated fields, and reporting confusion.

Practical Use Case: Program Recommendation Quiz and Lead Segmentation

Let’s look at a concrete example. An online school runs a QSM quiz called "Which training program is right for you?" The goal is not just to show an attractive result on the page, but to send a contact to ActiveCampaign with a clear interest, readiness level, and ad source. ActiveCampaign then sends different emails: introductory materials to beginners, a consultation invitation to advanced users, and a format comparison to people who are still deciding.

Goal

The objective is to create a contact in ActiveCampaign after quiz completion, but subscribe only those users who checked the consent box and scored at or above the required threshold. The contact record should include an interest tag, a level tag, the score, the result, and the UTM source. QSM should retain the full attempt record for manual review.

Preparation

In QSM, create a quiz with 6 to 8 questions. One question should define the main interest: "What matters most to you right now?" with short options such as "Email," "Automation," and "Analytics." Several questions should contribute points to the total score. In the contact form, enable email and first name, and make email required. In ActiveCampaign, create a test list and the fields QSM Score, QSM Result, QSM Interest, and UTM Source. Prepare level-based tags such as qsm_level_start, qsm_level_middle, and qsm_level_ready.

Configuration Steps

1. Open the QSM quiz editor and confirm that the contact form stores the email address.
2. In the Active Campaign settings, enable Enable for this quiz.
3. Select the test list in Subscribe user to list.
4. Set Subscription Mode to Optional and write clear consent checkbox text.
5. Set Minimum Score, for example a threshold that separates deliberate completion from a random click.
6. In Select Question, choose the question that captures the main interest so short answers become tags.
7. In Map Quiz Score, match score ranges to your level tags.
8. Enable Send quiz score and Send request parameters if the quiz receives UTM tags from ads.
9. In Send Custom Fields, map the score, result, and interest to ActiveCampaign fields.
10. Save the settings and complete the quiz as a new user.

Outcome Verification

Open QSM > Results and locate the test attempt. Check the name, email, answers, and scores. Then open ActiveCampaign, find the contact by email, and review the list, tags, and custom fields. If Optional mode is enabled, repeat the test without checking the box. The attempt should still be saved in QSM, but the subscription behavior should follow your configuration. Then repeat the test with a score below the threshold. That confirms that Minimum Score is actually filtering the contact.

A Common Detail People Miss

If an ActiveCampaign automation is triggered by list subscription, it may not start the way you expect in some repeat-contact situations. The contact may already have been subscribed to that list earlier. In that case, it is often better to use an additional level or interest tag as the condition for the next automation step. For testing, use unique email addresses and verify not only the list subscription, but also the appearance of the specific tag or field.

Verifying the Outcome: What to Check in WordPress and ActiveCampaign

Verification should be a separate step, not a quick glance at the thank-you page. A successful form submission on the site does not automatically mean ActiveCampaign received all the data. Start on the WordPress side. In QSM > Results, open the attempt record and make sure it includes the email, answers, scores, final page, and completion time. If the data is already missing there, ActiveCampaign cannot recreate it on its own.

Then move to ActiveCampaign. Find the contact by the test email. Check whether the contact exists, whether they are subscribed to the correct list, which tags were added, whether the custom fields are filled, and whether the event or activity appears if you configured Event Tracking. Do not confuse the list, the tag, and the field. These are separate parts of the contact record and different triggers for automations.

Quick Checklist Before Launching Ads

• The test contact appears in ActiveCampaign after completing the quiz with a valid email address.
• In Optional mode, the outcome changes based on the state of the subscription checkbox.
• The minimum score filters out a submission below the threshold if that logic is enabled.
• The tag created from the selected question is short, clear, and does not contain long user-written text.
• The custom fields contain the values actually needed for segmentation or personalization.
• UTM parameters arrive only when the user visits through a URL that really includes them.
• The ActiveCampaign automation is triggered by the condition you actually tested: list, tag, field, or event.

For UTM testing, use a dedicated test URL. This example can be adapted to your own domain and quiz page:

https://example.com/quiz/?utm_source=test&utm_medium=email&utm_campaign=qsm_activecampaign_check

Complete the quiz through that URL and check whether the parameters appear in ActiveCampaign if Send request parameters is enabled. If they do not arrive, first make sure they are still visible in the address bar at the moment the quiz is submitted. Sometimes redirects that clean the URL, or navigation between site pages, remove the parameters before the user submits the form.

Reliable outcome: you can explain every tag and every field in the contact record: which QSM question or setting created it, why it exists, and which automation uses it.

Consent, Security, and Careful Data Handling

Integrating a quiz with an email service almost always involves personal data. Even if you collect only an email address, the user should understand why they are providing it. If you send answers, scores, interests, or UTM values to ActiveCampaign, your responsibility becomes even greater. The plugin gives you the technical ability to transfer data, but it does not make legal or editorial decisions about consent on your behalf.

Optional mode with a checkbox is useful when quiz completion and subscription need to stay separate. The checkbox text should describe the real action, for example that the user will receive emails related to their result or a series of useful resources. Do not hide consent inside a long generic paragraph. If your workflow requires double opt-in, configure it in ActiveCampaign and verify exactly when the contact becomes active. ActiveCampaign’s documentation explains that with double opt-in, the contact goes through an extra confirmation step, and until that happens some workflows may not behave the same way they do with single opt-in.

API credential security matters as well. The API URL and Key must not be published. Do not include them in training screenshots, send them to a contractor through an open channel, or store them in notes next to site access details. If the key is reset, every integration using the old key must be updated. If the ActiveCampaign user tied to that key is deleted or loses permissions, the connection may stop working. Keep that in mind when staff members or agencies change.

Review contact info updates carefully as well. If Update Contact Info is enabled, QSM may update certain fields on an existing contact. That is useful when the quiz is your main data source. But if you already have a CRM, order forms, webinars, and manual qualification processes, a new incomplete value from the quiz may make the contact record worse. In that case, it is often smarter to disable overwriting for core fields and send quiz outcomes into separate fields with a QSM prefix.

Performance is usually not the main issue with this add-on, but the stability of the quiz page still depends on QSM, your theme, caching, and script optimization. Do not combine integration testing with major site changes. If you update the theme, enable new JavaScript minification, change caching rules, and connect ActiveCampaign all at once, finding the source of an error becomes much harder. Introduce changes one at a time and document exactly which step caused the problem.

It is better not to invent code customizations for this add-on unless they are backed by confirmed hooks or an official API for the specific add-on. For styling the consent checkbox or form, use QSM settings and your theme styles. If you need precise CSS adjustments, apply them through a child theme or a safe CSS area, but first inspect the real classes on your page with browser tools. This guide intentionally does not include a PHP snippet because the public add-on documentation does not confirm stable hooks specifically for altering the ActiveCampaign payload.

Why the Contact Did Not Reach ActiveCampaign and How to Find the Cause

Troubleshooting works best when you follow the chain instead of changing settings at random. The integration depends on several conditions: the add-on is active, the API connection is valid, the integration is enabled for the specific quiz, the contact form contains an email, a list is selected, the subscription mode is correct, the minimum score is met, and tag and field mapping are set up properly. If the contact does not appear, one of those conditions may have failed.

The Contact Is Not Created at All

Symptom: the attempt exists in QSM, but there is no contact in ActiveCampaign for the test email. Possible causes include an incorrect API URL or Key, integration not enabled for the quiz, email not passed from the contact form, no list selected, the user leaving the Optional checkbox unchecked, or a result below the minimum score.

What to check: first open the record in QSM > Results and confirm that the email was saved. Then verify the global API connection and the settings for the current quiz. Run the quiz again with a new unique email and temporarily use the simplest possible configuration: integration enabled, list selected, Optional mode off or the checkbox checked, and no minimum score blocking the test.

How to fix it: update the API credentials, choose a list, enable the integration for the quiz, make email required, and review the minimum score. If the contact appears after this simplified test, add the extra conditions back one at a time.

The Contact Exists but Is Not Subscribed to the Correct List

Symptom: the contact record exists, but the list is missing or the subscription does not match expectations. Possible causes include the wrong list being selected, the contact already existing in the database, double opt-in leaving the contact unconfirmed, or the automation waiting for a different trigger than the one QSM actually creates.

What to check: the list selected in Subscribe user to list, the contact status, the activity history, and the automation trigger conditions. If you are testing double opt-in, check the confirmation email and the contact status after confirmation.

How to fix it: select the correct list, use a separate test list, and configure the automation to rely not only on the subscription itself but also on a QSM tag if the same contact may come through again.

Tags Are Created but Too Long or Not Useful

Symptom: ActiveCampaign receives tags containing long answers, inconsistent wording, or random text. This often happens when a free-text question is selected for the "answers as tags" feature.

What to check: which question is selected in Select Question, which answer types it accepts, and what values users are actually submitting. Open several contact records and compare the tags.

How to fix it: use only questions with short, fixed answer choices for tags. Send free-text answers to a custom field or leave them in QSM Results. Remove old unnecessary tags from ActiveCampaign only after confirming they are not used in automations.

Custom Fields Are Empty or Filled Incorrectly

Symptom: the contact is created, but fields such as result, score, or interest are empty. Possible causes include the field not existing in ActiveCampaign, the wrong question being selected, the value not matching the field type, the field not being associated with the correct list, or the user not answering the question.

What to check: whether the field exists in ActiveCampaign, the field type, the mapping in Active Campaign Custom Fields, whether the field is available for the list, and the original attempt in QSM. If you are sending category scores through a variable, make sure that category is actually used in the questions.

How to fix it: recreate the field with the correct type, simplify the mapping, test one question with one field, and only then add the remaining values.

UTM Parameters Do Not Reach the Contact Record

Symptom: sending request parameters is enabled, but the campaign source is not visible in ActiveCampaign. Possible causes include the user landing on the page without UTM tags, a redirect stripping the URL, the parameters being lost between pages, no field being configured to store them, or you checking the wrong contact.

What to check: the test URL with UTM values, whether the parameters are visible in the address bar before submission, the field settings, and the exact contact record for the email used in the test.

How to fix it: test with a direct visit to the quiz page, temporarily disable redirects, review cache rules, and make sure QSM submits the attempt from the same page where the parameters are present.

When it is better to roll back the setup: if enabling tags or custom fields starts sending incorrect values into the database, temporarily disable that problematic block, keep only contact creation into a test list, and rebuild the mapping on a duplicate quiz.

Useful Combinations with Other WordPress and ActiveCampaign Features

QSM ActiveCampaign Integration works best not as a standalone tool, but as part of a clean overall system. But "combination" does not mean you should turn on every plugin you can find. The goal is to separate responsibilities: QSM collects responses, the add-on transfers selected data, ActiveCampaign segments contacts and sends emails, and WordPress themes and caching keep the page stable.

Using It Alongside QSM Results

Do not remove QSM Results from the process. Even if ActiveCampaign receives the contact, the WordPress record remains the primary proof that the quiz was completed. It helps you verify answers, scores, and contact fields when a manager disputes the CRM data or a user says they never received the email. A good internal rule is this: for any issue, first find the attempt in QSM, then find the contact in ActiveCampaign.

Using It Alongside ActiveCampaign Automations

It is usually best to trigger automations from a stable signal. If all quiz contacts go into one list, use tags or custom fields for branching. For example, the list shows the source is "quiz," the tag shows the interest, and the field shows the score. That lets you build conditions in ActiveCampaign without creating a large number of nearly identical lists.

Using It Alongside Caching and Optimization

You do not need to disable caching across the entire site because of one quiz. But if the QSM form behaves inconsistently, review the quiz page for exclusions from aggressive JavaScript optimization, deferred loading, and script combining. Do this carefully: first test the page without optimization on a staging copy, then re-enable rules one by one. The expected outcome is simple: the quiz submits, QSM stores the attempt, and ActiveCampaign receives the contact. If one specific rule breaks submission, roll back that rule only.

Using It Alongside the Native ActiveCampaign Plugin

The official ActiveCampaign WordPress plugin can be used for ActiveCampaign forms and Site Tracking. It is not a replacement for QSM ActiveCampaign Integration because it does not turn QSM answers into tags and fields on its own. A practical setup looks like this: the QSM add-on handles quiz contacts, while the native ActiveCampaign plugin handles form embedding or visit tracking if your workflow needs those features. In that setup, make sure the site does not present conflicting consent forms and that users understand exactly where they are subscribing to emails.

Video Walkthrough for the ActiveCampaign Add-On Setup

The QSM product page includes a focused video on setting up the ActiveCampaign add-on. It is useful as visual support for the connection stage and for configuring the ActiveCampaign tab inside QSM. Use the video as a quick interface reference, but make your decisions about lists, tags, fields, and consent based on your actual workflow.

After watching it, return to result verification. The video helps you see the path through the settings, but it does not replace a real test submission with a new email, checking the list, tags, custom fields, and automation triggers.

When QSM ActiveCampaign Integration Is the Right Choice

This plugin is worth using if a QSM quiz or survey is a real entry point into your marketing workflow. It helps you pass more than just an email address into ActiveCampaign. It carries over the meaning of the submission: result, score, interest, answers, tags, UTM parameters, and subscription status. The better your questions and data structure are designed, the more useful the integration becomes.

Before going live, follow a short but disciplined path: prepare fields and tags in ActiveCampaign, configure the QSM contact form, enable the integration on a quiz copy, choose the list, decide how consent will work, define a minimum score if needed, run several test submissions, and check the contact record. If every tag and every field has a clear role, you can then move the setup to the main quiz.

If instead you need a standard signup form, a multi-service integration, or data transfer from another form builder, do not make the project more complicated than it needs to be. Choose the solution that is closest to where the contact is created. QSM ActiveCampaign Integration is strongest when QSM answers and scores need to become clear conditions for follow-up communication in ActiveCampaign.