You might have to migrate to v9 to upload Structured Data Files afterSeptember 8, 2025. See ourdeprecations pagefor more details and ourv9 migration guidefor step-by-step instructions.
The start date of the media product in the format MM/DD/YYYY HH:mm
End Date
No
string
No
The end date of the media product in the format MM/DD/YYYY HH:mm
Budget
No
float
No
A positive budget amount for the media product. It is always a float for a currency amount since it will be always monetary budget. Currencies will be shown in the advertiser's currency in standard units (not in 1/1,000,000s of a currency unit)
Frequency Enabled
Yes
string
Yes
Frequency Exposures
Required when "Frequency Enabled" is "TRUE"
integer
Yes
A positive integer amount for the number of impressions in a given Frequency Amount, that is, the x in 'Show x impressions over y period'.
Frequency Period
Required when "Frequency Enabled" is "TRUE"
string
Yes
Minutes
Hours
Days
Weeks
Months
Lifetime
Frequency Amount
Required when "Frequency Enabled" is "TRUE"
integer
Yes
Geography Targeting - Include
No
string, list
Yes
List of geographies to include in targeting.
This column uses Display & Video 360 APITargetingOptionresource IDs for targeting typeTARGETING_TYPE_GEO_REGION.
List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.
Language Targeting - Include
No
string, list
Yes
List of languages to include in targeting.
This column uses Display & Video 360 APITargetingOptionresource IDs for targeting typeTARGETING_TYPE_LANGUAGE.
List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.
Language Targeting - Exclude
No
string, list
Yes
List of languages to exclude in targeting.
This column uses Display & Video 360 APITargetingOptionresource IDs for targeting typeTARGETING_TYPE_LANGUAGE.
List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.
Channel Targeting - Include
No
string, list
Yes
List of channels to include in targeting.
This column uses Display & Video 360 APIChannelresource IDs.
List format = (Channel.channelId; Channel.channelId; etc.).
Channel Targeting - Exclude
No
string, list
Yes
List of channels to exclude in targeting.
This column uses Display & Video 360 APIChannelresource IDs.
List format = (Channel.channelId; Channel.channelId; etc.).
Category Targeting - Include
No
string, list
Yes
List of categories to include in targeting. This column uses Display & Video 360 APITargetingOptionresource IDs for targeting typeTARGETING_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 APITargetingOptionresource IDs for targeting typeTARGETING_TYPE_CATEGORY.
List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.
For first-party audience lists, each audience is listed as a pair of FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId and recency setting. A pair is (1;1d;), where 1d is a sample recency representing 1 day recency. Recency is not available for third-party audiences, so the list format is (3;);(4;);. To "AND" and "OR" groups of audiences, follow this example: To combine pairs with and without recency: '((1;1d;);(2;365d;));((3;);(4;5m;);(5;all;));'. This means (list 1 with 1 day recency OR list 2 with 365day recency ) AND (list 3 without a specified recency OR list 4 with 5 minute recency OR list 5 with all users).
Each audience is listed as a pair of FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId and recency setting, if the audience list is a 1P audience list. A pair is (1;1d;), where 1d is a sample recency representing 1 day recency. However, for 3P audiences, recency is not available, so the list format is (3;);(4;);.
List format = ((FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;); (FirstPartyAndPartnerAudience.firstPartyAndPartnerAudienceId; recency optional;);)Example: "(1;1d;);(2;);".
Valid recency values are:
all
1m
5m
10m
15m
30m
1h
2h
3h
6h
12h
1d
2d
3d
5d
7d
10d
14d
15d
21d
28d
30d
45d
60d
90d
120d
180d
270d
365d
Affinity & In Market Targeting - Include
No
string, list
Yes
Affinity & In Market Targeting - Exclude
No
string, list
Yes
Demographic Targeting Gender
No
string, list
Yes
List of genders to target. Select one or more of the acceptable values:
Female
Male
Unknown
Demographic Targeting Age
No
string, list
Yes
Target to a user age range. Specify a from/to range by selecting a single From age and a single To age and whether to include unknown ages true/false. See the list of acceptable From/To ages. Example 1: to target 18-55 and include unknown ages, specify the format {From; To ; Include unknown True/False} = 18;55;true; Example 2: to target only users >35 years old and exclude unknown ages, specify the following = 35;+;false;. Acceptable values for From:
18
25
35
45
55
65
Acceptable values for To:
25
35
45
55
65
+
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
Device Targeting - Include
No
string, list
Yes
List of devices to include in targeting.
This column uses Display & Video 360 APITargetingOptionresource IDs for the following targeting types:
TARGETING_TYPE_DEVICE_TYPE
TARGETING_TYPE_DEVICE_MAKE_MODEL
TARGETING_TYPE_OPERATING_SYSTEM
List format = (TargetingOption.targetingOptionId; TargetingOption.targetingOptionId; etc.). This list is generated in ascending numerical order.
Video Player Size Targeting
No
string, list
Yes
List of video ad player size to target. Select one or more of the acceptable values:
unknown
small
large
HD
Private - Seller Name
No
string
No
The publisher's name in a deal. This field only applies to private media products.
Private - Order Id
No
string
No
The order id of a guaranteed deal. This field only applies to private media products.
Private - Inventory Source Id
No
string
No
The DBM id of the inventory source. This field only applies to private media products.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-21 UTC."],[[["\u003cp\u003eThis is a beta version of the Structured Data File (SDF) format, SDF v8, and is subject to unannounced changes.\u003c/p\u003e\n"],["\u003cp\u003eSDF v8 introduces support for Demand Gen resources, also in beta and limited to enrolled users.\u003c/p\u003e\n"],["\u003cp\u003eThe SDF format outlines the structure and fields required for defining media products, including targeting options like geography, language, audiences, and demographics.\u003c/p\u003e\n"],["\u003cp\u003eFrequency capping can be enabled by specifying the desired number of impressions (Frequency Exposures) within a given timeframe (Frequency Period and Frequency Amount).\u003c/p\u003e\n"],["\u003cp\u003ePrivate media products require specific fields like Seller Name, Order Id, and Inventory Source Id for deals and inventory identification.\u003c/p\u003e\n"]]],["This document details the structure for media product data, outlining required and optional fields. Key actions involve defining media product entries by specifying a *Name* (required), *Type*, *Start/End Date*, and *Budget*. Frequency-related settings, such as *Frequency Enabled*, *Exposures*, *Period*, and *Amount* are necessary when frequency is enabled. Targeting options, including *Geography, Language, Channel, Category, Audience, Affinity*, *Demographics,* and *Device*, are also configurable. For private media, *Seller Name, Order Id*, and *Inventory Source Id* are used.\n"],null,[]]
