Skip to content

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 ​

toml
[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 = true

Endpoints ​

  • GET /integrations/permutive/sdk - SDK serving
  • GET/POST /integrations/permutive/api/* - API proxy
  • GET/POST /integrations/permutive/secure-signal/* - Secure Signals (GAM integration)
  • GET/POST /integrations/permutive/events/* - Event collection
  • GET/POST /integrations/permutive/sync/* - ID synchronization
  • GET /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 ​

Released under the Apache License 2.0.