Skip to main content

Collective Audience

​
Collective Audience

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

Collective Audience (formerly BeOp) enables publishers to collect first-party survey data and optionally retarget Permutive cohorts within their survey platform.

Setup

Troubleshooting

​
Overview

Collective Audience (formerly BeOp) allows you to run multiple-choice surveys on your site. This declared first-party data is useful for building cohorts for demographics or purchase intent targeting. This is a Source integration where Collective Audience has integrated with Permutive, meaning you enable the integration from within the Collective Audience platform after Permutive configures a custom event in your workspace. Use cases include:
  • Build cohorts based on survey responses (e.g., demographic segments, purchase intent)
  • Track survey completion and question-level responses for advanced segmentation
  • Optionally activate Permutive cohorts to Collective Audience for targeted surveys

​
Environment Compatibility

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

​
Prerequisites

  • Permutive Project ID: Available in your Permutive dashboard project settings.
  • Custom SurveyResponse Event: Contact your Permutive Customer Success Manager (CSM) to configure the SurveyResponse custom event on your workspace. This event must be preconfigured before using this integration.
  • Access to Collective Audience Platform: You must have access to the Collective Audience dashboard where you can configure integrations.
  • Verify with your CSM: Confirm that this collector is part of your Permutive plan.

​
Setup

1

Request Custom Event Setup

Contact your Permutive Customer Success Manager (CSM) to configure the SurveyResponse custom event on your workspace.The SurveyResponse event is collected for every survey answer. If a survey has multiple questions, an event is emitted for each question.This is a prerequisite that must be completed before proceeding with the Collective Audience configuration.
2

Configure in Collective Audience

In the Collective Audience platform:
  1. Navigate to the DMP integration settings.
  2. Add your Permutive Project ID (found in your Permutive dashboard project settings).
  3. Save the configuration.
For detailed instructions, refer to Collective Audience’s DMP Configuration documentation.
3

Verify Data Collection

Once configured, survey responses from Collective Audience will automatically be sent to Permutive as SurveyResponse events.To verify:
  1. Navigate to the Permutive dashboard.
  2. Go to Events and look for the SurveyResponse event type.
  3. Check that survey response data is being collected.
4

Build Survey-Based Cohorts

Once event collection is verified, you can build cohorts based on survey responses. In the Permutive cohort builder, the SurveyResponse 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 (e.g., users who answered “Female” to a gender question)
  • Demographic segments (e.g., users who answered “25-34” to an age question)
  • Purchase intent (e.g., users interested in specific product categories)

​
Data Types

With your Collective Audience integration setup, you’ll see the following additional event types collected in Permutive:
The SurveyResponse event is emitted for each answer to a survey question. If a survey contains multiple questions, a SurveyResponse event is sent for each question answered.
​
answer.id
string
Collective Audience ID of the answer.
​
answer.text
string
Text of the answer provided by the user.
​
answer.valid
boolean
Whether the answer is valid.
​
answer.index
string
Index of the answer within the question options.
​
question.id
string
Collective Audience ID of the question.
​
question.text
string
Text of the question.
​
survey.id
string
Collective Audience ID of the survey.
​
survey.text
string
Text or title of the survey.
​
survey.complete
boolean
Whether the survey is completed (true when the last question is answered).
​
audience_question_match.id
string
Audience question match ID (Collective Audience technical field).
​
audience_question_match.tag
string
Audience question match tag (Collective Audience technical field).
​
audience_answer_match.id
string
Audience answer match ID (Collective Audience technical field).
​
audience_answer_match.tag
string
Audience answer match tag (Collective Audience technical field).
​
audience_survey_match.id
string
Audience survey match ID (Collective Audience technical field).
​
audience_survey_match.tag
string
Audience survey match tag (Collective Audience technical field).
​
audience_survey_match
array
List of audience survey match details (Collective Audience technical field).
​
audience_answer_match
array
List of audience answer match details (Collective Audience technical field).
​
audience_question_match
array
List of audience question match details (Collective Audience technical field).
SurveyResponse events also contain default Permutive event properties such as page URL (client.url) and page title (client.title).

​
Troubleshooting

Solution:
  • Verify that the SurveyResponse custom event has been created on your Permutive workspace. Contact your CSM if this step was missed.
  • Confirm that you have entered the correct Permutive Project ID in the Collective Audience DMP integration settings.
  • Check that the Permutive SDK is deployed on the pages where Collective Audience surveys are running.
  • Use your browser’s developer console to check for any JavaScript errors that might prevent event collection.
Solution:
  • Verify that you have ‘UpdateAll’ access to the Cohort API. Contact Technical Services to confirm API permissions.
  • Check that you have generated a valid API key from the Permutive dashboard and entered it correctly in Collective Audience.
  • Ensure “Activate Permutive retargeting” is enabled in Collective Audience settings and “Permutive API” mode is selected.
  • Confirm that the cohorts you want to retarget are active and have users.
Solution:
  • Not all survey types may populate all fields in the SurveyResponse event. The audience_question_match, audience_answer_match, and audience_survey_match fields are Collective Audience technical fields that may not be populated for all survey configurations.
  • Verify the survey configuration in Collective Audience to ensure the expected fields are being sent.
  • Check the Collective Audience documentation for details on which fields are supported for your survey type.

​
Changelog

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