Nativo

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.

This integration supports two activation methods:

Key-value activation: Cohort IDs are read from the Permutive SDK and passed as key-value pairs in Nativo ad requests via Nativo’s tag (Web) or mobile SDK (iOS/Android).
Server-side identity-based activation: Can be an alternative path where client-side activation isn’t viable. Permutive uploads cohort memberships to Nativo keyed by identity values (cookie ID, IDFA, AAID, IP address, or hashed email). Cohorts appear as Nativo targeting segments ready for use.

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
Activate audiences across Web and in-app (iOS/Android) inventory through key-value or server-side identity-based methods

Environment Compatibility

Environment	Activation
Web	Live — cohort IDs read from `_pnativo` local storage and attached to `window.ntvConfig.keyValues`
iOS	Available — customer implementation via Nativo’s iOS SDK
Android	Available — customer implementation via Nativo’s Android SDK
API Direct	Available — cohort IDs retrieved via Permutive CCS API and passed to Nativo ad calls

Server-side identity-based activation can be an alternative path for this integration, particularly where client-side activation isn’t viable. Permutive can support your team in setting this up — contact your Customer Success Manager to discuss.

Prerequisites

Required for all activation methods:

Nativo Account — an active Nativo account with access to manage ad campaigns and targeting settings.
Active Cohorts — cohorts created in Permutive that you want to activate for targeting in Nativo campaigns.

For Web:

Permutive Web SDK — deployed on your web properties where Nativo ads will be served.
Nativo tag — deployed on your pages with the cohort-passing script (see Web setup tab).

For iOS / Android:

Permutive Mobile SDK — deployed in your iOS / Android app.
Nativo mobile SDK — deployed in your app.
Customer implementation — to retrieve Permutive cohorts from the SDK and attach them as targeting key-values in Nativo ad calls.

For server-side identity-based activation:

This connector is not built today. If your use case calls for it, identity collection would need to be configured in Permutive for the identity types you want to use (cookie ID, IDFA, AAID, IP address, hashed email).
Contact your Permutive Customer Success Manager to discuss.

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.

Nativo supports in-app inventory via its iOS mobile SDK. Activation of Permutive cohorts on iOS in-app traffic requires customer implementation to retrieve cohort signals from the Permutive Mobile SDK and attach them as key-value targeting in Nativo ad calls.High-level pattern:

Initialise the Permutive Mobile SDK in your iOS app.
Retrieve the user’s active cohort IDs from the SDK.
Attach the cohort IDs as a key-value (under the key permutive) in your Nativo iOS SDK ad request — mirroring the window.ntvConfig.keyValues.permutive pattern used on Web.
Verify that Nativo receives Permutive cohort data in the ad request.

Contact your Permutive Customer Success Manager — our team will partner with you on the integration.

Nativo supports in-app inventory via its Android mobile SDK. Activation of Permutive cohorts on Android in-app traffic requires customer implementation to retrieve cohort signals from the Permutive Mobile SDK and attach them as key-value targeting in Nativo ad calls.High-level pattern:

Initialise the Permutive Mobile SDK in your Android app.
Retrieve the user’s active cohort IDs from the SDK (e.g. via TriggersProvider).
Attach the cohort IDs as a key-value (under the key permutive) in your Nativo Android SDK ad request — mirroring the window.ntvConfig.keyValues.permutive pattern used on Web.
Verify that Nativo receives Permutive cohort data in the ad request.

Contact your Permutive Customer Success Manager — our team will partner with you on the integration.

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.

​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