Structured Data - v7 - YouTube Ad Group

    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.
    • Active
    • Paused
    • Deleted
    Video Ad Format
    Yes
    string
    Yes
    The video ad format of the ad group.
    • In-stream
    • In-feed video
    • Bumper
    • Non skippable
    • Responsive
    • Efficient reach
    • YouTube audio
    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, Maximize Conversion Value or Target ROAS, this column must be 0 when uploading.
    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.

    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.

    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:
    • youtube_popular_content::001a1
    • gvp_popular_content::global_tier2
    • video_content::<ID>
    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:
    • 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 Household Income
    Yes
    string, list
    Yes
    List of household incomes to target. Select one or more of the acceptable values.
    • Top 10%
    • 11-20%
    • 21-30%
    • 31-40%
    • 41-50%
    • Lower 50%
    • 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
    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 Expansion Level
    No
    integer
    Yes
    Audience expansion level. It can only be set to AdGroups with value 0, 1, 2, 3.
    Audience Expansion Seed List Excluded
    No
    string
    Yes
    Enable audience expansion seed list excluded.
    • TRUE
    • FALSE
    Audience Targeting - Include
    No
    string, list
    Yes

    List of audience lists to include.

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

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

    Audience Targeting - Exclude
    No
    string, list
    Yes

    List of audience lists to exclude.

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

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

    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.

    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.
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: