Structured Data - v4.1 - Line Items

This SDF version has been sunset. Users should migrate to SDF v7 in order to continue using structured data files. Only use this documentation when referring to previously-generated files.

See the overview for an explanation of format.

Field	Required	Type	Writable	Description
Line Item Id	Required only when editing existing Line Items	integer	No	Numeric ID value of the line item. If left blank, a new line item will be created and a unique ID will be assigned. Optionally, when creating new Line Items, you can use a custom identifier for the purpose of assigning TrueView Ad Groups to the new Line Item. The format for a custom identifier is "ext[custom identifier]", for example, ext123. When the file is uploaded and processed, all custom identifiers will be replaced with DBM-assigned IDs and the objects will be associated (for example, Ad Group to Line Item) based on the custom identifiers.
Io Id	Yes	integer	No	Numeric ID value of the insertion order. You can specify a custom identifier (for example, "ext[custom IO identifier]") for an insertion order that you are creating at the same time as this line item.
Type	Yes	string	Yes	The type of entry. Only writable when creating, not editing. Display Video TrueView Audio
Subtype	Yes	string	Yes	Field required for TrueView line items to distinguish between the Standard and Mobile App Install TrueView formats Simple Mobile App Install
Name	Yes	string	Yes	The name of the entry.
Timestamp	Required when editing existing entries	integer	No	The timestamp for the entry, this is used by the system to verify that the entry has not changed between downloading and uploading.
Status	Yes	string	Yes	The status setting for the entry. Active Paused Draft Archived Deleted
Start Date	Yes	string	Yes	A timestamp for the flight start date of the entry in the format MM/DD/YYYY HH:mm.
End Date	Yes	string	Yes	A timestamp for the flight end date of the entry in the format MM/DD/YYYY HH:mm.
Budget Type	Yes	string	Yes	Specifies whether the budget is monetarily based or impression-based. If the IO for this entry is enabled for auto-budget allocation, you can set this to 'Automatic' to allow DBM to automatically budget for this entry. Amount Impressions Unlimited Automatic TrueView Budget
Budget Amount	Required when "Type" is "Display" or "Video" or "Audio"	float	Yes	A positive budget amount for the budget type. This could be a simple integer impression value, or a float for a currency amount. Currencies will be shown in the advertiser's currency in standard units (not in 1/1,000,000s of a currency unit). If 'Automatic' budget allocation is set on the entry, you can specify a minimum amount to spend (for example, 'spend at least' this amount).
Pacing	Yes	string	Yes	The time period used to spend to the pacing amount. Daily Monthly Flight TrueView Line Items can only be 'Daily' or 'Flight'
Pacing Rate	Yes	string	Yes	The rate of pacing for this entry. ASAP Even Ahead TrueView Line Items can only be 'ASAP' or 'Even'
Pacing Amount	Yes	float	Yes	The amount to spend per the time period set by the pacing type.
Frequency Enabled	Yes	string	Yes	Enables/disables impression-based frequency capping on the line item. TRUE FALSE
Frequency Exposures	Required when "Frequency Enabled" is "TRUE"	integer	Yes	A positive integer amount for the number of impressions in a given Frequency Amount, that is, the x in 'Show x impressions over y period'.
Frequency Period	Required when "Frequency Enabled" is "TRUE"	string	Yes	Specifies the time period unit for the frequency cap. For TrueView line items, supported periods are Days, Weeks, Months. Minutes Hours Days Weeks Months Lifetime
Frequency Amount	Required when "Frequency Enabled" is "TRUE"	integer	Yes	A positive integer amount for length of time of the Frequency Period type, that is, the y in 'Show x impressions over y period'. This amount is not supported for TrueView line items.
TrueView View Frequency Enabled	Required when "Type" is "TrueView"	string	Yes	Enables/disables view-based frequency capping on the TrueView line item TRUE FALSE
TrueView View Frequency Exposures	Required when "TrueView View Frequency Enabled" is "TRUE"	integer	Yes	A positive integer amount for the number of TrueView views, that is, the x in 'Show x views over the period'
TrueView View Frequency Period	Required when "TrueView View Frequency Enabled" is "TRUE"	string	Yes	Specifies the time period unit for the TrueView view-based frequency cap Days Weeks Months
Partner Revenue Model	Yes	string	Yes	A partner revenue model is the mechanism for controlling how revenue is calculated in Bid Manager. Use the partner revenue model to track the markup for your service fees. TMCM - Total Media Cost Markup MCM - Media Cost Markup CPM - Cost Per thousand impressions
Partner Revenue Amount	Yes	float	Yes	A positive float value corresponding to the Partner Revenue Model.
Conversion Counting Type	Required when "Type" is "Display" or "Video" or "Audio"	string	Yes	Choose the kinds of conversions that are counted. Count all Count post-click Count %
Conversion Counting Pct	Required when "Type" is "Display" or "Video" or "Audio"	float	Yes	Specify the % for 'Count %' Conversion Counting Type. Format the % as a float (3.123% = 3.123), with precision limited to the thousands (3 decimal places).
Conversion Pixel Ids	No	string, list of lists	Yes	Specify the conversion pixel(s) as a list of lists. Each pixel is specified as a pixel ID, post-view window (in minutes) and post-click window (in minutes). List format = (Pixel.common_data.id; view_window_minutes; click_window_minutes;).
Fees	No	string, list of lists	Yes	All fees for this entry. List format = (Fee category; Fee amount; Fee type; Invoiced;). Fee category CPM Media Fee amount Float Pct as float Fee type (string, see table in fees) Invoiced True False blank Example '(CPM; 2; Bid Manager Fee; False) ; (Media; 13; Default; True);' Acceptable values are provided in the following table: Note: Premium Fees CPM Fee is reserved by the system and is immutable. The cardinality of the Premium Fee is preserved across mutations by inserting Default CPM fees if needed. Fee category Fee Type Invoiced option CPM/Media Default Not permitted (leave blank) CPM/Media Third-Party Ad Server Not permitted (leave blank) CPM/Media DoubleVerify Permitted (True/False) CPM/Media Adsafe Not permitted (leave blank) CPM/Media Adxpose Not permitted (leave blank) CPM/Media Vizu Not permitted (leave blank) CPM/Media Aggregate Knowledge Not permitted (leave blank) CPM/Media Teracent Not permitted (leave blank) CPM/Media Evidon Not permitted (leave blank) CPM/Media Agency Trading Desk Fee Not permitted (leave blank) CPM/Media Adloox Permitted (True/False) CPM ShopLocal Required (True) CPM TrustMetrics Not permitted (leave blank) CPM Integral Ad Science Video Permitted (True/False) CPM MOAT Video Not permitted (leave blank) Media Bid Manager Fee Required (True) Media Media Cost Data Not permitted (leave blank) CPM Premium Fees Not permitted (leave blank)
Integration Code	No	string	Yes	An optional code for tracking purposes.
Details	No	string	Yes	Entry details in string format.
Bid Strategy Type	Required when "Type" is "Display" or "Video" or "Audio"	string	Yes	Select one of the applicable bid strategies: Minimize: While spending the full budget, minimize CPA/CPC Maximize: While spending the full budget, maximize Impression Value or Quality Impression Beat: Meet or beat a goal of X CPA/CPC Optimize vCPM: Optimize for viewable CPM bid of X Fixed: Specify a fixed bid of X
Bid Strategy Value	Required unless "Bid Strategy Type" is "Minimize", "Maximize" or "Type" is "TrueView"	float	Yes	For Beat, Optimize VCPM, Fixed strategy types, choose a value for the goal bid. Note that no Bid Strategy Value is required for the Bid Strategy Type 'Minimize' or 'Maximize'
Bid Strategy Unit	Required when "Bid Strategy Type" is "Beat" ,"Minimize" or "Maximize"	string	Yes	For Beat, Minimize or Maximize strategy types, select the corresponding unit: CPA CPC custom impr. value/cost CIVA IVO_TEN AV_VIEWED INCREMENTAL_CONVERSIONS
Bid Strategy Do Not Exceed	Required when "Type" is "Display" or "Video" or "Audio"	float	Yes	Set a 'do not exceed' CPM value. If 0, 'do not exceed' is not enabled. This is available only if the Bid Strategy is 'Minimize', 'Maximize' or 'Beat'.
Creative Assignments	No	string, list	Yes	List of Creative IDs to assign to the entry. List format = (Creative.common_data.id;Creative.common_data_id;etc.).
Geography Targeting - Include	No	string, list	Yes	List of geographies to include in targeting. List format = (GeoLocation.id; GeoLocation.id;etc.).
Geography Targeting - Exclude	No	string, list	Yes	List of geographies to exclude in targeting. List format = (GeoLocation.id;GeoLocation.id; etc.).
Language Targeting - Include	No	string, list	Yes	List of languages to include in targeting. List format = (Language.id;Language.id;etc.).
Language Targeting - Exclude	No	string, list	Yes	List of languages to exclude in targeting. List format = (Language.id;Language.id;etc.).
Device Targeting - Include	No	string, list	Yes	List of devices to include in targeting. List format = (DeviceCriteria.id;DeviceCriteria.id;etc.).
Device Targeting - Exclude	No	string, list	Yes	List of devices to exclude in targeting. List format = (DeviceCriteria.id;DeviceCriteria.id;etc.).
Browser Targeting - Include	No	string, list	Yes	List of browser to include in targeting. List format = (Browser.id;Browser.id;etc.).
Browser Targeting - Exclude	No	string, list	Yes	List of browser to exclude in targeting. List format = (Browser.id;Browser.id;etc.).
Brand Safety Labels	No	string, list	Yes	List of the digital content labels to target. List format = (G;PG; etc.). G PG T MA ?
Brand Safety Sensitivity Setting	No	string	Yes	Choose the sensitivity setting to block inventory based on the subject matter of its surrounding content. Do not block Use DoubleClick Verification Use custom
Brand Safety Custom Settings	Required when "Brand Safety Custom Setting" is "Use Custom"	string, list	Yes	If the Brand Safety Sensitivity Setting is 'Use custom', specify the list of standard content classifiers. For example, (Adult;Alcohol;Tobacco;etc.). Adult Derogatory Downloads & Sharing Weapons Gambling Violence Suggestive Profanity Alcohol Drugs Tobacco Politics Religion Tragedy Transportation Accidents Sensitive social issues Shocking
Third Party Verification Services	No	string	Yes	Third party verification services provider. None Integral Ad Science DoubleVerify Adloox
Third Party Verification Labels	No	string, list	Yes	If Third Party Verification Services is not "None", specify a list of labels supported by the selected provider.
Channel Targeting - Include	No	string, list	Yes	List of channels to include in targeting. List format = (UniversalChannel.id;UniversalChannel.id; etc.).
Channel Targeting - Exclude	No	string, list	Yes	List of channels to include in targeting. List format = (UniversalChannel.id;UniversalChannel.id; etc.).
Site Targeting - Include	No	string, list	Yes	List of sites to include in targeting. The list can include a set of site IDs or strings of URLs, if not found in the Universal Site table. List format = (UniversalSite.Id;'http://someurl.com';etc.).
Site Targeting - Exclude	No	string, list	Yes	List of sites to exclude in targeting. The list can include a set of site IDs or strings of URLs, if not found in the Universal Site table. List format = (UniversalSite.Id;'http://someurl.com';etc.).
App Targeting - Include	No	string, list	Yes	List of apps to include in targeting. The list can include a set of UniversalSite IDs or strings of app packages, if not found in the Universal Site table. List format = (UniversalSite.Id; 'some.app.package';etc.).
App Targeting - Exclude	No	string, list	Yes	List of apps to exclude in targeting. The list can include a set of UniversalSite IDs or strings of app packages, if not found in the Universal Site table. List format = (UniversalSite.Id; 'some.app.package';etc.).
App Collection Targeting - Include	No	string, list	Yes	List of app collections to include in targeting. List format= App Collection ID; App Collection ID;
App Collection Targeting - Exclude	No	string, list	Yes	List of app collections to exclude in targeting. List format= App Collection ID; App Collection ID;
Category Targeting - Include	No	string, list	Yes	List of categories to include in targeting, from AdX vertical IDs. List format = (Verticals.Id;Verticals.Id;etc.).
Category Targeting - Exclude	No	string, list	Yes	List of categories to exclude in targeting, from AdX vertical IDs. List format = (Verticals.Id;Verticals.Id;etc.).
Keyword Targeting - Include	No	string, list	Yes	List of keyword strings to include in targeting.
Keyword Targeting - Exclude	No	string, list	Yes	List of keyword strings to exclude in targeting.
Keyword List Targeting - Exclude	No	string, list	Yes	List of negative keyword lists to exclude in targeting. List format= Negative Keyword List ID; Negative Keyword List ID;
Audience Targeting - Similar Audiences	Required when "Type" is "Display" or "Video" or "Audio"	string	Yes	Enable similar audiences for positively targeted first-party lists. TRUE FALSE
Audience Targeting - Include	No	string, list of list of pairs	Yes	List of audience lists to include in targeting. For first-party audience lists, each audience is listed as a pair of UserList ID and recency setting. A pair is (1;1d;), where 1d is a sample recency representing 1 day recency. Recency is not available for third-party audiences, so the list format is (3;);(4;);. To "AND" and "OR" groups of audiences, follow this example: To combine pairs with and without recency: ' ((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'. This means (list 1 with 1 day recency OR list 2 with 365day recency ) AND (list 3 without a specified recency OR list 4 with 5 minute recency OR list 5 with all users). Valid recency values are: all, 1m, 5m, 10m, 15m, 30m, 1h, 2h, 3h, 6h, 12h, 1d, 2d, 3d, 5d, 7d, 10d, 14d, 15d, 21d, 28d, 30d, 45d, 60d, 90d, 120d, 180d, 270d, 365d
Audience Targeting - Exclude	No	string, list of list of pairs	Yes	List of audience lists to exclude in targeting. Each audience is listed as a pair of UserList ID and recency setting, if the audience list is a 1P audience list. A pair is (1;1d;), where 1d is a sample recency representing 1 day recency. However, for 3P audiences, recency is not available, so the list format is (3;);(4;);. List format= (UserList.id; recency optional;); (UserList.id; recency optional;); Example: "(1;1d;);(2;);". Valid recency values are: all, 1m, 5m, 10m, 15m, 30m, 1h, 2h, 3h, 6h, 12h, 1d, 2d, 3d, 5d, 7d, 10d, 14d, 15d, 21d, 28d, 30d, 45d, 60d, 90d, 120d, 180d, 270d, 365d
Affinity & In Market Targeting - Include	No	string, list	Yes	List of affinity and/or in-market audience lists to include. List format= UserList ID; UserList ID;
Affinity & In Market Targeting - Exclude	No	string, list	Yes	List of affinity and/or in-market audience lists to exclude. List format= UserList ID; UserList ID;
Custom List Targeting	No	string, list	Yes	List of custom lists to target. List format= UserList ID; UserList ID;
Inventory Source Targeting - Authorized Seller Only	Required when "Type" is "Display" or "Video" or "Audio"	string	Yes	Setting to target authorized seller only, authorized seller and resellers, or authorized seller + unknown. "Authorized Direct" means only authorized sellers will be targeted. TRUE means targeting the authorized sellers and resellers. FALSE means it will target authorized sellers, resellers, and unknown sellers. TRUE FALSE Authorized Direct
Inventory Source Targeting - Include	Required when "Type" is "Display" or "Video" or "Audio"	string, list	Yes	List of inventory to include in targeting. List format = (InventorySource.id; InventorySource.id;).
Inventory Source Targeting - Exclude	No	string, list	Yes	List of inventory to exclude in targeting. List format = (InventorySource.id; InventorySource.id;).
Inventory Source Targeting - Target New Exchanges	No	string	Yes	Setting to target new exchanges. True False
Daypart Targeting	No	string, list	Yes	List of IDs, where each daypart ID is constructed in the following format: daypart_id = base_dayparting_id + days_since_monday * 10000 + start * 100 + end base_dayparting_id = 300000 days_since_monday: 0=Monday, 1=Tuesday, ..., 6=Sunday start: 0..95 (00:00--23:45) an integer from 0-95, representing 15min slots end: 1..96 (00:15--24:00); an integer from 0-95, representing 15min slots start < end For new entities, times will be set in the timezone of your users (i.e., "Local"). For existing entities, the timezone will not be changed.
Daypart Targeting Time Zone	Required when "Daypart Targeting" is included.	string	Yes	Timezone to use for daypart targeting. Local Advertiser TrueView Line Items can only be 'Advertiser.'
Environment Targeting	Required when "Type" is "Display" or "Video" or "Audio"	string, list	Yes	List of environments to target. List format = (Desktop Web; Mobile App; etc.). For Display Environment: Desktop Web Mobile Web Mobile App Mobile App Interstitial Desktop Web on Mobile For Video: Desktop Web Video Desktop Web Game Desktop Web In-Read Desktop Web In-Feed Mobile Web Video Mobile App Video Mobile App Video Interstitial For Audio: Desktop Web Audio Mobile Web Audio Mobile App Audio
Viewability Targeting Active View	No	string	Yes	Target predicted viewability percentages. Percentages are represented as floats. One of {0.1,0.2,0.3,0.4,0.5,0.6,0.7,0.8,0.9}
Viewability Targeting Ad Position - Include	No	string	Yes	Target ad positions. Select one or none of the acceptable values: All ATF BTF Unknown
Viewability Targeting Ad Position - Exclude	No	string	Yes	Exclude ad positions in targeting. Select one or none of the acceptable values: ATF BTF Unknown
Video Ad Position Targeting	No	string, list	Yes	List of video ad positions to target. Select one or more of the acceptable values: unknown Pre-roll Mid-roll Post-roll
Video Player Size Targeting	No	string, list	Yes	List of video ad player size to target. Select one or more of the acceptable values: unknown small large HD
Demographic Targeting Gender	No	string, list	Yes	List of genders to target. Select one or more of the acceptable values: Female Male Unknown
Demographic Targeting Age	No	string, list	Yes	Target to a user age range. Specify a from/to range by selecting a single From age and a single To age and whether to include unknown ages true/false. See the list of acceptable From/To ages. Example 1: to target 18-55 and include unknown ages, specify the format {From; To ; Include unknown True/False} = 18;55;true; Example 2: to target only users >35 years old and exclude unknown ages, specify the following = 35;+;false;. Acceptable values for From: 18 25 35 45 55 65 Acceptable values for To: 25 35 45 55 65 +
Demographic Targeting Household Income	No	string, list	Yes	Target a household income range. Specify a from/to range by selecting a single Top_of_Range income range and a single Bottom_of_Range income range and whether to include households with unknown income true/false. See the list of acceptable Top_of_Range/Bottom_of_Range ranges. Example 1: to target the top 10% to 50% of households and include households with unknown income, specify the format {Top_of_Range; Bottom_of_Range; Include unknown True/False} = Top 10%;41-50%;true; Example 2: to target only the lower 50% of households and exclude households with unknown income, specify the format {Top_of_Range; Bottom_of_Range; Include unknown True/False} = Lower 50%;Lower 50%;true; Acceptable values for Top_of_Range/Bottom_of_Range: Top 10% 11-20% 21-30% 31-40% 41-50% Lower 50%
Demographic Targeting Parental Status	Yes	string, list	Yes	List of parental status to target. Select one or more of the acceptable values. Parent Not a parent Unknown
Connection Speed Targeting	No	string	Yes	Target to a specific connection speed. Select one of the acceptable values: All 2G 3G DSL 4G
Carrier Targeting - Include	No	string, list	Yes	List of ISPs or Carriers to target. List format = {ISP.id; ISP.id;}
Carrier Targeting - Exclude	No	string, list	Yes	List of ISPs or Carriers to exclude. List format = {ISP.id; ISP.id;}
Bid Multipliers	No	string, list of lists	Yes	All bid multipliers for this entry. List format = (row type;criteria ID;bid multiplier value); (row type;criteria ID;bid multiplier value);. Bid multiplier values can range between 0.1 and 10.0. Acceptable row types and their corresponding criteria ID's are listed in the following table: Row Type Dimension Criteria ID app App/Site The app criteria ID (= universal site ID). If the criteria ID is not found in the Universal Site table, replace it with a string of app package. eg. (app;UniversalSite.id;1.0);(app;'some.app.package';2.5); site App/Site The site criteria ID (= universal site ID). If the criteria ID is not found in the Universal Site table, replace it with a string of site url. eg. (site;UniversalSite.id;1.0);(site;'http://someurl.com';2.5); user_list Audience List The user list ID. eg. (user_list;UserList.id;1.0);(user_list;UserList.id;2.5); user_interest Audience List The user interest ID. eg. (user_interest;UserList.id;1.0);(user_interest;UserList.id;2.5); custom_affinity Audience List The custom affinity ID. eg. (custom_affinity;CustomAffinity.id;1.0);(custom_affinity;CustomAffinity.id;2.5); day_part Day Part The day part ID is defined in the Daypart Targeting column. eg 314159 represents "Tuesday, 10:15 AM - 2:45 PM." eg. (day_part;314159;1.0);(day_part;302312;2.5); age_range Demographics The age range, separated as From-To. Acceptable values are: 18-24 25-34 35-44 45-54 55-64 65+ Unknown eg. (age_range;55-64;1.0);(age_range;65+;2.5); gender Demographics The gender. Acceptable values are: Male Female Unknown eg. (gender;Male;1.0);(gender;Female;2.5); parental_status Demographics The parental status. Acceptable values are: Parent Not a parent Unknown eg. (parental_status;Not a parent;1.0); household_income Demographics The household income percentile range. Acceptable values are: Top 10% 11-20% 21-30% 31-40% 41-50% Lower 50% Unknown eg. (household_income;Top 10%;1.0);(household_income;Unknown;2.5); device_type Device Type The device type. Acceptable values are: Computer Smartphone Tablet eg. (device_type;Computer;1.0);(device_type;Tablet;2.5); geo Geography The geography location ID. eg. (geo;2840;1.0);
TrueView Video Ad Formats	Yes for TrueView Line Items	string	Yes	The video ad format of the line item. Select In-stream / Video Discovery for the two types of TrueView video ads sold on a CPV basis, or select Bumpers for 6-second video ads sold on a CPM basis. In-stream / Video Discovery Bumper
TrueView Mobile Bid Adjustment Option	No	string	Yes	Either 'Increase' or 'Decrease' Increase Decrease
TrueView Mobile Bid Adjustment Percentage	No	integer	Yes	Bid adjustment to increase chances of showing ads on Mobile. Acceptable adjustments are for Bid Adjustment Option 'Increase': [0;900%]; and for 'Decrease': [0;90%] or 100%
TrueView Desktop Bid Adjustment Option	No	string	Yes	Either 'Increase' or 'Decrease' Increase Decrease
TrueView Desktop Bid Adjustment Percentage	No	integer	Yes	Bid adjustment to increase chances of showing ads on desktop. Acceptable adjustments are for Bid Adjustment Option 'Increase': [0;900%]; and for 'Decrease': [0;90%] or 100%
TrueView Tablet Bid Adjustment Option	No	string	Yes	Either 'Increase' or 'Decrease' Increase Decrease
TrueView Tablet Bid Adjustment Percentage	No	integer	Yes	Bid adjustment to increase chances of showing ads on tablet. Acceptable adjustments are for Bid Adjustment Option 'Increase': [0;900%]; and for 'Decrease': [0;90%] or 100%
TrueView Category Exclusions Targeting	No	string, list	Yes	List of categories to exclude. List format = Games; Tragedy and conflict; etc Embedded Videos Live Streaming Games Tragedy And Conflict Sensitive Social Issues Families All Audiences Younger Teens Teens Adults Not Yet Rated Sexually suggestive content Sensational and shocking Profanity and rough language
TrueView Content Filter	No	string	Yes	TrueView content filter. Limited Standard None
TrueView Inventory Source Targeting	No	string, list	Yes	Lists of TrueView inventory sources to include YouTube Search YouTube Videos Video Partners