Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.permutive.com/llms.txt

Use this file to discover all available pages before exploring further.

Nativo

​
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.
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

EnvironmentSupportedNotes
Web—
iOS—
Android—
CTV—
API Direct—

​
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

1

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.
2

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.
3

Verify Setup

After enabling the integration and activating cohorts, you can verify the setup by:
  1. Open your browser’s Developer Tools
  2. Navigate to the Application tab (Chrome) or Storage tab (Firefox)
  3. Check Local Storage for your domain
  4. 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).

​
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

If you don’t see the _pnativo key in your browser’s local storage:
  1. Verify that the Nativo integration is enabled in the Permutive dashboard
  2. Check that you have activated at least one cohort for Nativo
  3. Ensure the Permutive SDK is properly deployed and firing page view events
  4. Verify that the user qualifies for at least one activated cohort
  5. 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.
If Nativo campaigns are not receiving cohort targeting data:
  1. Verify that the Nativo-specific script has been deployed on the page
  2. Check that the script is placed before Nativo’s ad request initialization
  3. Open browser Developer Tools and check the console for any JavaScript errors
  4. Verify that window.ntvConfig.keyValues.permutive is populated by inspecting the console: 
    console.log(window.ntvConfig.keyValues.permutive);
  5. 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.
If you see cohorts with 0 live size in Permutive insights despite having qualifying users:
  1. Check that users are actively browsing your site and triggering page view events
  2. Verify that cohort logic is correctly configured and users meet the qualification criteria
  3. Allow up to 24 hours for cohort membership data to populate in insights
  4. 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.
If cohort data in _pnativo is being cleared between browsing sessions:
  1. Check browser settings to ensure local storage is not being cleared on exit
  2. Verify that third-party cookie blocking or privacy settings are not affecting local storage
  3. Check for browser extensions that might be clearing local storage
  4. 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.