Data Dictionary

Table of Contents

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, which is automatically set to Open Deal in the Verve marketplace. Only Open Deals are available during this phase. Autogenerated Field No Example: Open Deal during Verve Marketplace Auto-populated, Non-editable. The field is pre-set by the system and does not require your input. It is automatically filled based on the deal configuration.
Deal Name Specifies the name of your deal. Text Field Yes Example: Deal Test Max length: 255 characters. This is a unique field for the Deal Portal
Description Specifies the description of your deal. Text Box Optional   Max length: 2500 characters. Only the first 250 characters are visible. Text box is scrollable.
Verve Marketplace Deal ID The autogenerated ID for the Verve Marketplace deal. Autogenerated Field Yes 3ad4bf0c-31e5-4b9e-97f4-31f48d3a100d Unique, Not editable in Deal Portal. This ID is visible if there is no external Deal ID. Grayed out (or similar) if external Deal ID is present.
External Deal ID Enter a pre-existing deal ID to replace the Marketplace deal ID and pass it to the DSP. Text Field No 3ad4bf0c-31e5-4b9e-97f4-31f48d3a100d  
Advertiser The advertiser associated with the deal. Dropdown (Single Selection) Optional Example: Others, Audigent, New Advertiser If Other is selected in the dropdown, you can input the advertiser name in Add Advertiser Name.
Select DSP The Demand-Side Platform (DSP) selected for the deal. Dropdown (Single Selection) Yes Example: Audigent Child Google DV360 OpenRTB 1825, Audigent Child Google-DV360-OpenRTB-VGI CTV, etc. List is in alphabetical order. Once selected and saved, DSP cannot be changed. Only available DSPs connected to the buyer account can be selected.
Select Seat The seat associated with the DSP in the deal. Dropdown (Single Selection) Optional Example: 1103026214 (Display & Video 360) – Audigent, 1153405600 (Display & Video 360) – Audigent, 360i – Audigent List is limited to seats associated with the DSP and buyer. List is in alphabetical order by seat name.
Time zone The time zone to be used for the deal’s scheduling. Dropdown (Single Selection) Optional Example: UTC List of global time zones, ordered alphabetically. Default: UTC. Deal Portal translates the selected time zone to UTC for SOMA.
Start date The date and time the deal should begin. Date/Time Picker Optional Example: 2025-01-17 23:40:31 24-hour clock format. If not set, defaults to the deal’s activation time. Must not be set in the past. Codependent with deal status set to active. If deal status is paused on the start date, it overrides the start date and the deal will not run.
End date The date and time the deal should end Date/Time Picker Optional Example: 2025-01-17 23:40:31 24-hour clock format. This cannot be in the past. Defaults to the date the deal is paused if not set. End date cannot be set without a start date. The deal status must be active for the end date to be considered
ATC Controls whether ATC (account-specific targeting control) is applied to the deal. This feature is automatically enabled by default. Boolean Optional Default: True Auto-populated as True
Request Capping Sets the maximum number of ad requests that this deal can evaluate. Used to prevent overserving or limit traffic. Numeric text box with spinner Optional 500000 (up to 10 digits). Leave blank for No Limit. Number, 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 the pricing strategy for the deal:

  • Min Price: Minimum expected CPM; demand partners can bid more.
  • Fixed Price: Fixed CPM; demand partners will have to bid exact amounts.
 Dropdown Enum (Min Price, Fixed)

No

  
eCPM

Represents the eCPM (Effective Cost per Thousand Impressions) based on the selected pricing model.

 Text Field (Spin Box)

No
  • Must be ≥ $0.01 and ≤ $99.99.
  • Displayed adjacent to the pricing model field.
  • If value exceeds $40.00, a confirmation message should be shown to the user.

 
Deal Fee

Define the fee in % or USD.
E.g. if you put 10% Fee for $2.00 CPM the bid price Verve sends downstream will be $2.20. $0.20 will be reported and paid to the buyer.

 Text Field (Spin Box)

No

  

Defines the additional margin percentage applied for third-party costs or partners in the deal setup.

 Input Field (Number / %)

No

 Used when an extra margin needs to be applied for external partners. Optional and editable
Verve Internal Margin (Minimum Setting)

 

Minimum internal margin that must be applied to the deal to meet business requirements.

 Input Field (Number / %)

No

 Enforced as a floor margin by the platform. Cannot be set lower than this value.

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 Specifies the entity (Advertiser, Seat, or DSP account) under which the deal is created or assigned Autogenerated Field / Dropdown No
Sales Person Select a user assigned to the Media Planner role for the given buyer. Dropdown No
Trafficker Allows the selection of users assigned to either Trafficker or Ad Ops roles for the specified buyer. Dropdown No

Define your Deal’s Ad Formats and Device Types

The table includes a definition for each field in the Define your Deal’s Ad Formats and Device Types section:

Field Name Description Type Is Mandatory Value Note
Ad Format Specifies which ad formats  are included or excluded in the deal targeting. Dropdown + Multi-select No Control: Allow / Block
Example: Allow: Video, Native
Block: Banner
  • If Allow is selected:
    Only chosen ad formats are targeted; others are blocked by default.
  • If Block is selected:
    Only chosen formats are excluded; others are allowed by default. Supports multiple selections (up to 4).
Ad Size Defines the creative sizes (width × height in pixels) to be targeted or excluded for the deal. Dropdown + Multi-select No Control: Allow / Block
Example: Allow: 300x250, 728x90
Block: 320x50
  • If Allow is selected:
    only chosen sizes are allowed; others are blocked by default.
  • If Block is selected
    only chosen sizes are blocked; others are allowed by default. Supports multiple selections (up to 40).

Define your Deal’s Geography

The table includes a definition for each field in the Define your Deal’s Geography section:

Field Name Description Type Value Notes
Country Defines the country-level targeting for the deal. You can allow or block specific countries. Dropdown + Search Example: Allow: India, Block: USA
  • If Allow is selected:
    only chosen countries are included.
  • If Block is selected:
     chosen countries are excluded. Supports multiple country selection.
State Defines the state/province-level targeting under the selected country. You can allow or block states. Dropdown + Search Example: Allow: California, Block: Texas Optional field. Works only when the parent country is selected
City Defines the city-level targeting under the selected state or country. You can allow or block cities. Dropdown + Search Example: Allow: Mumbai, Block: Los Angeles Optional field. Works only when the parent country or state is selected.
Allow/Block (Country/State/City) Allows or blocks deal targeting of a specific country, state or city.   Allow, Block  
Country Summary Displays a summary of the selected allowed/blocked countries. Autogenerated Field Example: Allowed: India, Canada Read-only summary, auto-populated based on selections
State Summary Displays a summary of the selected allowed/blocked states Autogenerated Field Example: Allowed: Karnataka, Blocked: New York Read-only summary, auto-populated based on selections
City Summary Displays a summary of the selected allowed/blocked cities. Autogenerated Field Example: Allowed: Bangalore, Blocked: San Francisco Read-only summary, auto-populated based on selections.
Zip code targeting Allows targeting or excluding specific zip/postal codes. Zip codes can be bulk uploaded for convenience. Dropdown Allow, Block  
Bulk Upload Provides a downloadable template for bulk uploading zip code targeting data. Button Action: Downloads a CSV/Excel template Use this to prepare a list of zip codes offline. The template ensures the correct format for uploading.
Upload  Enables you to upload a list of zip codes for targeting (from the completed Bulk Upload Template file). Button Action: Uploads CSV/Excel file containing zip codes Zip codes must follow the format in the Bulk Upload Template. Once uploaded, they will appear under targeting.

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 per config) The possible selected values for Data Provider are: Verve Audiences, Smaato Audiences, and 3rd-Party Audiences. Filters the segment list and affects pricing/availability show
Logical Operator Sets group logic for how segments combine: AND Between Groups / OR Within Group Dropdown The possible values for logic operator are: AND BETWEEN/OR WITHIN, OR BETWEEN/AND WITHIN.
Required; must select one of the provided combined logical operators.		 “Between Groups” uses AND across groups; “Within Group” uses OR across segments in the same group. Reflected in Targeting Summary.
 Group To create a new group to determine whether a segment is part of the group (included) or not part of the group (excluded). 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 the current provider/filter. Search Box The possible values are: 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 Represents the CPM (Cost Per Thousand Impressions) associated with each audience segment. Numeric Column Example: $1.00  
Total Reach Indicates the total audience size available for the specific segment. Numeric Column Example: 54700  
Action Options to either include or exclude the audience segment from the targeting group. Link  Include, Exclude Include = target users in this segment;
Exclude = avoid users in this segment. Can toggle per row.
Include Adds the selected audience or contextual segment to the deal’s targeting. Action (link/button) Action: Include Ensures only users in the selected segment(s) are targeted by the deal. Multiple segments can be included.
Exclude Removes or prevents the selected audience or contextual segment from being targeted in the deal. Action (link/button) Action: Exclude Ensures users in the selected segment(s) are excluded. Can be used alongside Include to refine targeting.
Targeting Summary Provides an overview of the selected audience segments and logical groupings applied. Users can remove segments or groups from this panel. Autogenerated panel Shows: selected groups/segments, logic, costs Read-only; updates as you include/exclude segments.
Remove Option to remove a specific audience segment or group from the targeting summary. Button    
Add Audience Applies the current group selection to the deal. Button   Enabled after at least one Include/Exclude is selected.
Group Selection Chip Quick view/removal of a group’s 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) Displays the effective logic applied. Summary field AND Between Group / OR Within Group Mirrors the Logic dropdown.
Total Audience Segments Cost range of selected audience 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 deal 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 Selects the inventory channel(s) where the deal is eligible to run (e.g., In-App, Web, CTV). Dropdown + Multi-select Control: Allow / Block
Example: Allow: In-App, Web
  • If Allow → only chosen channels are included.
  • If Block → chosen channels are excluded. Limit: up to 4.
List of Bundles / Domains Targets or excludes specific app bundles or web domains. Dropdown + Upload Example: Allow: com.app.news, Block: example.com Supports Allow/Block. Lists can be added manually or via Upload / Bulk Upload Template
List of Publishers Targets or excludes specific publishers. Dropdown + Upload Example: Allow: Publisher A, Block: Publisher B Supports Allow/Block. Lists can be added manually or via Upload / Bulk Upload Template.
List of Ad Spaces Targets or excludes individual ad spaces (placements) from publishers. Dropdown + Upload  Example: Allow: Placement 12345, Block: Placement 67890 Supports Allow/Block. Lists can be added manually or via Upload / Bulk Upload Template.
Integration Type Selects the type of integration through which inventory is sourced (e.g., SDK, API, Header Bidding) Dropdown + Multi-select Example: Allow: SOMA API
  • If Allow → only selected types are included.
  • If Block → only selected types are excluded. Limit: up to 89.
List of Multipliers Targets or excludes inventory segments identified by multipliers (internal categorization). Dropdown + Multi-select Example: Allow: Premium, Block: Low Value Supports multiple selections. Limit: up to 159.
List of OTT/Ad Breaks Targets or excludes specific OTT/CTV ad breaks. Dropdown + Upload Example: Allow: Mid-roll, Block: Pre-roll Supports Allow/Block. Lists can be uploaded via template.
Supply Chain Nodes Selects inventory based on supply chain object nodes (SChain). Dropdown + Multi-select  Example: Allow: 1 hop, Block: 3 hops  
Device Type Defines the type(s) of devices for targeting (e.g., Phone, Tablet, Desktop, CTV). Dropdown + Multi-select  Example: Allow: Phone, Tablet
  • If Allow → only chosen device types are targeted.
  • If Block → chosen device types are excluded. Limit: up to 7.
Upload Lets you upload a pre-prepared CSV/Excel file (e.g., bundles, domains, publishers, ad spaces, OTT breaks). Button Action: File upload Used together with Bulk Upload Template.
Bulk Upload Template Downloads the standard template for bulk upload (Bundles/Domains, Publishers, Ad Spaces, OTT/Ad Breaks). Button  Action: Download Ensures correct formatting for uploading large lists.
Inventory Packages Provides curated inventory groupings (e.g., Seasonal, Audiences, Display, OLV, Regulatory, CTV, Contextual, Performance). Expandable Lists  Example categories: Seasonal, ConnectedTV Predefined packages curated by Verve. Selecting a package applies pre-grouped targeting rules.
Package Subcategory A specific event, season, or theme under a category. Expandable List Item Example: Earth Day & Eco-Friendly Products, Memorial Day, Mother’s Day, Graduation Season Clicking a subcategory reveals more details for pre packaged details
Allow (Action) Applies the selected package or sub-package to the deal targeting. Action (link/button) Action: Allow Instantly includes all inventory defined under that package.
Save Saves the selected Allow configurations for the Inventory Targeting to the deal. Button   Disabled until at least one inventory targeting rule is set. Once clicked, the chosen configurations are stored and reflected in the Summary panel.
Summary Displays a summary of all applied inventory targeting selections. Autogenerated Field  Example: Earth Day & Eco-Friendly Products (Seasonal) Read-only. Updates dynamically as selections are made.

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 Selects or excludes specific CTV content channels where ads may appear. Dropdown + Multi-select Example: Allow: ESPN, Hulu Live
Limit: up to 1246
  • If Allow → only chosen channels are targeted.
  • If Block → chosen channels are excluded.
CTV Genre Defines the content genres (e.g., Sports, News, Kids, Entertainment) targeted or excluded.. Dropdown + Multi-select Example: Allow: Sports, Entertainment
Limit: up to 61		 Allows refining targeting based on program type or content category
CTV Content Rating Enables you to select specific content ratings for targeting. Dropdown + Multi-select Example: Movie-R, TV-Y7: Directed to old children, TV-MA: Mature Audience Only  
Content Language Filters inventory based on the language of the content (e.g., English, Spanish, Hindi). Dropdown + Multi-select Example: English, Spanish, French  
Content Livestream Enables you to select whether to include or exclude livestream content in targeting. Dropdown Example:True (Livestream)  
Content Network Enables you to select specific content networks for targeting.

Dropdown
+Multi-select

 Example: ABC, HBO, ESPN  
Skippable Defines whether ads should be served in skippable or non-skippable video environments. Dropdown Example: Allow: Skippable, Block: Skippable
Limit: 1

Helps control ad format experience.

  • If Allow → only skippable placements targeted.
  • If Block → skippable inventory is excluded.

 

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 Defines the operating system (OS) signals for targeting ads across App, Web, and CTV environments. Expandable Categories Categories: App, Web, CTV Each category expands to allow more granular targeting options.
App Targets or excludes device OS signals in mobile app environments Expandable + Action  Example: Allow: Android App, iOS App Supports Allow configuration. Expands to list mobile OS/app-specific targeting options
Web Targets or excludes device OS signals in web environments. Expandable + Action Example: Allow: Chrome on Android Supports Allow configuration. Expands to list browser/OS-based targeting combinations.
CTV Targets or excludes device OS signals in connected TV environments. Expandable + Action  Example: Allow: Roku OS, Tizen Supports Allow configuration. Expands to list connected TV/OTT device operating systems.
Save Saves the selected Allow configurations for device signals targeting to the deal. Button Action: Save Disabled until at least one targeting option is configured. Once clicked, the selections are stored in Summary
Summary Displays a summary of all applied device OS targeting selections (App, Web, CTV). Autogenerated Field Example: App: iOS, Web: Chrome, CTV: Roku Read-only. Updates dynamically when targeting is saved.
Doc Feedback Product Feedback

Last Modified: August 19, 2025 at 6:09 pm