Bulk Activating Cohorts

Overview

If you need to activate 30 or more cohorts at once, Permutive’s Technical Services team can process the activations in bulk using a CSV file you provide. This guide explains how to prepare the CSV and submit the request.

Prerequisites:

30 or more Custom or Lookalike cohorts that require activation.
The cohort ID (cohort code) for each cohort you want activated.
Destination-specific configuration values (e.g., network codes, advertiser IDs) ready for each activation.
Your workspace name and ID.

Limitations:

Bulk activation is only supported for Custom and Lookalike cohorts. Contextual and Classification cohorts cannot be bulk activated.
A minimum of 30 cohorts is required per bulk activation request.
Each workspace requires a separate CSV file.

Supported Destinations

The following destinations are supported for bulk activation. Use the corresponding activation_type and storage_key column value in your CSV.

Destination	`activation_type`	`storage_key`
Google Ad Manager	`gam`	Leave blank
DV360	`dv360`	Leave blank
Xandr / AppNexus	`appnexus`	Leave blank
Nativo	`nativo`	Leave blank
Facebook	`facebook`	Leave blank
Magnite / Rubicon	`rubicon`	Leave blank
PubMatic	`pubmatic`	Leave blank
Trade Desk 1P	`trade_desk`	Leave blank
Local Storage	`local_storage`	LocalStorage key you are activating to
Index Exchange (via Local Storage)	`local_storage`	`_pindexs`
Pinterest	`pinterest`	Leave blank

The Index Exchange integration uses the Local Storage integration. In your CSV, set activation_type to local_storage and storage_key to _pindexs. Ensure the Local Storage integration is enabled in your Dashboard before submitting the request.

Steps

Gather your cohort codes

Collect the cohort ID (cohort code) for every cohort you want activated. You can find cohort codes in the Custom Cohorts list in the Permutive Dashboard — the code is displayed alongside each cohort’s name.

Note your workspace name and workspace ID

You will need to provide these alongside your CSV when contacting Technical Services. Both are available in your Permutive Dashboard workspace settings.

Create the CSV file

Create a CSV file with the following header row, then add one row per cohort activation:

"cohort_code","activation_type","ttd_secret","ttd_advertiserid","dfp_name","dfp_network_code","storage_key","dv360_seat","pinterest_tag_id","pinterest_tag_name"

See the CSV Columns reference below for details on what to include in each field.

Submit the request to Technical Services

Send the CSV file to Technical Services along with your workspace name and workspace ID.

Bulk activations are typically completed within two weeks of submission.

CSV Columns

Column	Required	Description
`cohort_code`	Yes	The cohort ID of the cohort to activate.
`activation_type`	Yes	The destination identifier. See Supported Destinations for the correct value.
`ttd_secret`	No	Required for Trade Desk activations. Leave blank otherwise.
`ttd_advertiserid`	No	Required for Trade Desk activations. Leave blank otherwise.
`dfp_name`	No	Required for Google Ad Manager activations. Leave blank otherwise.
`dfp_network_code`	No	Required for Google Ad Manager activations. Leave blank otherwise.
`storage_key`	No	Required for Local Storage and Index Exchange activations. For Index Exchange, use `_pindexs`. Leave blank otherwise.
`dv360_seat`	No	Required for DV360 activations. Leave blank otherwise.
`pinterest_tag_id`	No	Required for Pinterest activations. The Pinterest pixel Tag ID associated with your Pinterest destination. Leave blank otherwise.
`pinterest_tag_name`	No	Required for Pinterest activations. The human-readable name of your Pinterest destination. Leave blank otherwise.

Leave optional columns present in the header but with an empty value for rows that do not use them. Do not remove columns from the CSV header.

Example

The following example shows a single cohort (ID 123456) activated to Pinterest, Facebook, and Index Exchange (via Local Storage):

"cohort_code","activation_type","ttd_secret","ttd_advertiserid","dfp_name","dfp_network_code","storage_key","dv360_seat","pinterest_tag_id","pinterest_tag_name"
123456,"pinterest",,,,,,,"1234567890","Example Publisher"
123456,"facebook",,,,,,,,
123456,"local_storage",,,,,"_pindexs",,,

Each row represents one activation. A single cohort can have multiple rows if it needs to be activated to more than one destination.

Next Steps

Creating Custom Cohorts

Build a new audience segment using the Cohort Builder

Creating Lookalike Cohorts

Create lookalike cohorts from a trained model

Back to Custom Cohorts

Return to product overview

​Overview

​Supported Destinations

​Steps

​CSV Columns

​Example

​Next Steps

Creating Custom Cohorts

Creating Lookalike Cohorts

Back to Custom Cohorts

Overview

Supported Destinations

Steps

CSV Columns

Example

Next Steps