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. |
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.
|
Max Cost Per View | Yes | float | Yes | Max CPV of the ad group. |
Popular Videos Bid Adjustment | No | integer | Yes | Bid adjustment to increase chances of showing ads on popular videos. Acceptable adjustments are 0-500%. |
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 - 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. |
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 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 Affinity Targeting | No | string, list | Yes | List of custom lists to target. List format= UserList ID; UserList ID; |