Data Dictionary

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: 300x250, 728x90, 160x600, 320x50, 970x250, 300x600, 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