Permutive Integration

Introduction

Permutive is a privacy-first audience platform that enables publishers and advertisers to build, analyze, and activate audience cohorts using first-party data. It allows teams to collaborate on audience insights and target campaigns without relying on third-party cookies.

Our Permutive integration allows you to send survey response data collected with Refiner directly to your Permutive account. Once configured, survey responses can be used to enrich audience cohorts and improve targeting, personalization, and campaign performance.

What we send to Permutive

You can choose for which surveys the integration should send data to Permutive. By default, all survey responses are sent once the integration is enabled.

Each event sent to Permutive contains the following information:

• The survey UUID and survey name
• An “alias” ID used to identify the user in Permutive
• Metadata about the survey response (for example timestamp and survey attributes)

The “completed survey” event also contains the survey response data provided by the user (see schema below).

How to set up this integration

The Refiner to Permutive data sync can be set up through the Refiner dashboard by navigating to Integrations Integrations → Permutive.

To set up the Permutive integration, follow these steps:

1. Log in to your Permutive dashboard and get your “Workspace ID” and “API Key”
2. In your Refiner dashboard, navigate to Integrations → Permutive.
3. Paste your Permutive credentials into the configuration field.
4. Choose which surveys should trigger data synchronization (optional).
5. Choose which survey events you want to sync to Permutive
6. Choose which field in Refiner holds the user ID used in Permutive and how the user ID is named
7. Save your settings.

That’s it! From this moment on, survey responses collected with Refiner will automatically be sent to your Permutive account.

Request Payload

For reference, the payload sent to to Permutive has the following format:

   "alias":{
      "tag": "--USER_ID_NAME--",
      "id":"--USER_ID--"
   },
   "events":[
      {
         "name":"--EVENT-NAME--",
         "time":"--EVENT-TIMESTAMP--",
         "workspace_id":"--PERMUTIVE-WORKSPACE-ID--",
         "properties":{
            "data":[
               {
                  "key":"question_identifier_1",
                  "label":"How was your day?",
                  "values":[
                     "Fantastic"
                  ]
               },
               {
                  "key":"question_identifier_2",
                  "label":"What are your preferred colors?",
                  "values":[
                     "blue",
                     "green"
                  ]
               }
            ],
            "response":{
               "id":"--RESPONSE-ID--",
               "completed":"--RESPONSE-TIMESTAMP--"
            },
            "survey":{
               "id":"--SURVEY-ID--",
               "name":"--SURVEY-NAME--"
            }
         }
      }
   ]
}