See the overview for an explanation of format.
Field | Required | Type | Writable | Description |
---|---|---|---|---|
Ad Group Id | Required only when editing existing Ad Groups | integer | No | Numeric ID value of the ad group. If left blank, a new Ad Group ID will be created and a unique ID will be assigned. Optionally, when creating new Ad Groups, you can use a custom identifier for the purpose of assigning TrueView Ads to the new Ad Group. 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 to Ad Group) based on the custom identifiers. |
Line Item Id | Yes | integer | No | Numeric ID value of the parent line item. You can specify a custom identifier (for example, "ext[custom line item ID]") for a line item that you are creating at the same time as this Ad Group. |
Line Item Name | No | string | No | Line Item Name |
Name | Yes | string | Yes | The name of the entry. |
Status | Yes | string | Yes | The status setting for the entry.
|
Video Ad Format | Yes | string | Yes | The video ad format of the ad group.
|
Bid Cost | Yes | float | Yes | The value representing the maximum target bid cost for the ad group based on the bid type set in the TrueView Bid Strategy Type column. For example, if the TrueView Bid Strategy Type is Manual CPV, it is the maximum cost-per-view. Note: If the column TrueView Bid Strategy Type is Maximize Conversions, this column must be 0 when uploading. |
Popular Videos Bid Adjustment | No | integer | Yes | Bid adjustment to increase chances of showing ads on popular videos. Acceptable adjustments: 0% for bidding strategy types Maximize Conversions or Target CPA; 0-500% otherwise. |
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. |
Category Targeting - Include | No | string, list | Yes | List of categories to include in targeting, from AdX vertical IDs. List format = (Verticals.Id;Verticals.Id;etc.). |
Category Targeting - Exclude | No | string, list | Yes | List of categories to exclude in targeting, from AdX vertical IDs. List format = (Verticals.Id;Verticals.Id;etc.). |
Placement Targeting - YouTube Channels - Include | No | string, list | Yes | List of YouTube channels to include. |
Placement Targeting - YouTube Channels - Exclude | No | string, list | Yes | List of YouTube channels to exclude. |
Placement Targeting - YouTube Videos - Include | No | string, list | Yes | List of YouTube videos to include. |
Placement Targeting - YouTube Videos - Exclude | No | string, list | Yes | List of YouTube videos to exclude. |
Placement Targeting - Popular Content - Include | No | string, list | Yes | List of popular content across YouTube and Google video partners to include. Select one or more of the acceptable values:
|
Placement Targeting - URLs - Include | No | string, list | Yes | List of URLs to include. |
Placement Targeting - URLs - Exclude | No | string, list | Yes | List of URLs to exclude. |
Placement Targeting - Apps - Include | No | string, list | Yes | List of mobile apps to include. |
Placement Targeting - Apps - Exclude | No | string, list | Yes | List of mobile apps to exclude. |
Placement Targeting - App Collections - Include | No | string, list | Yes | List of app collections to include in targeting. List format= App Collection ID; App Collection ID; |
Placement Targeting - App Collections - Exclude | No | string, list | Yes | List of app collections to exclude in targeting. List format= App Collection ID; App Collection ID; |
Demographic Targeting Gender | Yes | string, list | Yes | List of genders to target. Select one or more of the acceptable values:
|
Demographic Targeting Age | Yes | string, list | Yes | List of ages to target. Select one or more of the acceptable values.
|
Demographic Targeting Household Income | Yes | string, list | Yes | List of household incomes to target. Select one or more of the acceptable values.
|
Demographic Targeting Parental Status | Yes | string, list | Yes | List of parental status to target. Select one or more of the acceptable values.
|
Audience Targeting - Include | No | string, list | Yes | List of audience lists to include. List format= UserList ID; UserList ID; |
Audience Targeting - Exclude | No | string, list | Yes | List of audience lists to exclude. List format= UserList ID; UserList ID; |
Affinity & In Market Targeting - Include | No | string, list | Yes | List of affinity and/or in-market audience lists to include. List format= UserList ID; UserList ID; |
Affinity & In Market Targeting - Exclude | No | string, list | Yes | List of affinity and/or in-market audience lists to exclude. List format= UserList ID; UserList ID; |
Custom List Targeting | No | string, list | Yes | List of custom lists to target. List format= UserList ID; UserList ID; |