See the overview for an explanation of format.
This is a QA file format. Files in this format are read-only and cannot be uploaded.
Field | Type | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Line Item Id | integer | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Io Id | integer | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Io Name | string | Insertion Order Name | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Type | string | The type of entry. Only writable when creating, not editing.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Subtype | string | Field required for line items to distinguish between different formats
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Name | string | The name of the entry. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Timestamp | integer | The timestamp for the entry, this is used by the system to verify that the entry has not changed between downloading and uploading. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Status | string | The status setting for the entry.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Start Date | string | A timestamp for the flight start date of the entry in the format MM/DD/YYYY or "Same as Insertion Order" to use the same start date as the parent Insertion Order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
End Date | string | A timestamp for the flight end date of the entry in the format MM/DD/YYYY or "Same as Insertion Order" to use the same end date as the parent Insertion Order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Budget Type | string | 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.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Budget Amount | float | 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 | string | The time period used to spend to the pacing amount.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Pacing Rate | string | The rate of pacing for this entry.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Pacing Amount | float | The amount to spend per the time period set by the pacing type. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Frequency Enabled | string | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Frequency Exposures | integer | 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 | string |
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Frequency Amount | integer | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView View Frequency Enabled | string | Enables/disables view-based frequency capping on the TrueView line item
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView View Frequency Exposures | integer | 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 | string | Specifies the time period unit for the TrueView view-based frequency cap
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Partner Revenue Model | string | 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. Column Partner Revenue Amount should be specified when column Partner Revenue Model is included.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Partner Revenue Amount | float | A positive float value corresponding to the Partner Revenue Model. Only applicable when column Partner Revenue Model is specified. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Conversion Counting Type | string | Choose the kinds of conversions that are counted.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Conversion Counting Pct | float | 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 Floodlight Activity Ids Qa | string, list of lists | The floodlight activities used for conversions and related settings. This column uses Display & Video 360 API List of list format = ((FloodlightActivity.displayName; view_window_days; click_window_days;);(FloodlightActivity.displayName; view_window_days; click_window_days;);). This list is generated in ascending alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Primary Attribution Model Id Qa | string | The attribution model name for the associated line item. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Fees | string, list of lists | All fees for this entry. List format = (Fee category; Fee amount; Fee type; Invoiced;).
Example '(CPM; 2; Display & Video 360 Fee; False) ; (Media; 13; Default; True);'
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Integration Code | string | An optional code for tracking purposes. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Details | string | Entry details in string format. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Bid Strategy Type | string | Select one of the applicable bid strategies:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Bid Strategy Value | float | 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 | string | For Beat, Minimize or Maximize strategy types, select the corresponding unit:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Bid Strategy Do Not Exceed | float | 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'. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Apply Floor Price For Deals | string | Whether to prioritize deals over open auction inventory | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Algorithm Id | integer | This corresponding algorithm ID must be used when Bid Strategy Unit is set to custom impr. value/cost. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Creative Assignments Qa | string, list | List of Creatives assigned to the entry. List format = (Creative name; Creative name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Geography Targeting - Include Qa | string, list | List of geography regions to include in targeting. List format = (Geo Region Name; Geo Region Name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Geography Targeting - Exclude Qa | string, list | List of geography regions to exclude in targeting. List format = (Geo Region Name; Geo Region Name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Geography Regional Location List Targeting - Include Qa | string, list | List of regional location lists names to include in targeting. An entity can only target two location lists, including proximity location lists. List format = (Location list name; Location list name;). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Geography Regional Location List Targeting - Exclude Qa | string, list | List of regional location lists names to exclude in targeting. An entity can only target two location lists, including proximity location lists. List format = (Location list name; Location list name;). | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Proximity Targeting | string, list of lists | List of proximity targets each in the format "(Latitude; Longitude; Radius; Unit; FullAddress;);". Latitude is between -90 and 90 degrees (inclusive); Longitude is between -180 and 180 degrees (inclusive); Radius is a distance between 1 and 500 (inclusive) in Unit; Unit can be "mi" or "km"; FullAddress is optional. For example: "(38.907192; -77.03687; 1.0; mi; Washington D.C., DC, USA;); (40.712775; -74.005972; 20.5; km; 40.712775, -74.005972;); (20.000234; -56.675423; 5.0; mi; ;);". | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Proximity Location List Targeting Qa | string, list of lists | List of proximity location lists to include in targeting for insertion orders or Non-TrueView line items, each in the format "(Proximity list name; Radius; Unit;);". Radius is a distance between 1 and 500 (inclusive) in Unit; Unit can be "mi" or "km"; An entity can only target two location lists, including regional location Lists. For example: "(Proximity list 1; 20.0; mi;); (Proximity list 2; 20.5; km;);". This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Language Targeting - Include Qa | string, list | List of languages to include in targeting. List format = (Language name; Language name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Language Targeting - Exclude Qa | string, list | List of languages to exclude in targeting. List format = (Language name; Language name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Device Targeting - Include Qa | string, list | List of devices to include in targeting. List format = (Device name; Device name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Device Targeting - Exclude Qa | string, list | List of devices to exclude in targeting. List format = (Device name; Device name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Browser Targeting - Include Qa | string, list | List of browsers to include in targeting. List format = (Browser name; Browser name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Browser Targeting - Exclude Qa | string, list | List of browsers to exclude in targeting. List format = (Browser name; Browser name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Digital Content Labels - Exclude | string, list | List of the digital content labels to exclude. List format = (G;PG; etc.).
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Brand Safety Sensitivity Setting | string | Choose the sensitivity setting to block inventory based on the subject matter of its surrounding content.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Brand Safety Custom Settings | string, list | If the Brand Safety Sensitivity Setting is 'Use custom', specify the list of standard content classifiers. For example, (Sexual;Alcohol;Tobacco;etc.).
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Third Party Verification Services | string | Third party verification services provider.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Third Party Verification Labels | string, list | If Third Party Verification Services is not "None", specify a list of labels supported by the selected provider. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Channel Targeting - Include Qa | string, list | List of channels to include in targeting. List format = (Channel name; Channel name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Channel Targeting - Exclude Qa | string, list | List of channels to exclude in targeting. List format = (Channel name; Channel name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Site Targeting - Include Qa | string, list | List of sites to include in targeting. The list is strings of URLs. List format = (someurl.com; someurltwo.com; etc.). This list is generated in alphabetical order. If the total character length of the list exceeds 32700 characters, individual URLs in the list will be truncated as needed. Truncated URLs will be no shorter than 10 characters. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Site Targeting - Exclude Qa | string, list | List of sites to exclude in targeting. The list is strings of URLs. List format = (someurl.com; someurltwo.com; etc.). This list is generated in alphabetical order. If the total character length of the list exceeds 32700 characters, individual URLs in the list will be truncated as needed. Truncated URLs will be no shorter than 10 characters. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
App Targeting - Include Qa | string, list | List of apps to include in targeting. The list is concatenated strings of app platform and app platform ID. The following values are used to define the app platform:
The concatenated string of app platform and ID is separated by a colon, for example: List format = (APP:com.google.android.gm; APP:422689480; etc.). This list is generated in ascending alphabetical order. If the total character length of the list exceeds 32700 characters, individual entries in the list will be truncated as needed. Truncated entries will be no shorter than 10 characters. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
App Targeting - Exclude Qa | string, list | List of apps to exclude in targeting. The list is concatenated strings of app platform and app platform ID. The following values are used to define the app platform:
The concatenated string of app platform and ID is separated by a colon, for example: List format = (APP:com.google.android.gm; APP:422689480; etc.). This list is generated in ascending alphabetical order. If the total character length of the list exceeds 32700 characters, individual entries in the list will be truncated as needed. Truncated entries will be no shorter than 10 characters. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
App Collection Targeting - Include Qa | string, list | List of app collections to include in targeting. List format = (App Collection name; App Collection name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
App Collection Targeting - Exclude Qa | string, list | List of app collections to exclude in targeting. List format = (App Collection name; App Collection name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Category Targeting - Include Qa | string, list | List of categories to include in targeting. List format = (Category name; Category name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Category Targeting - Exclude Qa | string, list | List of categories to exclude in targeting. List format = (Category name; Category name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Content Genre Targeting - Include Qa | string, list | List of content genres to include in targeting. List format = (Content genre name; Content genre name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Content Genre Targeting - Exclude Qa | string, list | List of content genres to exclude in targeting. List format = (Content genre name; Content genre name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Keyword Targeting - Include Qa | string, list | List of keyword strings to include in targeting. This list is generated in alphabetical order. If the total character length of the list exceeds 32700 characters, individual entries in the list will be truncated as needed. Truncated entries will be no shorter than 10 characters. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Keyword Targeting - Exclude Qa | string, list | List of keyword strings to exclude in targeting. This list is generated in alphabetical order. If the total character length of the list exceeds 32700 characters, individual entries in the list will be truncated as needed. Truncated entries will be no shorter than 10 characters. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Keyword List Targeting - Exclude Qa | string, list | List of negative keyword lists to exclude in targeting. List format = (Negative keyword list name; Negative keyword list name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Optimized Targeting | string | Enable optimized targeting.
Optimized targeting is not compatible with all bid strategies. This column must be 'FALSE' if:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Audience Targeting - Include Qa | string, list of list of pairs | List of first- and third-party audience lists to include in targeting. For first-party audience lists, each audience is listed as a pair of display name and recency setting. A pair is (Audience name;1d;), where 1d is a sample recency representing 1 day recency. Recency is not available for third-party audiences, so the list format is (Audience name;);(Audience name;);. To "AND" and "OR" groups of audiences, follow this example: To combine pairs with and without recency: '((audience 1 name;1d;);(audience 2 name;365d;));((audience 3 name;);(audience 4 name;5m;);(audience 5 name;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:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Audience Targeting - Exclude Qa | string, list of list of pairs | List of first- and third-party audience lists to exclude in targeting. For first-party audience lists, each audience is listed as a pair of display name and recency setting. A pair is (Audience name;1d;), where 1d is a sample recency representing 1 day recency. Recency is not available for third-party audiences, so the list format is (Audience name;);(Audience name;);. To "AND" and "OR" groups of audiences, follow this example: To combine pairs with and without recency: '((audience 1 name;1d;);(audience 2 name;365d;));((audience 3 name;);(audience 4 name;5m;);(audience 5 name;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:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Affinity & In Market Targeting - Include Qa | string, list | List of affinity and/or in-market audience lists to include. List format = (Audience name; Audience name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Affinity & In Market Targeting - Exclude Qa | string, list | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Combined Audience Targeting Qa | string, list | List of combined audience lists to target. List format = (Audience name; Audience name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Custom List Targeting Qa | string, list | List of custom lists to target. List format = (Custom list name; Custom list name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Inventory Source Targeting - Authorized Seller Options | string | Setting to target authorized direct sellers, authorized direct seller and resellers, or authorized seller + unknown. "Authorized Direct" means only authorized sellers will be targeted. "Authorized Direct Sellers And Resellers" means targeting the authorized sellers and resellers. "Authorized and Non-Participating Publisher" means it will target authorized sellers, resellers, and unknown sellers.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Inventory Source Targeting - Include Qa | string, list | List of inventory sources, exchanges, and sub-exchanges to include in targeting. List format = (Inventory source/Exchange/Sub-exchange name; Inventory source/Exchange/Sub-exchange name; etc.) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Inventory Source Targeting - Exclude Qa | string, list | List of inventory sources, exchanges, and sub-exchanges to exclude in targeting. List format = (Inventory source/Exchange/Sub-exchange name; Inventory source/Exchange/Sub-exchange name; etc.) | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Inventory Source Targeting - Target New Exchanges | string | Setting to target new exchanges.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Private Deal Group Targeting Include Qa | string, list | List of Grouped Deals to include in targeting. List format = (Grouped deal name; Grouped deal name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Daypart Targeting Qa | string, list | List of DayParts to target. Each daypart is constructed in the format "day_of_the_week start_time end_time":
Example list: (Monday 01:20 13:20; Tuesday 09:00 10:00;) This list is generated in ascending time order, starting with Monday. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Daypart Targeting Time Zone | string | Timezone to use for daypart targeting. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Environment Targeting | string, list | List of environments to target. Select one or more of the acceptable values. Please note that 'Web Not Optimized' cannot be selected without selecting 'Web'.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Viewability Omid Targeting Enabled | string | Enables targeting only impressions that are measurable through the open Measurement standard.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Viewability Targeting Active View | string | 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} | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Position Targeting - On Screen | string, list | On screen ad positions targeting. Select one or more of the acceptable values:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Position Targeting - Display Position In Content | string, list | Display ad content positions to target. Select one or more of the acceptable values:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Position Targeting - Video Position In Content | string, list | Video ad content positions to target. Select one or more of the acceptable values:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Position Targeting - Audio Position In Content | string, list | Audio ad content positions to target. Select one or more of the acceptable values:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Video Player Size Targeting | string, list | List of video ad player size to target. Select one or more of the acceptable values:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Content Duration Targeting | string, list | List of content durations to target. Unit value is minutes. Select one or more of the acceptable values:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Content Stream Type Targeting | string, list | List of content stream types to target. Select one or more of the acceptable values:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Audio Content Type Targeting | string, list | List of audio content type to target. Select one or more of the acceptable values:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Demographic Targeting Gender Qa | string, list | Full list of genders being targeted. List format = (Female; Male; Unknown;)
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Demographic Targeting Age Qa | string, list | Full list of ages being targeted. List format = (25-34; 35-44; Unknown;)
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Demographic Targeting Household Income Qa | string, list | Full list of household incomes being targeted. List format = (Top 10%; 11-20%; 21-30%;)
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Demographic Targeting Parental Status Qa | string, list | Full list of parental status being targeted. List format = (Parent;)
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Connection Speed Targeting | string | Target to a specific connection speed. Select one of the acceptable values:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Carrier Targeting - Include Qa | string, list | List of ISPs or Carriers to include in targeting. List format = (Carrier/ISP name; Carrier/ISP name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Carrier Targeting - Exclude Qa | string, list | List of ISPs or Carriers to exclude in targeting. List format = (Carrier/ISP name; Carrier/ISP name; etc.). This list is generated in alphabetical order. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Bid Multipliers | string, list of lists | 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:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Video Ad Formats | string | The video ad format of the line item. In-stream / In-feed Video are TrueView video ad types sold on a CPV basis. In-stream / Bumper are TrueView video ad types sold on a CPM basis. Bumpers are 6-second or less video ads sold on a CPM basis. Non-skippable video ads are in-stream ads between 6 and 15 seconds sold on a CPM basis.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Bid Strategy Type | string | Select one of the applicable TrueView bid strategies:
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Bid Strategy Value | float | For the Target CPA or Target ROAS bid strategy type, choose a value for the target bid. For the other "TrueView Bid Strategy Type" values or non-TrueView line items this column should be 0 when uploading. For Target ROAS, this column should be the percentage as a fraction, e.g., if you want Target ROAS to be 150%, put 1.5 to this column. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Mobile Bid Adjustment Option | string | Either 'Increase' or 'Decrease'
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Mobile Bid Adjustment Percentage | integer | 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%. When TrueView Bid Strategy Type is Target CPA or Maximize Conversions, acceptable adjustments are for Bid Adjustment Option 'Increase': 0; and for 'Decrease': 100%. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Desktop Bid Adjustment Option | string | Either 'Increase' or 'Decrease'
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Desktop Bid Adjustment Percentage | integer | 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%. When TrueView Bid Strategy Type is Target CPA or Maximize Conversions, acceptable adjustments are for Bid Adjustment Option 'Increase': 0; and for 'Decrease': 100%. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Tablet Bid Adjustment Option | string | Either 'Increase' or 'Decrease'
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Tablet Bid Adjustment Percentage | integer | 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%. When TrueView Bid Strategy Type is Target CPA or Maximize Conversions, acceptable adjustments are for Bid Adjustment Option 'Increase': 0; and for 'Decrease': 100%. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Connected TV Bid Adjustment Option | string | Either 'Increase' or 'Decrease'
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Connected TV Bid Adjustment Percentage | integer | Bid adjustment to increase chances of showing ads on connected TVs. Acceptable adjustments are for Bid Adjustment Option 'Increase': [0;900%]; and for 'Decrease': [0;90%] or 100%. When TrueView Bid Strategy Type is Target CPA or Maximize Conversions, acceptable adjustments are for Bid Adjustment Option 'Increase': 0; and for 'Decrease': 100%. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Category Exclusions Targeting | string, list | List of categories to exclude. List format = Embedded Videos; Families; etc.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Content Filter | string | TrueView content filter. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Inventory Source Targeting | string, list | Lists of TrueView inventory sources to include
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Third-Party Viewability Vendor | string, list of lists | Third-party vendor measuring viewability for TrueView line item. If this is left empty during TrueView line item creation and there is a default viewability vendor enabled at the advertiser level, the line item will be created with the advertiser-level default vendor enabled.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Third-Party Viewability Reporting ID | string | ID used by your third-party viewability vendor to identify events for specific reports. An empty string is valid for this column, which sets the reporting ID to empty. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Third-Party Brand Safety Vendor | string, list of lists | Third-party vendor measuring brand safety for TrueView line item. If this is left empty during TrueView line item creation and there is a default brand safety vendor enabled at the advertiser level, the line item will be created with the advertiser-level default vendor enabled.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Third-Party Brand Safety Reporting ID | string | ID used by your third-party brand safety vendor to identify events for specific reports. An empty string is valid for this column, which sets the reporting ID to empty. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Third-Party Reach Vendor | string, list of lists | Third-party vendor measuring reach for TrueView line item. If this is left empty during TrueView line item creation and there is a default reach vendor enabled at the advertiser level, the line item will be created with the advertiser-level default vendor enabled.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Third-Party Reach Reporting ID | string | ID used by your third-party reach vendor to identify events for specific reports. An empty string is valid for this column, which sets the reporting ID to empty. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Third-Party Brand Lift Vendor | string, list of lists | Third-party vendor measuring brand lift for TrueView line item. If this is left empty during TrueView line item creation and there is a default brand lift vendor enabled at the advertiser level, the line item will be created with the advertiser-level default vendor enabled.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Third-Party Brand Lift Reporting ID | string | ID used by your third-party brand lift vendor to identify events for specific reports. An empty string is valid for this column, which sets the reporting ID to empty. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Target Frequency Count | integer | The target frequency count set for a Target Frequency type YouTube line item. This field can only be set with value 2, 3, or 4. For YouTube line items that are not of type Target Frequency, this field should be empty. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TrueView Target Frequency Time Window | string | The target frequency time window for a Target Frequency type YouTube line item. This field can only be set to Weekly for now. For YouTube line items that are not of type Target Frequency, this field should be empty.
|