Data Dictionary
- Deal Settings
- Price Settings
- Deal Reporting Labels
- Define your Deal's Ad Format and Device Types
- Define your Deal's Geography
- Add Audiences Contextual Segments to your Deal
- Add Inventory Targeting
- Add Video Signal Targeting
- Add Device Signals Targeting
Deal Settings
The table includes a definition for each field in the Deal Settings section:
| Field Name | Description | Type | Is Mandatory | Value | Note |
|---|---|---|---|---|---|
| Deal Type | Specifies the type of the deal, auto-set to Open Deal in Verve marketplace. Only Open Deals are available. | Autogenerated Field | No | Example: Open Deal during Verve Marketplace | Auto-populated, non-editable. Pre-set by system. |
| Deal Name | Specifies the name of your deal. | Text Field | Yes | Example: Deal Test | Max length: 255 characters. Unique in Deal Portal. |
| Description | Specifies the description of your deal. | Text Box | Optional | — | Max 2500 chars. First 250 visible, scrollable text box. |
| Verve Marketplace Deal ID | Autogenerated ID for the Verve Marketplace deal. | Autogenerated Field | Yes | Example: 3ad4bf0c-31e5-4b9e-97f4-31f48d3a100d | 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. | Text Field | No | Example: 3ad4bf0c-31e5-4b9e-97f4-31f48d3a100d | — |
| Advertiser | Advertiser associated with the deal. | Dropdown (Single Select) | Optional | Example: Others, Audigent, New Advertiser | If “Other” is selected, you can input advertiser name manually. |
| Select DSP | Demand-Side Platform (DSP) selected for the deal. | Dropdown (Single Select) | Yes | Example: Audigent Child Google DV360, etc. | Alphabetical list. Once saved, DSP cannot be changed. |
| Select Seat | Seat associated with DSP in the deal. | Dropdown (Single Select) | Optional | Example: 1103026214 – Audigent | Limited to buyer-associated seats. Alphabetical by seat name. |
| Time Zone | Time zone for the deal’s scheduling. | Dropdown (Single Select) | Optional | Example: UTC | Default: UTC. Converted to UTC in SOMA. |
| Start Date | Date/time the deal should begin. | Date/Time Picker | Optional | Example: 2025-01-17 23:40:31 | 24h format. Cannot be past. Requires active status. Paused status overrides. |
| End Date | Date/time the deal should end. | Date/Time Picker | Optional | Example: 2025-01-17 23:40:31 | 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. | Boolean | Optional | Default: True | Auto-populated as True. |
| Request Capping | Max number of ad requests deal can evaluate. Prevents overserving or limits traffic. | Numeric Text Box + Spinner | Optional | Example: 500000 (up to 10 digits) | Leave blank = No Limit. Limited to 10 digits. |
Price Settings
The table includes a definition for each field in the 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 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 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 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 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 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 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 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. |
Updated 2 months ago
What’s Next