Structured Data - v9.2 - Line Items

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.

Io Name

No

string

No

Insertion Order Name

Type

Yes

string

Yes

The type of entry.

Only writable when creating, not editing.

Select one of the following values:

• Display
• Video
• TrueView
• Audio
• Demand Gen

Subtype

Yes

string

Yes

Field required for line items to distinguish between different formats.

Select one of the following values:

• Simple
• Non Skippable
• Action
• Reach
• View
• Audio
• Over The Top
• Mobile App Install
• Mobile App Buying
• Simple Over The Top
• Non Skippable Over The Top
• Reach Over The Top
• Target Frequency
• Demand Gen
• Video Sequence

'Action' is not compatible with TrueView line items.
'Video Sequence' is only available for a closed list of Display & Video 360 clients.

Name

Yes

string

Yes

The name of the entry.

Timestamp

Required when editing existing entries

integer

No

The timestamp for the entry.

• For non-Demand Gen line items, this is a "last modified" timestamp used by the system to verify that the entry has not changed between downloading and uploading.
• For Demand Gen line items, this is timestamp of the file generation and is used to verify that the line item was downloaded recently, but does not guarantee that the line item has not been updated since the initial download.

Status

Yes

string

Yes

The status setting for the entry.

• Active
• Paused
• Draft
• Archived

Start Date

Yes

string

Yes

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

Yes

string

Yes

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

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.

TrueView and Demand Gen line items can only be 'Daily' or 'Flight'

Pacing Rate

Yes

string

Yes

The rate of pacing for this entry.

Select one of the following values:

• ASAP
• Even
• Ahead

TrueView and Demand Gen line items can only be 'ASAP' or 'Even'

Pacing Amount

Required when 'Type' is 'Display' or 'Video' or 'Audio'. Required when 'Type' is 'TrueView' or 'Demand Gen' and 'Pacing' is 'Daily'

float

Yes

The amount to spend per the time period set by the pacing type.

Frequency Enabled

Required when 'Subtype' is not 'Demand Gen'

string

Yes

Enables/disables impression-based frequency capping on the line item.

Select one of the following values:

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

Select one of the following values:

• Minutes
• Hours
• Days
• Weeks
• Months

For TrueView and Demand Gen line items, supported periods are Days, Weeks, Months.

Frequency Amount

Required when "Frequency Enabled" is "TRUE"

integer

Yes

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

No

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. Column Partner Revenue Amount should be specified when column Partner Revenue Model is included.

• TMCM - Total Media Cost Markup
• MCM - Media Cost Markup
• CPM - Cost Per thousand impressions

Partner Revenue Amount

Required only when column Partner Revenue Model is specified

float

Yes

A positive float value corresponding to the Partner Revenue Model. Only applicable when column Partner Revenue Model is specified.

Conversion Counting Type

Required when "Type" is "Display" or "Video" or "Audio" or "TrueView"

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" or "TrueView"

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 Floodlight Activity Ids

No

string, list of lists

Yes

The floodlight activities used for conversions and related settings.

This column uses Display & Video 360 API FloodlightActivity resource IDs and measurements, in minutes, of post-view and post-click windows.

List of list format = ((FloodlightActivity.floodlightActivityId; view_window_minutes; click_window_minutes;);(FloodlightActivity.floodlightActivityId; view_window_minutes; click_window_minutes;);).

This field cannot be updated if the 'Algorithm Id' column is set. Attempts to do so will result in an error

Primary Attribution Model Id

No

integer

Yes

The attribution model id used for the associated line item.

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; Display & Video 360 Fee; False) ; (Media; 13; Default; True);'Acceptable values are provided in the following table:

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	Display & Video 360 Fee	Required (True)
Media	Media Cost Data	Not permitted (leave blank)
Media	Scibids Fee	Required (True)

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

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
• REACH

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

Apply Floor Price For Deals

Required when "Bid Strategy Type" is "Minimize" or "Maximize"

string

Yes

Whether to prioritize deals over open auction inventory

• TRUE
• FALSE

Algorithm Id

Required when 'Bid Strategy Unit' custom impr. value/cost

integer

Yes

This corresponding algorithm ID must be used when Bid Strategy Unit is set to custom impr. value/cost.

Any floodlight activies used in the algorithm assigned to this column must be included in the 'Conversion Floodlight Activity Ids' column. Attempts to assign an algorithm without properly updating the 'Conversion Floodlight Activity Ids' column will result in an error.

Creative Assignments

No

string, list

Yes

List of Creative IDs to assigned to the entry.

This column uses Display & Video 360 API Creative resource IDs.

List format = (Creative.creativeId; Creative.creativeId; etc.). This list is generated in ascending numerical order.

On upload, users can also include Campaign Manager 360 Placement IDs . Placement IDs should be preceded by the letters 'CM', ex 'CM789'.

Ex. (123;CM789;).

Contains EU Political Ads

Yes

string

Yes

Whether this line item serves European Union political ads.

If you have declared that this advertiser does not serve EU political ads, new line items will be assigned the 'No' value if the column is not set.

This value can be updated for existing line items using the UI, SDF or API.

• Yes
• No
• Unset

Primary Status

No

string

No

The primary status for the entry.

The following are possible statuses:

• Eligible
• Not eligible
• Paused
• Removed
• Ended
• Limited
• Pending
• Misconfigured

Primary Status Reason

No

string

No

The cause of the current primary status.

• Campaign group paused
• Campaign group all group budgets ended
• Campaign ended
• Campaign paused
• Campaign pending
• Campaign removed
• No ad groups
• Has ads disapproved
• Has ads limited by policy
• No ad group ads
• Most ads under review
• No mobile application ad group criteria
• Bidding strategy learning
• Missing location targeting

Demand Gen Geography And Language Targeting Level

Required when 'Type' is 'Demand Gen'

string

Yes

The level at which location and language targeting are set for Demand Gen campaigns This column shouldn't be set for non-Demand Gen line items. This column is immutable after creation.

• Line Item
• Ad Group

Geography Targeting - Include

No

string, list

Yes

List of geographies to include in targeting.

This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_GEO_REGION .

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.

If the 'Type' column is set to 'Demand Gen', this column is only available if the line item has a geography and language targeting level set to line item in the UI.

Geography Targeting - Exclude

No

string, list

Yes

List of geographies to exclude in targeting.

This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_GEO_REGION .

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.

If the 'Type' column is set to 'Demand Gen', this column is only available if the line item has a geography and language targeting level set to line item in the UI.

Geography Regional Location List Targeting - Include

No

string, list

Yes

List of geo regional location list ids to include. List format = (11; 22; 33;).

Geography Regional Location List Targeting - Exclude

No

string, list

Yes

List of geo regional location list ids to exclude. List format = (11; 22; 33;).

Proximity Targeting

No

string, list of lists

Yes

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; ;);".

If the 'Type' column is set to 'Demand Gen', this column is only available if the line item has a geography and language targeting level set to line item in the UI.

Proximity Location List Targeting

No

string, list of lists

Yes

List of proximity list targets for insertion orders or Non-TrueView line items, each in the format "(ProximityListId; Radius; Unit; );". ProximityListId is a location list id under an advertiser's resources. Radius is a distance between 1 and 500 (inclusive) in Unit; Unit can be "mi" or "km"; There is a limit of targeting two location lists per entity along with Geography Regional Location Lists. For example: "(10041691678; 20.0; mi;); (10038858567; 20.5; km;);".

Language Targeting - Include

No

string, list

Yes

List of languages to include in targeting.

This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_LANGUAGE .

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.

If the 'Type' column is set to 'Demand Gen', this column is only available if the line item has a geography and language targeting level set to line item in the UI.

Language Targeting - Exclude

No

string, list

Yes

List of languages to exclude in targeting.

This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_LANGUAGE .

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.

Not available if 'Type' is 'TrueView' or 'Demand Gen'.

Device Targeting - Include

No

string, list

Yes

List of devices to include in targeting.

This column uses Display & Video 360 API TargetingOption resource IDs for the following targeting types:

• TARGETING_TYPE_DEVICE_TYPE
• TARGETING_TYPE_DEVICE_MAKE_MODEL
• TARGETING_TYPE_OPERATING_SYSTEM

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.

Device Targeting - Exclude

No

string, list

Yes

List of devices to exclude in targeting.

This column uses Display & Video 360 API TargetingOption resource IDs for the following targeting types:

• TARGETING_TYPE_DEVICE_TYPE
• TARGETING_TYPE_DEVICE_MAKE_MODEL
• TARGETING_TYPE_OPERATING_SYSTEM

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.

Browser Targeting - Include

No

string, list

Yes

List of browsers to include in targeting.

This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_BROWSER .

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.

Browser Targeting - Exclude

No

string, list

Yes

List of browsers to exclude in targeting.

This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_BROWSER .

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.

Digital Content Labels - Exclude

No

string, list

Yes

List of the digital content labels to exclude. 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 Campaign Manager 360 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, (Sexual;Alcohol;Tobacco;etc.).

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

This column uses Display & Video 360 API Channel resource IDs.

List format = (Channel.channelId; Channel.channelId; etc.).

Channel Targeting - Exclude

No

string, list

Yes

List of channels to exclude in targeting.

This column uses Display & Video 360 API Channel resource IDs.

List format = (Channel.channelId; Channel.channelId; etc.).

Site Targeting - Include

No

string, list

Yes

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 ascending alphabetical order.

Site Targeting - Exclude

No

string, list

Yes

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 ascending alphabetical order.

App Targeting - Include

No

string, list

Yes

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:

• APP (This encompasses both Android Play store and Apple App store platforms)
• ROKU_APP
• AMAZON_FIRETV_APP
• XBOX_APP
• PLAYSTATION_APP
• APPLE_TV_APP
• SAMSUNG_TV_APP
• ANDROID_TV_APP
• GENERIC_CTV_APP
• LG_TV_APP
• VIZIO_TV_APP

The ID is provided by the relevant platform, such as a bundle ID from Android's Play store (example: com.google.android.gm) or a App ID from Apple's App store (example: 422689480).

The concatenated string of app platform and ID is separated by a colon, for example: APP:com.google.android.gm .

List format = (APP:com.google.android.gm; APP:422689480; etc.). This list is generated in ascending alphabetical order.

App Targeting - Exclude

No

string, list

Yes

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:

• APP (This encompasses both Android Play store and Apple App store platforms)
• ROKU_APP
• AMAZON_FIRETV_APP
• XBOX_APP
• PLAYSTATION_APP
• APPLE_TV_APP
• SAMSUNG_TV_APP
• ANDROID_TV_APP
• GENERIC_CTV_APP
• LG_TV_APP
• VIZIO_TV_APP

The ID is provided by the relevant platform, such as a bundle ID from Android's Play store (example: com.google.android.gm) or a App ID from Apple's App store (example: 422689480).

The concatenated string of app platform and ID is separated by a colon, for example: APP:com.google.android.gm .

List format = (APP:com.google.android.gm; APP:422689480; etc.). This list is generated in ascending alphabetical order.

App Collection Targeting - Include

No

string, list

Yes

List of app collections to include in targeting.

This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_APP_CATEGORY .

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.).

App Collection Targeting - Exclude

No

string, list

Yes

List of app collections to exclude in targeting.

This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_APP_CATEGORY .

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.).

Category Targeting - Include

No

string, list

Yes

List of categories to include in targeting. This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_CATEGORY .

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.

Category Targeting - Exclude

No

string, list

Yes

List of categories to exclude in targeting. This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_CATEGORY .

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.

Content Genre Targeting - Include

No

string, list

Yes

List of content genres to include in targeting.

This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_CONTENT_GENRE

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.

Content Genre Targeting - Exclude

No

string, list

Yes

List of content genres to exclude in targeting.

This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_CONTENT_GENRE

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.

Keyword Targeting - Include

No

string, list

Yes

List of keyword strings to include in targeting.

This list is generated in ascending alphabetical order.

Keyword Targeting - Exclude

No

string, list

Yes

List of keyword strings to exclude in targeting.

This list is generated in ascending alphabetical order.

Keyword List Targeting - Exclude

No

string, list

Yes

List of negative keyword lists to exclude in targeting.

This column uses Display & Video 360 API NegativeKeywordList resource IDs.

List format = (NegativeKeywordList.negativeKeywordListId; NegativeKeywordList.negativeKeywordListId; etc.). This list is generated in ascending numerical order.

Optimize Fixed Bidding

Required when 'Bid Strategy Type' is 'Fixed'

string

Yes

Enables your line item to bid lower than your fixed bid.

This column must be unset or set to 'TRUE' unless 'Bid Strategy Type' is 'Fixed'.

• TRUE
• FALSE

Optimized Targeting

No

string

Yes

Enable optimized targeting.

• TRUE
• FALSE

Optimized targeting is not compatible with all bid strategies. This column must be 'FALSE' if:

• 'Bid Strategy Type' is 'Fixed'
• 'Bid Strategy Type' is 'Optimized vCPM'
• 'Bid Strategy Type' is 'Maximum' and 'Bid Strategy Unit' is 'CIVA', 'IVO_TEN', or 'AV_VIEWED'

Audience Targeting - Include

No

string, list of list of pairs

Yes

List of audience lists to include in targeting.

This column uses Display & Video 360 API FirstPartyAndPartnerAudience resource IDs.

Each audience is listed as a pair of FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId 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 = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; 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

If 'Subtype' is 'Video Sequence', the list will only contain audience IDs with a list format (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; etc.).

Audience Targeting - Exclude

No

string, list of list of pairs

Yes

List of audience lists to exclude in targeting.

This column uses Display & Video 360 API FirstPartyAndPartnerAudience resource IDs.

Each audience is listed as a pair of FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId 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 = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; 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

If 'Subtype' is 'Video Sequence', the list will only contain audience IDs with a list format (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; etc.).

Affinity & In Market Targeting - Include

No

string, list

Yes

List of affinity and/or in-market audience lists to include.

Audience list IDs can be retrieved from the Display & Video 360 interface.

List format = (Audience ID; Audience ID; etc.). This list is generated in ascending numerical order.

Affinity & In Market Targeting - Exclude

No

string, list

Yes

List of affinity and/or in-market audience lists to exclude.

Audience list IDs can be retrieved from the Display & Video 360 interface.

List format = (Audience ID; Audience ID; etc.). This list is generated in ascending numerical order.

Life Event Targeting - Include

No

string, list

Yes

List of life event audience lists to include.

Audience list IDs can be retrieved from the Display & Video 360 interface.

List format = (Audience ID; Audience ID; etc.). This list is generated in ascending numerical order.

Only valid if 'Type' is 'TrueView' or 'Demand Gen'.

Life Event Targeting - Exclude

No

string, list

Yes

List of life event audience lists to exclude.

Audience list IDs can be retrieved from the Display & Video 360 interface.

List format = (Audience ID; Audience ID; etc.). This list is generated in ascending numerical order.

Only valid if 'Type' is 'TrueView' or 'Demand Gen'.

Detailed Demo Targeting - Include

No

string, list

Yes

List of detailed demo audience lists to include.

Audience list IDs can be retrieved from the Display & Video 360 interface.

List format = (Audience ID; Audience ID; etc.). This list is generated in ascending numerical order.

Only valid if 'Type' is 'TrueView' or 'Demand Gen'.

Detailed Demo Targeting - Exclude

No

string, list

Yes

List of detailed demo audience lists to exclude.

Audience list IDs can be retrieved from the Display & Video 360 interface.

List format = (Audience ID; Audience ID; etc.). This list is generated in ascending numerical order.

Only valid if 'Type' is 'TrueView' or 'Demand Gen'.

Combined Audience Targeting

No

string, list

Yes

List of combined audience lists to target.

This column uses Display & Video 360 API CombinedAudience resource IDs.

List format = (CombinedAudience.combinedAudienceId; CombinedAudience.combinedAudienceId; etc.). This list is generated in ascending numerical order.

Custom List Targeting

No

string, list

Yes

List of custom lists to target.

This column uses Display & Video 360 API CustomList resource IDs.

List format = (CustomList.customListId; CustomList.customListId; etc.). This list is generated in ascending numerical order.

Inventory Source Targeting - Authorized Seller Options

Required when "Type" is "Display" or "Video" or "Audio"

string

Yes

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.

• Authorized Direct Sellers
• Authorized Direct Sellers And Resellers
• Authorized and Non-Participating Publisher

Inventory Source Targeting - Include

Required when "Type" is "Display" or "Video" or "Audio"

string, list

Yes

List of inventory sources, exchanges, and sub-exchanges to include in targeting.

This column uses Display & Video 360 API InventorySource resource IDs, published exchange IDs , and Display & Video 360 API TargetingOption resource IDs of targeting type TARGETING_TYPE_SUB_EXCHANGE .

List format = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; etc.)

Inventory Source Targeting - Exclude

No

string, list

Yes

List of inventory sources, exchanges, and sub-exchanges to exclude in targeting.

This column uses Display & Video 360 API InventorySource resource IDs, published exchange IDs , and Display & Video 360 API TargetingOption resource IDs of targeting type TARGETING_TYPE_SUB_EXCHANGE .

List format = (InventorySource.inventorySourceId; exchangeId; TargetingOption.targetingOptionId; etc.)

Inventory Source Targeting - Target New Exchanges

No

string

Yes

Setting to target new exchanges.

• True
• False

Private Deal Group Targeting Include

No

string, list

Yes

List of Deal group IDs to include in targeting. Deal group IDs can be found in the Deal groups section of My Inventory and the Groups section of Inventory Source settings in line items, insertion orders, and campaigns.

List format = (DealGroupId; DealGroupId; etc.). This list is generated in ascending numerical order.

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

Variable limits:

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

This list is generated in ascending numerical order.

Daypart Targeting Time Zone

Required when "Daypart Targeting" is included

string

Yes

Timezone to use for daypart targeting.

Select one of the following values:

• Local
• Advertiser

TrueView and Demand Gen line items can only be 'Advertiser'.

Environment Targeting

No

string, list

Yes

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

• Web
• Web Not Optimized
• App

Viewability Omid Targeting Enabled

No

string

Yes

Enables targeting only impressions that are measurable through the open Measurement standard. If the entity does not support OMID targeting, leave this column empty.

• TRUE
• FALSE

If OMID targeting is enabled at the advertiser level and supported for the entity, this column cannot be set to 'FALSE'. If this column is not set at resource creation for a supported entity, it will default to the advertiser level setting.

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}

Position Targeting - On Screen

No

string, list

Yes

On screen ad positions targeting. Select one or more of the acceptable values:

• Above the fold
• Below the fold
• Unknown

Position Targeting - Display Position In Content

No

string, list

Yes

Display ad content positions to target. Select one or more of the acceptable values:

• In-Article
• In-Feed
• In-Banner
• Interstitial
• Unknown

Position Targeting - Video Position In Content

No

string, list

Yes

Video ad content positions to target. Select one or more of the acceptable values:

• In-Article
• In-Feed
• In-Banner
• Interstitial
• Unknown Out-Stream
• Pre-Roll
• Mid-Roll
• Post-Roll
• Unknown In-Stream

Position Targeting - Audio Position In Content

No

string, list

Yes

Audio ad content positions to target. Select one or more of the acceptable values:

• Pre-Roll
• Mid-Roll
• Post-Roll
• Unknown

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

Content Duration Targeting

No

string, list

Yes

List of content durations to target. Unit value is minutes. Select one or more of the acceptable values:

• 0-1
• 1-5
• 5-15
• 15-30
• 30-60
• 60+
• unknown

Content Stream Type Targeting

No

string, list

Yes

List of content stream types to target. Select one or more of the acceptable values:

• livestream
• on-demand

Audio Content Type Targeting

No

string, list

Yes

List of audio content type to target. Select one or more of the acceptable values:

• unknown
• online radio
• streaming music
• podcasts

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
• +

If 'Subtype' is 'Video Sequence', the column will contain a list of the following age range values:

• 18-24
• 25-34
• 35-44
• 45-54
• 55-64
• 65+
• Unknown

List format = (18-24; 25-34; etc.).

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%

If 'Subtype' is 'Video Sequence', the column will contain a list of the following household income range values:

• Top 10%
• 11-20%
• 21-30%
• 31-40%
• 41-50%
• Lower 50%
• Unknown

List format = (Top 10%; 11-20%; etc.).

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.

This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_CARRIER_AND_ISP .

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.

Carrier Targeting - Exclude

No

string, list

Yes

List of ISPs or Carriers to exclude.

This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_CARRIER_AND_ISP .

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.

Placement Targeting - YouTube Channels - Exclude

No

string, list

Yes

List of YouTube channels to exclude.

List format = (YouTube Channel ID; YouTube Channel ID; etc.).

This column is only available if 'Subtype' is 'Video Sequence'.

Placement Targeting - YouTube Videos - Exclude

No

string, list

Yes

List of YouTube videos to exclude.

List format = (YouTube Video ID; YouTube Video ID; etc.).

This column is only available if 'Subtype' is 'Video Sequence'.

Placement Targeting - Popular Content - Exclude

No

string, list

Yes

List of popular content across YouTube and Google video partners to exclude. Individual content groupings should have the structured 'video_content:: Content Grouping ID '.

List format = (video_content:: Content Grouping ID ; video_content:: Content Grouping ID ; etc.).

This column is only available if 'Subtype' is 'Video Sequence'.

Placement Targeting - URLs - Exclude

No

string, list

Yes

List of URLs to exclude in targeting. The list consists of URL strings.

List format = (someurl.com; someurltwo.com; etc.).

This column is only available if 'Subtype' is 'Video Sequence'.

Placement Targeting - Apps - Exclude

No

string, list

Yes

List of mobile apps to exclude in targeting. The list consists of app platform IDs.

The ID is provided by the relevant platform, such as a bundle ID from Android's Play store (example: com.google.android.gm) or a App ID from Apple's App store (example: 422689480).

List format = (com.google.android.gm; 422689480; etc.).

This column is only available if 'Subtype' is 'Video Sequence'.

Placement Targeting - App Collections - Exclude

No

string, list

Yes

List of app collections to include in targeting.

This column uses Display & Video 360 API TargetingOption resource IDs for targeting type TARGETING_TYPE_APP_CATEGORY .

List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.).

This column is only available if 'Subtype' is 'Video Sequence'.

TrueView Video Ad Formats

Yes for TrueView Line Items

string

Yes

The video ad format of the line item.

Skippable / In-feed Video are TrueView video ad types sold on a CPV basis. Non skippable video ads are in-stream ads between 6 and 15 seconds sold on a CPM basis. Skippable / Bumper / Non-skippable video ads are acceptable TrueView video ad types for line items with a 'Target Frequency' or 'Video Sequence' subtype sold on a CPM basis. Responsive video ads are ad types that serve as multiple formats.

• Skippable
• Skippable / In-feed Video
• Non Skippable
• Skippable / Bumper / Non-skippable
• Responsive

TrueView Bid Strategy Type

Required for TrueView and Demand Gen line items

string

Yes

The bid strategy used by a TrueView or Demand Gen line item.

Select one of the following values:

• Manual CPV: Manual view-based bidding where you pay per view.
• Manual CPM: Manual impression-based bidding where you pay per thousand impressions. This value is not supported for new Trueview or Demand Gen line items.
• Target CPM: Automated bid strategy that optimizes bids to help get as many impressions as possible using a target amount for how much you're willing to pay every thousand times your ad is shown.
• Maximize Conversions: Automated bid strategy that optimizes bids to help get as many conversions as possible.
• Target CPA: Automated bid strategy that optimizes bids to help get as many conversions as possible using a target amount for how much you're willing to pay per conversion.
• Maximize Conversion Value: Automated value-based bidding strategy that optimizes for the higher value conversions.
• Target ROAS: A value-based bidding strategy that optimizes for higher value of a conversion.
• Maximize Clicks: Automated bidding strategy that optimizes bids to maximize clicks based on budget

TrueView Bid Strategy Value

Required for TrueView and Demand Gen line items

float

Yes

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 other line item types, 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

No

string

Yes

The direction in which to adjust bids for display on mobile devices.

• Increase
• Decrease

TrueView Mobile Bid Adjustment Percentage

Required when 'TrueView Bid Strategy Type' is 'Target CPA' or 'Maximize Conversions'

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

When 'TrueView Bid Strategy Type' is 'Target CPA 'or 'Maximize Conversions', or when 'Subtype is 'Demand Gen' or 'Video Sequence', acceptable adjustments are for Bid Adjustment Option 'Increase': 0; and for 'Decrease': 100%.

TrueView Desktop Bid Adjustment Option

No

string

Yes

The direction in which to adjust bids for display on desktop devices.

• Increase
• Decrease

TrueView Desktop Bid Adjustment Percentage

Required when 'TrueView Bid Strategy Type' is 'Target CPA' or 'Maximize Conversions'

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

When 'TrueView Bid Strategy Type' is 'Target CPA 'or 'Maximize Conversions', or when 'Subtype is 'Demand Gen' or 'Video Sequence', acceptable adjustments are for Bid Adjustment Option 'Increase': 0; and for 'Decrease': 100%.

TrueView Tablet Bid Adjustment Option

No

string

Yes

The direction in which to adjust bids for display on tablets.

• Increase
• Decrease

TrueView Tablet Bid Adjustment Percentage

Required when 'TrueView Bid Strategy Type' is 'Target CPA' or 'Maximize Conversions'

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

When 'TrueView Bid Strategy Type' is 'Target CPA 'or 'Maximize Conversions', or when 'Subtype is 'Demand Gen' or 'Video Sequence', acceptable adjustments are for Bid Adjustment Option 'Increase': 0; and for 'Decrease': 100%.

TrueView Connected TV Bid Adjustment Option

No

string

Yes

The direction in which to adjust bids for display on connected TVs.

• Increase
• Decrease

TrueView Connected TV Bid Adjustment Percentage

Required when 'TrueView Bid Strategy Type' is 'Target CPA' or 'Maximize Conversions'

integer

Yes

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', or when 'Subtype is 'Demand Gen' or 'Video Sequence', acceptable adjustments are for Bid Adjustment Option 'Increase': 0; and for 'Decrease': 100%.

TrueView Category Exclusions Targeting

No

string, list

No

List of categories to exclude. List format = Embedded Videos; Families; etc.

• Embedded Videos
• Live Streaming
• Games
• Families

Inventory Mode

No

string

No

TrueView or Demand Gen content filter.

Select one of the following values:

• Limited
• Standard
• Expanded

TrueView Inventory Source Targeting

No

string, list

Yes

Lists of TrueView inventory sources to include

• YouTube
• Google TV
• Video Partners

'Video Partners' must be included for Demand Gen line items.

TrueView Third-Party Viewability Vendor

Required only when updating existing 'TrueView' or 'Demand Gen' line items

string, list of lists

Yes

Third-party vendor measuring viewability for TrueView and Demand Gen line items. If this is left empty during TrueView or Demand Gen 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.

Select one of the following values:

• None
• Moat
• DoubleVerify
• Integral Ad Science

TrueView Third-Party Viewability Reporting ID

Yes when third-party viewability vendor is not 'None'

string

Yes

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

Required only when updating existing TrueView or Demand Gen line items

string, list of lists

Yes

Third-party vendor measuring brand safety for TrueView and Demand Gen line items. If this is left empty during TrueView or Demand Gen 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.

Select one of the following values:

• None
• DoubleVerify
• Integral Ad Science
• Zefr

TrueView Third-Party Brand Safety Reporting ID

Yes when third-party brand safety vendor is not 'None'

string

Yes

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

Required only when updating existing TrueView or Demand Gen line items

string, list of lists

Yes

Third-party vendor measuring reach for TrueView and Demand Gen line items. If this is left empty during TrueView or Demand Gen 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.

Select one of the following values:

• None
• Nielsen
• Comscore
• Kantar
• Gemius
• Video Research
• Media Scope
• Audience Project
• iSpot TV
• VideoAmp

TrueView Third-Party Reach Reporting ID

Yes when third-party reach vendor is not 'None'

string

Yes

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

Required only when updating existing 'TrueView' or 'Demand Gen' line items

string, list of lists

Yes

Third-party vendor measuring brand lift for TrueView and Demand Gen line items. If this is left empty during TrueView or Demand Gen 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.

Select one of the following values:

• None
• Kantar
• Dynata
• Intage
• Nielsen
• Macromill

TrueView Third-Party Brand Lift Reporting ID

Yes when third-party brand lift vendor is not 'None'

string

Yes

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

Yes when the line item subtype is Target Frequency

integer

Yes

The target frequency count set for a Target Frequency type YouTube line item. This field can only be set with different set of values based on the time window. For YouTube line items that are not of type Target Frequency, this field should be empty.

TrueView Target Frequency Time Window

Yes when the line item subtype is Target Frequency

string

Yes

The target frequency time window for a Target Frequency type YouTube line item. This field can be set to Weekly or Monthly for now. For YouTube line items that are not of type Target Frequency, this field should be empty.

• Weekly
• Monthly

TrueView Video Ad Inventory Control

Yes when the line item subtype is Reach

string, list

Yes

The video ad inventory control for Reach or View line items.

Select one or more of the acceptable ad format values:

• In-stream
• In-feed
• Shorts

Merchant Center Account Id

No

integer

Yes

Merchant Center Account Id. Immutable once set.

Only valid if 'Type' is 'TrueView' or 'Demand Gen'.

Related Videos

No

string, list

Yes

List of related YouTube videos. If set, the list must contain 2 to 5 YouTube video IDs.

List format = (YouTube Video ID; YouTube Video ID; etc.).

Only valid if 'Type' is 'TrueView'.

Video Sequence Steps

No

string, list of lists

Yes

A list of values representing the sequence of steps that constitutes a video sequence line item. Each item in the list represents a 'step' in the sequence.

Each step, formatted as "(step_id; previous_step_id; interaction_type; ad_group_type; video_asset_id;)", uses the following fields:

• step_id: the unique ID of the step. If this is a new step, you must use a negative number as a temporary ID, such as -1, -2, etc. Once saved, the system will assign a new ID to this step.
• previous_step_id: the step ID of the previous step in the sequence. Steps connected by 'Skip' and 'Paid View' interactions may have the same previous step, creating a branching sequence.
• interaction_type: the type of interaction that connects the previous step to this step. Accepted values are 'Impression', 'Skip', and 'Paid View'.
• ad_group_type: the ad group type of the step. Accepted values are 'In-stream', 'Bumper', and 'Non skippable'.
• video_asset_id: the asset ID of the step's ad video.

Sequences must follow the following rules:

• The first step of a sequence must have empty 'previous_step_id' and 'interaction_type' values.
• The previous step has to be in front of its next step in the list.
• Leaving the column empty will remove any existing video sequence for the line item on upload.

List format = ((step_id; previous_step_id; interaction_type; ad_group_type; video_asset_id;);(step_id; previous_step_id; interaction_type; ad_group_type; video_asset_id;);)

This column is only available if 'Subtype' is 'Video Sequence'.

Video Sequence Minimum Duration

Required when the line item subtype is 'Video Sequence'

string

Yes

The minimum amount of time required for a user to repeat an ad sequence.

• Week
• Month

Only available for 'Video Sequence' line items.