The FreeWheel integration requires involvement from your FreeWheel technical account manager in order to provision access to the Audience Item API.

1. Contact your Permutive Customer Success Manager to request the FreeWheel integration. You will need to provide:
   1. Your FreeWheel network code
   2. Your FreeWheel technical account manager
2. Permutive will provide a unique email alias to the FreeWheel technical accounts team. This is required to enable Audience Item API authentication
3. After Permutive has received confirmation that the alias has been enabled, we will need your username and password for the API so Permutive can enable the integration. Typically credentials are provided for a staging environment first, Permutive enables the integration, and you are able to test the integration. Once you are ready to run the integration in production, the production username and password should be shared with Permutive and Permutive will update the credentials for the integration so it can run in production.

When the FreeWheel integration is enabled, a new localStorage and activation key will be created. The freewheel key includes all of the cohort IDs for a given user that have been activated to FreeWheel.

The following are the local storage keys that will contain the Permutive cohorts that are activated to Freewheel:
web, HbbTV, Tizen - _pfws (note for the web environment we have some examples of how to append the cohorts to the ad requests, see here)
tvOS, iOS - freewheelCohorts
AndroidTV, FireTV, Android - freewheelActivations

Note: Customers will be responsible for retrieving cohort IDs from local storage, the SDK or the CCS API response and appending these to the FreeWheel ad request.

There are two main methods for activating cohorts within the Permutive platform. In each instance, you must turn on the FreeWheel activation for each cohort that you intend to make available within the ad server.

Important: FreeWheel does not accept two audiences with the same name. If you encounter an error when activating a cohort to FreeWheel, check to see if you already have an audience in your FreeWheel network with the same name as the one you are trying to use.

Sending Cohorts Via Activations

You can also send cohorts manually via the FreeWheel Activation.

In the Permutive Dashboard:

1. Login to your project, select 'Cohort Activation' *→ '*Add Activation'
2. Select the FreeWheel Action
3. Set up the activation for your cohort. For more guidance on setting up activations, see this guide.
4. Choose the cohort you'd like to activate to FreeWheel
5. Hit 'Save'

Cohorts activated to FreeWheel are represented as ‘audience items’ within the FreeWheel UI. In order to target a Permutive cohort for a campaign / line item you must:

1. Navigate to the ‘Audience’ section of the line item
2. Search for the audience item by name using the search function provided
3. Choose whether to include or exclude the audience item from being targeted for your campaign