Structured Data - v3.1 - YouTube Ad Group

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.

• Active
• Paused
• Deleted

Video Ad Format

Yes

string

Yes

The video ad format of the ad group.

• In-stream
• Video discovery

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:

• Female
• Male
• Unknown

Demographic Targeting Age

Yes

string, list

Yes

List of ages to target. Select one or more of the acceptable values.

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

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

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;