Integrate with AdsWizz for audio advertising and cohort activation.
AdsWizz
AdsWizz is an audio advertising platform specializing in programmatic audio and podcast monetization.
Setup
Troubleshooting
Overview
AdsWizz is an audio advertising platform that specializes in programmatic audio and podcast monetization. The AdsWizz integration enables real-time cohort activation and ad impression event collection across audio environments including web players, mobile apps, and smart speakers.This integration is Bidirectional:
Source: Permutive collects ad impression events from AdsWizz Audioserve campaigns, enabling cohort creation based on audio ad delivery data.
Destination: Permutive cohorts are activated for campaign targeting in AdsWizz. This integration supports two distinct activation methods:
Key-Value Activation: Real-time cohort activation via key-value targeting (Web, iOS, Android, API Direct). Cohort IDs are stored in local storage (Web), retrieved via SDK APIs (iOS/Android), or returned from the CCS API (API Direct), then appended to AdsWizz ad requests using the aw_0_1st.permutive custom parameter.Identity Based Activation: Server-to-server cohort activation where Permutive uploads audience data enriched with cohort memberships to AdsWizz, keyed by identity tags such as IDFA, AAID, and IP Address. See Supported Identity Tags for the full list. Cohorts appear as Audiences in AdsWizz.Use cases include:
Activate Permutive cohorts in AdsWizz for real-time audience targeting across audio inventory.
Collect impression data from AdsWizz campaigns to build cohorts based on audio ad exposure.
Target audio campaigns using first-party data segments from Permutive.
Enable cross-environment activation across web players, mobile apps, and smart speakers.
Activate audiences in environments without an SDK using identity-based, server-to-server delivery (Identity Based).
Leverage key-value targeting in AdsWizz with Permutive cohorts for flexible campaign configuration.
Supported Cohort Types (Key-Value Activation)
Cohort Type
Supported
Notes
Custom
Computed in real time on the client.
Lookalike
Computed in real time on the client.
Contextual
Delivered through the same key-value; requires contextual script configuration — coordinate with your Permutive Customer Success Manager.
Classification
In development — not yet supported.
Choosing an Activation Method
AdsWizz 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, API Direct
Web, iOS, Android, API Direct (Smart Speakers)
Sync Timing
Real-time
Daily
AdsWizz Feature
Key-value targeting (aw_0_1st.permutive)
Audiences
Use Cases
Real-time targeting on owned audio inventory across all environments
Audience activation in environments without an SDK, 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
API Direct
API Direct covers smart speakers, Alexa skills, and other environments where SDK deployment isn’t feasible. For Identity Based Activation in these environments, IP address is used as the identity tag.
Supported Identity Tags
These identity tags apply to Identity Based Activation only — Permutive uploads cohort memberships to AdsWizz keyed by the identifiers below. (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
Web, smart speakers, and other environments without device IDs
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:
Permutive SDK or API Key: The Permutive SDK must be deployed (Web/iOS/Android) or you must have a Permutive API key for API Direct implementations.
AdsWizz Account: Active AdsWizz account with access to Audioserve.
AdsWizz Technical Account Manager Coordination: Publishers must notify their AdsWizz Technical Account Manager to whitelist custom parameters for reporting, targeting, and forecasting.
For Impression Tracking: A custom event schema must be configured in Permutive (discuss with your Customer Success Manager), and the Permutive user ID must be passed in ad requests.
For Identity Based Activation:
AdsWizz Account: Active AdsWizz account with access to Audioserve.
Permutive Identity Collection: Identity collection must be configured in Permutive for the identity tags you want to send (see Supported Identity Tags).
AdsWizz Technical Account Manager Coordination: Publishers must coordinate with their AdsWizz Technical Account Manager to initiate the technical setup. AdsWizz provisions a bucket/path that Permutive uses to upload audience data files on the customer’s behalf.
Integration Enablement: Identity Based Activation is enabled by Permutive on request. Contact your Customer Success Manager to discuss enablement and timelines.
Setup
Key-Value Activation
Primary Setup Steps
Web
iOS
Android
API Direct
1
Enable Integration in Permutive Dashboard
Navigate to the integrations page in the Permutive dashboard (Settings → Integrations) and enable the AdsWizz integration.
Click Settings in the navigation menu
Select Integrations
Find AdsWizz in the integrations catalog
Click to enable the integration
Once enabled, you can activate individual cohorts for AdsWizz via cohort settings or the cohort activations page.
2
Coordinate with AdsWizz Technical Account Manager
Contact your AdsWizz Technical Account Manager to whitelist the custom parameters you’ll be passing.The key-value format for Permutive cohorts is:
Key: aw_0_1st.permutive
Value: Comma-separated cohort IDs
Additionally, notify them about the Permutive user ID parameter:
Key: aw_0_1st.permutiveid
Value: Permutive user ID
The aw_0_1st prefix identifies first-party data collected by the publisher. This coordination is essential to enable reporting, targeting, and forecasting options within AdsWizz.
3
Activate Cohorts
In the Permutive dashboard, activate cohorts for AdsWizz:
Navigate to the cohort you want to activate
Go to cohort settings or the cohort activations page
Enable the AdsWizz activation for that cohort
Activated cohort IDs will be made available in the appropriate storage location for each environment.
4
Implement Cohort Activation Code
Follow the environment-specific implementation steps in the tabs below (Web, iOS, Android) to retrieve cohort IDs and append them to AdsWizz ad requests.For Smart Speaker environments, see the API Direct implementation details in the Web tab.
5
Optional: Set up Impression Tracking
If you want to collect impression events from AdsWizz campaigns for cohort building and analytics, discuss this with your Customer Success Manager first.This requires:
A custom event schema to be set up within Permutive
Permutive user ID to be passed in AdsWizz ad requests (as aw_0_1st.permutiveid)
Tracking pixel placed in Ad/Creative in Audioserve campaigns
Once the event schema is configured, you can proceed with implementing the impression tracking pixel (see Web tab for details).
Cohort Activation on Web
To pass Permutive cohorts in your AdsWizz ad requests, retrieve cohort IDs from local storage and append them as key-value pairs to the ad request URL:
// Retrieve Permutive cohorts from local storagevar permutiveCohorts = JSON.parse(localStorage.getItem('_padswizz')) || [];// Retrieve Permutive user ID for impression trackingvar permutiveUserId = window.permutive.context.user_id || '';// Construct your AdsWizz ad request URLvar adsWizzUrl = 'https://[YOUR_ADSWIZZ_DOMAIN]/adserver/...';// Append Permutive cohorts as key-valuesif (permutiveCohorts.length > 0) { adsWizzUrl += '&aw_0_1st.permutive=' + permutiveCohorts.join(',');}// Append Permutive user ID for impression trackingif (permutiveUserId) { adsWizzUrl += '&aw_0_1st.permutiveid=' + permutiveUserId;}// Use the URL in your ad request// (Implementation varies based on your player setup)
Important Notes:
The Permutive SDK automatically populates the _padswizz local storage field with activated cohort IDs
Replace [YOUR_ADSWIZZ_DOMAIN] with your actual AdsWizz configuration
All custom parameters must use the aw_0_1st prefix to identify first-party publisher data
The same key-value format applies across all integration types (VAST, AIS, ORTB)
Ensure your AdsWizz TAM has whitelisted these parameters
Advanced: Enable Impression Event Collection
To collect impression events from AdsWizz for cohort building and analytics:
Add Tracking Pixel to Ad/Creative: In your AdsWizz Audioserve campaigns, add the following tracking pixel to each Ad/Creative you want to track:
Available AdsWizz Macros: The following macros can be used to capture impression metadata:
{campaignID} - Campaign ID
{ZoneId} - Zone ID
{publishername} - Publisher name
{listenerid} - Listener ID (AdsWizz user ID - cookie on web, MAID/device ID in other environments)
{campaignName} - Campaign name
{orderName} - Order name
{advertiserid} - Advertiser ID
{advertisername} - Advertiser name
For the full list of supported macros, consult your AdsWizz Technical Account Manager.
Custom Event Schema: Before implementing impression tracking, ensure your custom event schema has been configured in Permutive. Discuss with your Customer Success Manager to set this up.
Cohort Activation on iOS
Retrieve Permutive cohort IDs for AdsWizz using the activations property:
// Import Permutive SDKimport Permutive// Access AdsWizz Cohort IDs directlylet adsWizzCohorts: [String] = activations["adswizz_keyvalue"]// Retrieve Permutive user ID for impression trackinglet permutiveUserId = Permutive.user.id ?? ""// Construct your AdsWizz ad request URLvar adsWizzUrl = "https://[YOUR_ADSWIZZ_DOMAIN]/adserver/..."// Append Permutive cohorts as key-valuesif !adsWizzCohorts.isEmpty { let cohortsString = adsWizzCohorts.joined(separator: ",") adsWizzUrl += "&aw_0_1st.permutive=\(cohortsString)"}// Append Permutive user ID for impression trackingif !permutiveUserId.isEmpty { adsWizzUrl += "&aw_0_1st.permutiveid=\(permutiveUserId)"}// Use the URL in your ad request
Important Notes:
The activations property provides direct access to cohort IDs configured for AdsWizz activation
Use the key adswizz_keyvalue to retrieve AdsWizz-specific cohorts
Replace [YOUR_ADSWIZZ_DOMAIN] with your actual AdsWizz configuration
All custom parameters must use the aw_0_1st prefix
Cohort Activation on Android
Retrieve Permutive cohort IDs for AdsWizz using the TriggersProvider API. The callback is invoked whenever cohort membership changes:
val triggerAction: TriggerAction = triggersProvider.cohortActivations( activationType = "adswizz_keyvalue", callback = object : Method<List<String>> { override fun invoke(cohorts: List<String>) { if (cohorts.isNotEmpty()) { // Cohorts available for AdsWizz activation // Pass these to your AdsWizz ad requests as key-values println("AdsWizz cohorts: $cohorts") } else { println("No active cohorts with an AdsWizz activation configured.") } } })
Once you have the cohort IDs, append them to your AdsWizz ad request URL as key-values using the format aw_0_1st.permutive=[cohort_ids].Important Notes:
The TriggersProvider API allows you to listen for cohort membership changes
Use the activation type adswizz_keyvalue to retrieve AdsWizz-specific cohorts
All custom parameters must use the aw_0_1st prefix
In environments where it is not possible to deploy a Permutive SDK (e.g. some smart speaker 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.Identity Options for Smart Speakers:
Account-linked (authenticated) users: Use an internal cross-platform user ID that identifies the user across your environments
Non account-linked users: Use a device ID specific to the smart speaker
AdsWizz listener ID: Can also be used as the identity alias
For cross-environment segmentation and targeting, the identity provided should be consistent with identities used in your other environments (web, app).Example Response:
The API response includes cohort IDs for AdsWizz activation under the adswizz_keyvalue key within the activations object. These can then be passed to AdsWizz as key-values for activation using the same format: aw_0_1st.permutive=[cohort_ids].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
Web
iOS
Android
Smart Speakers
1
Contact Permutive CSM
Contact your Permutive Customer Success Manager to enable Identity Based Activation for AdsWizz. This is a server-to-server integration that must be configured by Permutive.
2
Coordinate with AdsWizz Technical Account Manager
Contact your AdsWizz Technical Account Manager to initiate the technical setup on the AdsWizz side. AdsWizz provisions a bucket/path that Permutive uses to upload audience data files on your behalf, and shares the destination details with Permutive.
3
Configure in Permutive Dashboard
Once enabled, navigate to Settings → Integrations in the Permutive Dashboard. Find “AdsWizz (ID-based)” in the list of available integrations and click to configure it.
4
Select Identity Tags
Choose which identity tags you want to send to AdsWizz.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 AdsWizz 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 “AdsWizz (ID-based)” activation toggle for each cohort you want to sync to AdsWizz.
7
Verify in AdsWizz
After the first sync completes (within 24 hours), check your AdsWizz dashboard to verify that audiences appear with names matching your activated cohorts.
Cohort data syncs to AdsWizz daily. Changes to cohort membership will be reflected in AdsWizz within 24 hours of the next scheduled sync.
Identity Based Activation for AdsWizz is enabled by Permutive on request. The integration approach has been mapped out with AdsWizz and can be made available within a few weeks of a customer request. Contact your Customer Success Manager to get started.
Identity Based Activation for Web enables server-to-server cohort syncing using IP Address. No SDK code changes are required to append cohorts to ad requests — activation happens server-to-server.How it works:
Permutive collects IP addresses from your web users
Cohort memberships are synced daily to AdsWizz server-to-server
Cohorts appear as Audiences in AdsWizz, ready for campaign targeting
Data syncing happens automatically once configured in the Permutive Dashboard
Prerequisites:
Permutive must be collecting IP addresses from your web environment
Work with your Permutive Customer Success Manager to ensure proper identity collection
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 AdsWizz server-to-server
Cohorts appear as Audiences in AdsWizz, 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 AdsWizz server-to-server
Cohorts appear as Audiences in AdsWizz, 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 smart speakers and other server-side audio environments enables server-to-server cohort syncing using IP Address. No SDK deployment is required in the activation environment.How it works:
Permutive collects IP addresses from your smart speaker or server-side audio environments
Cohort memberships are synced daily to AdsWizz server-to-server
Cohorts appear as Audiences in AdsWizz, ready for campaign targeting
Data syncing happens automatically once configured in the Permutive Dashboard
Prerequisites:
Permutive must be collecting IP addresses from your smart speaker environment
Work with your Permutive Customer Success Manager to ensure proper identity collection
Data Types
The AdsWizz integration involves the following data types. Impression events are collected into Permutive (Source), while cohort activation data is delivered to AdsWizz (Destination):
AdsWizz Impression
Fired when an audio ad impression is served through AdsWizz Audioserve. This event captures campaign, publisher, and listener metadata for cohort building and analytics.
string
The ID of the campaign associated with the impression.
string
The ID of the zone where the ad was served.
string
The name of the publisher associated with the impression.
string
The AdsWizz listener ID (cookie on web, MAID/device ID in other environments).
string
The name of the campaign associated with the impression.
string
The name of the order associated with the impression.
string
The ID of the advertiser associated with the impression.
string
The name of the advertiser associated with the impression.
Cohort Activation Data (Identity Based)
When you activate a cohort using Identity Based Activation, Permutive uploads audience data enriched with cohort memberships to AdsWizz via a server-to-server transfer.Data Transfer:
Cohort data is synced daily from Permutive to AdsWizz
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
AdsWizz Audiences:
Cohorts appear as Audiences in AdsWizz
Named using the cohort name from Permutive
Available for campaign targeting in AdsWizz’s audience targeting interface
Updated daily with the latest cohort membership data
Impression events require additional setup. A custom event schema must be configured in Permutive (discuss with your Customer Success Manager), and the tracking pixel must be placed in Ad/Creative in Audioserve campaigns. See the “Advanced: Enable Impression Event Collection” section in Setup for implementation details.
Troubleshooting
Cohorts not appearing in local storage or SDK APIs
Symptoms: Cohort IDs are not appearing in _padswizz local storage (Web) or not returned by SDK APIs (iOS/Android).Solutions:
Verify the AdsWizz integration is enabled in the Permutive dashboard (Settings → Integrations)
Check that cohorts have been activated for AdsWizz in the Permutive dashboard (via cohort settings or cohort activations page)
Ensure the Permutive SDK is properly deployed and initialized
For Web, check browser developer tools → Application → Local Storage to verify the _padswizz key exists
For iOS/Android, verify you’re using the correct activation type key (adswizz_keyvalue)
Cohorts not being passed in ad requests
Symptoms: Permutive cohorts are not included in AdsWizz ad request URLs, or targeting doesn’t work as expected.Solutions:
Verify cohort IDs are being retrieved correctly from local storage (Web) or SDK APIs (iOS/Android)
Ensure the key-value format is correct: aw_0_1st.permutive=[cohort_ids]
Confirm the custom parameters are being appended to the AdsWizz ad request URL
Check that the Permutive SDK loads before the AdsWizz ad request is made
Verify the cohorts are activated with an AdsWizz activation (not just other activations)
AdsWizz not recognizing key-values (whitelisting issue)
Symptoms: Key-values are being passed in ad requests but AdsWizz is not recognizing them for targeting or reporting.Solutions:
Contact your AdsWizz Technical Account Manager to whitelist the custom parameters
Confirm that the aw_0_1st.permutive and aw_0_1st.permutiveid parameters have been whitelisted
Verify the key-value format matches AdsWizz requirements (prefix aw_0_1st for first-party data)
Allow time for whitelisting changes to take effect in AdsWizz systems
Check AdsWizz campaign targeting interface to confirm parameters are available
Impression events not being collected
Symptoms: AdsWizz impression events are not appearing in Permutive analytics or event stream.Solutions:
Verify the tracking pixel has been added to Ad/Creative in AdsWizz Audioserve campaigns
Ensure the custom event schema has been configured in Permutive (discuss with your Customer Success Manager)
Confirm the Permutive user ID is being passed in ad requests (as aw_0_1st.permutiveid)
Check that the tracking pixel URL is correctly formatted with the Permutive API key
Verify AdsWizz macros are correctly replacing with actual values (e.g., {campaignID}, {ZoneId})
Test the tracking pixel URL manually to confirm it’s reachable
API Direct returning empty activations
Symptoms: The CCS API response includes an empty adswizz_keyvalue array or doesn’t include the key at all.Solutions:
Verify the AdsWizz integration is enabled in the Permutive dashboard
Check that cohorts have been activated for AdsWizz
Ensure the user identified in the API request (via alias) is a member of activated cohorts
Confirm the activations=true query parameter is included in the API request URL
Allow time for cohort membership to be computed after sending events
Verify the API key used in the request has the correct permissions
Issues with Identity Based Activation
Symptoms: Audiences are not appearing in AdsWizz, or cohort memberships are not syncing as expected.Solutions:
Verify that cohorts are activated with the “AdsWizz (ID-based)” toggle enabled in the Permutive Dashboard
Remember that cohort data syncs daily — allow up to 24 hours for changes to appear in AdsWizz
Confirm that Permutive is collecting the identity tags you selected (see Supported Identity Tags) by checking with your Permutive Customer Success Manager
Verify your selected identity tags are correct in Settings → Integrations
Confirm Identity Based Activation has been enabled for your workspace (this is enabled by Permutive on request)
For Identity Based Activation issues, contact your Permutive Customer Success Manager for assistance.
Changelog
September 2026
Contextual cohort activation is now supported via Key-Value Activation
June 2026
Documented Identity Based Activation for AdsWizz: server-to-server cohort upload keyed by IDFA, AAID, or IP Address, with cohorts appearing as Audiences in AdsWizz (available on request)
October 2025
AdsWizz key-value integration released for Web, iOS, and Android environments
Added support for API Direct implementation for smart speaker environments
Enabled AdsWizz impression event collection via tracking pixel
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":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","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/adswizz","slug":"/integrations/advertising/ad-servers/adswizz","pageMetadata":{"title":"AdsWizz","description":"Integrate with AdsWizz for audio advertising and cohort activation.","href":"/integrations/advertising/ad-servers/adswizz"},"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 AdsWizz for audio advertising and cohort activation.\"\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`,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,ResponseField,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(!ResponseField)_missingMdxReference(`ResponseField`,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/pNhz39ducTVcQczh/images/integrations/logos/adswizz.svg?fit=max\u0026auto=format\u0026n=pNhz39ducTVcQczh\u0026q=85\u0026s=872eda08cf80a878d44bf1d34744add8`,alt:`AdsWizz`,style:{maxWidth:`32px`,maxHeight:`32px`,display:`block`},\"data-og-width\":`102`,width:`102`,\"data-og-height\":`93`,height:`93`,\"data-path\":`images/integrations/logos/adswizz.svg`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/permutive/pNhz39ducTVcQczh/images/integrations/logos/adswizz.svg?w=280\u0026fit=max\u0026auto=format\u0026n=pNhz39ducTVcQczh\u0026q=85\u0026s=bdcb9bb844f47281ec19b0938f79389a 280w, https://mintcdn.com/permutive/pNhz39ducTVcQczh/images/integrations/logos/adswizz.svg?w=560\u0026fit=max\u0026auto=format\u0026n=pNhz39ducTVcQczh\u0026q=85\u0026s=102da34a343d83d8b637f662af3b251c 560w, https://mintcdn.com/permutive/pNhz39ducTVcQczh/images/integrations/logos/adswizz.svg?w=840\u0026fit=max\u0026auto=format\u0026n=pNhz39ducTVcQczh\u0026q=85\u0026s=fe62252409b252c36e53e55bb783957f 840w, https://mintcdn.com/permutive/pNhz39ducTVcQczh/images/integrations/logos/adswizz.svg?w=1100\u0026fit=max\u0026auto=format\u0026n=pNhz39ducTVcQczh\u0026q=85\u0026s=b0678efc701f5f3d895c3f645705675f 1100w, https://mintcdn.com/permutive/pNhz39ducTVcQczh/images/integrations/logos/adswizz.svg?w=1650\u0026fit=max\u0026auto=format\u0026n=pNhz39ducTVcQczh\u0026q=85\u0026s=db921df71ed689bc6a019dd7f0a3ae59 1650w, https://mintcdn.com/permutive/pNhz39ducTVcQczh/images/integrations/logos/adswizz.svg?w=2500\u0026fit=max\u0026auto=format\u0026n=pNhz39ducTVcQczh\u0026q=85\u0026s=e8104eadcc3f890b300eb21e249ad300 2500w`})}),_jsx(Heading,{level:`3`,id:`adswizz`,style:{margin:0,fontSize:`1.125rem`,fontWeight:`600`},children:`AdsWizz`})]}),_jsxs(`div`,{style:{marginBottom:`1rem`},children:[_jsx(_MdxComponentBoundary,{name:`BadgeRowCenter`,children:_jsx(BadgeRowCenter,{label:`Direction`,children:_jsx(_MdxComponentBoundary,{name:`DirectionBadge`,children:_jsx(DirectionBadge,{direction:`Bidirectional`})})})}),_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:`API Direct`})})]})})})}),_jsx(_MdxComponentBoundary,{name:`BadgeRowCenter`,children:_jsx(BadgeRowCenter,{label:`Capability`,children:_jsx(_MdxComponentBoundary,{name:`BadgeContainer`,children:_jsxs(BadgeContainer,{children:[_jsx(_MdxComponentBoundary,{name:`CapabilityBadge`,children:_jsx(CapabilityBadge,{capability:`Event Collection`})}),_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:`AdsWizz is an audio advertising platform specializing in programmatic audio and podcast 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:`AdsWizz is an audio advertising platform that specializes in programmatic audio and podcast monetization. The AdsWizz integration enables real-time cohort activation and ad impression event collection across audio environments including web players, mobile apps, and smart speakers.`}),`\n`,_jsx(_components.p,{children:`This integration is Bidirectional:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Source:`}),` Permutive collects ad impression events from AdsWizz Audioserve campaigns, enabling cohort creation based on audio ad delivery data.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Destination:`}),` Permutive cohorts are activated for campaign targeting in AdsWizz. This integration supports two distinct activation methods:`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Key-Value Activation:`}),` Real-time cohort activation via key-value targeting (Web, iOS, Android, API Direct). Cohort IDs are stored in local storage (Web), retrieved via SDK APIs (iOS/Android), or returned from the CCS API (API Direct), then appended to AdsWizz ad requests using the `,_jsx(_components.code,{children:`aw_0_1st.permutive`}),` custom parameter.`]}),`\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 AdsWizz, keyed by identity tags such as IDFA, AAID, and IP Address. See `,_jsx(_components.a,{href:`#supported-identity-tags`,children:`Supported Identity Tags`}),` for the full list. Cohorts appear as Audiences in AdsWizz.`]}),`\n`,_jsx(_components.p,{children:`Use cases include:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Activate Permutive cohorts in AdsWizz for real-time audience targeting across audio inventory.`}),`\n`,_jsx(_components.li,{children:`Collect impression data from AdsWizz campaigns to build cohorts based on audio ad exposure.`}),`\n`,_jsx(_components.li,{children:`Target audio campaigns using first-party data segments from Permutive.`}),`\n`,_jsx(_components.li,{children:`Enable cross-environment activation across web players, mobile apps, and smart speakers.`}),`\n`,_jsx(_components.li,{children:`Activate audiences in environments without an SDK using identity-based, server-to-server delivery (Identity Based).`}),`\n`,_jsx(_components.li,{children:`Leverage key-value targeting in AdsWizz with Permutive cohorts for flexible campaign configuration.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`supported-cohort-types-key-value-activation`,children:`Supported Cohort Types (Key-Value Activation)`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Cohort Type`}),_jsx(_components.th,{children:`Supported`}),_jsx(_components.th,{children:`Notes`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Custom`})}),_jsx(_components.td,{children:_jsx(_MdxComponentBoundary,{name:`YesBadge`,children:_jsx(YesBadge,{})})}),_jsx(_components.td,{children:`Computed in real time on the client.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Lookalike`})}),_jsx(_components.td,{children:_jsx(_MdxComponentBoundary,{name:`YesBadge`,children:_jsx(YesBadge,{})})}),_jsx(_components.td,{children:`Computed in real time on the client.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Contextual`})}),_jsx(_components.td,{children:_jsx(_MdxComponentBoundary,{name:`YesBadge`,children:_jsx(YesBadge,{})})}),_jsx(_components.td,{children:`Delivered through the same key-value; requires contextual script configuration — coordinate with your Permutive Customer Success Manager.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Classification`})}),_jsx(_components.td,{children:_jsx(_MdxComponentBoundary,{name:`NoBadge`,children:_jsx(NoBadge,{})})}),_jsx(_components.td,{children:`In development — not yet supported.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`choosing-an-activation-method`,children:`Choosing an Activation Method`}),`\n`,_jsx(_components.p,{children:`AdsWizz 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, API Direct`}),_jsx(_components.td,{children:`Web, iOS, Android, API Direct (Smart Speakers)`})]}),_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:`AdsWizz Feature`})}),_jsxs(_components.td,{children:[`Key-value targeting (`,_jsx(_components.code,{children:`aw_0_1st.permutive`}),`)`]}),_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 audio inventory across all environments`}),_jsx(_components.td,{children:`Audience activation in environments without an SDK, 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:`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(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`API Direct`}),` covers smart speakers, Alexa skills, and other environments where SDK deployment isn’t feasible. For Identity Based Activation in these environments, IP address is used as the identity tag.`]})}),`\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 AdsWizz keyed by the identifiers below. (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:`Web, smart speakers, and other environments without device IDs`})]})]})]}),`\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:`Permutive SDK or API Key`}),`: The Permutive SDK must be deployed (Web/iOS/Android) or you must have a Permutive API key for API Direct implementations.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`AdsWizz Account`}),`: Active AdsWizz account with access to Audioserve.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`AdsWizz Technical Account Manager Coordination`}),`: Publishers must notify their AdsWizz Technical Account Manager to whitelist custom parameters for reporting, targeting, and forecasting.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`For Impression Tracking`}),`: A custom event schema must be configured in Permutive (discuss with your Customer Success Manager), and the Permutive user ID must be passed in ad requests.`]}),`\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:`AdsWizz Account`}),`: Active AdsWizz account with access to Audioserve.`]}),`\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`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`AdsWizz Technical Account Manager Coordination`}),`: Publishers must coordinate with their AdsWizz Technical Account Manager to initiate the technical setup. AdsWizz provisions a bucket/path that Permutive uses to upload audience data files on the customer’s behalf.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Integration Enablement`}),`: Identity Based Activation is enabled by Permutive on request. Contact your Customer Success Manager to discuss enablement and timelines.`]}),`\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:[_jsxs(Step,{title:`Enable Integration in Permutive Dashboard`,children:[_jsx(_components.p,{children:`Navigate to the integrations page in the Permutive dashboard (Settings → Integrations) and enable the AdsWizz integration.`}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Settings`}),` in the navigation menu`]}),`\n`,_jsxs(_components.li,{children:[`Select `,_jsx(_components.strong,{children:`Integrations`})]}),`\n`,_jsxs(_components.li,{children:[`Find `,_jsx(_components.strong,{children:`AdsWizz`}),` in the integrations catalog`]}),`\n`,_jsx(_components.li,{children:`Click to enable the integration`}),`\n`]}),_jsx(_components.p,{children:`Once enabled, you can activate individual cohorts for AdsWizz via cohort settings or the cohort activations page.`})]}),_jsxs(Step,{title:`Coordinate with AdsWizz Technical Account Manager`,children:[_jsx(_components.p,{children:`Contact your AdsWizz Technical Account Manager to whitelist the custom parameters you’ll be passing.`}),_jsx(_components.p,{children:`The key-value format for Permutive cohorts is:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Key`}),`: `,_jsx(_components.code,{children:`aw_0_1st.permutive`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Value`}),`: Comma-separated cohort IDs`]}),`\n`]}),_jsx(_components.p,{children:`Additionally, notify them about the Permutive user ID parameter:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Key`}),`: `,_jsx(_components.code,{children:`aw_0_1st.permutiveid`})]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Value`}),`: Permutive user ID`]}),`\n`]}),_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`aw_0_1st`}),` prefix identifies first-party data collected by the publisher. This coordination is essential to enable reporting, targeting, and forecasting options within AdsWizz.`]})]}),_jsxs(Step,{title:`Activate Cohorts`,children:[_jsx(_components.p,{children:`In the Permutive dashboard, activate cohorts for AdsWizz:`}),_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Navigate to the cohort you want to activate`}),`\n`,_jsx(_components.li,{children:`Go to cohort settings or the cohort activations page`}),`\n`,_jsx(_components.li,{children:`Enable the AdsWizz activation for that cohort`}),`\n`]}),_jsx(_components.p,{children:`Activated cohort IDs will be made available in the appropriate storage location for each environment.`})]}),_jsxs(Step,{title:`Implement Cohort Activation Code`,children:[_jsx(_components.p,{children:`Follow the environment-specific implementation steps in the tabs below (Web, iOS, Android) to retrieve cohort IDs and append them to AdsWizz ad requests.`}),_jsx(_components.p,{children:`For Smart Speaker environments, see the API Direct implementation details in the Web tab.`})]}),_jsxs(Step,{title:`Optional: Set up Impression Tracking`,children:[_jsx(_components.p,{children:`If you want to collect impression events from AdsWizz campaigns for cohort building and analytics, discuss this with your Customer Success Manager first.`}),_jsx(_components.p,{children:`This requires:`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`A custom event schema to be set up within Permutive`}),`\n`,_jsxs(_components.li,{children:[`Permutive user ID to be passed in AdsWizz ad requests (as `,_jsx(_components.code,{children:`aw_0_1st.permutiveid`}),`)`]}),`\n`,_jsx(_components.li,{children:`Tracking pixel placed in Ad/Creative in Audioserve campaigns`}),`\n`]}),_jsx(_components.p,{children:`Once the event schema is configured, you can proceed with implementing the impression tracking pixel (see Web tab for details).`})]})]})}),_jsxs(Tab,{title:`Web`,id:`web`,\"data-child-heading-ids\":`[\"cohort-activation-on-web\",\"advanced%3A-enable-impression-event-collection\"]`,children:[_jsx(Heading,{level:`2`,id:`cohort-activation-on-web`,children:`Cohort Activation on Web`}),_jsx(_components.p,{children:`To pass Permutive cohorts in your AdsWizz ad requests, retrieve cohort IDs from local storage and append them as key-value pairs to the ad request URL:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`21`,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:`21`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:`// Retrieve Permutive cohorts from local storage`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`var`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` permutiveCohorts = JSON.parse(localStorage.getItem(`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`'_padswizz'`}),_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:`// Retrieve Permutive user ID for impression tracking`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`var`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` permutiveUserId = window.permutive.context.user_id || `}),_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`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:`// Construct your AdsWizz ad request URL`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`var`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` adsWizzUrl = `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`'https://[YOUR_ADSWIZZ_DOMAIN]/adserver/...'`}),_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:`// 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:` (permutiveCohorts.length > 0) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` adsWizzUrl += `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`'\u0026aw_0_1st.permutive='`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` + permutiveCohorts.join(`}),_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:`// Append Permutive user ID for impression tracking`})}),`\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:` (permutiveUserId) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` adsWizzUrl += `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`'\u0026aw_0_1st.permutiveid='`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` + permutiveUserId;`})]}),`\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 URL in your ad request`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:`// (Implementation varies based on your player setup)`})}),`\n`]})})}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Important Notes:`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`The Permutive SDK automatically populates the `,_jsx(_components.code,{children:`_padswizz`}),` local storage field with activated cohort IDs`]}),`\n`,_jsxs(_components.li,{children:[`Replace `,_jsx(_components.code,{children:`[YOUR_ADSWIZZ_DOMAIN]`}),` with your actual AdsWizz configuration`]}),`\n`,_jsxs(_components.li,{children:[`All custom parameters must use the `,_jsx(_components.code,{children:`aw_0_1st`}),` prefix to identify first-party publisher data`]}),`\n`,_jsx(_components.li,{children:`The same key-value format applies across all integration types (VAST, AIS, ORTB)`}),`\n`,_jsx(_components.li,{children:`Ensure your AdsWizz TAM has whitelisted these parameters`}),`\n`]}),_jsx(Heading,{level:`2`,id:`advanced-enable-impression-event-collection`,children:`Advanced: Enable Impression Event Collection`}),_jsx(_components.p,{children:`To collect impression events from AdsWizz for cohort building and analytics:`}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Add Tracking Pixel to Ad/Creative`}),`: In your AdsWizz Audioserve campaigns, add the following tracking pixel to each Ad/Creative you want to track:`]}),`\n`]}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:'https://api.permutive.app/v2.0/px/track?k=PERMUTIVE_API_KEY\u0026u=${parameters[\"aw_0_1st.permutiveid\"]!}\u0026e=AdsWizzImpression\u0026p={\"campaign_id\":\"{campaignID}\",\"zone_id\":\"{ZoneId}\",\"publisher_name\":\"{publishername}\",\"listener_id\":\"{listenerid}\",\"campaign_name\":\"{campaignName}\",\"order_name\":\"{orderName}\",\"advertiser_id\":\"{advertiserid}\",\"advertiser_name\":\"{advertisername}\"}'})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_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 macro `,_jsx(_components.code,{children:'${parameters[\"aw_0_1st.permutiveid\"]!}'}),` extracts the Permutive user ID from the ad request`]}),`\n`,_jsx(_components.li,{children:`This requires the Permutive user ID to be passed in ad requests (see cohort activation code above)`}),`\n`,_jsxs(_components.li,{children:[`AdsWizz macros (e.g., `,_jsx(_components.code,{children:`{campaignID}`}),`, `,_jsx(_components.code,{children:`{ZoneId}`}),`) capture impression metadata`]}),`\n`]}),_jsxs(_components.ol,{start:`2`,children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Available AdsWizz Macros`}),`: The following macros can be used to capture impression metadata:`]}),`\n`]}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`{campaignID}`}),` - Campaign ID`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`{ZoneId}`}),` - Zone ID`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`{publishername}`}),` - Publisher name`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`{listenerid}`}),` - Listener ID (AdsWizz user ID - cookie on web, MAID/device ID in other environments)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`{campaignName}`}),` - Campaign name`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`{orderName}`}),` - Order name`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`{advertiserid}`}),` - Advertiser ID`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`{advertisername}`}),` - Advertiser name`]}),`\n`]}),_jsx(_components.p,{children:`For the full list of supported macros, consult your AdsWizz Technical Account Manager.`}),_jsxs(_components.ol,{start:`3`,children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Custom Event Schema`}),`: Before implementing impression tracking, ensure your custom event schema has been configured in Permutive. Discuss with your Customer Success Manager to set this up.`]}),`\n`]})]}),_jsxs(Tab,{title:`iOS`,id:`ios`,\"data-child-heading-ids\":`[\"cohort-activation-on-ios\"]`,children:[_jsx(Heading,{level:`2`,id:`cohort-activation-on-ios`,children:`Cohort Activation on iOS`}),_jsxs(_components.p,{children:[`Retrieve Permutive cohort IDs for AdsWizz using the `,_jsx(_components.code,{children:`activations`}),` property:`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`24`,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:`24`,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 AdsWizz 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:` adsWizzCohorts: [`}),_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:`\"adswizz_keyvalue\"`}),_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:`// Retrieve Permutive user ID for impression tracking`})}),`\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:` permutiveUserId = Permutive.`}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`user`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#9CDCFE`,\"--shiki-dark\":`#9CDCFE`},children:`id`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` ?? `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},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 AdsWizz ad request URL`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`var`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` adsWizzUrl = `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"https://[YOUR_ADSWIZZ_DOMAIN]/adserver/...\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\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:` !adsWizzCohorts.`}),_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 = adsWizzCohorts.`}),_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`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` adsWizzUrl += `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"\u0026aw_0_1st.permutive=`}),_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`\\\\(`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`cohortsString`}),_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`)`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},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:`// Append Permutive user ID for impression tracking`})}),`\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:` !permutiveUserId.`}),_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:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` adsWizzUrl += `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"\u0026aw_0_1st.permutiveid=`}),_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`\\\\(`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:`permutiveUserId`}),_jsx(_components.span,{style:{color:`#569CD6`,\"--shiki-dark\":`#569CD6`},children:`)`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},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 URL in your ad request`})}),`\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 AdsWizz activation`]}),`\n`,_jsxs(_components.li,{children:[`Use the key `,_jsx(_components.code,{children:`adswizz_keyvalue`}),` to retrieve AdsWizz-specific cohorts`]}),`\n`,_jsxs(_components.li,{children:[`Replace `,_jsx(_components.code,{children:`[YOUR_ADSWIZZ_DOMAIN]`}),` with your actual AdsWizz configuration`]}),`\n`,_jsxs(_components.li,{children:[`All custom parameters must use the `,_jsx(_components.code,{children:`aw_0_1st`}),` prefix`]}),`\n`]})]}),_jsxs(Tab,{title:`Android`,id:`android`,\"data-child-heading-ids\":`[\"cohort-activation-on-android\"]`,children:[_jsx(Heading,{level:`2`,id:`cohort-activation-on-android`,children:`Cohort Activation on Android`}),_jsxs(_components.p,{children:[`Retrieve Permutive cohort IDs for AdsWizz 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:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`val`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` triggerAction: TriggerAction = triggersProvider.cohortActivations(`})]}),`\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:`\"adswizz_keyvalue\"`}),_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:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:`object`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` : Method\u003cList\u003cString>> {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:` override`}),_jsx(_components.span,{style:{color:`#C586C0`,\"--shiki-dark\":`#C586C0`},children:` fun`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` invoke(cohorts: List\u003cString>) {`})]}),`\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.isNotEmpty()) {`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:` // Cohorts available for AdsWizz activation`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6A9955`,\"--shiki-dark\":`#6A9955`},children:` // Pass these to your AdsWizz ad requests as key-values`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` println(`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"AdsWizz cohorts: $cohorts\"`}),_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:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` println(`}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`\"No active cohorts with an AdsWizz 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`]})})}),_jsxs(_components.p,{children:[`Once you have the cohort IDs, append them to your AdsWizz ad request URL as key-values using the format `,_jsx(_components.code,{children:`aw_0_1st.permutive=[cohort_ids]`}),`.`]}),_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:`adswizz_keyvalue`}),` to retrieve AdsWizz-specific cohorts`]}),`\n`,_jsxs(_components.li,{children:[`All custom parameters must use the `,_jsx(_components.code,{children:`aw_0_1st`}),` prefix`]}),`\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\":`[\"cohort-activation-via-api-direct\",\"how-it-works\"]`,children:[_jsx(Heading,{level:`2`,id:`cohort-activation-via-api-direct`,children:`Cohort Activation via API Direct`}),_jsx(_components.p,{children:`In environments where it is not possible to deploy a Permutive SDK (e.g. some smart speaker 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:`26`,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:`26`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#DCDCAA`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` --request POST \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},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:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#D4D4D4`,\"--shiki-dark\":`#D4D4D4`},children:` --header `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`'accept: application/json'`}),_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:` --header `}),_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:`'content-type: application/json'`}),_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:` --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:` \"name\": \"AudioView\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"time\": \"2025-10-02T09:40:43.179Z\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"view_id\": \"a55a9c8b-4a0b-4fe7-99a9-170624850501\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"session_id\": \"1d145310-1338-4ff7-96dd-e6128f54cbe5\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"properties\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"audio\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"title\": \"...\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#CE9178`,\"--shiki-dark\":`#CE9178`},children:` \"genre\": \"...\"`})}),`\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`,_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`,_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:`Identity Options for Smart Speakers:`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Account-linked (authenticated) users:`}),` Use an internal cross-platform user ID that identifies the user across your environments`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Non account-linked users:`}),` Use a device ID specific to the smart speaker`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`AdsWizz listener ID:`}),` Can also be used as the identity alias`]}),`\n`]}),_jsx(_components.p,{children:`For cross-environment segmentation and targeting, the identity provided should be consistent with identities used in your other environments (web, app).`}),_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:` \"adswizz_keyvalue\"`}),_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:`]`})]}),`\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 AdsWizz activation under the `,_jsx(_components.code,{children:`adswizz_keyvalue`}),` key within the `,_jsx(_components.code,{children:`activations`}),` object. These can then be passed to AdsWizz as key-values for activation using the same format: `,_jsx(_components.code,{children:`aw_0_1st.permutive=[cohort_ids]`}),`.`]}),_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 AdsWizz. This is a server-to-server integration that must be configured by Permutive.`})}),_jsx(Step,{title:`Coordinate with AdsWizz Technical Account Manager`,children:_jsx(_components.p,{children:`Contact your AdsWizz Technical Account Manager to initiate the technical setup on the AdsWizz side. AdsWizz provisions a bucket/path that Permutive uses to upload audience data files on your behalf, and shares the destination details with Permutive.`})}),_jsx(Step,{title:`Configure in Permutive Dashboard`,children:_jsx(_components.p,{children:`Once enabled, navigate to Settings → Integrations in the Permutive Dashboard. Find “AdsWizz (ID-based)” in the list of available integrations and click to configure it.`})}),_jsxs(Step,{title:`Select Identity Tags`,children:[_jsx(_components.p,{children:`Choose which identity tags you want to send to AdsWizz.`}),_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 AdsWizz 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 “AdsWizz (ID-based)” activation toggle for each cohort you want to sync to AdsWizz.`})}),_jsx(Step,{title:`Verify in AdsWizz`,children:_jsx(_components.p,{children:`After the first sync completes (within 24 hours), check your AdsWizz dashboard to verify that audiences appear with names matching your activated cohorts.`})})]}),_jsx(Info,{children:_jsx(_components.p,{children:`Cohort data syncs to AdsWizz daily. Changes to cohort membership will be reflected in AdsWizz within 24 hours of the next scheduled sync.`})}),_jsx(Note,{children:_jsx(_components.p,{children:`Identity Based Activation for AdsWizz is enabled by Permutive on request. The integration approach has been mapped out with AdsWizz and can be made available within a few weeks of a customer request. Contact your Customer Success Manager to get started.`})})]}),_jsxs(Tab,{title:`Web`,id:`web-2`,children:[_jsx(_components.p,{children:`Identity Based Activation for Web enables server-to-server cohort syncing using IP Address. No SDK code changes are required to append cohorts to ad requests — activation happens server-to-server.`}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`How it works:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Permutive collects IP addresses from your web users`}),`\n`,_jsx(_components.li,{children:`Cohort memberships are synced daily to AdsWizz server-to-server`}),`\n`,_jsx(_components.li,{children:`Cohorts appear as Audiences in AdsWizz, 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 from your web environment`}),`\n`,_jsx(_components.li,{children:`Work with your Permutive Customer Success Manager to ensure proper identity collection`}),`\n`]})]}),_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 AdsWizz server-to-server`}),`\n`,_jsx(_components.li,{children:`Cohorts appear as Audiences in AdsWizz, 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 AdsWizz server-to-server`}),`\n`,_jsx(_components.li,{children:`Cohorts appear as Audiences in AdsWizz, 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:`Smart Speakers`,id:`smart-speakers`,children:[_jsx(_components.p,{children:`Identity Based Activation for smart speakers and other server-side audio environments enables server-to-server cohort syncing using IP Address. No SDK deployment is required in the activation environment.`}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`How it works:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Permutive collects IP addresses from your smart speaker or server-side audio environments`}),`\n`,_jsx(_components.li,{children:`Cohort memberships are synced daily to AdsWizz server-to-server`}),`\n`,_jsx(_components.li,{children:`Cohorts appear as Audiences in AdsWizz, 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 from your smart speaker environment`}),`\n`,_jsx(_components.li,{children:`Work with your Permutive Customer Success Manager to ensure proper identity collection`}),`\n`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`data-types`,children:`Data Types`}),`\n`,_jsx(_components.p,{children:`The AdsWizz integration involves the following data types. Impression events are collected into Permutive (Source), while cohort activation data is delivered to AdsWizz (Destination):`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`AdsWizz Impression`,id:`adswizz-impression`,children:[_jsx(_components.p,{children:`Fired when an audio ad impression is served through AdsWizz Audioserve. This event captures campaign, publisher, and listener metadata for cohort building and analytics.`}),_jsx(ResponseField,{name:`campaign_id`,type:`string`,id:`param-campaign-id`,children:_jsx(_components.p,{children:`The ID of the campaign associated with the impression.`})}),_jsx(ResponseField,{name:`zone_id`,type:`string`,id:`param-zone-id`,children:_jsx(_components.p,{children:`The ID of the zone where the ad was served.`})}),_jsx(ResponseField,{name:`publisher_name`,type:`string`,id:`param-publisher-name`,children:_jsx(_components.p,{children:`The name of the publisher associated with the impression.`})}),_jsx(ResponseField,{name:`listener_id`,type:`string`,id:`param-listener-id`,children:_jsx(_components.p,{children:`The AdsWizz listener ID (cookie on web, MAID/device ID in other environments).`})}),_jsx(ResponseField,{name:`campaign_name`,type:`string`,id:`param-campaign-name`,children:_jsx(_components.p,{children:`The name of the campaign associated with the impression.`})}),_jsx(ResponseField,{name:`order_name`,type:`string`,id:`param-order-name`,children:_jsx(_components.p,{children:`The name of the order associated with the impression.`})}),_jsx(ResponseField,{name:`advertiser_id`,type:`string`,id:`param-advertiser-id`,children:_jsx(_components.p,{children:`The ID of the advertiser associated with the impression.`})}),_jsx(ResponseField,{name:`advertiser_name`,type:`string`,id:`param-advertiser-name`,children:_jsx(_components.p,{children:`The name of the advertiser associated with the impression.`})})]}),_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 AdsWizz 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 AdsWizz`}),`\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:`AdsWizz Audiences:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Cohorts appear as Audiences in AdsWizz`}),`\n`,_jsx(_components.li,{children:`Named using the cohort name from Permutive`}),`\n`,_jsx(_components.li,{children:`Available for campaign targeting in AdsWizz’s audience targeting interface`}),`\n`,_jsx(_components.li,{children:`Updated daily with the latest cohort membership data`}),`\n`]})]})]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Impression events require additional setup. A custom event schema must be configured in Permutive (discuss with your Customer Success Manager), and the tracking pixel must be placed in Ad/Creative in Audioserve campaigns. See the “Advanced: Enable Impression Event Collection” section in Setup for implementation details.`})}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`Cohorts not appearing in local storage or SDK APIs`,id:`cohorts-not-appearing-in-local-storage-or-sdk-apis`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Symptoms:`}),` Cohort IDs are not appearing in `,_jsx(_components.code,{children:`_padswizz`}),` local storage (Web) or not returned by SDK APIs (iOS/Android).`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Solutions:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Verify the AdsWizz integration is enabled in the Permutive dashboard (Settings → Integrations)`}),`\n`,_jsx(_components.li,{children:`Check that cohorts have been activated for AdsWizz in the Permutive dashboard (via cohort settings or cohort activations page)`}),`\n`,_jsx(_components.li,{children:`Ensure the Permutive SDK is properly deployed and initialized`}),`\n`,_jsxs(_components.li,{children:[`For Web, check browser developer tools → Application → Local Storage to verify the `,_jsx(_components.code,{children:`_padswizz`}),` key exists`]}),`\n`,_jsxs(_components.li,{children:[`For iOS/Android, verify you’re using the correct activation type key (`,_jsx(_components.code,{children:`adswizz_keyvalue`}),`)`]}),`\n`]})]}),_jsxs(Accordion,{title:`Cohorts not being passed in ad requests`,id:`cohorts-not-being-passed-in-ad-requests`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Symptoms:`}),` Permutive cohorts are not included in AdsWizz ad request URLs, or targeting doesn’t work as expected.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Solutions:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Verify cohort IDs are being retrieved correctly from local storage (Web) or SDK APIs (iOS/Android)`}),`\n`,_jsxs(_components.li,{children:[`Ensure the key-value format is correct: `,_jsx(_components.code,{children:`aw_0_1st.permutive=[cohort_ids]`})]}),`\n`,_jsx(_components.li,{children:`Confirm the custom parameters are being appended to the AdsWizz ad request URL`}),`\n`,_jsx(_components.li,{children:`Check that the Permutive SDK loads before the AdsWizz ad request is made`}),`\n`,_jsx(_components.li,{children:`Verify the cohorts are activated with an AdsWizz activation (not just other activations)`}),`\n`]})]}),_jsxs(Accordion,{title:`AdsWizz not recognizing key-values (whitelisting issue)`,id:`adswizz-not-recognizing-key-values-whitelisting-issue`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Symptoms:`}),` Key-values are being passed in ad requests but AdsWizz is not recognizing them for targeting or reporting.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Solutions:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Contact your AdsWizz Technical Account Manager to whitelist the custom parameters`}),`\n`,_jsxs(_components.li,{children:[`Confirm that the `,_jsx(_components.code,{children:`aw_0_1st.permutive`}),` and `,_jsx(_components.code,{children:`aw_0_1st.permutiveid`}),` parameters have been whitelisted`]}),`\n`,_jsxs(_components.li,{children:[`Verify the key-value format matches AdsWizz requirements (prefix `,_jsx(_components.code,{children:`aw_0_1st`}),` for first-party data)`]}),`\n`,_jsx(_components.li,{children:`Allow time for whitelisting changes to take effect in AdsWizz systems`}),`\n`,_jsx(_components.li,{children:`Check AdsWizz campaign targeting interface to confirm parameters are available`}),`\n`]})]}),_jsxs(Accordion,{title:`Impression events not being collected`,id:`impression-events-not-being-collected`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Symptoms:`}),` AdsWizz impression events are not appearing in Permutive analytics or event stream.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Solutions:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Verify the tracking pixel has been added to Ad/Creative in AdsWizz Audioserve campaigns`}),`\n`,_jsx(_components.li,{children:`Ensure the custom event schema has been configured in Permutive (discuss with your Customer Success Manager)`}),`\n`,_jsxs(_components.li,{children:[`Confirm the Permutive user ID is being passed in ad requests (as `,_jsx(_components.code,{children:`aw_0_1st.permutiveid`}),`)`]}),`\n`,_jsx(_components.li,{children:`Check that the tracking pixel URL is correctly formatted with the Permutive API key`}),`\n`,_jsxs(_components.li,{children:[`Verify AdsWizz macros are correctly replacing with actual values (e.g., `,_jsx(_components.code,{children:`{campaignID}`}),`, `,_jsx(_components.code,{children:`{ZoneId}`}),`)`]}),`\n`,_jsx(_components.li,{children:`Test the tracking pixel URL manually to confirm it’s reachable`}),`\n`]})]}),_jsxs(Accordion,{title:`API Direct returning empty activations`,id:`api-direct-returning-empty-activations`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Symptoms:`}),` The CCS API response includes an empty `,_jsx(_components.code,{children:`adswizz_keyvalue`}),` array or doesn’t include the key at all.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Solutions:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Verify the AdsWizz integration is enabled in the Permutive dashboard`}),`\n`,_jsx(_components.li,{children:`Check that cohorts have been activated for AdsWizz`}),`\n`,_jsxs(_components.li,{children:[`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:[`Confirm the `,_jsx(_components.code,{children:`activations=true`}),` query parameter is included in the API request URL`]}),`\n`,_jsx(_components.li,{children:`Allow time for cohort membership to be computed after sending events`}),`\n`,_jsx(_components.li,{children:`Verify the API key used in the request has the correct permissions`}),`\n`]})]}),_jsxs(Accordion,{title:`Issues with Identity Based Activation`,id:`issues-with-identity-based-activation`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Symptoms:`}),` Audiences are not appearing in AdsWizz, or cohort memberships are not syncing as expected.`]}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Solutions:`})}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Verify that cohorts are activated with the “AdsWizz (ID-based)” toggle enabled in the Permutive Dashboard`}),`\n`,_jsx(_components.li,{children:`Remember that cohort data syncs daily — allow up to 24 hours for changes to appear in AdsWizz`}),`\n`,_jsxs(_components.li,{children:[`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`,_jsx(_components.li,{children:`Verify your selected identity tags are correct in Settings → Integrations`}),`\n`,_jsx(_components.li,{children:`Confirm Identity Based Activation has been enabled for your workspace (this is enabled by Permutive on request)`}),`\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:`september-2026`,children:`September 2026`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Contextual cohort activation is now supported via Key-Value Activation`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`june-2026`,children:`June 2026`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Documented Identity Based Activation for AdsWizz: server-to-server cohort upload keyed by IDFA, AAID, or IP Address, with cohorts appearing as Audiences in AdsWizz (available on request)`}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`october-2025`,children:`October 2025`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`AdsWizz key-value integration released for Web, iOS, and Android environments`}),`\n`,_jsx(_components.li,{children:`Added support for API Direct implementation for smart speaker environments`}),`\n`,_jsx(_components.li,{children:`Enabled AdsWizz impression event collection via tracking pixel`}),`\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":"AdsWizz","description":"Integrate with AdsWizz for audio advertising and cohort activation.","href":"/integrations/advertising/ad-servers/adswizz"}}},"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":"AdsWizz","slug":"adswizz","depth":3,"children":[]},{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Supported Cohort Types (Key-Value Activation)","slug":"supported-cohort-types-key-value-activation","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":"Cohort Activation on Web","slug":"cohort-activation-on-web","depth":2,"children":[],"tabId":"web"},{"title":"Advanced: Enable Impression Event Collection","slug":"advanced-enable-impression-event-collection","depth":2,"children":[],"tabId":"web"},{"title":"Cohort Activation on iOS","slug":"cohort-activation-on-ios","depth":2,"children":[],"tabId":"ios"},{"title":"Cohort Activation on Android","slug":"cohort-activation-on-android","depth":2,"children":[],"tabId":"android"},{"title":"Cohort Activation via API Direct","slug":"cohort-activation-via-api-direct","depth":2,"children":[{"title":"How it Works","slug":"how-it-works","depth":3,"children":[],"tabId":"api-direct"}],"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":"September 2026","slug":"september-2026","depth":3,"children":[]},{"title":"June 2026","slug":"june-2026","depth":3,"children":[]},{"title":"October 2025","slug":"october-2025","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/permutive/9a9f86ed1fb0eb1f/agent-chat-rail.js"],"subdomain":"permutive","siteName":"Permutive","title":"AdsWizz - Permutive","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T10:23:16.372Z","originalFileLocation":"integrations/advertising/ad-servers/adswizz.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 AdsWizz for audio advertising and cohort activation.\">\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=\"AdsWizz - Permutive\">\u003cmeta data-mint-head property=\"og:description\" content=\"Integrate with AdsWizz for audio advertising and cohort activation.\">\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/adswizz\">\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=AdsWizz\u0026amp;description=Integrate+with+AdsWizz+for+audio+advertising+and+cohort+activation.\u0026amp;theme=476d64e99ccc72d9df9ea1e6\u0026amp;signature=020c9a9157313da80c1f4ec9ffeac5e845908cc7d8467648c4f1c0bd4a2cdbc8\">\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=\"AdsWizz - Permutive\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Integrate with AdsWizz for audio advertising and cohort activation.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://permutive.mintlify.site/_mintlify/api/og/v2?division=Integrations\u0026amp;title=AdsWizz\u0026amp;description=Integrate+with+AdsWizz+for+audio+advertising+and+cohort+activation.\u0026amp;theme=476d64e99ccc72d9df9ea1e6\u0026amp;signature=020c9a9157313da80c1f4ec9ffeac5e845908cc7d8467648c4f1c0bd4a2cdbc8\">\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/adswizz\">\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/adswizz.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/adswizz#webpage\",\"url\":\"https://docs.permutive.com/integrations/advertising/ad-servers/adswizz\",\"name\":\"AdsWizz\",\"description\":\"Integrate with AdsWizz for audio advertising and cohort activation.\",\"dateModified\":\"2026-11-17T10:23:16.372Z\",\"isPartOf\":{\"@id\":\"https://docs.permutive.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.permutive.com/integrations/advertising/ad-servers/adswizz#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.permutive.com/integrations/advertising/ad-servers/adswizz#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\":\"AdsWizz\",\"item\":\"https://docs.permutive.com/integrations/advertising/ad-servers/adswizz\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.permutive.com/integrations/advertising/ad-servers/adswizz#article\",\"headline\":\"AdsWizz\",\"name\":\"AdsWizz\",\"description\":\"Integrate with AdsWizz for audio advertising and cohort activation.\",\"url\":\"https://docs.permutive.com/integrations/advertising/ad-servers/adswizz\",\"mainEntityOfPage\":{\"@id\":\"https://docs.permutive.com/integrations/advertising/ad-servers/adswizz#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/adswizz.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","href":"/integrations/advertising/ad-servers/google-ad-manager"},{"title":"FreeWheel","href":"/integrations/advertising/ad-servers/freewheel"},{"title":"Microsoft Monetize","href":"/integrations/advertising/ad-servers/xandr"},{"title":"Equativ","href":"/integrations/advertising/ad-servers/equativ"},{"title":"Nativo","description":"Integrate with Nativo for targeting and campaign optimization","href":"/integrations/advertising/ad-servers/nativo"},{"title":"AdsWizz","href":"/integrations/advertising/ad-servers/adswizz"},{"title":"SmartX","description":"Integrate with SmartX for real-time cohort activation on video advertising.","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":"AdsWizz - Permutive","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["a74be98ba7"],"chunks":["zoom-image-lightbox-DQG3o8Eu.js","lightbox-handle-r17bVUz3.js"]}