> [!CAUTION]
> This SDF version has been sunset. Users should use SDF [v10](https://developers.google.com/display-video/api/structured-data-file/v10/Campaign) in order to continue using structured data files. Only use this documentation when referring to previously-generated files.

See the [overview](https://developers.google.com/display-video/api/structured-data-file/format) 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)](https://developers.google.com/bid-manager/guides/entity-read/format-v2#pixel) 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](https://developers.google.com/bid-manager/guides/entity-read/format-v2#creative) 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](https://developers.google.com/bid-manager/guides/entity-read/format#geolocation) to include in targeting. List format = (GeoLocation.id; GeoLocation.id;etc.). |
| Geography Targeting - Exclude | No | string, list | Yes | List of [geographies](https://developers.google.com/bid-manager/guides/entity-read/format#geolocation) to exclude in targeting. List format = (GeoLocation.id;GeoLocation.id; etc.). |
| Language Targeting - Include | No | string, list | Yes | List of [languages](https://developers.google.com/bid-manager/guides/entity-read/format-v2#language) to include in targeting. List format = (Language.id;Language.id;etc.). |
| Language Targeting - Exclude | No | string, list | Yes | List of [languages](https://developers.google.com/bid-manager/guides/entity-read/format-v2#language) to exclude in targeting. List format = (Language.id;Language.id;etc.). |
| Device Targeting - Include | No | string, list | Yes | List of [devices](https://developers.google.com/bid-manager/guides/entity-read/format-v2#deviceCriteria) to include in targeting. List format = (DeviceCriteria.id;DeviceCriteria.id;etc.). |
| Device Targeting - Exclude | No | string, list | Yes | List of [devices](https://developers.google.com/bid-manager/guides/entity-read/format-v2#deviceCriteria) to exclude in targeting. List format = (DeviceCriteria.id;DeviceCriteria.id;etc.). |
| Browser Targeting - Include | No | string, list | Yes | List of [browser](https://developers.google.com/bid-manager/guides/entity-read/format-v2#browser) to include in targeting. List format = (Browser.id;Browser.id;etc.). |
| Browser Targeting - Exclude | No | string, list | Yes | List of [browser](https://developers.google.com/bid-manager/guides/entity-read/format-v2#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](https://developers.google.com/display-video/api/structured-data-file/third-party-verification) supported by the selected provider. |
| Channel Targeting - Include | No | string, list | Yes | List of [channels](https://developers.google.com/bid-manager/guides/entity-read/format-v2#universalchannel) to include in targeting. List format = (UniversalChannel.id;UniversalChannel.id; etc.). |
| Channel Targeting - Exclude | No | string, list | Yes | List of [channels](https://developers.google.com/bid-manager/guides/entity-read/format-v2#universalchannel) to include in targeting. List format = (UniversalChannel.id;UniversalChannel.id; etc.). |
| Site Targeting - Include | No | string, list | Yes | List of [sites](https://developers.google.com/bid-manager/guides/entity-read/format-v2#universalsite) 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](https://developers.google.com/bid-manager/guides/entity-read/format-v2#universalsite) 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](https://developers.google.com/bid-manager/guides/entity-read/format-v2#universalsite) 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](https://developers.google.com/bid-manager/guides/entity-read/format-v2#universalsite) 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](https://developers.google.com/bid-manager/guides/entity-read/format-v2#appCollection) to include in targeting. List format= App Collection ID; App Collection ID; |
| App Collection Targeting - Exclude | No | string, list | Yes | List of [app collections](https://developers.google.com/bid-manager/guides/entity-read/format-v2#appCollection) 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](https://developers.google.com/adwords/api/docs/appendix/verticals). 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](https://developers.google.com/adwords/api/docs/appendix/verticals). 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](https://developers.google.com/bid-manager/guides/entity-read/format-v2#negativeKeywordList) 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](https://developers.google.com/bid-manager/guides/entity-read/format-v2#userlist) 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](https://developers.google.com/bid-manager/guides/entity-read/format-v2#userlist) 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](https://developers.google.com/bid-manager/guides/entity-read/format-v2#userlist) to exclude. List format= UserList ID; UserList ID; |
| Custom List Targeting | No | string, list | Yes | List of custom [lists](https://developers.google.com/bid-manager/guides/entity-read/format-v2#customaffinity) 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](https://developers.google.com/bid-manager/guides/entity-read/format-v2#inventorysource) to include in targeting. List format = (InventorySource.id; InventorySource.id;). |
| Inventory Source Targeting - Exclude | No | string, list | Yes | List of [inventory](https://developers.google.com/bid-manager/guides/entity-read/format-v2#inventorysource) 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 <br /> 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% <br /> |
| 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](https://developers.google.com/bid-manager/guides/entity-read/format-v2#isp) or Carriers to target. List format = {ISP.id; ISP.id;} |
| Carrier Targeting - Exclude | No | string, list | Yes | List of [ISPs](https://developers.google.com/bid-manager/guides/entity-read/format-v2#isp) 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 |