Skip to main content

OS Data Solutions

​
OS Data Solutions

DirectionSource
Environment
WebiOSAndroid
Capability
Contextual Signal
SDK RequiredYes
Product(s) Required
Core PlatformContextual

OS Data Solutions provides German publishers with advanced content classification based on an independent OVK standard.

Setup

Troubleshooting

​
Overview

OS Data Solutions provides German publishers with advanced content classification based on an independent OVK standard. Their Contextual Classifier analyzes website content to assign IAB-standard categories and keyword-based segments. The integration enriches your Pageview events with contextual classifications using the IAB 2.2 taxonomy (excluding Sensitive Topics), enabling you to build contextual cohorts without relying on user identifiers. OS Data Solutions classifies content into Categories aligned with IAB standards, enabling precise contextual targeting without user data. This integration is a Source:
  • Source: Permutive enriches Pageview events with contextual classifications from OS Data Solutions.
Use cases include:
  • Build contextual cohorts using IAB 2.2 category classifications for cookie-less targeting
  • Apply brand safety rules by including or excluding specific categories
  • Power privacy-safe targeting strategies across your inventory
  • Leverage OVK standard-based contextual intelligence for content understanding

​
Environment Compatibility

EnvironmentSupportedNotes
WebYes—
iOSYes—
AndroidYes—
CTVNo—
API DirectNo—

​
Prerequisites

  • Permutive SDK: Deployed on your web and mobile properties where you want content classified.
  • Permutive enablement: OS Data Solutions must be enabled for your workspace by Permutive.
  • Accessible content: Content should be accessible to classifiers. For paywalled or bot-protected pages, configure an allow mechanism (see Setup).
  • Monthly classification quota: Ensure your monthly classification quota covers expected volume.

​
Setup

1

Enable OS Data Solutions

There are two ways to enable OS Data Solutions:
  • Permutive-managed: If OS Data Solutions is included in your Permutive contract, contact your Customer Success Manager (CSM) to enable it for your workspace.
  • Your own credentials: If you have a direct relationship with OS Data Solutions, work with your CSM to configure the integration using your own credentials.
2

Configure classification settings

In the Permutive dashboard, navigate to Contextual > Catalog and locate OS Data Solutions. Configure your settings including:
  • Requested Types: Specify which classification types to request (Categories for OS Data Solutions)
  • Domains: Restrict classifications to specific domains to optimize quota usage. The domains shown are based on what you have defined under Settings > Domains & App names
  • Quota: Maximum monthly classification quota. You can only change this value when using your own credentials; otherwise it is managed by Permutive. Once the quota is reached, no more content will be classified until the next month
  • Selective Classifications Threshold: Set a minimum traffic threshold to classify only high-traffic URLs, optimizing quota usage. The default threshold is 20 pageviews within 24 hours before initial classification is triggered
If you are using your own credentials, you will also configure:
  • Email: The email address for authenticating with OS Data Solutions
  • Password: The password for authenticating with OS Data Solutions
3

(Optional) Configure access for paywalled content

If your site uses a paywall or bot mitigation that blocks classifier requests, configure an allow mechanism. Navigate to Contextual > Catalog > Settings and configure a URL parameter (e.g., bot-access=true) that will be appended to classification requests. Configure your paywall to allow bypass when this parameter is present.
4

Verify enrichment

After enablement, browse several article pages and check in your Permutive dashboard that Pageview events contain OS Data Solutions classifications. Remember that pages must meet the configured threshold before they are classified. You can preview classifications by hovering over the OS Data Solutions tile in the Catalog and clicking “Preview”.

​
Data Types

With OS Data Solutions enabled, Permutive enriches your Pageview events with contextual classifications. Permutive automatically updates your event schema to include these properties.
OS Data Solutions enriches Pageview events with category classifications.
​
contextual.classifications.categories
list[object]
List of category classifications detected for the page. Each object contains:
  • provider (string, required): “osds”
  • value (string, required): The classification category ID. The dashboard uses the taxonomy to display human-readable names
  • taxonomy (string, required): “iab_2.2” (excluding Sensitive Topics)
  • confidence (float, required): Confidence score for the classification

​
Troubleshooting

Confirm the URL has met the minimum traffic threshold for classification. The default threshold is 20 pageviews within 24 hours. Low-traffic or newly published pages may classify later. Contact Permutive Support to check if a specific URL has been classified or to verify your threshold configuration.
If your monthly quota is reached, new URLs will not be classified until the next month. Contact your Customer Success Manager to review quotas.
Classifier requests must be able to fetch the full article content. Configure your paywall to allow bypass using a URL parameter (e.g., bot-access=true). Set this in the Permutive dashboard under Contextual > Catalog > Settings, then configure your paywall system to allow access when this parameter is present in the URL.
If the Preview feature in the Contextual Catalog is not returning classifications, verify that the URL is publicly accessible and not blocked by bot protection. The Preview feature uses the same classification process as production, so access issues will prevent preview from working.
If you are using your own OS Data Solutions credentials and experiencing authentication failures, verify that your email and password are correctly configured. Contact your Customer Success Manager and OS Data Solutions support to validate your credentials.

​
Changelog

For detailed changelog information, visit our Changelog.