Integrate with FreeWheel for targeting and campaign optimization
FreeWheel
FreeWheel offers a premium video ad server and SSP tailored to broadcasters and publishers for advanced monetization.
Setup
Troubleshooting
Overview
FreeWheel is a premium video ad server used by media companies, broadcasters, and publishers with significant video content and ad inventory. Our integration with FreeWheel enables activation of Permutive cohorts for campaign targeting within the FreeWheel ad server. This integration supports two distinct activation methods:Key-Value Activation: Real-time cohort activation via FreeWheel Federated Segments (Web, iOS, Android, CTV, API Direct). Cohort IDs are stored in local storage (Web), retrieved via SDK APIs (iOS/Android), or returned from the CCS API (API Direct).Identity Based Activation: Server-to-server cohort activation where Permutive uploads audience data enriched with cohort memberships to FreeWheel, keyed by identity tags such as IDFA, AAID, IP Address, and Connected TV device IDs. See Supported Identity Tags for the full list. Cohorts appear as Audiences in FreeWheel.Use cases include:
Activate Permutive cohorts in FreeWheel for real-time audience targeting on video inventory across all environments
Target premium video campaigns using first-party data segments from Permutive
Enable audience extension by activating cohorts on non-owned properties (Identity Based)
Share audience data across business units using identity-based activation
Enable broadcasters and publishers to monetize video content more effectively with data-driven targeting
Choosing an Activation Method
FreeWheel supports two activation methods. Choose the method that best fits your use case:
Aspect
Key-Value Activation
Identity Based Activation
Mechanism
Client-side, cohort IDs appended to ad requests
Server-to-server transfer
Environments
Web, iOS, Android, CTV, API Direct
Web, iOS, Android, CTV, API Direct
Sync Timing
Real-time
Daily
FreeWheel Feature
Federated Segments
Audiences
Use Cases
Real-time targeting on owned properties across all environments
Audience extension, cross business unit data sharing
Environment Compatibility
The table below shows which activation method is available for each environment:
Environment
Key-Value Activation
Identity Based Activation
Web
iOS
Android
CTV
API Direct
Supported Identity Tags
These identity tags apply to Identity Based Activation only — Permutive uploads cohort memberships to FreeWheel keyed by the identifiers below, and each maps to a FreeWheel id_type. (Key-Value Activation does not use identity tags; it appends cohort IDs to ad requests client-side.)
Identity Tag (tag)
Description
Environment
idfa
Apple Identifier for Advertisers (IDFA)
iOS
aaid
Android Advertising ID (AAID)
Android
ip_address
IP Address
CTV and other environments
ctv
Connected TV advertising IDs — RIDA (Roku), TIFA (Samsung), AFAI (Amazon Fire TV)
CTV
Identity Based Activation requires that Permutive is collecting the identity tags you select. Work with your Permutive Customer Success Manager to ensure identity collection is configured properly for your desired tags.
Prerequisites
For Key-Value Activation:
FreeWheel Account - You must have an active FreeWheel ad server account
FreeWheel Client ID - Your unique FreeWheel Client ID
Federated Segments Enabled - Your FreeWheel account manager must allow Permutive to create Federated Segments in your FreeWheel account
Permutive SDK - The Permutive SDK must be deployed on your web properties where FreeWheel ad requests are made
For Identity Based Activation:
FreeWheel Account - You must have an active FreeWheel ad server account
FreeWheel Client ID - Your unique FreeWheel Client ID
Permutive Identity Collection - Identity collection must be configured in Permutive for the identity tags you want to send (see Supported Identity Tags)
Setup
Key-Value Activation
Primary Setup Steps
Web
iOS
Android
API Direct
1
Contact FreeWheel Account Manager
Contact your FreeWheel account manager and ask them to allow Permutive to create Federated Segments in your FreeWheel account. This is required for the integration to work.
2
Provide Client ID to Permutive
Contact your Permutive Customer Success Manager to request the FreeWheel integration. You will need to provide your FreeWheel Client ID.Your Permutive Customer Success Manager will enable the FreeWheel integration in your Permutive workspace using this Client ID.
3
Verify Setup
In the Permutive Dashboard, navigate to one of your cohorts. Check that the FreeWheel activation sync is visible. Toggle it to On and save the cohort.In your FreeWheel dashboard, verify that a new Federated Segment has been created with a name matching your cohort ID. This confirms your integration setup is successful.
The FreeWheel integration uses a client-side key-value approach with FreeWheel Federated Segments. When cohorts are activated to FreeWheel in the Permutive Dashboard, Permutive creates a Federated Segment in FreeWheel, and the cohort IDs are stored in the browser’s local storage under a FreeWheel-specific key.You must implement code to retrieve these cohort IDs from local storage and append them to your FreeWheel ad requests. Permutive provides the cohort data, but your implementation is responsible for passing it to FreeWheel.
Accessing FreeWheel Cohorts for Targeting
Cohort IDs are stored in the local storage variable _pfws (this is the default key for FreeWheel activations). This variable is updated as soon as Permutive has segmented the user on the page.Below is an example of how to retrieve Permutive cohort IDs in a variable called cohorts, which you can then append to your FreeWheel ad requests:
var cohorts;try { cohorts = JSON.parse(window.localStorage._pfws || '[]').slice(0, 250).toString();} catch (e) { cohorts = '';}// Use the cohorts variable to append to your FreeWheel ad request// Example: append as key-value pairs in your ad request configuration
Implementation Notes
Ensure the Permutive SDK loads before you attempt to retrieve cohort IDs from local storage.
The cohort IDs are updated in real-time as users enter or exit cohorts.
You can append up to 250 cohort IDs per ad request (the .slice(0, 250) in the example limits this).
Coordinate with your development team to integrate this code into your FreeWheel ad request flow.
For technical assistance with implementation, contact Permutive Support.
Retrieve Permutive cohort IDs for FreeWheel using the activations property:
// Import Permutive SDKimport Permutive// Access FreeWheel Cohort IDs directlylet freeWheelCohorts: [String] = activations["freewheel"]// Construct your FreeWheel ad request// Append Permutive cohorts as key-valuesif !freeWheelCohorts.isEmpty { let cohortsString = freeWheelCohorts.joined(separator: ",") // Append cohortsString to your FreeWheel ad request}
Important Notes:
The activations property provides direct access to cohort IDs configured for FreeWheel activation
Use the key freewheel to retrieve FreeWheel-specific cohorts
Coordinate with your development team to integrate this code into your FreeWheel ad request flow
Retrieve Permutive cohort IDs for FreeWheel using the TriggersProvider API. The callback is invoked whenever cohort membership changes:
val triggerAction: TriggerAction = triggersProvider.cohortActivations( activationType = "freewheel", callback = object : Method<List<String>> { override fun invoke(cohorts: List<String>) { if (cohorts.isNotEmpty()) { // Cohorts available for FreeWheel activation // Pass these to your FreeWheel ad requests as key-values println("FreeWheel cohorts: $cohorts") } else { println("No active cohorts with a FreeWheel activation configured.") } } })
Once you have the cohort IDs, append them to your FreeWheel ad request.Important Notes:
The TriggersProvider API allows you to listen for cohort membership changes
Use the activation type freewheel to retrieve FreeWheel-specific cohorts
In environments where it is not possible to deploy a Permutive SDK (e.g. some CTV environments), you can use Permutive’s CCS (Custom Cohort Segmentation) API for event tracking and segmentation instead.Access to this API requires customer-specific authorization. You will need a dedicated API key from Permutive.
How it Works
The CCS API can be used to:
Track events for a specific user (optional)
Retrieve cohort IDs for activation
The events array in the request is optional. If you only need to retrieve cohort memberships without tracking a new event, you can pass an empty array.
The API accepts a user identity passed in the alias object. Permutive then either links this identity to an existing Permutive user ID or creates a new Permutive user ID if the identity hasn’t been seen before.Example Response:
The API response includes cohort IDs for FreeWheel activation under the freewheel key within the activations object. These can then be passed to FreeWheel as key-values for activation.Important Notes:
Replace PERMUTIVE_API_KEY with your actual Permutive API key
The activations=true query parameter is required to receive activation data in the response
Identity Based Activation
Primary Setup Steps
iOS
Android
CTV
1
Contact Permutive CSM
Contact your Permutive Customer Success Manager to enable Identity Based Activation for FreeWheel. This is a server-to-server integration that must be configured by Permutive.
2
Configure in Permutive Dashboard
Once enabled, navigate to Settings → Integrations in the Permutive Dashboard. Find “FreeWheel (ID-based)” in the list of available integrations and click to configure it.
3
Enter FreeWheel Client ID
Provide your FreeWheel Client ID in the configuration form. This is the same Client ID used for key-value activation if you have that enabled.
4
Select Identity Tags
Choose which identity tags you want to send to FreeWheel.See Supported Identity Tags for all available types. Select the tags that match your use case and the environments where you need activation.
5
Save Configuration
Save your configuration. Permutive will begin syncing cohort data to FreeWheel on a daily basis for users with the selected identity types.
6
Activate Cohorts
Navigate to your cohorts in the Permutive Dashboard and enable the “FreeWheel (ID-based)” activation toggle for each cohort you want to sync to FreeWheel.
7
Verify in FreeWheel
After the first sync completes (within 24 hours), check your FreeWheel dashboard to verify that audiences appear with names matching your activated cohorts.
Cohort data syncs to FreeWheel daily. Changes to cohort membership will be reflected in FreeWheel within 24 hours of the next scheduled sync.
Identity Based Activation requires that Permutive is collecting the identity types you select. Work with your Permutive Customer Success Manager to ensure identity collection is configured properly for your desired identity types.
Identity Based Activation for iOS enables server-to-server cohort syncing using IDFA (Identifier for Advertisers). No SDK code changes are required on iOS devices.How it works:
Permutive collects IDFA values from iOS users via the Permutive SDK
Cohort memberships are synced daily to FreeWheel server-to-server
Cohorts appear as Audiences in FreeWheel, ready for campaign targeting
Data syncing happens automatically once configured in the Permutive Dashboard
Prerequisites:
Permutive SDK must be deployed on your iOS app
IDFA collection must be enabled and properly configured
Users must grant tracking permission for IDFA to be available
Identity Based Activation for Android enables server-to-server cohort syncing using AAID (Android Advertising ID). No SDK code changes are required on Android devices.How it works:
Permutive collects AAID values from Android users via the Permutive SDK
Cohort memberships are synced daily to FreeWheel server-to-server
Cohorts appear as Audiences in FreeWheel, ready for campaign targeting
Data syncing happens automatically once configured in the Permutive Dashboard
Prerequisites:
Permutive SDK must be deployed on your Android app
AAID collection must be enabled and properly configured
Identity Based Activation for CTV enables server-to-server cohort syncing using IP Address or other supported identifiers. No SDK code changes are required on CTV devices.How it works:
Permutive collects IP addresses (or other supported identifiers) from CTV users
Cohort memberships are synced daily to FreeWheel server-to-server
Cohorts appear as Audiences in FreeWheel, ready for campaign targeting
Data syncing happens automatically once configured in the Permutive Dashboard
Prerequisites:
Permutive must be collecting IP addresses or other supported identifiers from your CTV environment
Work with your Permutive Customer Success Manager to ensure proper identity collection for CTV
Data Types
The FreeWheel integration is a Destination-only integration for cohort activation. It does not collect event data from FreeWheel.
Cohort Activation Data (Key-Value)
When you activate a cohort to FreeWheel using Key-Value Activation, Permutive creates a Federated Segment in FreeWheel and makes cohort IDs available for targeting via key-value pairs.Cohort ID Format:
Cohort IDs are stored as an array in local storage under the _pfws key
Each ID corresponds to a cohort the user is a member of
Maximum of 250 cohort IDs can be passed per ad request
FreeWheel Federated Segment:
Created automatically when a cohort is activated
Named using the cohort ID from Permutive
Searchable in FreeWheel’s audience targeting interface
Can be used for campaign targeting (include or exclude)
Represents a reusable audience segment across all sites and site sections within your FreeWheel network
Cohort Activation Data (Identity Based)
When you activate a cohort using Identity Based Activation, Permutive uploads audience data enriched with cohort memberships to FreeWheel via a server-to-server transfer.Data Transfer:
Cohort data is synced daily from Permutive to FreeWheel
Data is keyed by the identity tags you selected during configuration (see Supported Identity Tags)
Each user’s cohort memberships are associated with their identity values
FreeWheel Audiences:
Cohorts appear as Audiences in FreeWheel
Named using the cohort name from Permutive
Available for campaign targeting in FreeWheel’s audience targeting interface
Updated daily with the latest cohort membership data
Troubleshooting
Unable to enable FreeWheel integration in Permutive Dashboard
If you cannot see the FreeWheel integration option in your Permutive Dashboard:
Verify that your Permutive Customer Success Manager has enabled the integration for your workspace
Confirm that your FreeWheel account manager has allowed Permutive to create Federated Segments in your FreeWheel account
Check that your FreeWheel Client ID was provided to Permutive
Contact your Permutive Customer Success Manager if the integration is still not visible.
Federated Segments not appearing in FreeWheel
If cohorts are activated in Permutive but Federated Segments are not created in FreeWheel:
Client ID: Verify that the correct FreeWheel Client ID was provided to Permutive
Federated Segments Permission: Check with your FreeWheel account manager that Permutive has been allowed to create Federated Segments in your FreeWheel account
Cohort Activation: Ensure the cohort has the FreeWheel activation toggle set to On in the Permutive Dashboard
If the issue persists after checking these items, contact Permutive Support.
Cohort IDs not available in local storage
If you cannot find cohort IDs in local storage (_pfws key):
Cohort Activation: Verify the cohort has the FreeWheel activation toggle set to On in the Permutive Dashboard
SDK Deployment: Ensure the Permutive SDK is properly deployed and loading on your web pages
User Membership: Confirm the current user is actually a member of the activated cohort (check in browser console using permutive.segments())
Browser Console: Open browser console and check window.localStorage._pfws to see if the key exists
If the key exists but is empty, the user may not be in any activated cohorts.
Cohorts not being passed to FreeWheel ad requests
If cohort IDs are in local storage but not appearing in your FreeWheel ad requests:
Implementation: Verify you’ve implemented the code to retrieve cohort IDs from local storage (see Web Setup tab)
Timing: Ensure the Permutive SDK loads before you attempt to retrieve cohort IDs
Ad Request Configuration: Check that your ad request code is correctly appending the cohort variable to FreeWheel ad calls
Network Inspection: Use browser developer tools to inspect network requests to FreeWheel and verify cohort IDs are included
For implementation assistance, contact Permutive Support.
Cohorts not appearing in SDK APIs (iOS/Android)
If cohort IDs are not being returned by the SDK APIs:
Cohort Activation: Verify the cohort has the FreeWheel activation toggle set to On in the Permutive Dashboard
SDK Deployment: Ensure the Permutive SDK is properly deployed and initialized in your app
Activation Type: Verify you’re using the correct activation type key (freewheel)
User Membership: Confirm the current user is a member of the activated cohort
For iOS, check the activations property. For Android, ensure the TriggersProvider callback is properly set up with activation type freewheel.
API Direct returning empty activations
If the CCS API response includes an empty freewheel array or doesn’t include the key at all:
Integration Enabled: Verify the FreeWheel integration is enabled in the Permutive dashboard
Cohort Activation: Check that cohorts have been activated for FreeWheel
User Membership: Ensure the user identified in the API request (via alias) is a member of activated cohorts
Query Parameter: Confirm the activations=true query parameter is included in the API request URL
API Key: Verify the API key used in the request has the correct permissions
For API Direct issues, contact your Permutive Customer Success Manager for assistance.
Need to update Client ID
If you need to update your FreeWheel Client ID:
Contact your Permutive Customer Success Manager with the new Client ID
Permutive will update the configuration for your integration
Do not attempt to update the Client ID directly - always work with your Customer Success Manager.
Issues with Identity Based Activation
If you’re experiencing issues with Identity Based Activation:
Missing Audiences: Verify that cohorts are activated with the “FreeWheel (ID-based)” toggle enabled in the Permutive Dashboard
Sync Timing: Remember that cohort data syncs daily - allow up to 24 hours for changes to appear in FreeWheel
Identity Collection: Confirm that Permutive is collecting the identity tags you selected (see Supported Identity Tags) by checking with your Permutive Customer Success Manager
Configuration: Verify your FreeWheel Client ID and selected identity tags are correct in Settings → Integrations
For Identity Based Activation issues, contact your Permutive Customer Success Manager for assistance.
Changelog
May 2026
Documented the full set of supported identity tags for Identity Based Activation, including Connected TV device IDs (RIDA, TIFA, AFAI)
January 2026
Added Identity Based Activation support for all environments
Identity Based Activation enables server-to-server cohort upload keyed by AAID, IDFA, or IP Address
Cohorts activated via Identity Based Activation appear as Audiences in FreeWheel
November 2025
Documentation updated to clarify that the integration uses FreeWheel Federated Segments
January 2023
Initial release of FreeWheel integration for cohort activation
For detailed changelog information, visit our Changelog.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Permutive","colors":{"primary":"#ff5e99","light":"#f3eefe","dark":"#632ef5"},"logo":{"light":"https://mintcdn.com/permutive/zX9G7jjpccuZZlEf/logo/permutive-logo-light.svg?fit=max\u0026auto=format\u0026n=zX9G7jjpccuZZlEf\u0026q=85\u0026s=ae940c2b1c2eb923f6344b583fef176c","dark":"https://mintcdn.com/permutive/zX9G7jjpccuZZlEf/logo/permutive-logo-dark.svg?fit=max\u0026auto=format\u0026n=zX9G7jjpccuZZlEf\u0026q=85\u0026s=6406296261c92b204e6a6a9f8cca5676"},"favicon":"https://mintcdn.com/permutive/pNhz39ducTVcQczh/favicon.svg?fit=max\u0026auto=format\u0026n=pNhz39ducTVcQczh\u0026q=85\u0026s=a80278bd668352096f35034b78398cb5","navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://dash.permutive.com"}},"footer":{"socials":{"x":"https://x.com/permutive","github":"https://github.com/permutive","linkedin":"https://uk.linkedin.com/company/permutive"}},"styling":{"codeblocks":"dark","latex":true},"variables":{"android_core_release_version":"1.16.0","android_google_ads_release_version":"2.2.0","android_appnexus_release_version":"1.7.0"},"navigation":{"global":{"anchors":[{"anchor":"Support","icon":"life-ring","href":"mailto:technical-services@permutive.com"},{"anchor":"Status","icon":"signal","href":"https://status.permutive.com"},{"anchor":"Changelog","icon":"megaphone","href":"https://changelog.permutive.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"permutive","hasAudioNarration":false,"actualSubdomain":"permutive","customDomains":["docs.permutive.com"],"gitSource":{"type":"github","owner":"permutive","repo":"permutive-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afc2afc2d447c3b84b9c090","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Guides","count":145},{"language":"default","tag":"Integrations","count":123},{"language":"default","tag":"Platform","count":102},{"language":"default","tag":"Deployment","count":66},{"language":"default","tag":"Signals","count":48},{"language":"default","tag":"Mobile","count":40},{"language":"default","tag":"Cohorts","count":37},{"language":"default","tag":"APIs","count":35},{"language":"default","tag":"Advertising","count":25},{"language":"default","tag":"Connectivity","count":22}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles/custom.css","content":"pre,pre[class*=\"shiki\"],[data-rehype-pretty-code-fragment] pre,div[data-rehype-pretty-code-fragment] pre,figure[data-rehype-pretty-code-figure] pre{background-color:#1A1A1A!important}pre span[style],code span[style]{color:var(--shiki-dark)!important}:not(pre)>code{padding:0.2em 0.4em;border-radius:3px}html:not(.dark) :not(pre)>code{background-color:#EDEDED!important;color:#FA8784!important}html.dark :not(pre)>code{background-color:#1A1A1A!important;color:#F7D0E2!important}[data-callout-type=\"note\"]{border-color:#5BB5E0!important}[data-callout-type=\"note\"] svg{color:#5BB5E0!important}[data-callout-type=\"tip\"]{border-color:#9B7EE8!important}[data-callout-type=\"tip\"] svg{color:#9B7EE8!important}[data-callout-type=\"info\"]{border-color:#9CA3AF!important}[data-callout-type=\"info\"] svg{color:#6B7280!important}[data-callout-type=\"warning\"]{border-color:#E8956A!important}[data-callout-type=\"warning\"] svg{color:#E8956A!important}html:not(.dark) [data-callout-type=\"note\"]{background-color:rgba(199, 232, 249, 0.4)!important}html:not(.dark) [data-callout-type=\"tip\"]{background-color:rgba(203, 182, 255, 0.4)!important}html:not(.dark) [data-callout-type=\"info\"]{background-color:rgba(237, 237, 237, 0.5)!important}html:not(.dark) [data-callout-type=\"warning\"]{background-color:rgba(249, 193, 168, 0.4)!important}html:not(.dark) :is([data-callout-type=\"note\"],[data-callout-type=\"tip\"],[data-callout-type=\"info\"],[data-callout-type=\"warning\"]) [data-component-part=\"callout-content\"]{color:#1A1A1A!important}html.dark [data-callout-type=\"note\"]{background-color:rgba(91, 181, 224, 0.12)!important}html.dark [data-callout-type=\"tip\"]{background-color:rgba(155, 126, 232, 0.14)!important}html.dark [data-callout-type=\"info\"]{background-color:rgba(156, 163, 175, 0.12)!important}html.dark [data-callout-type=\"info\"] svg{color:#9CA3AF!important}html.dark [data-callout-type=\"warning\"]{background-color:rgba(232, 149, 106, 0.12)!important}html.dark :is([data-callout-type=\"note\"],[data-callout-type=\"tip\"],[data-callout-type=\"info\"],[data-callout-type=\"warning\"]) [data-component-part=\"callout-content\"]{color:#E5E7EB!important}html.dark [data-callout-type] :not(pre)>code{background-color:rgba(255, 255, 255, 0.1)!important;color:#F7D0E2!important}.agent-chat-user{display:flex;justify-content:flex-end;margin:1.25rem 0}.agent-chat-user-bubble{max-width:85%;padding:0.75rem 1rem;border-radius:1rem;background-color:#F0F0F0;color:#1A1A1A}.agent-chat-user-bubble>p{margin:0.4rem 0}.agent-chat-agent{margin:1.25rem 0;padding:1rem 1.25rem 0.75rem;border:1px solid #E5E5E5;border-radius:1rem}.agent-chat-tools{font-size:0.8rem;color:#8A8A8A;margin-bottom:0.5rem}html.dark .agent-chat-user-bubble{background-color:#2A2A2A;color:#EDEDED}html.dark .agent-chat-agent{border-color:#333333}.agent-chat-conversation{display:grid;grid-template-columns:minmax(0, 1fr) 16.5rem;column-gap:5.75rem;margin:2rem -22.25rem 3rem 0}body:has(.agent-chat-conversation) #content-side-layout{pointer-events:none}body:has(.agent-chat-conversation) #table-of-contents-layout{pointer-events:auto}.agent-chat-conversation>.agent-chat-turn{grid-column:1;min-width:0;margin-bottom:1.5rem}.agent-chat-conversation{position:relative}.agent-chat-conversation>.agent-chat-rail{position:absolute;top:0;right:0;bottom:calc(-1 * var(--agent-chat-rail-extend, 0px));width:16.5rem}.agent-chat-turn-label{display:none}.agent-chat-rail-list{position:sticky;top:calc(9.5rem + var(--agent-chat-toc-height, 15rem) + 1.5rem);max-height:calc(100vh - 9.5rem - var(--agent-chat-toc-height, 15rem) - 2.5rem);overflow-y:auto;overscroll-behavior:contain;scrollbar-width:none;list-style:none;margin:0;padding:0 0 0 1.25rem}.agent-chat-rail-list::-webkit-scrollbar{display:none}.agent-chat-rail-list::before{content:\"\";position:absolute;left:0;top:0;bottom:0;width:3px;border-radius:3px;background-color:#E5E5E5}.agent-chat-rail-step{position:relative}.agent-chat-rail-step::before{content:\"\";position:absolute;left:-1.25rem;top:0;bottom:0;width:3px;border-radius:3px;background-color:#ff5e99;opacity:0;transition:opacity 0.25s ease}.agent-chat-rail-step.is-active::before{opacity:1}.agent-chat-rail-step{margin:0 0 0.9rem;padding:0;font-size:0.875rem;opacity:0.45;transition:opacity 0.3s ease}.agent-chat-rail-step::marker{content:none}.agent-chat-rail-step.is-done{opacity:0.65}.agent-chat-rail-step.is-active{opacity:1}.agent-chat-rail-step .agent-chat-note-body{display:grid;grid-template-rows:0fr;overflow:hidden;transition:grid-template-rows 0.3s ease}.agent-chat-rail-step .agent-chat-note-body>*{min-height:0}.agent-chat-rail-step.is-active .agent-chat-note-body{grid-template-rows:1fr}.agent-chat-note-title{font-weight:600;margin:0.15rem 0 0.4rem}.agent-chat-note-body code{font-size:0.75rem}html.dark .agent-chat-rail-list::before{background-color:#333333}@media (max-width: 1279px){.agent-chat-conversation{grid-template-columns:minmax(0, 1fr);margin-right:0}.agent-chat-conversation>.agent-chat-rail{position:absolute;width:1px;height:1px;overflow:hidden;clip-path:inset(50%)}.agent-chat-rail-list{position:relative;top:auto;max-height:none;overflow:visible;-webkit-mask-image:none!important;mask-image:none!important}.agent-chat-rail-step::before{display:none}.agent-chat-rail-step,.agent-chat-rail-step.is-done{opacity:1}.agent-chat-rail-step .agent-chat-note-body{grid-template-rows:1fr}.agent-chat-turn-label{display:none}.agent-chat-conversation{padding-top:var(--agent-chat-floating-space, 0px)}}.agent-chat-excerpt{-webkit-mask-image:linear-gradient(to bottom, black calc(100% - 3rem), transparent);mask-image:linear-gradient(to bottom, black calc(100% - 3rem), transparent)}.agent-chat-body:has(details[open]) .agent-chat-excerpt{display:none}.agent-chat-full>summary{cursor:pointer;list-style:none;font-size:0.8rem;font-weight:600;color:#ff5e99;text-align:center;padding:0.25rem 0}.agent-chat-full>summary::-webkit-details-marker{display:none}.agent-chat-full>summary::after{content:\"Show full response ↓\"}.agent-chat-full[open]>summary::after{content:\"Show less ↑\"}.agent-chat-chart{margin:1rem 0;padding:1rem;border-radius:0.75rem;background-color:#F7F7F7}.agent-chat-chart-caption{margin-bottom:0.75rem}.agent-chat-chart-title{font-weight:600;font-size:0.9rem}.agent-chat-chart-unit{font-size:0.75rem;color:#8A8A8A}.agent-chat-chart-row{display:grid;grid-template-columns:9.5rem minmax(0, 1fr) 4.5rem;align-items:center;gap:0.75rem;font-size:0.8rem;margin:0.3rem 0}.agent-chat-chart-label{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.agent-chat-chart-track{height:0.9rem}.agent-chat-chart-bar{display:block;height:100%;border-radius:0 4px 4px 0;background-color:#ff5e99}.agent-chat-chart-value{text-align:right;font-variant-numeric:tabular-nums}html.dark .agent-chat-chart{background-color:#222222}@media (max-width: 640px){.agent-chat-chart-row{grid-template-columns:7rem minmax(0, 1fr) 4rem;gap:0.5rem}}.agent-chat-user-bubble [data-as=\"p\"],.agent-chat-body [data-as=\"p\"]{display:block;margin:0.6rem 0}.agent-chat-user-bubble [data-as=\"p\"]:first-child{margin-top:0}.agent-chat-user-bubble [data-as=\"p\"]:last-child{margin-bottom:0}.agent-chat-conversation .agent-chat-user,.agent-chat-conversation .agent-chat-agent{margin:0.5rem 0}.agent-chat-user-bubble,.agent-chat-agent,.agent-chat-attachment{transition:box-shadow 0.25s ease}.agent-chat-turn.is-current .agent-chat-user-bubble,.agent-chat-turn.is-current .agent-chat-agent,.agent-chat-turn.is-current .agent-chat-attachment{box-shadow:0 0 0 2px #ff5e99}.agent-chat-connector{position:fixed;inset:0;z-index:20;pointer-events:none;overflow:visible}.agent-chat-connector path{fill:none;stroke:#ff5e99;stroke-width:2;stroke-linejoin:round}.agent-chat-body table{font-size:0.8125rem}.agent-chat-body table th,.agent-chat-body table td{min-width:0;white-space:normal}.agent-chat-tools a{border-bottom:none}.agent-chat-conversation>.agent-chat-agent{grid-column:1;min-width:0;margin:0.5rem 0 1.5rem}.agent-chat-part{margin:0 -0.75rem;padding:0.25rem 0.75rem;border-radius:0.6rem;transition:box-shadow 0.25s ease}.agent-chat-turn.agent-chat-part.is-current{box-shadow:0 0 0 2px #ff5e99}.agent-chat-attachment-row{display:flex;justify-content:flex-end;margin:0.5rem 0 0.3rem}.agent-chat-conversation>.agent-chat-turn:has(>.agent-chat-attachment-row){margin-bottom:0}.agent-chat-attachment{display:inline-flex;align-items:center;gap:0.5rem;padding:0.5rem 0.75rem;border:1px solid #E5E5E5;border-radius:0.75rem;background:none;font-size:0.8125rem;cursor:zoom-in}.agent-chat-attachment:hover{border-color:#ff5e99}.agent-chat-attachment-kind{font-size:0.65rem;font-weight:600;padding:0.1rem 0.35rem;border-radius:0.3rem;background-color:#F0F0F0;color:#6B6B6B}.agent-chat-document{position:fixed;inset:0;margin:auto;height:fit-content;width:min(52rem, calc(100vw - 2rem));max-height:calc(100vh - 4rem);padding:0;border:1px solid #E5E5E5;border-radius:0.75rem;overflow:auto;background-color:#F7F7F7}.agent-chat-document::backdrop{background-color:rgb(0 0 0 / 0.4)}.agent-chat-document-header{position:sticky;top:0;display:flex;justify-content:space-between;align-items:center;padding:0.6rem 1rem;border-bottom:1px solid #E5E5E5;background-color:#FFFFFF;font-size:0.875rem;font-weight:600}.agent-chat-document-header button{background:none;border:none;cursor:pointer;font-size:1rem;color:#6B6B6B}.agent-chat-document-pages{display:flex;flex-direction:column;gap:1rem;padding:1rem}.agent-chat-document-pages img{width:100%;margin:0;border-radius:0.25rem;box-shadow:0 1px 4px rgb(0 0 0 / 0.15)}html.dark .agent-chat-attachment,html.dark .agent-chat-document,html.dark .agent-chat-document-header{border-color:#333333}html.dark .agent-chat-document{background-color:#1A1A1A}html.dark .agent-chat-document-header{background-color:#222222}html.dark .agent-chat-attachment-kind{background-color:#2A2A2A;color:#AAAAAA}.agent-chat-doc-link{display:block;margin-top:0.4rem;padding:0;border:none;background:none;font-size:0.8125rem;font-weight:600;color:#ff5e99;cursor:pointer}.agent-chat-doc-link:hover{text-decoration:underline}.agent-chat-document-annotated .agent-chat-document-header{background-color:#FFF0F5;border-bottom-color:#FFD1E1;color:#B3245B}.agent-chat-document-annotated .agent-chat-document-pages img{box-shadow:none;border:1px solid #E5E5E5}html.dark .agent-chat-document-annotated .agent-chat-document-header{background-color:#3A1A27;border-bottom-color:#5A2A3D;color:#FF9EC1}.agent-chat-document-annotated .agent-chat-document-pages{gap:0;margin:1rem;padding:1rem;border:1px solid #E5E5E5;border-radius:0.25rem;background-color:#FFFFFF}.agent-chat-document-annotated .agent-chat-document-pages img{border:none;border-radius:0}.agent-chat-document-annotated .agent-chat-document-pages img+img{margin-top:0.75rem;padding-top:0.75rem;border-top:1px dashed #D0D0D0}.agent-chat-attachment-output{justify-content:flex-start;margin:1rem 0 0.5rem}.agent-chat-document-wide{width:min(90rem, calc(100vw - 4rem))}.agent-chat-attachment-label{display:inline-flex;align-items:center;gap:0.5rem;min-width:0}.agent-chat-attachment-card{flex-direction:column;align-items:stretch;gap:0.5rem;width:33%;min-width:14rem;padding:0.5rem 0.5rem 0.6rem}.agent-chat-attachment-card .agent-chat-attachment-thumb{display:block;width:100%;margin:0;border:1px solid #EDEDED;border-radius:0.4rem}.agent-chat-attachment-card .agent-chat-attachment-label{padding:0 0.25rem}.agent-chat-attachment-card .agent-chat-attachment-name{text-align:left}.agent-chat-attachment-card .agent-chat-attachment-kind{margin-left:auto}html.dark .agent-chat-attachment-card .agent-chat-attachment-thumb{border-color:#333333}.agent-chat-document-wide .agent-chat-document-pages img{width:auto;max-width:100%;max-height:calc(100vh - 10rem);margin:0 auto}.agent-chat-card-tags{display:flex;flex-wrap:wrap;gap:0.35rem;margin-top:0.6rem}.agent-chat-card-tags>span{padding:0.1rem 0.45rem;border-radius:0.3rem;background-color:#FFF0F5;color:#B3245B;font-size:0.7rem;font-weight:600}html.dark .agent-chat-card-tags>span{background-color:#3A1A27;color:#FF9EC1}a.agent-chat-note-title{display:block;color:inherit;text-decoration:none;border-bottom:none;cursor:pointer}a.agent-chat-note-title:hover{color:#ff5e99}.agent-chat-turn{scroll-margin-top:9rem}.agent-chat-floating{position:fixed;z-index:30;box-sizing:border-box;padding:0.75rem 1rem;border:1px solid #E5E5E5;border-left:3px solid #ff5e99;border-radius:0.6rem;background-color:#FFFFFF;box-shadow:0 6px 20px rgb(0 0 0 / 0.08);font-size:0.8125rem;line-height:1.45;opacity:0;visibility:hidden;transition:opacity 0.2s ease, visibility 0.2s}.agent-chat-floating.is-visible{opacity:1;visibility:visible}.agent-chat-floating-title{font-weight:600;margin-bottom:0.25rem}.agent-chat-floating-body code{font-size:0.75rem}.agent-chat-floating .agent-chat-doc-link{margin-top:0.3rem}html.dark .agent-chat-floating{background-color:#1A1A1A;border-color:#333333;border-left-color:#ff5e99}@media (min-width: 1280px){.agent-chat-floating{display:none}}.agent-chat-body table code{white-space:nowrap}"}],"page":{"pagePath":"integrations/advertising/ad-servers/freewheel","slug":"/integrations/advertising/ad-servers/freewheel","pageMetadata":{"title":"FreeWheel","description":"Integrate with FreeWheel for targeting and campaign optimization","href":"/integrations/advertising/ad-servers/freewheel"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Integrate with FreeWheel for targeting and campaign optimization\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const NoBadge=()=>{return _jsx(`span`,{style:{display:`inline-block`,padding:`0.125rem 0.5rem`,borderRadius:`0.25rem`,fontSize:`0.625rem`,background:`#F7D0E2`,color:`#1A1A1A`,fontWeight:`500`},children:`No`})};const YesBadge=()=>{return _jsx(`span`,{style:{display:`inline-block`,padding:`0.125rem 0.5rem`,borderRadius:`0.25rem`,fontSize:`0.625rem`,background:`#C7E8F9`,color:`#1A1A1A`,fontWeight:`500`},children:`Yes`})};const BadgeRowCenter=({label,children})=>{return _jsxs(`div`,{style:{display:`flex`,justifyContent:`space-between`,alignItems:`center`,marginBottom:`0.5rem`},children:[_jsx(`span`,{style:{fontSize:`0.625rem`,color:`#6b7280`,textTransform:`uppercase`,fontWeight:`500`,letterSpacing:`0.05em`},children:label}),children]})};const BadgeRow=({label,children})=>{return _jsxs(`div`,{style:{display:`flex`,justifyContent:`space-between`,alignItems:`flex-start`,marginBottom:`0.5rem`},children:[_jsx(`span`,{style:{fontSize:`0.625rem`,color:`#6b7280`,textTransform:`uppercase`,fontWeight:`500`,letterSpacing:`0.05em`},children:label}),children]})};const BadgeContainer=({children})=>{return _jsx(`div`,{style:{display:`flex`,gap:`0.25rem`,flexWrap:`wrap`,justifyContent:`flex-end`,minWidth:`0`,flex:`1`},children})};const ProductRequiredBadge=({product})=>{const getBadgeStyle=product=>{switch(product){case`Core Platform`:return{background:`#CB88FC`,color:`#1A1A1A`};--purple;case`Routing`:return{background:`#CB88FC`,color:`#1A1A1A`};--purple;case`Contextual`:return{background:`#CB88FC`,color:`#1A1A1A`};--purple;default:return{background:`#A7B3D9`,color:`#1A1A1A`};--haze}};const style=getBadgeStyle(product);return _jsx(`span`,{style:{display:`inline-block`,padding:`0.125rem 0.375rem`,borderRadius:`0.25rem`,fontSize:`0.625rem`,background:style.background,color:style.color,fontWeight:`500`},children:product})};const SdkRequiredBadge=({required})=>{const getBadgeStyle=required=>{switch(required){case`Yes`:return{background:`#C7E8F9`,color:`#1A1A1A`};--blue;case`No`:return{background:`#F7D0E2`,color:`#1A1A1A`};--pink;default:return{background:`#A7B3D9`,color:`#1A1A1A`};--haze}};const style=getBadgeStyle(required);return _jsx(`span`,{style:{display:`inline-block`,padding:`0.125rem 0.375rem`,borderRadius:`0.25rem`,fontSize:`0.625rem`,background:style.background,color:style.color,fontWeight:`500`},children:required})};const CapabilityBadge=({capability})=>{const getBadgeStyle=capability=>{switch(capability){case`Event Collection`:return{background:`#EFDFC8`,color:`#1A1A1A`};--clay;case`Cohort Activation`:return{background:`#EFDFC8`,color:`#1A1A1A`};--clay;case`Campaign Optimization`:return{background:`#EFDFC8`,color:`#1A1A1A`};--clay;case`Identity Signal`:return{background:`#EFDFC8`,color:`#1A1A1A`};--clay;case`Contextual Signal`:return{background:`#EFDFC8`,color:`#1A1A1A`};--clay;case`Connectivity`:return{background:`#EFDFC8`,color:`#1A1A1A`};--clay;case`Routing`:return{background:`#EFDFC8`,color:`#1A1A1A`};--clay;case`Data Collaboration`:return{background:`#EFDFC8`,color:`#1A1A1A`};--clay;default:return{background:`#A7B3D9`,color:`#1A1A1A`};--haze}};const style=getBadgeStyle(capability);return _jsx(`span`,{style:{display:`inline-block`,padding:`0.125rem 0.375rem`,borderRadius:`0.25rem`,fontSize:`0.625rem`,background:style.background,color:style.color,fontWeight:`500`,whiteSpace:`nowrap`},children:capability})};const EnvironmentBadge=({environment})=>{const getBadgeStyle=environment=>{switch(environment){case`Web`:return{background:`#F9C1A8`,color:`#1A1A1A`};--peach;case`iOS`:return{background:`#F9C1A8`,color:`#1A1A1A`};--peach;case`Android`:return{background:`#F9C1A8`,color:`#1A1A1A`};--peach;case`CTV`:return{background:`#F9C1A8`,color:`#1A1A1A`};--peach;case`API Direct`:return{background:`#F9C1A8`,color:`#1A1A1A`};--peach;case`Realtime API`:return{background:`#F9C1A8`,color:`#1A1A1A`};--peach;default:return{background:`#A7B3D9`,color:`#1A1A1A`};--haze}};const style=getBadgeStyle(environment);return _jsx(`span`,{style:{display:`inline-block`,padding:`0.125rem 0.375rem`,borderRadius:`0.25rem`,fontSize:`0.625rem`,background:style.background,color:style.color,fontWeight:`500`,whiteSpace:`nowrap`},children:environment})};const DirectionBadge=({direction})=>{const getBadgeStyle=direction=>{switch(direction){case`Bidirectional`:return{background:`#FA8784`,color:`#1A1A1A`};--tomato;case`Destination`:return{background:`#FA8784`,color:`#1A1A1A`};--tomato;case`Source`:return{background:`#FA8784`,color:`#1A1A1A`};--tomato;default:return{background:`#A7B3D9`,color:`#1A1A1A`};--haze}};const style=getBadgeStyle(direction);return _jsx(`span`,{style:{display:`inline-block`,padding:`0.125rem 0.375rem`,borderRadius:`0.25rem`,fontSize:`0.625rem`,background:style.background,color:style.color,fontWeight:`500`},children:direction})};function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CardGroup,CodeBlock,Heading,Info,Note,OptimizedImage,Step,Steps,Tab,Table,Tabs,_MdxComponentBoundary}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsxs(_Fragment,{children:[_jsxs(Card,{title:``,children:[_jsxs(`div`,{style:{display:`flex`,alignItems:`center`,marginBottom:`1rem`},children:[_jsx(`div`,{style:{width:`32px`,height:`32px`,marginRight:`0.75rem`,display:`flex`,alignItems:`center`,justifyContent:`center`,flexShrink:0},children:_jsx(OptimizedImage,{src:`https://mintcdn.com/permutive/tY6HQAw8J0a8II15/images/integrations/logos/freewheel-icon.png?fit=max\u0026auto=format\u0026n=tY6HQAw8J0a8II15\u0026q=85\u0026s=154a46d899cd3da68fc8ac012f174a15`,alt:`FreeWheel`,style:{maxWidth:`32px`,maxHeight:`32px`,display:`block`},\"data-og-width\":`256`,width:`256`,\"data-og-height\":`256`,height:`256`,\"data-path\":`images/integrations/logos/freewheel-icon.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/permutive/tY6HQAw8J0a8II15/images/integrations/logos/freewheel-icon.png?w=280\u0026fit=max\u0026auto=format\u0026n=tY6HQAw8J0a8II15\u0026q=85\u0026s=e2ee33aab4bcc39f239de59284d4d5b0 280w, https://mintcdn.com/permutive/tY6HQAw8J0a8II15/images/integrations/logos/freewheel-icon.png?w=560\u0026fit=max\u0026auto=format\u0026n=tY6HQAw8J0a8II15\u0026q=85\u0026s=fb2d83c3641a3ab2fc303d1033fbe6b5 560w, https://mintcdn.com/permutive/tY6HQAw8J0a8II15/images/integrations/logos/freewheel-icon.png?w=840\u0026fit=max\u0026auto=format\u0026n=tY6HQAw8J0a8II15\u0026q=85\u0026s=2d06e48e69957eba8b303bdbf20612c7 840w, https://mintcdn.com/permutive/tY6HQAw8J0a8II15/images/integrations/logos/freewheel-icon.png?w=1100\u0026fit=max\u0026auto=format\u0026n=tY6HQAw8J0a8II15\u0026q=85\u0026s=afcd36330f69cd5509410ac2c11ef3a1 1100w, https://mintcdn.com/permutive/tY6HQAw8J0a8II15/images/integrations/logos/freewheel-icon.png?w=1650\u0026fit=max\u0026auto=format\u0026n=tY6HQAw8J0a8II15\u0026q=85\u0026s=1763ccc965b71fcb231c9f5d1bb510d0 1650w, https://mintcdn.com/permutive/tY6HQAw8J0a8II15/images/integrations/logos/freewheel-icon.png?w=2500\u0026fit=max\u0026auto=format\u0026n=tY6HQAw8J0a8II15\u0026q=85\u0026s=a02a0a5bdf0cdcca891a9349b87b9019 2500w`})}),_jsx(Heading,{level:`3`,id:`freewheel`,style:{margin:0,fontSize:`1.125rem`,fontWeight:`600`},children:`FreeWheel`})]}),_jsxs(`div`,{style:{marginBottom:`1rem`},children:[_jsx(_MdxComponentBoundary,{name:`BadgeRowCenter`,children:_jsx(BadgeRowCenter,{label:`Direction`,children:_jsx(_MdxComponentBoundary,{name:`DirectionBadge`,children:_jsx(DirectionBadge,{direction:`Destination`})})})}),_jsx(_MdxComponentBoundary,{name:`BadgeRowCenter`,children:_jsx(BadgeRowCenter,{label:`Environment`,children:_jsx(_MdxComponentBoundary,{name:`BadgeContainer`,children:_jsxs(BadgeContainer,{children:[_jsx(_MdxComponentBoundary,{name:`EnvironmentBadge`,children:_jsx(EnvironmentBadge,{environment:`Web`})}),_jsx(_MdxComponentBoundary,{name:`EnvironmentBadge`,children:_jsx(EnvironmentBadge,{environment:`iOS`})}),_jsx(_MdxComponentBoundary,{name:`EnvironmentBadge`,children:_jsx(EnvironmentBadge,{environment:`Android`})}),_jsx(_MdxComponentBoundary,{name:`EnvironmentBadge`,children:_jsx(EnvironmentBadge,{environment:`CTV`})}),_jsx(_MdxComponentBoundary,{name:`EnvironmentBadge`,children:_jsx(EnvironmentBadge,{environment:`API Direct`})})]})})})}),_jsx(_MdxComponentBoundary,{name:`BadgeRowCenter`,children:_jsx(BadgeRowCenter,{label:`Capability`,children:_jsx(_MdxComponentBoundary,{name:`BadgeContainer`,children:_jsx(BadgeContainer,{children:_jsx(_MdxComponentBoundary,{name:`CapabilityBadge`,children:_jsx(CapabilityBadge,{capability:`Cohort Activation`})})})})})}),_jsx(_MdxComponentBoundary,{name:`BadgeRowCenter`,children:_jsx(BadgeRowCenter,{label:`SDK Required`,children:_jsx(_MdxComponentBoundary,{name:`SdkRequiredBadge`,children:_jsx(SdkRequiredBadge,{required:`Yes`})})})}),_jsx(_MdxComponentBoundary,{name:`BadgeRowCenter`,children:_jsx(BadgeRowCenter,{label:`Product(s) Required`,children:_jsx(_MdxComponentBoundary,{name:`ProductRequiredBadge`,children:_jsx(ProductRequiredBadge,{product:`Core Platform`})})})})]}),_jsx(`p`,{style:{margin:0,fontSize:`0.875rem`,color:`#6b7280`,lineHeight:`1.5`},children:_jsx(_components.p,{children:`FreeWheel offers a premium video ad server and SSP tailored to broadcasters and publishers for advanced monetization.`})})]}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Setup`,href:`#setup`,icon:`gear`}),_jsx(Card,{title:`Troubleshooting`,href:`#troubleshooting`,icon:`wrench`})]}),`\n`,_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsx(_components.p,{children:`FreeWheel is a premium video ad server used by media companies, broadcasters, and publishers with significant video content and ad inventory. Our integration with FreeWheel enables activation of Permutive cohorts for campaign targeting within the FreeWheel ad server. This integration supports two distinct activation methods:`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Key-Value Activation:`}),` Real-time cohort activation via FreeWheel Federated Segments (Web, iOS, Android, CTV, API Direct). Cohort IDs are stored in local storage (Web), retrieved via SDK APIs (iOS/Android), or returned from the CCS API (API Direct).`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Identity Based Activation:`}),` Server-to-server cohort activation where Permutive uploads audience data enriched with cohort memberships to FreeWheel, keyed by identity tags such as IDFA, AAID, IP Address, and Connected TV device IDs. See `,_jsx(_components.a,{href:`#supported-identity-tags`,children:`Supported Identity Tags`}),` for the full list. Cohorts appear as Audiences in FreeWheel.`]}),`\n`,_jsx(_components.p,{children:`Use cases include:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Activate Permutive cohorts in FreeWheel for real-time audience targeting on video inventory across all environments`}),`\n`,_jsx(_components.li,{children:`Target premium video campaigns using first-party data segments from Permutive`}),`\n`,_jsx(_components.li,{children:`Enable audience extension by activating cohorts on non-owned properties (Identity Based)`}),`\n`,_jsx(_components.li,{children:`Share audience data across business units using identity-based activation`}),`\n`,_jsx(_components.li,{children:`Enable broadcasters and publishers to monetize video content more effectively with data-driven targeting`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`choosing-an-activation-method`,children:`Choosing an Activation Method`}),`\n`,_jsx(_components.p,{children:`FreeWheel supports two activation methods. Choose the method that best fits your use case:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Aspect`}),_jsx(_components.th,{children:`Key-Value Activation`}),_jsx(_components.th,{children:`Identity Based Activation`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Mechanism`})}),_jsx(_components.td,{children:`Client-side, cohort IDs appended to ad requests`}),_jsx(_components.td,{children:`Server-to-server transfer`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Environments`})}),_jsx(_components.td,{children:`Web, iOS, Android, CTV, API Direct`}),_jsx(_components.td,{children:`Web, iOS, Android, CTV, API Direct`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Sync Timing`})}),_jsx(_components.td,{children:`Real-time`}),_jsx(_components.td,{children:`Daily`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`FreeWheel Feature`})}),_jsx(_components.td,{children:`Federated Segments`}),_jsx(_components.td,{children:`Audiences`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Use Cases`})}),_jsx(_components.td,{children:`Real-time targeting on owned properties across all environments`}),_jsx(_components.td,{children:`Audience extension, cross business unit data sharing`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`environment-compatibility`,children:`Environment Compatibility`}),`\n`,_jsx(_components.p,{children:`The table below shows which activation method is available for each environment:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Environment`}),_jsx(_components.th,{children:`Key-Value Activation`}),_jsx(_components.th,{children:`Identity Based Activation`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Web`})}),_jsx(_components.td,{children:_jsx(_MdxComponentBoundary,{name:`YesBadge`,children:_jsx(YesBadge,{})})}),_jsx(_components.td,{children:_jsx(_MdxComponentBoundary,{name:`YesBadge`,children:_jsx(YesBadge,{})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`iOS`})}),_jsx(_components.td,{children:_jsx(_MdxComponentBoundary,{name:`YesBadge`,children:_jsx(YesBadge,{})})}),_jsx(_components.td,{children:_jsx(_MdxComponentBoundary,{name:`YesBadge`,children:_jsx(YesBadge,{})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Android`})}),_jsx(_components.td,{children:_jsx(_MdxComponentBoundary,{name:`YesBadge`,children:_jsx(YesBadge,{})})}),_jsx(_components.td,{children:_jsx(_MdxComponentBoundary,{name:`YesBadge`,children:_jsx(YesBadge,{})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`CTV`})}),_jsx(_components.td,{children:_jsx(_MdxComponentBoundary,{name:`YesBadge`,children:_jsx(YesBadge,{})})}),_jsx(_components.td,{children:_jsx(_MdxComponentBoundary,{name:`YesBadge`,children:_jsx(YesBadge,{})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`API Direct`})}),_jsx(_components.td,{children:_jsx(_MdxComponentBoundary,{name:`YesBadge`,children:_jsx(YesBadge,{})})}),_jsx(_components.td,{children:_jsx(_MdxComponentBoundary,{name:`YesBadge`,children:_jsx(YesBadge,{})})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`supported-identity-tags`,children:`Supported Identity Tags`}),`\n`,_jsxs(_components.p,{children:[`These identity tags apply to `,_jsx(_components.strong,{children:`Identity Based Activation`}),` only — Permutive uploads cohort memberships to FreeWheel keyed by the identifiers below, and each maps to a FreeWheel `,_jsx(_components.code,{children:`id_type`}),`. (Key-Value Activation does not use identity tags; it appends cohort IDs to ad requests client-side.)`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsxs(_components.th,{children:[`Identity Tag (`,_jsx(_components.code,{children:`tag`}),`)`]}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Environment`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`idfa`})}),_jsx(_components.td,{children:`Apple Identifier for Advertisers (IDFA)`}),_jsx(_components.td,{children:`iOS`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`aaid`})}),_jsx(_components.td,{children:`Android Advertising ID (AAID)`}),_jsx(_components.td,{children:`Android`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ip_address`})}),_jsx(_components.td,{children:`IP Address`}),_jsx(_components.td,{children:`CTV and other environments`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ctv`})}),_jsx(_components.td,{children:`Connected TV advertising IDs — RIDA (Roku), TIFA (Samsung), AFAI (Amazon Fire TV)`}),_jsx(_components.td,{children:`CTV`})]})]})]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Identity Based Activation requires that Permutive is collecting the identity tags you select. Work with your Permutive Customer Success Manager to ensure identity collection is configured properly for your desired tags.`})}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`For Key-Value Activation:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`FreeWheel Account`}),` - You must have an active FreeWheel ad server account`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`FreeWheel Client ID`}),` - Your unique FreeWheel Client ID`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Federated Segments Enabled`}),` - Your FreeWheel account manager must allow Permutive to create Federated Segments in your FreeWheel account`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Permutive SDK`}),` - The Permutive SDK must be deployed on your web properties where FreeWheel ad requests are made`]}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`For Identity Based Activation:`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`FreeWheel Account`}),` - You must have an active FreeWheel ad server account`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`FreeWheel Client ID`}),` - Your unique FreeWheel Client ID`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Permutive Identity Collection`}),` - Identity collection must be configured in Permutive for the identity tags you want to send (see `,_jsx(_components.a,{href:`#supported-identity-tags`,children:`Supported Identity Tags`}),`)`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`setup`,children:`Setup`}),`\n`,_jsx(Heading,{level:`3`,id:`key-value-activation`,children:`Key-Value Activation`}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`Primary Setup Steps`,id:`primary-setup-steps`,children:_jsxs(Steps,{children:[_jsx(Step,{title:`Contact FreeWheel Account Manager`,children:_jsx(_components.p,{children:`Contact your FreeWheel account manager and ask them to allow Permutive to create Federated Segments in your FreeWheel account. This is required for the integration to work.`})}),_jsxs(Step,{title:`Provide Client ID to Permutive`,children:[_jsx(_components.p,{children:`Contact your Permutive Customer Success Manager to request the FreeWheel integration. You will need to provide your FreeWheel Client ID.`}),_jsx(_components.p,{children:`Your Permutive Customer Success Manager will enable the FreeWheel integration in your Permutive workspace using this Client ID.`})]}),_jsxs(Step,{title:`Verify Setup`,children:[_jsxs(_components.p,{children:[`In the Permutive Dashboard, navigate to one of your cohorts. Check that the FreeWheel activation sync is visible. Toggle it to `,_jsx(_components.em,{children:`On`}),` and save the cohort.`]}),_jsx(_components.p,{children:`In your FreeWheel dashboard, verify that a new Federated Segment has been created with a name matching your cohort ID. This confirms your integration setup is successful.`})]})]})}),_jsxs(Tab,{title:`Web`,id:`web`,\"data-child-heading-ids\":`[\"accessing-freewheel-cohorts-for-targeting\",\"implementation-notes\"]`,children:[_jsx(_components.p,{children:`The FreeWheel integration uses a client-side key-value approach with FreeWheel Federated Segments. When cohorts are activated to FreeWheel in the Permutive Dashboard, Permutive creates a Federated Segment in FreeWheel, and the cohort IDs are stored in the browser’s local storage under a FreeWheel-specific key.`}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`You must implement code to retrieve these cohort IDs from local storage and append them to your FreeWheel ad requests.`}),` Permutive provides the cohort data, but your implementation is responsible for passing it to FreeWheel.`]}),_jsx(Heading,{level:`4`,id:`accessing-freewheel-cohorts-for-targeting`,children:`Accessing FreeWheel Cohorts for Targeting`}),_jsxs(_components.p,{children:[`Cohort IDs are stored in the local storage variable `,_jsx(_components.code,{children:`_pfws`}),` (this is the default key for FreeWheel activations). This variable is updated as soon as Permutive has segmented the user on the page.`]}),_jsxs(_components.p,{children:[`Below is an example of how to retrieve Permutive cohort IDs in a variable called `,_jsx(_components.code,{children:`cohorts`}),`, which you can then append to your FreeWheel ad requests:`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`javascript`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`10`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`var`}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` cohorts`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`try`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` cohorts`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` = `}),_jsx(_components.span,{style:{color:`#4FC1FF`,\"--shiki-dark\":`#4FC1FF`},children:`JSON`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`parse`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`window`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`localStorage`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`_pfws`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` || `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`'[]'`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`).`}),_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`slice`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#B5CEA8`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#B5CEA8`,\"--shiki-dark\":`#B5CEA8`},children:`250`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`).`}),_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`toString`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`} `}),_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`catch`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`e`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` cohorts`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` = `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`''`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:`// Use the cohorts variable to append to your FreeWheel ad request`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:`// Example: append as key-value pairs in your ad request configuration`})}),`\n`]})})}),_jsx(Heading,{level:`4`,id:`implementation-notes`,children:`Implementation Notes`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Ensure the Permutive SDK loads before you attempt to retrieve cohort IDs from local storage.`}),`\n`,_jsx(_components.li,{children:`The cohort IDs are updated in real-time as users enter or exit cohorts.`}),`\n`,_jsxs(_components.li,{children:[`You can append up to 250 cohort IDs per ad request (the `,_jsx(_components.code,{children:`.slice(0, 250)`}),` in the example limits this).`]}),`\n`,_jsx(_components.li,{children:`Coordinate with your development team to integrate this code into your FreeWheel ad request flow.`}),`\n`]}),_jsx(_components.p,{children:`For technical assistance with implementation, contact Permutive Support.`})]}),_jsxs(Tab,{title:`iOS`,id:`ios`,children:[_jsxs(_components.p,{children:[`Retrieve Permutive cohort IDs for FreeWheel using the `,_jsx(_components.code,{children:`activations`}),` property:`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`12`,language:`swift`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`swift`,children:_jsxs(_components.code,{language:`swift`,numberOfLines:`12`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:`// Import Permutive SDK`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#4EC9B0`,\"--shiki-dark\":`#4EC9B0`},children:` Permutive`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:`// Access FreeWheel Cohort IDs directly`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`let`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` freeWheelCohorts: [`}),_jsx(_components.span,{style:{color:`#4EC9B0`,\"--shiki-dark\":`#4EC9B0`},children:`String`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`] = activations[`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"freewheel\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:`// Construct your FreeWheel ad request`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:`// Append Permutive cohorts as key-values`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`if`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` !freeWheelCohorts.`}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`isEmpty`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:` let`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` cohortsString = freeWheelCohorts.`}),_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`joined`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`separator`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\",\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:` // Append cohortsString to your FreeWheel ad request`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Important Notes:`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`The `,_jsx(_components.code,{children:`activations`}),` property provides direct access to cohort IDs configured for FreeWheel activation`]}),`\n`,_jsxs(_components.li,{children:[`Use the key `,_jsx(_components.code,{children:`freewheel`}),` to retrieve FreeWheel-specific cohorts`]}),`\n`,_jsx(_components.li,{children:`Coordinate with your development team to integrate this code into your FreeWheel ad request flow`}),`\n`]})]}),_jsxs(Tab,{title:`Android`,id:`android`,children:[_jsxs(_components.p,{children:[`Retrieve Permutive cohort IDs for FreeWheel using the `,_jsx(_components.code,{children:`TriggersProvider`}),` API. The callback is invoked whenever cohort membership changes:`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`14`,language:`kotlin`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`kotlin`,children:_jsxs(_components.code,{language:`kotlin`,numberOfLines:`14`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`val`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` triggerAction: `}),_jsx(_components.span,{style:{color:`#4EC9B0`,\"--shiki-dark\":`#4EC9B0`},children:`TriggerAction`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` = triggersProvider.`}),_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`cohortActivations`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` activationType = `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"freewheel\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` callback = `}),_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`object`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` : `}),_jsx(_components.span,{style:{color:`#4EC9B0`,\"--shiki-dark\":`#4EC9B0`},children:`Method`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#4EC9B0`,\"--shiki-dark\":`#4EC9B0`},children:`List`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#4EC9B0`,\"--shiki-dark\":`#4EC9B0`},children:`String`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`>> {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:` override`}),_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:` fun`}),_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:` invoke`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`(cohorts: `}),_jsx(_components.span,{style:{color:`#4EC9B0`,\"--shiki-dark\":`#4EC9B0`},children:`List`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#4EC9B0`,\"--shiki-dark\":`#4EC9B0`},children:`String`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`>) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:` if`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` (cohorts.`}),_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`isNotEmpty`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`()) {`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:` // Cohorts available for FreeWheel activation`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:` // Pass these to your FreeWheel ad requests as key-values`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:` println`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"FreeWheel cohorts: `}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`$cohorts`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`else`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:` println`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"No active cohorts with a FreeWheel activation configured.\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`]})})}),_jsx(_components.p,{children:`Once you have the cohort IDs, append them to your FreeWheel ad request.`}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Important Notes:`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`The `,_jsx(_components.code,{children:`TriggersProvider`}),` API allows you to listen for cohort membership changes`]}),`\n`,_jsxs(_components.li,{children:[`Use the activation type `,_jsx(_components.code,{children:`freewheel`}),` to retrieve FreeWheel-specific cohorts`]}),`\n`,_jsxs(_components.li,{children:[`See the `,_jsx(_components.a,{href:`https://sdk-docs.permutive.com/core/com.permutive.android/-triggers-provider/query-reactions.html`,children:`Android SDK documentation`}),` for more details`]}),`\n`]})]}),_jsxs(Tab,{title:`API Direct`,id:`api-direct`,\"data-child-heading-ids\":`[\"how-it-works\"]`,children:[_jsx(_components.p,{children:`In environments where it is not possible to deploy a Permutive SDK (e.g. some CTV environments), you can use Permutive’s CCS (Custom Cohort Segmentation) API for event tracking and segmentation instead.`}),_jsx(_components.p,{children:`Access to this API requires customer-specific authorization. You will need a dedicated API key from Permutive.`}),_jsx(Heading,{level:`3`,id:`how-it-works`,children:`How it Works`}),_jsx(_components.p,{children:`The CCS API can be used to:`}),_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Track events for a specific user (optional)`}),`\n`,_jsx(_components.li,{children:`Retrieve cohort IDs for activation`}),`\n`]}),_jsx(Note,{children:_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`events`}),` array in the request is optional. If you only need to retrieve cohort memberships without tracking a new event, you can pass an empty array.`]})}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Example Request:`})}),_jsx(CodeBlock,{filename:``,numberOfLines:`13`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`13`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#D7BA7D`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.permutive.app/ccs/v1/segmentation?activations=true\u0026synchronous-validation=false\u0026k=PERMUTIVE_API_KEY'`}),_jsx(_components.span,{style:{color:`#D7BA7D`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` 'accept: application/json'`}),_jsx(_components.span,{style:{color:`#D7BA7D`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` 'content-type: application/json'`}),_jsx(_components.span,{style:{color:`#D7BA7D`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:` --data`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` '`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`{`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"alias\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"tag\": \"example\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"id\": \"12345\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"events\": []`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`'`})}),`\n`]})})}),_jsxs(_components.p,{children:[`The API accepts a user identity passed in the `,_jsx(_components.code,{children:`alias`}),` object. Permutive then either links this identity to an existing Permutive user ID or creates a new Permutive user ID if the identity hasn’t been seen before.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Example Response:`})}),_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes dark-plus dark-plus`,style:{backgroundColor:`#0B0C0E`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"user_id\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"2008c38f-dece-4570-976d-87593ed001c3\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"cohorts\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"12345\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"23456\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"34567\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"activations\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:` \"freewheel\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"12345\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"23456\"`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsxs(_components.p,{children:[`The API response includes cohort IDs for FreeWheel activation under the `,_jsx(_components.code,{children:`freewheel`}),` key within the `,_jsx(_components.code,{children:`activations`}),` object. These can then be passed to FreeWheel as key-values for activation.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Important Notes:`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Replace `,_jsx(_components.code,{children:`PERMUTIVE_API_KEY`}),` with your actual Permutive API key`]}),`\n`,_jsxs(_components.li,{children:[`The `,_jsx(_components.code,{children:`activations=true`}),` query parameter is required to receive activation data in the response`]}),`\n`]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`identity-based-activation`,children:`Identity Based Activation`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Primary Setup Steps`,id:`primary-setup-steps-2`,children:[_jsxs(Steps,{children:[_jsx(Step,{title:`Contact Permutive CSM`,children:_jsx(_components.p,{children:`Contact your Permutive Customer Success Manager to enable Identity Based Activation for FreeWheel. This is a server-to-server integration that must be configured by Permutive.`})}),_jsx(Step,{title:`Configure in Permutive Dashboard`,children:_jsx(_components.p,{children:`Once enabled, navigate to Settings → Integrations in the Permutive Dashboard. Find “FreeWheel (ID-based)” in the list of available integrations and click to configure it.`})}),_jsx(Step,{title:`Enter FreeWheel Client ID`,children:_jsx(_components.p,{children:`Provide your FreeWheel Client ID in the configuration form. This is the same Client ID used for key-value activation if you have that enabled.`})}),_jsxs(Step,{title:`Select Identity Tags`,children:[_jsx(_components.p,{children:`Choose which identity tags you want to send to FreeWheel.`}),_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`#supported-identity-tags`,children:`Supported Identity Tags`}),` for all available types. Select the tags that match your use case and the environments where you need activation.`]})]}),_jsx(Step,{title:`Save Configuration`,children:_jsx(_components.p,{children:`Save your configuration. Permutive will begin syncing cohort data to FreeWheel on a daily basis for users with the selected identity types.`})}),_jsx(Step,{title:`Activate Cohorts`,children:_jsx(_components.p,{children:`Navigate to your cohorts in the Permutive Dashboard and enable the “FreeWheel (ID-based)” activation toggle for each cohort you want to sync to FreeWheel.`})}),_jsx(Step,{title:`Verify in FreeWheel`,children:_jsx(_components.p,{children:`After the first sync completes (within 24 hours), check your FreeWheel dashboard to verify that audiences appear with names matching your activated cohorts.`})})]}),_jsx(Info,{children:_jsx(_components.p,{children:`Cohort data syncs to FreeWheel daily. Changes to cohort membership will be reflected in FreeWheel within 24 hours of the next scheduled sync.`})}),_jsx(Note,{children:_jsx(_components.p,{children:`Identity Based Activation requires that Permutive is collecting the identity types you select. Work with your Permutive Customer Success Manager to ensure identity collection is configured properly for your desired identity types.`})})]}),_jsxs(Tab,{title:`iOS`,id:`ios-2`,children:[_jsx(_components.p,{children:`Identity Based Activation for iOS enables server-to-server cohort syncing using IDFA (Identifier for Advertisers). No SDK code changes are required on iOS devices.`}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`How it works:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Permutive collects IDFA values from iOS users via the Permutive SDK`}),`\n`,_jsx(_components.li,{children:`Cohort memberships are synced daily to FreeWheel server-to-server`}),`\n`,_jsx(_components.li,{children:`Cohorts appear as Audiences in FreeWheel, ready for campaign targeting`}),`\n`,_jsx(_components.li,{children:`Data syncing happens automatically once configured in the Permutive Dashboard`}),`\n`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Prerequisites:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Permutive SDK must be deployed on your iOS app`}),`\n`,_jsx(_components.li,{children:`IDFA collection must be enabled and properly configured`}),`\n`,_jsx(_components.li,{children:`Users must grant tracking permission for IDFA to be available`}),`\n`]})]}),_jsxs(Tab,{title:`Android`,id:`android-2`,children:[_jsx(_components.p,{children:`Identity Based Activation for Android enables server-to-server cohort syncing using AAID (Android Advertising ID). No SDK code changes are required on Android devices.`}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`How it works:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Permutive collects AAID values from Android users via the Permutive SDK`}),`\n`,_jsx(_components.li,{children:`Cohort memberships are synced daily to FreeWheel server-to-server`}),`\n`,_jsx(_components.li,{children:`Cohorts appear as Audiences in FreeWheel, ready for campaign targeting`}),`\n`,_jsx(_components.li,{children:`Data syncing happens automatically once configured in the Permutive Dashboard`}),`\n`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Prerequisites:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Permutive SDK must be deployed on your Android app`}),`\n`,_jsx(_components.li,{children:`AAID collection must be enabled and properly configured`}),`\n`]})]}),_jsxs(Tab,{title:`CTV`,id:`ctv`,children:[_jsx(_components.p,{children:`Identity Based Activation for CTV enables server-to-server cohort syncing using IP Address or other supported identifiers. No SDK code changes are required on CTV devices.`}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`How it works:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Permutive collects IP addresses (or other supported identifiers) from CTV users`}),`\n`,_jsx(_components.li,{children:`Cohort memberships are synced daily to FreeWheel server-to-server`}),`\n`,_jsx(_components.li,{children:`Cohorts appear as Audiences in FreeWheel, ready for campaign targeting`}),`\n`,_jsx(_components.li,{children:`Data syncing happens automatically once configured in the Permutive Dashboard`}),`\n`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Prerequisites:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Permutive must be collecting IP addresses or other supported identifiers from your CTV environment`}),`\n`,_jsx(_components.li,{children:`Work with your Permutive Customer Success Manager to ensure proper identity collection for CTV`}),`\n`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`data-types`,children:`Data Types`}),`\n`,_jsx(_components.p,{children:`The FreeWheel integration is a Destination-only integration for cohort activation. It does not collect event data from FreeWheel.`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`Cohort Activation Data (Key-Value)`,id:`cohort-activation-data-key-value`,children:[_jsx(_components.p,{children:`When you activate a cohort to FreeWheel using Key-Value Activation, Permutive creates a Federated Segment in FreeWheel and makes cohort IDs available for targeting via key-value pairs.`}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Cohort ID Format:`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Cohort IDs are stored as an array in local storage under the `,_jsx(_components.code,{children:`_pfws`}),` key`]}),`\n`,_jsx(_components.li,{children:`Each ID corresponds to a cohort the user is a member of`}),`\n`,_jsx(_components.li,{children:`Maximum of 250 cohort IDs can be passed per ad request`}),`\n`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`FreeWheel Federated Segment:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Created automatically when a cohort is activated`}),`\n`,_jsx(_components.li,{children:`Named using the cohort ID from Permutive`}),`\n`,_jsx(_components.li,{children:`Searchable in FreeWheel’s audience targeting interface`}),`\n`,_jsx(_components.li,{children:`Can be used for campaign targeting (include or exclude)`}),`\n`,_jsx(_components.li,{children:`Represents a reusable audience segment across all sites and site sections within your FreeWheel network`}),`\n`]})]}),_jsxs(Accordion,{title:`Cohort Activation Data (Identity Based)`,id:`cohort-activation-data-identity-based`,children:[_jsx(_components.p,{children:`When you activate a cohort using Identity Based Activation, Permutive uploads audience data enriched with cohort memberships to FreeWheel via a server-to-server transfer.`}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Data Transfer:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Cohort data is synced daily from Permutive to FreeWheel`}),`\n`,_jsxs(_components.li,{children:[`Data is keyed by the identity tags you selected during configuration (see `,_jsx(_components.a,{href:`#supported-identity-tags`,children:`Supported Identity Tags`}),`)`]}),`\n`,_jsx(_components.li,{children:`Each user’s cohort memberships are associated with their identity values`}),`\n`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`FreeWheel Audiences:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Cohorts appear as Audiences in FreeWheel`}),`\n`,_jsx(_components.li,{children:`Named using the cohort name from Permutive`}),`\n`,_jsx(_components.li,{children:`Available for campaign targeting in FreeWheel’s audience targeting interface`}),`\n`,_jsx(_components.li,{children:`Updated daily with the latest cohort membership data`}),`\n`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`Unable to enable FreeWheel integration in Permutive Dashboard`,id:`unable-to-enable-freewheel-integration-in-permutive-dashboard`,children:[_jsx(_components.p,{children:`If you cannot see the FreeWheel integration option in your Permutive Dashboard:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Verify that your Permutive Customer Success Manager has enabled the integration for your workspace`}),`\n`,_jsx(_components.li,{children:`Confirm that your FreeWheel account manager has allowed Permutive to create Federated Segments in your FreeWheel account`}),`\n`,_jsx(_components.li,{children:`Check that your FreeWheel Client ID was provided to Permutive`}),`\n`]}),_jsx(_components.p,{children:`Contact your Permutive Customer Success Manager if the integration is still not visible.`})]}),_jsxs(Accordion,{title:`Federated Segments not appearing in FreeWheel`,id:`federated-segments-not-appearing-in-freewheel`,children:[_jsx(_components.p,{children:`If cohorts are activated in Permutive but Federated Segments are not created in FreeWheel:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Client ID`}),`: Verify that the correct FreeWheel Client ID was provided to Permutive`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Federated Segments Permission`}),`: Check with your FreeWheel account manager that Permutive has been allowed to create Federated Segments in your FreeWheel account`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Cohort Activation`}),`: Ensure the cohort has the FreeWheel activation toggle set to `,_jsx(_components.em,{children:`On`}),` in the Permutive Dashboard`]}),`\n`]}),_jsx(_components.p,{children:`If the issue persists after checking these items, contact Permutive Support.`})]}),_jsxs(Accordion,{title:`Cohort IDs not available in local storage`,id:`cohort-ids-not-available-in-local-storage`,children:[_jsxs(_components.p,{children:[`If you cannot find cohort IDs in local storage (`,_jsx(_components.code,{children:`_pfws`}),` key):`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Cohort Activation`}),`: Verify the cohort has the FreeWheel activation toggle set to `,_jsx(_components.em,{children:`On`}),` in the Permutive Dashboard`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`SDK Deployment`}),`: Ensure the Permutive SDK is properly deployed and loading on your web pages`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`User Membership`}),`: Confirm the current user is actually a member of the activated cohort (check in browser console using `,_jsx(_components.code,{children:`permutive.segments()`}),`)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Browser Console`}),`: Open browser console and check `,_jsx(_components.code,{children:`window.localStorage._pfws`}),` to see if the key exists`]}),`\n`]}),_jsx(_components.p,{children:`If the key exists but is empty, the user may not be in any activated cohorts.`})]}),_jsxs(Accordion,{title:`Cohorts not being passed to FreeWheel ad requests`,id:`cohorts-not-being-passed-to-freewheel-ad-requests`,children:[_jsx(_components.p,{children:`If cohort IDs are in local storage but not appearing in your FreeWheel ad requests:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Implementation`}),`: Verify you’ve implemented the code to retrieve cohort IDs from local storage (see Web Setup tab)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Timing`}),`: Ensure the Permutive SDK loads before you attempt to retrieve cohort IDs`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Ad Request Configuration`}),`: Check that your ad request code is correctly appending the cohort variable to FreeWheel ad calls`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Network Inspection`}),`: Use browser developer tools to inspect network requests to FreeWheel and verify cohort IDs are included`]}),`\n`]}),_jsx(_components.p,{children:`For implementation assistance, contact Permutive Support.`})]}),_jsxs(Accordion,{title:`Cohorts not appearing in SDK APIs (iOS/Android)`,id:`cohorts-not-appearing-in-sdk-apis-ios-android`,children:[_jsx(_components.p,{children:`If cohort IDs are not being returned by the SDK APIs:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Cohort Activation`}),`: Verify the cohort has the FreeWheel activation toggle set to `,_jsx(_components.em,{children:`On`}),` in the Permutive Dashboard`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`SDK Deployment`}),`: Ensure the Permutive SDK is properly deployed and initialized in your app`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Activation Type`}),`: Verify you’re using the correct activation type key (`,_jsx(_components.code,{children:`freewheel`}),`)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`User Membership`}),`: Confirm the current user is a member of the activated cohort`]}),`\n`]}),_jsxs(_components.p,{children:[`For iOS, check the `,_jsx(_components.code,{children:`activations`}),` property. For Android, ensure the `,_jsx(_components.code,{children:`TriggersProvider`}),` callback is properly set up with activation type `,_jsx(_components.code,{children:`freewheel`}),`.`]})]}),_jsxs(Accordion,{title:`API Direct returning empty activations`,id:`api-direct-returning-empty-activations`,children:[_jsxs(_components.p,{children:[`If the CCS API response includes an empty `,_jsx(_components.code,{children:`freewheel`}),` array or doesn’t include the key at all:`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Integration Enabled`}),`: Verify the FreeWheel integration is enabled in the Permutive dashboard`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Cohort Activation`}),`: Check that cohorts have been activated for FreeWheel`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`User Membership`}),`: Ensure the user identified in the API request (via `,_jsx(_components.code,{children:`alias`}),`) is a member of activated cohorts`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Query Parameter`}),`: Confirm the `,_jsx(_components.code,{children:`activations=true`}),` query parameter is included in the API request URL`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`API Key`}),`: Verify the API key used in the request has the correct permissions`]}),`\n`]}),_jsx(_components.p,{children:`For API Direct issues, contact your Permutive Customer Success Manager for assistance.`})]}),_jsxs(Accordion,{title:`Need to update Client ID`,id:`need-to-update-client-id`,children:[_jsx(_components.p,{children:`If you need to update your FreeWheel Client ID:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Contact your Permutive Customer Success Manager with the new Client ID`}),`\n`,_jsx(_components.li,{children:`Permutive will update the configuration for your integration`}),`\n`]}),_jsx(_components.p,{children:`Do not attempt to update the Client ID directly - always work with your Customer Success Manager.`})]}),_jsxs(Accordion,{title:`Issues with Identity Based Activation`,id:`issues-with-identity-based-activation`,children:[_jsx(_components.p,{children:`If you’re experiencing issues with Identity Based Activation:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Missing Audiences`}),`: Verify that cohorts are activated with the “FreeWheel (ID-based)” toggle enabled in the Permutive Dashboard`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Sync Timing`}),`: Remember that cohort data syncs daily - allow up to 24 hours for changes to appear in FreeWheel`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Identity Collection`}),`: Confirm that Permutive is collecting the identity tags you selected (see `,_jsx(_components.a,{href:`#supported-identity-tags`,children:`Supported Identity Tags`}),`) by checking with your Permutive Customer Success Manager`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Configuration`}),`: Verify your FreeWheel Client ID and selected identity tags are correct in Settings → Integrations`]}),`\n`]}),_jsx(_components.p,{children:`For Identity Based Activation issues, contact your Permutive Customer Success Manager for assistance.`})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`changelog`,children:`Changelog`}),`\n`,_jsx(Heading,{level:`3`,id:`may-2026`,children:`May 2026`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Documented the full set of supported identity tags for Identity Based Activation, including Connected TV device IDs (RIDA, TIFA, AFAI)`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`january-2026`,children:`January 2026`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Added Identity Based Activation support for all environments`}),`\n`,_jsx(_components.li,{children:`Identity Based Activation enables server-to-server cohort upload keyed by AAID, IDFA, or IP Address`}),`\n`,_jsx(_components.li,{children:`Cohorts activated via Identity Based Activation appear as Audiences in FreeWheel`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`november-2025`,children:`November 2025`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Documentation updated to clarify that the integration uses FreeWheel Federated Segments`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`january-2023`,children:`January 2023`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Initial release of FreeWheel integration for cohort activation`}),`\n`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`For detailed changelog information, visit our `,_jsx(_components.a,{href:`https://changelog.permutive.com/`,children:`Changelog`}),`.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{NoBadge,YesBadge,BadgeRowCenter,BadgeRow,BadgeContainer,ProductRequiredBadge,SdkRequiredBadge,CapabilityBadge,EnvironmentBadge,DirectionBadge,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"FreeWheel","description":"Integrate with FreeWheel for targeting and campaign optimization","href":"/integrations/advertising/ad-servers/freewheel"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[146,4922,"null;const YesBadge=()=>null;const BadgeRowCenter=()=>null;const BadgeRow=()=>null;const BadgeContainer=()=>null;const ProductRequiredBadge=()=>null;const SdkRequiredBadge=()=>null;const CapabilityBadge=()=>null;const EnvironmentBadge=()=>null;const DirectionBadge=()=>null;functi"]]},"mdxExtracts":{"tableOfContents":[{"title":"FreeWheel","slug":"freewheel","depth":3,"children":[]},{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Choosing an Activation Method","slug":"choosing-an-activation-method","depth":2,"children":[]},{"title":"Environment Compatibility","slug":"environment-compatibility","depth":2,"children":[]},{"title":"Supported Identity Tags","slug":"supported-identity-tags","depth":2,"children":[]},{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"Setup","slug":"setup","depth":2,"children":[{"title":"Key-Value Activation","slug":"key-value-activation","depth":3,"children":[]},{"title":"Accessing FreeWheel Cohorts for Targeting","slug":"accessing-freewheel-cohorts-for-targeting","depth":4,"children":[],"tabId":"web"},{"title":"Implementation Notes","slug":"implementation-notes","depth":4,"children":[],"tabId":"web"},{"title":"How it Works","slug":"how-it-works","depth":3,"children":[],"tabId":"api-direct"},{"title":"Identity Based Activation","slug":"identity-based-activation","depth":3,"children":[]}]},{"title":"Data Types","slug":"data-types","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]},{"title":"Changelog","slug":"changelog","depth":2,"children":[{"title":"May 2026","slug":"may-2026","depth":3,"children":[]},{"title":"January 2026","slug":"january-2026","depth":3,"children":[]},{"title":"November 2025","slug":"november-2025","depth":3,"children":[]},{"title":"January 2023","slug":"january-2023","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/permutive/9a9f86ed1fb0eb1f/agent-chat-rail.js"],"subdomain":"permutive","siteName":"Permutive","title":"FreeWheel - Permutive","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T10:23:16.372Z","originalFileLocation":"integrations/advertising/ad-servers/freewheel.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Integrate with FreeWheel for targeting and campaign optimization\">\u003cmeta data-mint-head name=\"application-name\" content=\"Permutive\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/permutive/_gGnYYOjUBeWUMY8/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/permutive/_gGnYYOjUBeWUMY8/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/permutive/_gGnYYOjUBeWUMY8/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/permutive/_gGnYYOjUBeWUMY8/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/permutive/_gGnYYOjUBeWUMY8/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/permutive/_gGnYYOjUBeWUMY8/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/permutive/_gGnYYOjUBeWUMY8/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/permutive/_gGnYYOjUBeWUMY8/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/permutive/_gGnYYOjUBeWUMY8/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"FreeWheel - Permutive\">\u003cmeta data-mint-head property=\"og:description\" content=\"Integrate with FreeWheel for targeting and campaign optimization\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Permutive\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.permutive.com/integrations/advertising/ad-servers/freewheel\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://permutive.mintlify.site/_mintlify/api/og/v2?division=Integrations\u0026amp;title=FreeWheel\u0026amp;description=Integrate+with+FreeWheel+for+targeting+and+campaign+optimization\u0026amp;theme=476d64e99ccc72d9df9ea1e6\u0026amp;signature=3f4b375c298b981f0f83cd165ef4fec3fcc0f64ec5825927cf1dcb7646f59df4\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"FreeWheel - Permutive\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Integrate with FreeWheel for targeting and campaign optimization\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://permutive.mintlify.site/_mintlify/api/og/v2?division=Integrations\u0026amp;title=FreeWheel\u0026amp;description=Integrate+with+FreeWheel+for+targeting+and+campaign+optimization\u0026amp;theme=476d64e99ccc72d9df9ea1e6\u0026amp;signature=3f4b375c298b981f0f83cd165ef4fec3fcc0f64ec5825927cf1dcb7646f59df4\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/permutive/_gGnYYOjUBeWUMY8/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Permutive\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff5e99\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.permutive.com/integrations/advertising/ad-servers/freewheel\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/integrations/advertising/ad-servers/freewheel.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.permutive.com/#organization\",\"name\":\"Permutive\",\"url\":\"https://docs.permutive.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/permutive/zX9G7jjpccuZZlEf/logo/permutive-logo-light.svg?fit=max\u0026auto=format\u0026n=zX9G7jjpccuZZlEf\u0026q=85\u0026s=ae940c2b1c2eb923f6344b583fef176c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.permutive.com#website\",\"name\":\"Permutive\",\"url\":\"https://docs.permutive.com\",\"publisher\":{\"@id\":\"https://docs.permutive.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.permutive.com/integrations/advertising/ad-servers/freewheel#webpage\",\"url\":\"https://docs.permutive.com/integrations/advertising/ad-servers/freewheel\",\"name\":\"FreeWheel\",\"description\":\"Integrate with FreeWheel for targeting and campaign optimization\",\"dateModified\":\"2026-11-17T10:23:16.372Z\",\"isPartOf\":{\"@id\":\"https://docs.permutive.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.permutive.com/integrations/advertising/ad-servers/freewheel#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.permutive.com/integrations/advertising/ad-servers/freewheel#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Advertising\",\"item\":\"https://docs.permutive.com/integrations/advertising/ad-servers/catalog\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Ad Servers\",\"item\":\"https://docs.permutive.com/integrations/advertising/ad-servers/catalog\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Integrations\",\"item\":\"https://docs.permutive.com/integrations/advertising/ad-servers/google-ad-manager\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"FreeWheel\",\"item\":\"https://docs.permutive.com/integrations/advertising/ad-servers/freewheel\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.permutive.com/integrations/advertising/ad-servers/freewheel#article\",\"headline\":\"FreeWheel\",\"name\":\"FreeWheel\",\"description\":\"Integrate with FreeWheel for targeting and campaign optimization\",\"url\":\"https://docs.permutive.com/integrations/advertising/ad-servers/freewheel\",\"mainEntityOfPage\":{\"@id\":\"https://docs.permutive.com/integrations/advertising/ad-servers/freewheel#webpage\"},\"dateModified\":\"2026-11-17T10:23:16.372Z\",\"publisher\":{\"@id\":\"https://docs.permutive.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.permutive.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Permutive\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Permutive\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/integrations/advertising/ad-servers/freewheel.md","siteName":"Permutive","nav":{"global":{"anchors":[{"anchor":"Support","icon":"life-ring","href":"mailto:technical-services@permutive.com"},{"anchor":"Status","icon":"signal","href":"https://status.permutive.com"},{"anchor":"Changelog","icon":"megaphone","href":"https://changelog.permutive.com"}]},"tabs":[{"tab":"Platform","pages":[{"title":"Platform","href":"/introduction"}]},{"tab":"Integrations","groups":[{"group":"Integrations","icon":"plug","pages":[{"title":"Overview","mode":"wide","href":"/integrations/overview"}]},{"group":"Identity","icon":"passport","pages":[{"title":"Catalog","mode":"wide","href":"/integrations/identity/catalog"},{"group":"Integrations","pages":[{"title":"ID5","href":"/integrations/identity/id5"},{"title":"LiveRamp RampID","href":"/integrations/identity/rampid"},{"title":"UID2 (Unified ID 2.0)","sidebarTitle":"UID2","href":"/integrations/identity/uid2"}]}]},{"group":"Contextual","icon":"bullseye","pages":[{"title":"Catalog","mode":"wide","href":"/integrations/contextual/catalog"},{"group":"Integrations","pages":[{"title":"IBM Watson","href":"/integrations/contextual/ibm-watson"},{"title":"Silverbullet 4D","href":"/integrations/contextual/silverbullet-4d"},{"title":"OS Data Solutions","href":"/integrations/contextual/os-data-solutions"},{"title":"TextRazor","href":"/integrations/contextual/text-razor"}]}]},{"group":"Advertising","icon":"bullhorn","pages":[{"group":"Ad Servers","pages":[{"title":"Catalog","mode":"wide","href":"/integrations/advertising/ad-servers/catalog"},{"group":"Integrations","pages":[{"title":"Google Ad Manager","description":"Integrate with Google Ad Manager for targeting and campaign optimization","href":"/integrations/advertising/ad-servers/google-ad-manager"},{"title":"FreeWheel","href":"/integrations/advertising/ad-servers/freewheel"},{"title":"Microsoft Monetize","description":"Integrate with Microsoft Monetize (Ad Server) for real-time cohort targeting and campaign insights","href":"/integrations/advertising/ad-servers/xandr"},{"title":"Equativ","href":"/integrations/advertising/ad-servers/equativ"},{"title":"Nativo","href":"/integrations/advertising/ad-servers/nativo"},{"title":"AdsWizz","href":"/integrations/advertising/ad-servers/adswizz"},{"title":"SmartX","href":"/integrations/advertising/ad-servers/smartx"},{"title":"MGID","href":"/integrations/advertising/ad-servers/mgid"}]}]},{"group":"Bidstream","pages":[{"title":"Catalog","mode":"wide","href":"/integrations/advertising/bidstream/catalog"},{"group":"Integrations","pages":[{"title":"Prebid","href":"/integrations/advertising/bidstream/prebid"},{"title":"Amazon Publisher Services (APS)","sidebarTitle":"APS","href":"/integrations/advertising/bidstream/aps"}]}]},{"group":"SSPs","pages":[{"title":"Catalog","mode":"wide","href":"/integrations/advertising/ssps/catalog"},{"group":"Integrations","pages":[{"title":"Magnite","href":"/integrations/advertising/ssps/magnite"},{"title":"Microsoft Monetize","href":"/integrations/advertising/ssps/xandr"},{"title":"PubMatic","href":"/integrations/advertising/ssps/pubmatic"},{"title":"OpenX","href":"/integrations/advertising/ssps/openx"},{"title":"Index Exchange","href":"/integrations/advertising/ssps/index-exchange"}]}]},{"group":"DSPs","pages":[{"title":"Catalog","mode":"wide","href":"/integrations/advertising/dsps/catalog"},{"group":"Integrations","pages":[{"title":"Adform","href":"/integrations/advertising/dsps/adform"},{"title":"The Trade Desk","href":"/integrations/advertising/dsps/the-trade-desk"},{"title":"DV360","href":"/integrations/advertising/dsps/dv360"},{"title":"StackAdapt","href":"/integrations/advertising/dsps/stackadapt"},{"title":"Viant","href":"/integrations/advertising/dsps/viant"},{"title":"Yahoo","href":"/integrations/advertising/dsps/yahoo"}]}]}]},{"group":"Marketing","icon":"envelope","pages":[{"group":"CDPs","pages":[{"title":"Catalog","mode":"wide","href":"/integrations/marketing/cdps/catalog"},{"group":"Integrations","pages":[{"title":"mParticle","href":"/integrations/marketing/cdps/mparticle"}]}]},{"group":"ESPs","pages":[{"title":"Catalog","mode":"wide","href":"/integrations/marketing/esps/catalog"},{"group":"Integrations","pages":[{"title":"Salesforce Marketing Cloud","href":"/integrations/marketing/esps/sfmc"},{"title":"Adestra","href":"/integrations/marketing/esps/adestra"},{"title":"Sailthru","href":"/integrations/marketing/esps/sailthru"}]}]}]},{"group":"Data Collaboration","icon":"database","pages":[{"group":"Data Warehouses","pages":[{"title":"Catalog","mode":"wide","href":"/integrations/data-collaboration/data-warehouses/catalog"},{"group":"Integrations","pages":[{"title":"Google BigQuery","href":"/integrations/data-collaboration/data-warehouses/bigquery"},{"title":"AWS S3","href":"/integrations/data-collaboration/data-warehouses/aws-s3"},{"title":"Snowflake","href":"/integrations/data-collaboration/data-warehouses/snowflake"},{"title":"Google Cloud Storage","href":"/integrations/data-collaboration/data-warehouses/gcs"}]}]}]},{"group":"Video","icon":"video","pages":[{"title":"Catalog","mode":"wide","href":"/integrations/video/catalog"},{"group":"Integrations","pages":[{"title":"Brightcove","href":"/integrations/video/brightcove"},{"title":"Dailymotion","href":"/integrations/video/dailymotion"},{"title":"JW Player","href":"/integrations/video/jw-player"},{"title":"YouTube","href":"/integrations/video/youtube"}]}]},{"group":"Social Media","icon":"share","pages":[{"title":"Catalog","mode":"wide","href":"/integrations/social-media/catalog"},{"group":"Integrations","pages":[{"title":"Facebook","href":"/integrations/social-media/facebook"},{"title":"Instagram","href":"/integrations/social-media/instagram"},{"title":"Pinterest","href":"/integrations/social-media/pinterest"},{"title":"X (Twitter)","sidebarTitle":"X","href":"/integrations/social-media/twitter"},{"title":"YouTube","href":"/integrations/social-media/youtube"},{"title":"TikTok","href":"/integrations/social-media/tiktok"},{"title":"LinkedIn","href":"/integrations/social-media/linkedin"}]}]},{"group":"Survey","icon":"chart-line","pages":[{"title":"Catalog","mode":"wide","href":"/integrations/survey/catalog"},{"group":"Integrations","pages":[{"title":"Collective Audience","href":"/integrations/survey/collective-audience"},{"title":"Apester","href":"/integrations/survey/apester"},{"title":"Brand Metrics","href":"/integrations/survey/brandmetrics"},{"title":"Opinary","href":"/integrations/survey/opinary"},{"title":"Qualifio","href":"/integrations/survey/qualifio"}]}]}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/introduction"}]},{"tab":"APIs","pages":[{"title":"APIs","href":"/api/introduction"}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/api/mcp/introduction"}]}]},"basePath":"","title":"FreeWheel - Permutive","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-DQG3o8Eu.js","lightbox-handle-r17bVUz3.js"]}