In this article 

Permutive’s integration with Equativ enables customers to target 1st party and 3rd party cohorts across their smart ad server campaigns. This activation utilizes key-value pairs, allowing for maximum addressability / targetable impressions. In addition to cohort targeting, this integration also supports event collection (for further cohort creation based on campaign delivery data).

The integration enables targeting and event ingestion across web environments only.

Integration Set Up

Equativ Credentials

In order to utilize the Equativ integration, customers need to provide Equativ credentials that will enable Permutive to push cohort names into the ad server. 

1. Navigate to the integrations page (within settings) in the Permutive dashboard
2. Click the ‘+ add integration’ button and select Equativ from the list of integrations
3. Enter your Equativ Network ID, Username, and Password
   1. See How to find the Network ID

Enable Passing Cohorts in Ad Request

The following snippet needs to be applied on the page in order to add Permutive cohort IDs into the Equativ Ad Request:

<!-- start Smart setup -->
<script type="application/javascript" src="https://ced.sascdn.com/tag/8/smart.js" async></script>

<script type="application/javascript">
var sas = sas || {}
sas.cmd = sas.cmd || []
sas.cmd.push(function () {
sas.setup({ networkid: 8, domain: 'https://www.smartadserver.com', async: true, renderMode: 0 })
})
var permutive_cohorts_for_smart = JSON.parse(window.localStorage.getItem('_psmart')) || []
sas.cmd.push(function () {
sas.call('std', {
siteId: 492369,
pageId: 1539112,
formatId: 109757,
target: `permutive=${permutive_cohorts_for_smart.join(',')}`
})
})
</script>

Note: that various fields should be replaced (networkid, domain, siteId, pageId, formatId) depending on the settings of a publisher and particular campaign/formats. See the Tagging guide for instructions on how to extract this information.

The target will contain the key value to be sent to smart for keyword targeting, containing the Permutive keyword group and corresponding Permutive cohorts.

Then a specific format can be rendered on the page, e.g.:

<div id="sas_109757"></div>
<script type="application/javascript">
sas.cmd.push(function () {
sas.render('109757')
})
</script>

Impression Event Collection

In order to ingest impression events from Smart AdServer, customers need to ensure the Equativ credentials as stated in the steps above. Then, follow these instructions:

1. The following snippet should be set in the 'Creative Section' of the Equativ Ad Server:

<script>
;(function () {
var data = {
advertiserId: "[sas_advertiserId]" || "[sas_rtb_advertiserId]" || null,
campaignId: "[sas_campaignId]" || "[sas_rtb_campaignId]" || null,
creativeId: "[sas_creativeId]" || "[sas_rtb_creativeId]" || null,
insertionId: "[sas_insertionId]" || null,
dealId: "[sas_rtb_dealId]" || null,
cpm: "[sas_cpm]" || "[sas_rtb_clearedPricePublisherCurrency]" || null,
tagId: "[sas_tagId]" || null,
creativeHeight: "[sas_creativeHeight]" || null,
creativeWidth: "[sas_creativeWidth]" || null,
keywords: "[sas_keywordTargeting]" || null
}
window.parent.postMessage({
type: 'permutiveEventSmart',
data: data
}, "*")
})()
/<script>

2. The following script can be added alongside your Permutive deployment tag to enable the processing of impression events that occur before the Permutive SDK has initialized. 

;(function () {
var messageDataQueue = []
var sdkReady = false
var listener = function (event) {
if ( typeof event.data === 'object' && 'origin' in event.data && event.data.origin === 'permutive'){
if (event.data.type === 'sdk-init') {
sdkReady = true
window.removeEventListener('message', listener)
messageDataQueue.forEach(function (msgData) {
window.postMessage(msgData, '*')
}) return
if (!sdkReady) {
messageDataQueue.push(event.data)
}}}
window.addEventListener('message', listener, false)
})()

Once we have a couple of successful implementations of the above, Equativ will include this as a ‘partner script’ in their library so there is less effort required from the clients.

Equativ Cohort Targeting

Once the integration setup steps have been completed, you will be able to activate cohorts to be sent to Equativ. This can be done in one of two ways:

Toggle Activation in Specific Cohort

1. Go to the cohort that you wish to activate
2. Toggle Equativ on and save

   Create Cohort Activation

   Go to Cohort Activation → Add Activation and select Equativ from the list of activations

Once you have activated the cohorts that you wish to target in Smart Ad Server, the names of the cohorts will be visible within the Targeting > Keywords section of the campaign setup. All cohorts that you have activated will be visible once you have selected the Permutive keyword group.

Equativ’s keyword targeting uses OR logic to combine multiple cohorts by default. If you wish to set up more complex targeting combinations using Permutive cohorts, you need to enter cohort IDs manually. Please see Equativ’s targeting documentation for more details.