Structured Data - v7.1 - YouTube Ad Group QA

    • This version of the SDF is deprecated and users should migrate to SDF v9 before March 3, 2026.

    • This is a read-only QA file format and cannot be uploaded.

    • The file provides details on various targeting options including keywords, categories, placements, demographics, and audiences.

    • Fields such as Bid Cost and Optimized Targeting have specific constraints based on bid strategy types.

    See the overview for an explanation of format.

    This is a QA file format . Files in this format are read-only and cannot be uploaded.

    Field
    Type
    Description
    Ad Group Id
    integer
    Line Item Id
    integer
    Line Item Name
    string
    Line Item Name
    Name
    string
    The name of the entry.
    Status
    string
    The status setting for the entry.
    • Active
    • Paused
    • Archived
    • Deleted
    • Draft
    Video Ad Format
    string
    The video ad format of the ad group.
    • In-stream
    • In-feed video
    • Bumper
    • Non skippable
    • Responsive
    • Efficient reach
    • YouTube audio
    Bid Cost
    float
    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 Qa
    string, list

    List of keyword strings to include in targeting. This list is generated in alphabetical order.

    If the total character length of the list exceeds 32700 characters, individual entries in the list will be truncated as needed. Truncated entries will be no shorter than 10 characters.

    Keyword Targeting - Exclude Qa
    string, list

    List of keyword strings to exclude in targeting. This list is generated in alphabetical order.

    If the total character length of the list exceeds 32700 characters, individual entries in the list will be truncated as needed. Truncated entries will be no shorter than 10 characters.

    Category Targeting - Include Qa
    string, list
    List of categories to include in targeting. List format = (Category name; Category name; etc.). This list is generated in alphabetical order.
    Category Targeting - Exclude Qa
    string, list
    List of categories to exclude in targeting. List format = (Category name; Category name; etc.). This list is generated in alphabetical order.
    Placement Targeting - YouTube Channels - Include Qa
    string, list
    List of YouTube channels to include. List format = (YouTube channel name; YouTube channel name; etc.). This list is generated in alphabetical order.
    Placement Targeting - YouTube Channels - Exclude Qa
    string, list
    List of YouTube channels to exclude. List format = (YouTube channel name; YouTube channel name; etc.). This list is generated in alphabetical order.
    Placement Targeting - YouTube Videos - Include Qa
    string, list
    List of YouTube videos to include. List format = (YouTube video name; YouTube video name; etc.). This list is generated in alphabetical order.
    Placement Targeting - YouTube Videos - Exclude Qa
    string, list
    List of YouTube videos to exclude. List format = (YouTube video name; YouTube video name; etc.). This list is generated in alphabetical order.
    Placement Targeting - Popular Content - Include
    string, list
    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
    string, list

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

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

    Placement Targeting - URLs - Exclude
    string, list

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

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

    Placement Targeting - Apps - Include
    string, list

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

    Placement Targeting - Apps - Exclude
    string, list

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

    Placement Targeting - App Collections - Include Qa
    string, list
    List of app collections to include in targeting. List format = (App collection name; App collection name; etc.). This list is generated in alphabetical order.
    Placement Targeting - App Collections - Exclude Qa
    string, list
    List of app collections to exclude in targeting. List format = (App collection name; App collection name; etc.). This list is generated in alphabetical order.
    Demographic Targeting Gender
    string, list
    List of genders to target. Select one or more of the acceptable values:
    • Female
    • Male
    • Unknown
    Demographic Targeting Age
    string, list

    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
    string, list

    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
    string, list

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

    • Parent
    • Not a parent
    • Unknown
    Optimized Targeting
    string
    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
    integer
    Audience expansion level. It can only be set to AdGroups with value 0, 1, 2, 3.
    Audience Expansion Seed List Excluded
    string
    Enable audience expansion seed list excluded.
    • TRUE
    • FALSE
    Audience Targeting - Include Qa
    string, list

    List of first- and third-party audience lists to include in targeting.

    List format = (Audience name; Audience name; etc.). This list is generated in alphabetical order.

    Audience Targeting - Exclude Qa
    string, list

    List of first- and third-party audience lists to exclude in targeting.

    List format = (Audience name; Audience name; etc.). This list is generated in alphabetical order.

    Affinity & In Market Targeting - Include Qa
    string, list
    List of affinity and/or in-market audience lists to include. List format = (Audience name; Audience name; etc.). This list is generated in alphabetical order.
    Affinity & In Market Targeting - Exclude Qa
    string, list
    Custom List Targeting Qa
    string, list
    List of custom lists to target. List format = (Custom list name; Custom list name; etc.). This list is generated in alphabetical order.
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: