--- updatedAt: 2026-09-03T09:52:37.000Z --- # Data Dictionary - [Deal Settings](##deal-settings) - [Price Settings](#price-settings) - [Deal Reporting Labels](#deal-reporting-labels) - [Define your Deal's Ad Format and Device Types](#define-your-deals-ad-format-and-device-types) - [Define your Deal's Geography](#define-your-deals-geo) - [Add Audiences Contextual Segments to your Deal](#add-audiences-contextual-segments-to-your-deal) - [Add Inventory Targeting](#add-inventory-targeting) - [Add Video Signal Targeting](#add-video-signal-targeting) - [Add Device Signals Targeting](#add-device-signals-targeting) ## Deal Settings The table includes a definition for each field in the [Deal Settings](https://developers-brand.verve.com/creating-a-deal/#deal-settings) section: | Field Name | Description | Is Mandatory | Value | Type | Note | | ------------------------- | -------------------------------------------------------------------------------------------------------------- | ------------ | ----------------------------------------------- | -------------------------- | ---------------------------------------------------------------------------------------------- | | Deal Type | Specifies the type of the deal, auto-set to **Open Deal** in Verve marketplace. Only Open Deals are available. | No | Example: Open Deal during Verve Marketplace | Autogenerated Field | Auto-populated, non-editable. Pre-set by system. | | Deal Name | Specifies the name of your deal. | Yes | Example: Deal Test | Text Field | Max length: 255 characters. Unique in Deal Portal. | | Description | Specifies the description of your deal. | Optional | — | Text Box | Max 2500 chars. First 250 visible, scrollable text box. | | Verve Marketplace Deal ID | Autogenerated ID for the Verve Marketplace deal. | Yes | Example: `3ad4bf0c-31e5-4b9e-97f4-31f48d3a100d` | Autogenerated Field | Unique, not editable. Visible only if no external Deal ID. Grayed if external Deal ID present. | | External Deal ID | Enter a pre-existing deal ID to replace Marketplace ID and pass it to the DSP. | No | Example: `3ad4bf0c-31e5-4b9e-97f4-31f48d3a100d` | Text Field | — | | Advertiser | Advertiser associated with the deal. | Optional | Example: Others, Audigent, New Advertiser | Dropdown (Single Select) | If “Other” is selected, you can input advertiser name manually. | | Select DSP | Demand-Side Platform (DSP) selected for the deal. | Yes | Example: Audigent Child Google DV360, etc. | Dropdown (Single Select) | Alphabetical list. Once saved, DSP cannot be changed. | | Select Seat | Seat associated with DSP in the deal. | Optional | Example: `1103026214 – Audigent` | Dropdown (Single Select) | Limited to buyer-associated seats. Alphabetical by seat name. | | Time Zone | Time zone for the deal’s scheduling. | Optional | Example: UTC | Dropdown (Single Select) | Default: UTC. Converted to UTC in SOMA. | | Start Date | Date/time the deal should begin. | Optional | Example: 2025-01-17 23:40:31 | Date/Time Picker | 24h format. Cannot be past. Requires active status. Paused status overrides. | | End Date | Date/time the deal should end. | Optional | Example: 2025-01-17 23:40:31 | Date/Time Picker | 24h format. Cannot be past. Needs start date. Active status required for enforcement. | | ATC | Whether ATC (account-specific targeting control) is applied. Enabled by default. | Optional | Default: `True` | Boolean | Auto-populated as `True`. | | Request Capping | Max number of ad requests deal can evaluate. Prevents overserving or limits traffic. | Optional | Example: 500000 (up to 10 digits) | Numeric Text Box + Spinner | Leave blank = **No Limit**. Limited to 10 digits. | ## Price Settings The table includes a definition for each field in the [Price Settings](https://developers-brand.verve.com/creating-a-deal/#price-settings) section:
Field Name Description Type Is Mandatory Value
Pricing Model Determines pricing strategy:
- **Min Price**: Minimum expected CPM; demand can bid more.
- **Fixed Price**: Fixed CPM; demand must bid exact. 		Dropdown Enum (Min Price, Fixed) No —
eCPM Effective CPM based on selected pricing model. Text Field (Spin Box) No * Must be ≥ $0.01 and ≤ $99.99
- Shown beside pricing model
- If > $40, show confirm
Deal Fee Fee in % or USD. E.g. **10% fee** on $2 CPM → $2.20 downstream. $0.20 goes to buyer. Text Field (Spin Box) No —
Additional 3rd Party Fee Extra margin % for 3rd-party costs or partners. Number / % Field No Optional, editable. Used for external partner margin.
Verve Internal Margin Minimum internal margin enforced by platform. Cannot be set lower. Number / % Field No Floor margin requirement.
*** ## Deal Reporting Labels The table includes a definition for each field in the [Deal Reporting Labels](https://developers-brand.verve.com/creating-a-deal/#deal-reporting-labels) section: | Field Name | Description | Type | Is Mandatory | | ---------------- | -------------------------------------------------------------------------- | ------------------------ | ------------ | | Deals Belongs To | Entity (Advertiser, Seat, or DSP account) under which the deal is created. | Autogenerated / Dropdown | No | | Sales Person | Select a user with **Media Planner** role for the buyer. | Dropdown | No | | Trafficker | Select users with **Trafficker** or **Ad Ops** roles for the buyer. | Dropdown | No | *** ## Define your Deal’s Ad Formats and Device Types The table includes a definition for each field in the [Ad Formats & Device Types](https://developers-brand.verve.com/add-device-signals-targeting-workflow/) section:
Field Name Description Type Is Mandatory Value Note
Ad Format Select which ad formats are included or excluded in deal targeting. Dropdown + Multi-select No **Allow/Block**
Example: Allow: Video, Native
Block: Banner 		* Allow → only chosen formats targeted.
- Block → only chosen formats excluded. Supports up to 4.
Ad Size Defines creative sizes (px) to target or exclude. Dropdown + Multi-select No **Allow/Block**
Example: Allow: 300x250, 728x90
Block: 320x50 		* Allow → only chosen sizes included.
- Block → only chosen sizes excluded. Supports up to 40.
*** ## Define your Deal’s Geography The table includes a definition for each field in the [Geography](https://developers-brand.verve.com/define-your-deals-geography-workflow/) section: | Field Name | Description | Type | Value | Notes | | ------------------ | -------------------------------------------------- | ----------------- | -------------------------------------- | -------------------------------------------------------------------------- | | Country | Country-level targeting (Allow/Block). | Dropdown + Search | Example: Allow: India, Block: USA | Allow → only chosen included. Block → chosen excluded. Multiple supported. | | State | State/province targeting under a country. | Dropdown + Search | Example: Allow: California | Works only if parent country selected. | | City | City-level targeting under country/state. | Dropdown + Search | Example: Allow: Mumbai, Block: LA | Works only if parent country/state selected. | | Allow/Block | Defines whether selection is included or excluded. | — | Allow, Block | — | | Country Summary | Summary of allowed/blocked countries. | Autogenerated | Example: Allowed: India, Canada | Read-only, auto-populated. | | State Summary | Summary of allowed/blocked states. | Autogenerated | Example: Allowed: Karnataka, Block: NY | Read-only, auto-populated. | | City Summary | Summary of allowed/blocked cities. | Autogenerated | Example: Allowed: Bangalore | Read-only, auto-populated. | | Zip Code Targeting | Target or exclude zip/postal codes. | Dropdown | Allow, Block | Supports bulk upload. | | Bulk Upload | Download template for zip targeting. | Button | Action: Download CSV/Excel template | Ensures correct format. | | Upload | Upload a zip targeting file. | Button | Action: Upload CSV/Excel | Must follow template format. |
## Add Audiences Contextual Segments to your Deal The table includes a definition for each field in the [Add Audiences & Contextual Segments](https://developers-brand.verve.com/add-your-deals-audiences-and-contextual-segments/) to your Deal section: | Field Name | Description | Type | Value | Note | | ----------------------- | ----------------------------------------------------------------------------------- | ------------------------ | ----------------------------------------------------------------------- | --------------------------------------------------------------------------------- | | Data Provider | Lets you filter segments by data provider (e.g., Fusion, Oracle, etc.). | Dropdown (single/multi) | Possible values: Verve Audiences, Smaato Audiences, 3rd-Party Audiences | Filters the segment list and affects pricing/availability shown | | Logical Operator | Sets group logic for how segments combine: **AND Between Groups / OR Within Group** | Dropdown | AND BETWEEN/OR WITHIN, OR BETWEEN/AND WITHIN (must select one) | “Between Groups” = AND across groups; “Within Group” = OR across same group | | Group | Create a new group to include/exclude a segment. | Button | Example: `Group 1` | — | | Column+ | Choose which columns are visible in the segment table. | Dropdown with Checkbox | Example: `Segment, ID, Cost, Total Reach, Action` | — | | Search by Name | Finds segments by name across current provider/filter. | Search Box | Example: Behavioral Audiences | Partial matches supported. Clears to show full list | | Segment | Displays the name of audience segment available for targeting. | Text Column | Example: Verve Audiences > Behavioral Audiences > Mobile Carrier AT\&T | — | | ID | Unique identifier for each audience segment. | Numeric Column | Example: 5003 | — | | Cost | CPM (Cost Per Thousand Impressions) for each segment. | Numeric Column | Example: $1.00 | — | | Total Reach | Audience size available for a segment. | Numeric Column | Example: 54700 | — | | Action | Include or Exclude the segment from targeting. | Link | `Include`, `Exclude` | **Include** = target, **Exclude** = avoid. Toggle per row. | | Include | Adds segment(s) to deal targeting. | Action (link/button) | Action: Include | Ensures only selected segment(s) are targeted. Multiple segments can be included. | | Exclude | Prevents selected segment(s) from being targeted. | Action (link/button) | Action: Exclude | Ensures users in selected segment(s) are excluded. | | Targeting Summary | Overview of selected segments and logic. | Autogenerated panel | Shows: groups, logic, costs | Read-only; updates dynamically. | | Remove | Removes a specific segment or group from summary. | Button | — | — | | Add Audience | Applies the group selection to the deal. | Button | — | Enabled after at least one Include/Exclude is selected. | | Group Selection Chip | Quick view/removal of group selections. | Chip with remove (×) | Example: `Group 1 Selection ×` | Click × to clear that group’s selections. | | Total Groups | Count of groups configured. | Summary field | Example: `1` | Auto-calculated. | | Data Providers (count) | Count of distinct providers in selected segments. | Summary field | Example: 0 | Auto-calculated. | | Logic (Summary) | Effective logic applied. | Summary field | AND Between Group / OR Within Group | Mirrors the Logic dropdown. | | Total Audience Segments | Cost range of selected segments by group. | Summary field | Example: `Group 1: $0.00 – $0.00` | Range may show min–max based on provider pricing. | | Total Cost | Estimated incremental CPM for all included paid segments. | Summary field (currency) | Example: `Range: $0.00 – $0.00 per CPM` | *Estimate only.* Final CPM depends on provider fees and delivery. | *** ## Add Inventory Targeting The table includes a definition for each field in the [Add Inventory targeting](https://developers-brand.verve.com/add-inventory-targeting/) section: | Field Name | Description | Type | Value | Note | | ----------------------- | ------------------------------------------------------------------------------ | ----------------------- | ----------------------------------------------------------- | ------------------------------------------------------ | | Channel | Select eligible inventory channels (In-App, Web, CTV). | Dropdown + Multi-select | Allow/Block, Example: `Allow: In-App, Web` | Allow = only included; Block = excluded. Limit: 4. | | List of Bundles/Domains | Target/exclude specific app bundles or domains. | Dropdown + Upload | Example: `Allow: com.app.news`, `Block: example.com` | Allow/Block supported. Manual or bulk upload template. | | List of Publishers | Target/exclude publishers. | Dropdown + Upload | Example: `Allow: Publisher A`, `Block: Publisher B` | Allow/Block supported. Manual or bulk upload template. | | List of Ad Spaces | Target/exclude placements from publishers. | Dropdown + Upload | Example: `Allow: Placement 12345`, `Block: Placement 67890` | Allow/Block supported. Manual or bulk upload template. | | Integration Type | Type of integration (SDK, API, Header Bidding). | Dropdown + Multi-select | Example: `Allow: SOMA API` | Allow = include only, Block = exclude. Limit: 89. | | List of Multipliers | Target/exclude inventory segments by multipliers (internal categorization). | Dropdown + Multi-select | Example: `Allow: Premium`, `Block: Low Value` | Supports multiple. Limit: 159. | | List of OTT/Ad Breaks | Target/exclude OTT/CTV ad breaks. | Dropdown + Upload | Example: `Allow: Mid-roll`, `Block: Pre-roll` | Allow/Block supported. Upload template available. | | Supply Chain Nodes | Select based on supply chain object nodes (SChain). | Dropdown + Multi-select | Example: `Allow: 1 hop`, `Block: 3 hops` | — | | Device Type | Define targeted/excluded device types (Phone, Tablet, Desktop, CTV). | Dropdown + Multi-select | Example: `Allow: Phone, Tablet` | Allow = included, Block = excluded. Limit: 7. | | Upload | Upload CSV/Excel file for bundles, domains, publishers, ad spaces, OTT breaks. | Button | Action: File upload | Used with Bulk Upload Template. | | Bulk Upload Template | Download template for bulk uploads. | Button | Action: Download | Ensures correct formatting. | | Inventory Packages | Curated inventory groupings (Seasonal, Audiences, Display, OLV, CTV, etc.). | Expandable Lists | Example: `Seasonal`, `ConnectedTV` | Predefined packages curated by Verve. | | Package Subcategory | Specific event/theme under a package. | Expandable List Item | Example: Earth Day, Memorial Day, Mother’s Day | Shows more details when expanded. | | Allow (Action) | Applies the selected package/sub-package. | Action (link/button) | Action: Allow | Instantly includes all inventory under that package. | | Save | Saves chosen Allow configurations. | Button | — | Disabled until at least one targeting rule is set. | | Summary | Summary of all applied inventory targeting selections. | Autogenerated Field | Example: `Earth Day & Eco-Friendly Products (Seasonal)` | Read-only, updates dynamically. | *** ## Add Video Signal Targeting The table includes a definition for each field in the [Add Video signal targeting](https://developers-brand.verve.com/add-video-signal-targeting/) section: | Field Name | Description | Type | Value | Note | | ------------------- | -------------------------------------------------- | ----------------------- | -------------------------------------------------- | ----------------------------------------------------------------- | | CTV Content Channel | Target/exclude specific CTV channels. | Dropdown + Multi-select | Example: `Allow: ESPN, Hulu Live` (limit 1246) | Allow = include only; Block = exclude. | | CTV Genre | Define genres (Sports, News, Kids, Entertainment). | Dropdown + Multi-select | Example: `Allow: Sports, Entertainment` (limit 61) | Refines targeting by content category. | | CTV Content Rating | Select content ratings. | Dropdown + Multi-select | Example: Movie-R, TV-Y7, TV-MA | — | | Content Language | Target by content language. | Dropdown + Multi-select | Example: English, Spanish, French | — | | Content Livestream | Include/exclude livestream content. | Dropdown | Example: `True (Livestream)` | — | | Content Network | Target by content network. | Dropdown + Multi-select | Example: ABC, HBO, ESPN | — | | Skippable | Target skippable/non-skippable ad environments. | Dropdown | Example: `Allow: Skippable`, `Block: Skippable` | Helps control ad format. Allow = only skippable, Block = exclude. | *** ## Add Device Signals Targeting The table includes a definition for each field in the [Add Device signals targeting](https://developers-brand.verve.com/add-device-signals-targeting/) section: | Field Name | Description | Type | Value | Note | | ---------- | ----------------------------------------------------------- | --------------------- | ------------------------------------------- | -------------------------------------------------------------------- | | Device OS | Define OS signals for App, Web, CTV. | Expandable Categories | Categories: `App`, `Web`, `CTV` | Each expands for more granular targeting. | | App | Target/exclude OS signals in **mobile apps**. | Expandable + Action | Example: `Allow: Android App`, iOS | Supports Allow config. Expands to list OS/app options. | | Web | Target/exclude OS signals in **web environments**. | Expandable + Action | Example: `Allow: Chrome on Android` | Supports Allow config. Expands to list browser/OS combos. | | CTV | Target/exclude OS signals in **connected TV environments**. | Expandable + Action | Example: `Allow: Roku OS`, Tizen | Supports Allow config. Expands to list OTT device operating systems. | | Save | Saves selected Allow configurations. | Button | Action: Save | Disabled until at least one option set. | | Summary | Displays summary of applied selections. | Autogenerated Field | Example: `App: iOS, Web: Chrome, CTV: Roku` | Read-only, updates dynamically. |