Skip to main content

Qualifio

​
Qualifio

DirectionSource
Environment
Web
Capability
Event Collection
SDK RequiredYes
Product(s) RequiredCore Platform

Qualifio allows publishers to create interactive experiences (polls, contests) to boost engagement and collect first-party data.

Setup

Troubleshooting

​
Overview

Qualifio is the leading first- and zero-party data collection platform for media groups and consumer brands. The platform enables marketing teams to generate engagement and capture data through quizzes, games, contests, and over 50 other interactive formats via Qualifio Engage, and to reward and segment members with interaction-based programs through Qualifio Loyalty. The Permutive integration with Qualifio Engage allows you to deliver survey response data from any Qualifio campaign directly into your Permutive workspace. This is a Source integration where Qualifio has integrated with Permutive, meaning you enable the integration from within the Qualifio platform after Permutive configures a custom event in your workspace. Use cases include:
  • Build cohorts based on survey responses to understand audience preferences and interests
  • Target users who answered specific questions in particular ways
  • Enrich audience profiles with zero-party data collected through interactive campaigns
  • Segment audiences based on engagement with quizzes and surveys

​
Environment Compatibility

EnvironmentSupportedNotes
WebYes—
iOSNo—
AndroidNo—
CTVNo—
API DirectNo—

​
Prerequisites

  • Permutive SDK Deployment - The Permutive JavaScript SDK must be deployed on your website where Qualifio campaigns will run.
  • Custom Event Configuration - This integration requires a custom QualifioSurveyResponse event to be preconfigured in your Permutive workspace. Contact your Permutive Customer Success Manager (CSM) to request this custom event setup.
  • Qualifio Account - You must have an active Qualifio account with access to campaign configuration settings.

​
Setup

1

Request Custom Event Configuration

Contact your Permutive Customer Success Manager (CSM) to request the setup of the QualifioSurveyResponse custom event in your workspace. This step must be completed before you can proceed with enabling the integration.The event schema will be configured to accept the following data fields:
  • Survey site URL
  • Survey ID
  • Survey completion status
  • Question text
  • Answer text
2

Enable Integration in Qualifio

Once the custom event has been configured in your Permutive workspace, follow the instructions on the Qualifio support website to enable the Permutive integration for your campaigns:During this process, you will need to provide your Permutive Project ID, which can be found in your Permutive dashboard.
3

Verify Event Collection

After enabling the integration in Qualifio, run a test campaign and submit survey responses. In your Permutive dashboard, navigate to the Events page and verify that QualifioSurveyResponse events are being collected. You should see recent events appearing in the Events list with the survey response data.
4

Build Survey-Based Cohorts

Once event collection is verified, you can build cohorts based on survey responses. In the Permutive cohort builder, the QualifioSurveyResponse event will appear in the event dropdown list.For example, you can create cohorts for:
  • Users who completed a specific survey
  • Users who answered a particular question with a specific response
  • Users who engaged with any Qualifio campaign

​
Data Types

With your Qualifio integration setup, you’ll see the following event type collected in Permutive:
This event is triggered when a user responds to a Qualifio survey question. The event captures details about the survey, question, and answer provided.
​
site
string
The URL of the site where the Qualifio campaign is running. Example: https://my-survey.com
​
survey.id
string
The unique identifier for the Qualifio campaign. Example: 12345
​
survey.complete
boolean
Indicates whether this response completes the survey. Set to true when this is the last question in the survey, false otherwise.
​
question.text
string
The text of the survey question presented to the user. Example: How old are you?
​
answer.text
string
The user’s response to the question. Example: 30

​
Troubleshooting

Verify the following:
  • The custom QualifioSurveyResponse event has been configured in your Permutive workspace. Check the Events page in your dashboard to confirm the event exists.
  • The Permutive integration is enabled in your Qualifio campaign settings with the correct Project ID.
  • The Permutive SDK is deployed and loading correctly on the pages where your Qualifio campaigns are displayed. Use the Permutive Chrome Extension to verify SDK presence.
  • Test with a simple survey to isolate any configuration issues.
The QualifioSurveyResponse event is a custom event that must be preconfigured before the integration will work. If you attempt to enable the integration in Qualifio without this custom event being set up first, survey data will not be collected.Contact your Permutive Customer Success Manager (CSM) to request the custom event setup.
If the QualifioSurveyResponse event is not appearing in the cohort builder dropdown:
  • Confirm that events are being collected by checking the Events page in your dashboard.
  • Ensure at least one event has been received. Events only appear in the cohort builder after data has been collected.
  • Wait a few minutes after the first event is received, then refresh the cohort builder page.
If events are being collected but still not appearing, contact Permutive support for assistance.

​
Changelog

For the latest updates and changes to this integration, visit changelog.permutive.com.