Nativo

DirectionDestination

Environment

Web

Capability

Cohort Activation

SDK RequiredYes

Product(s) RequiredCore Platform

Nativo helps publishers deliver and manage native advertising formats that blend seamlessly with editorial content.

Setup

Troubleshooting

Overview

Nativo is a native advertising platform that helps publishers deliver and manage native ad formats. The Permutive integration with Nativo enables you to activate your Permutive cohorts for targeting in Nativo ad campaigns. This integration is a Destination:

Destination: Permutive activates cohorts into Nativo for audience targeting via key-value pairs.

Use cases include:

Target Nativo ad campaigns with Permutive audience segments
Deliver personalized native advertising based on user behavior and interests
Optimize native ad performance with audience insights

Environment Compatibility

Environment	Supported	Notes
Web	Yes	—
iOS	No	—
Android	No	—
CTV	No	—
API Direct	No	—

Prerequisites

Nativo Account - You must have an active Nativo account with access to manage ad campaigns and targeting settings.
Permutive SDK - The Permutive JavaScript SDK must be deployed on your web properties where Nativo ads will be served.
Active Cohorts - You should have cohorts created in Permutive that you want to activate for targeting in Nativo campaigns.

Setup

Primary Setup Steps
Web
iOS
Android

Enable in Permutive Dashboard

In the Permutive dashboard, navigate to your workspace’s integrations page. Click Add Integration and select Nativo from the list of available ad server integrations.Once enabled, you’ll be able to activate cohorts to Nativo from the cohort configuration page.

Activate Cohorts

Navigate to the cohort you want to activate for Nativo targeting. In the cohort’s activation settings, toggle the Nativo activation to On.When a cohort is activated, Permutive will automatically sync the cohort membership data to the browser’s local storage, making it available for Nativo ad requests.

Verify Setup

After enabling the integration and activating cohorts, you can verify the setup by:

Open your browser’s Developer Tools
Navigate to the Application tab (Chrome) or Storage tab (Firefox)
Check Local Storage for your domain
Look for the _pnativo key - it should contain an array of cohort IDs for activated cohorts

Once verified, proceed to deploy the Nativo-specific script on your web properties (see Web tab).

Deploy Nativo-specific JavaScript

You’ll need to deploy a small piece of JavaScript on your web properties to enable Permutive to append targeting key-values to Nativo ad requests. This script reads cohort membership data from local storage and makes it available to Nativo’s ad server.Deploy this script on pages where Nativo ads will be served. We recommend placing it before Nativo’s ad request initialization:

<script>
window.ntvConfig = window.ntvConfig || {} ;
window.ntvConfig.keyValues = window.ntvConfig.keyValues || {};
var segs = localStorage.getItem('_pnativo');
if (segs) {
  window.ntvConfig.keyValues.permutive = JSON.parse(segs).join(",");
}
</script>

What this script does:

Initializes the window.ntvConfig object if it doesn’t exist
Reads cohort membership data from the _pnativo local storage key
Appends cohort IDs as a comma-separated string to window.ntvConfig.keyValues.permutive
Makes this data available for Nativo to use in ad targeting

This script should be deployed on all pages where Nativo ads are served, alongside your standard Permutive tag.

Data Types

The Nativo integration is a cohort activation integration and does not collect event data into Permutive. Instead, it passes cohort membership data from Permutive to Nativo for ad targeting purposes. Cohort Data Format: Cohort IDs are stored in the browser’s local storage under the _pnativo key as a JSON array. These are then passed to Nativo’s window.ntvConfig.keyValues.permutive as a comma-separated string. Example format:

// Local storage: _pnativo
["cohort-id-1", "cohort-id-2", "cohort-id-3"]

// Passed to Nativo as:
window.ntvConfig.keyValues.permutive = "cohort-id-1,cohort-id-2,cohort-id-3"

Troubleshooting

Cohort data not appearing in local storage

If you don’t see the _pnativo key in your browser’s local storage:

Verify that the Nativo integration is enabled in the Permutive dashboard
Check that you have activated at least one cohort for Nativo
Ensure the Permutive SDK is properly deployed and firing page view events
Verify that the user qualifies for at least one activated cohort
Check browser console for any JavaScript errors that might be blocking Permutive

You can verify cohort membership by checking other Permutive local storage keys or using the Permutive Chrome Extension.

Nativo not receiving Permutive cohort data

If Nativo campaigns are not receiving cohort targeting data:

Verify that the Nativo-specific script has been deployed on the page
Check that the script is placed before Nativo’s ad request initialization
Open browser Developer Tools and check the console for any JavaScript errors
Verify that window.ntvConfig.keyValues.permutive is populated by inspecting the console:
```
console.log(window.ntvConfig.keyValues.permutive);
```
Ensure that the _pnativo local storage key contains valid cohort data

If the key-value is populated correctly but Nativo still isn’t receiving it, contact Nativo support to verify their side of the integration.

Cohort data shows 0 live size in insights

If you see cohorts with 0 live size in Permutive insights despite having qualifying users:

Check that users are actively browsing your site and triggering page view events
Verify that cohort logic is correctly configured and users meet the qualification criteria
Allow up to 24 hours for cohort membership data to populate in insights
Check the cohort’s definition to ensure there are no overly restrictive filters

If the issue persists after 24 hours, contact Permutive Support for investigation.

Local storage data not persisting across sessions

If cohort data in _pnativo is being cleared between browsing sessions:

Check browser settings to ensure local storage is not being cleared on exit
Verify that third-party cookie blocking or privacy settings are not affecting local storage
Check for browser extensions that might be clearing local storage
On Safari, ensure Intelligent Tracking Prevention (ITP) settings are not interfering

Permutive automatically refreshes local storage data on each page view, so even if data is cleared, it should be repopulated on the next visit.

Changelog

For detailed changelog information, visit our Changelog.

Integrations

Identity

Contextual

Advertising

Marketing

Data Collaboration

Video

Social Media

Survey

Nativo

Nativo

Setup

Troubleshooting

Overview

Environment Compatibility

Prerequisites

Setup

Deploy Nativo-specific JavaScript

Data Types

Troubleshooting

Changelog

Integrations

Identity

Contextual

Advertising

Marketing

Data Collaboration

Video

Social Media

Survey

​Nativo

Setup

Troubleshooting

​Overview

​Environment Compatibility

​Prerequisites

​Setup

​Deploy Nativo-specific JavaScript

​Data Types

​Troubleshooting

​Changelog

Nativo

Overview

Environment Compatibility

Prerequisites

Setup

Deploy Nativo-specific JavaScript

Data Types

Troubleshooting

Changelog