Index Exchange

​

Integrate with Prebid.js

Configuration

pbjs.setConfig({
  realTimeData: {
    dataProviders: [
      {
        name: "permutive",
        waitForIt: true,
        params: {
          maxSegs: 500,
        },
      },
    ],
  },
});

How it Works

• Custom Cohorts: Stored in the _pindexs local storage key
• Standard, Curated, and DCR Cohorts: Stored in the _pssps local storage key

1. The Permutive RTD module reads cohort IDs from local storage (_pindexs for Custom Cohorts, _pssps for Standard/Curated/DCR cohorts)
2. Cohort data is attached to the ORTB2 object in bid requests for Index Exchange
3. For Custom Cohorts, the module updates two locations:
   • ortb2.user.data – adds a data provider entry for permutive.com with the list of cohort IDs in the segment field
   • ortb2.user.keywords – adds a keyword group called permutive containing the list of cohort IDs
4. Index Exchange receives cohort targeting data in the bid request and makes it available to demand partners (DSPs) for real-time targeting

Consent

pbjs.setConfig({
  realTimeData: {
    dataProviders: [{
      name: 'permutive',
      params: {
        enforceVendorConsent: true  // Require TCF vendor consent for Permutive (ID: 361)
      }
    }]
  }
})

1. Initialise the Permutive Mobile SDK in your iOS app.
2. Retrieve the user’s active cohort IDs from the SDK.
3. Attach the cohort IDs to your Prebid Mobile bid request configuration as first-party user data, matching the structure used by the Permutive RTD module on web — see the Web tab for the full ORTB2 mapping (ortb2.user.data and ortb2.user.keywords).
4. Verify that bid requests reaching Index Exchange (via your Prebid Server) carry Permutive cohort data.

1. Initialise the Permutive Mobile SDK in your Android app.
2. Retrieve the user’s active cohort IDs from the SDK (e.g. via TriggersProvider).
3. Attach the cohort IDs to your Prebid Mobile bid request configuration as first-party user data, matching the structure used by the Permutive RTD module on web — see the Web tab for the full ORTB2 mapping (ortb2.user.data and ortb2.user.keywords).
4. Verify that bid requests reaching Index Exchange (via your Prebid Server) carry Permutive cohort data.

• Permutive collects IDFA values from iOS users via the Permutive SDK
• Cohort memberships are synced to Index Exchange server-to-server on a schedule
• Cohorts are registered as segments in your Index Exchange account, ready for targeting
• Data syncing happens automatically once configured in the Permutive Dashboard

• Permutive SDK must be deployed on your iOS app
• IDFA collection must be enabled and properly configured
• Users must grant tracking permission for IDFA to be available

• Permutive collects AAID values from Android users via the Permutive SDK
• Cohort memberships are synced to Index Exchange server-to-server on a schedule
• Cohorts are registered as segments in your Index Exchange account, ready for targeting
• Data syncing happens automatically once configured in the Permutive Dashboard

• Permutive SDK must be deployed on your Android app
• AAID collection must be enabled and properly configured

• Permutive collects IP addresses from your CTV environment
• Cohort memberships are synced to Index Exchange server-to-server on a schedule
• Cohorts are registered as segments in your Index Exchange account, ready for targeting
• Data syncing happens automatically once configured in the Permutive Dashboard

• Permutive must be collecting IP addresses from your CTV environment
• Work with your Permutive Customer Success Manager to ensure proper identity collection for CTV

• Permutive resolves the ID5 ID for your web users
• Cohort memberships are synced to Index Exchange server-to-server on a schedule
• Cohorts are registered as segments in your Index Exchange account, ready for targeting
• Data syncing happens automatically once configured in the Permutive Dashboard

• ID5 must be configured so Permutive can collect the ID5 ID for your web users
• Work with your Permutive Customer Success Manager to ensure proper identity collection