Knowledge Base

Prerequisites

• A Narrative dataset that represents the audience you want to deliver.
• Your Magnite data provider name (no seat ID required for profile creation).

Step 1 — Create a Magnite profile (API)

Profiles are reusable across datasets. Today, create them via API using just data_provider and name.

curl --location 'https://magnite.narrativeconnectors.com/profiles' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN>' \
--data '{
  "data_provider": "<YOUR_DATA_PROVIDER_NAME>",
  "name": "<FRIENDLY_PROFILE_NAME>",
  "description": "Optional description"
}'

• Required: data_provider, name
• Optional: description

Step 2 — Connect a dataset with quick‑settings

From the dataset details drawer, choose your Magnite profile and fill out quick‑settings. Submit creates a connection and schedules delivery aligned to your dataset’s refresh cadence.

Quick‑settings shape:

{
  "type": "audience_first_party_new",
  "historical_data_enabled": false,
  "name": "<AUDIENCE_NAME>",
  "description": "<OPTIONAL_DESCRIPTION>",
  "price": {
    "default": { "type": "price_cpm", "value": 1.12 }
  }
}

• Required: type, historical_data_enabled, name, price.default.value
• Optional: description
• Deliver‑all vs new rows: toggle historical_data_enabled to backfill existing rows on first run or only deliver new rows written after you connect.

API example:

curl --location 'https://app.narrative.io/openapi/connections' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <TOKEN>' \
--data '{
  "dataset_id": <DATASET_ID>,
  "profile_id": "<PROFILE_ID>",
  "quick_settings": {
    "type": "audience_first_party_new",
    "historical_data_enabled": true,
    "name": "Example Audience",
    "description": "Optional",
    "price": { "default": { "type": "price_cpm", "value": 0.0 } }
  }
}'

Step 3 — Delivery and refresh cadence

• Delivery is tied to your materialized view refresh schedule.
• On connect, if historical_data_enabled=true, existing rows are delivered; subsequent runs deliver new rows.

What the connector does

• Creates or updates a Magnite taxonomy element for your audience.
• Delivers membership files containing identifiers.
• Updates taxonomy on subsequent runs.

Related reading