Rolling main documentation

Built from commit f80b604a992ba1144e6c45229a8165c81e52dae0. 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 = 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

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