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   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.
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
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
           

 

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

 

Deal Reporting Labels

The table includes a definition for each field in the Deal Reporting Labels section:

Field Name Description Type Is Mandatory
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 Value
Ad Format Allows you to specify whether to allow or block ad targeting based on ad format. Dropdown Allow, Block.
Ad Format Selection Enables you to select specific ad formats for targeting. Dropdown Examples: Native Ads, Native Videos, Instream Preroll video, Instream Midroll video, Instream Postroll video, etc.
Device Type Allows you to specify whether to allow or block targeting based on device types. Dropdown Allow, Block
Device Type Selection Enables you to select specific device types for targeting. Dropdown Example: SmartPhone, Desktop, Tablet, Smart-TV, Feature Phone, and Other
Ad Size Allows you to specify whether to allow or block targeting based on ad sizes. Dropdown Allow, Block
Ad Size Selection Enables you to select specific ad sizes for targeting Dropdown Example: 300×250, 728×90, 160×600, 320×50, 970×250, 300×600, etc.

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
Country Displays a list of countries available for targeting, with options to allow or block specific countries. List Examples: Afghanistan, Albania, Algeria
Allow/Block (Country) Allows or blocks targeting of a specific country.   Allow, Block
State Displays states within a selected country for targeting. List Example: California, Texas (when the US is selected)
Allow/Block (State) Allows or blocks targeting of a specific state within specific countries   Allow, Block
City Displays cities within a selected states for targeting List Example: Los Angeles, San Francisco
Allow/Block (City) Allows or blocks targeting of a specific city within specific state.   Allow, Block
Country Summary Summarizes the targeting made at the country level. Section Footer Example: Afghanistan: Allow, Algeria: Block
State Summary Summarizes the targeting made at the state level Section Footer Example: California: Allow, Texas: Block
City Summary Summarizes the targeting made at the city level. Section Footer Example: Los Angeles: Allow, San Francisco: Block
Zip code targeting Allows you to specify whether to allow or block targeting based on zip codes Dropdown Allow, Block
Bulk Upload Provides a downloadable template for bulk uploading zip code targeting data. Button  
Upload Enables you to upload a list of zip codes for targeting. Button  
Geo Fencing Allows you to specify geographic boundaries using map tools or Multi ID options for geofencing. Section Header Options: Map, Multi ID
Map Allows you to configure geographic boundaries visually on a map interface. Button  
Multi ID Allows you to configure geographic boundaries by uploading or specifying multiple geographic identifiers. Button Options: Bulk Upload Template and Upload
Bulk Upload Template Provides a downloadable template to ensure correct formatting for uploading Multi ID data. Button  
Upload Enables you to upload a file containing Multi ID data for geofencing purposes. Button  

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
EID Specifies whether to allow or block the type of Encrypted Identifier being targeted. Dropdown/Select Allow, Block
EID Selection Enables to select specific Encrypted Identifier options available in list for targeting. Multi-Select At least one EID value must be selected when Allow or Block is applied.
The possible values are: Unified ID 2.0, ID5, LiveRamp, NetID, etc.
Data Provider Lists the data providers offering audience and contextual segments. Can be filtered or selected to add segments to groups. Dropdown/Select The possible selected values for Data Provider are: Verve Audiences, Smaato Audiences, and 3rd-Party Audiences.
Logical Operator Specifies the logical operator for combining groups and segments in targeting. 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.
Create New 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 You can create maximum up to 5 groups
Column+ Dropdown filter that allows you to customize and select the columns displayed in a Segment table. Dropdown with Checkbox The values are ID, Cost, Total Reach, etc.
Search by Name Allows you to search audience segments by name. Search Box The possible values are: Behavioral Audiences
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. Include, Exclude  
Targeting Summary Provides an overview of the selected audience segments and logical groupings applied. Users can remove segments or groups from this panel. Panel  
Remove Option to remove a specific audience segment or group from the targeting summary. Button  
Add Audience Allow you to save a audience segment to the list or group for targeted inclusion or exclusion. Button  

Add Inventory targeting

The table includes a definition for each field in the Add Inventory targeting section:

Field Name Description Type Value
Inventory Type Specifies whether to allow or block certain types of inventory for targeting. Dropdown Allow, Block
Inventory Type Selection Enables you to select specific Inventory Type selection for targeting. Multi-Select In-app, CTV, Web
List of Bundles Determines whether to allow or block specific bundles for inventory targeting. Dropdown  
Bulk Upload Template (Bundles) Provides a downloadable template for bulk uploading bundle lists. Button  
Upload (Bundles) Enables you to upload a list of bundles for targeting. Button  
List of Apps Determines whether to allow or block specific apps for inventory targeting. Dropdown Allow, Block
Bulk Upload Template (List of Apps) Provides a downloadable template for bulk uploading apps list.. Button  
Upload (List of Apps) Enables you to upload a list of apps for targeting. Button  
List of Ad Spaces Determines whether to allow or block specific ad spaces for inventory targeting. Dropdown  
Bulk Upload Template (List of Ad Spaces) Provides a downloadable template for bulk uploading ad space lists. Button  
Upload (Ad Spaces) Enables you to upload a list of ad spaces for targeting. Button  
List of OTT/Ad Breaks Allows you to specify whether to allow or block specific OTT (Over-The-Top) ad breaks for targeting. Dropdown Allow, Block
Bulk Upload Template (OTT/Ad Breaks) Provides a downloadable template for bulk uploading OTT/Ad Break data. Button  
Upload (OTT/Ad Breaks) Enables you to upload a list of OTT/Ad Break IDs for targeting. Button  
Number of SChain Hops Allows you to set whether to allow or block specific Supply Chain Hops (SChain Hops) for inventory targeting. Dropdown Allow, Block
Number of SChain Hops Selection Enables you to select or input the specific number of SChain Hops for inventory targeting. Dropdown One, Two
Bidstream Signals Allows you to specify whether to allow or block specific Bidstream Signals for inventory targeting. Dropdown  
Bidstream Signals Selection Enables you to select or input specific bidstream signals for targeting. Dropdown Device ID Available, GPS Data Available
Content IAB Category Represents the section for selecting and managing IAB (Interactive Advertising Bureau) content categories. Section Header  
Category Name Displays the name of each IAB content category with an option to expand and view subcategories. Text with Expand icon Examples: Food & Drink, Hobbies & Interests, Cigars, etc.
Allow (Category) Allows targeting of content within the specified IAB content category. Option  
Block (Category) Blocks targeting of content within the specified IAB content category. Option  
Expand Icon (Category) Clicking the expand icon opens subcategories or additional options for the selected IAB category.   Example: Expand to view subcategories of Food & Drink.
Save Saves the selected allow/block configurations for the IAB content categories. Button  
Summary Displays a summary of the selected and saved configurations for content IAB targeting. Section Footer Example: Food & Drink: Allow, Sports: Block.

Add Video signal targeting

The table includes a definition for each field in the Add Video signal targeting section:

Field Name Description Type Value
CTV Content Channel Allows you to specify whether to allow or block specific CTV content channels for targeting. Dropdown Allow, Block
CTV Content Channel Selection Enables you to select specific CTV content channels for targeting. Dropdown Example: News, Sports, Entertainment
CTV Genre Allows you to specify whether to allow or block specific genres of CTV content for targeting. Dropdown Allow, Block
CTV Genre Selection Enables you to select specific genres for targeting. Dropdown Example: Comedy, Drama, Documentary
CTV Content Rating Allows you to specify whether to allow or block specific CTV content ratings for targeting. Dropdown Allow, Block
CTV Content Rating Selection Enables you to select specific content ratings for targeting. Dropdown Example: TV-Y7: Directed to old children, TV-MA: Mature Audience Only
Content Language Allows you to specify whether to allow or block content based on language. Dropdown Allow, Block
Content Language Selection Enables you to select specific content languages for targeting. Dropdown Example: English, Spanish, French
Content Livestream Allows you to specify whether to allow or block livestream content for targeting. Dropdown Allow, Block
Content Livestream Selection Enables you to select whether to include or exclude livestream content in targeting. Dropdown Example: True (Livestream)
Content Network Allows you to specify whether to allow or block specific content networks for targeting Dropdown Allow, Block
Content Network Selection Enables you to select specific content networks for targeting. Dropdown Example: ABC, HBO, ESPN
Skippable Allows you to specify whether to allow or block skippable ads for targeting. Dropdown Allow, Block
Skippable Selection Enables you to select specific skippable options for targeting. Dropdown Example: Skippable

Boost your Deal’s performance with KPI targeting

The table includes a definition for each field in the Boost your Deal’s performance with KPI targeting section:

Field Name Description Type Value
Click Through Rate Allows you to specify whether to allow or block specific click through rate for targeting. Dropdown Allow, Block
Click Through Rate Selection Enables you to select specific Click Through Rate (CTR) for targeting. Dropdown Example: 0.1% and Greater, 0.2% and Greater
Video Completion Rate Allows you to specify whether to allow or block targeting based on Video Completion Rate (VCR). Dropdown Allow, Block
Video Completion Rate Selection Enables you to select specific VCR targeting options. Dropdown Example: 95% and Greater, 90% and Greater
Viewability Allows you to specify whether to allow or block targeting based on Viewability. Dropdown Allow, Block
Viewability Selection Enables you to select specific viewability thresholds for targeting. Dropdown Example: 95% and Greater, 90% and Greater
Open Measurement Allows you to specify whether to allow or block targeting based on Open Measurement-enabled inventory. Dropdown Allow, Block
Open Measurement Selection Enables you to select targeting options for Open Measurement. Dropdown Example: OM available

Add Device signals targeting

The table includes a definition for each field in the Add Device signals targeting section:

Field Name Description Type Value
Browser Language Allows you to specify whether to allow or block device signals targeting based on the browser language.  Dropdown Allow, Block
Browser Language Selection Enables you to select specific browser languages for device signals targeting. Dropdown Example: Arabic, English, etc.
Device Model Allows you to specify whether to allow or block device signals targeting based on device model. Dropdown Allow, Block
Device Model Selection Enables users to select specific device models for device signals targeting. Dropdown Example: Alcatel, Amazon, etc.
Device OS Allows you to specify whether to allow or block device signal targeting based on the operating system (OS) of devices. Dropdown Allow, Block
Device OS Selection Enables you to select specific operating systems for device signals targeting. Dropdown Example: Android, Android TV

Back to top

Doc Feedback Product Feedback

Last Modified: January 17, 2025 at 6:05 pm