Rolling main documentation
Built from commit 1810c763add220dd34fd5faaffe2c69aab1d556f. Content may describe unreleased behavior.
Permutive Integration
Category: Data Status: Production Type: Audience Data Platform
Overview
The Permutive integration enables first-party audience segmentation and data collection by proxying Permutive's SDK and API endpoints through your domain.
What is Permutive?
Permutive is a real-time data platform that helps publishers build and activate audience segments for advertising without relying on third-party cookies.
Configuration
[integrations.permutive]
enabled = true
organization_id = "your-org-id"
workspace_id = "your-workspace-id"
project_id = "your-project-id"
api_endpoint = "https://api.permutive.com"
secure_signals_endpoint = "https://secure-signals.permutive.app"
cache_ttl_seconds = 3600
rewrite_sdk = trueEndpoints
GET /integrations/permutive/sdk- SDK servingGET/POST /integrations/permutive/api/*- API proxyGET/POST /integrations/permutive/secure-signal/*- Secure Signals (GAM integration)GET/POST /integrations/permutive/events/*- Event collectionGET/POST /integrations/permutive/sync/*- ID synchronizationGET /integrations/permutive/cdn/*- CDN proxy
SDK URL rewriting
Server-side attribute rewriting and the browser script guard recognize URLs on cdn.permutive.com or a subdomain of edge.permutive.app whose pathname ends in -web.js, case-insensitively. Absolute HTTP(S) and protocol-relative URLs are supported. The bare edge.permutive.app host, unrelated scripts, lookalike hosts, and vendor names embedded in another URL's path or query are not claimed.
Query strings and fragments do not prevent SDK recognition. Matching URLs use /integrations/permutive/sdk, which serves the SDK selected by organization_id and workspace_id; the original query and fragment are not forwarded to upstream.
Features
- Real-time segmentation: Build audience cohorts in real-time
- First-party data: All data collection through your domain
- Secure Signals: Integrate with Google Ad Manager
- SDK caching: Performance optimization (1 hour TTL)
- Consent-based activation: Segment activation subject to available consent signals
Use Cases
Publisher Audience Monetization
Collect first-party data, build segments, activate in programmatic auctions to increase CPMs.
Contextual Targeting
Combine page context with user behavior for audience segment targeting.
Cross-Site Insights
Aggregate audience data across your property portfolio.
Implementation
See crates/trusted-server-core/src/integrations/permutive.rs for implementation details.
Next Steps
- Review Integrations Overview for comparison
- Check Configuration Reference for options
- Learn about First-Party Proxy architecture