AI-generated Key Takeaways
-
This documented SDF version is outdated and no longer supported for new file creation.
-
Users must transition to SDF v7 to utilize structured data files for Display & Video 360.
-
This documentation remains relevant solely for understanding previously generated files using the sunsetted SDF version.
-
The documentation outlines the required fields and their properties for constructing structured data files for Display & Video 360, encompassing various ad formats like In-stream, Bumper, and In-feed Video.
-
To manage existing ads or create new ones, consult the specifications detailed in the field descriptions, such as Ad Id, Ad Group Id, Status, and format-specific parameters.
See the overview for an explanation of format.
| Field | Required | Type | Writable | Description |
|---|---|---|---|---|
| Ad Id | Required only when editing existing Ads | integer | No | Numeric ID value of the ad group ad. If left blank a new Ad will be created and a unique ID will be assigned. |
| Ad Group Id | Yes | integer | No | Numeric ID value of the parent ad group. You can specify a custom identifier (for example, "ext[custom ad group ID]") for an Ad Group that you are creating at the same time as this Ad. |
| Ad Group Name | No | string | No | Ad Group Name |
| Name | Yes | string | Yes | The name of the entry. |
| Status | Yes | string | Yes | The status setting for the entry.
|
| Video Id | Yes | string | Yes | The YouTube video ID |
| Display URL | Yes for In-stream and Bumper | string | Yes | The ad display URL |
| Landing Page URL | Yes for In-stream and Bumper | string | Yes | The ad landing page URL |
| DCM Tracking - Placement Id | Required only when updating DCM Tracking Ad | integer | Yes | Numeric ID value of DCM placement for the corresponding tracking ad. To remove a DCM Tracking Ad, leave the three columns DCM Tracking - Placement ID, DCM Tracking - Ad ID and DCM Tracking - Creative ID blank. |
| DCM Tracking - Ad Id | Required only when updating DCM Tracking Ad | integer | Yes | Numeric ID value of DCM Ad for the corresponding tracking ad.To remove a DCM Tracking Ad, leave the three columns DCM Tracking - Placement ID, DCM Tracking - Ad ID and DCM Tracking - Creative ID blank. |
| DCM Tracking - Creative Id | Required only when updating DCM Tracking Ad | integer | Yes | Numeric ID value of the creative for the corresponding tracking ad.To remove a DCM Tracking Ad, leave the three columns DCM Tracking - Placement ID, DCM Tracking - Ad ID and DCM Tracking - Creative ID blank. |
| Click Tracker URL | No | string | Yes | The ad click tracker URL |
| In-stream Custom Parameters | No | string, list of lists | Yes | The click tracker URL custom parameters. Format = (name1; value1;); (name2; value2;); etc. |
| Action Button Label | Yes if the parent line item is a TrueView for action line item or column Action Headline is not empty | string | Yes | Label for the Call to Action button (1 line with up to 10 characters). |
| Action Headline | No | string | Yes | Headline for the Call to Action overlay (1 line with up to 15 characters). |
| Responsive Ad Display Url Path 1 | No | string | Yes | The responsive ad display url path 1 |
| Responsive Ad Display Url Path 2 | No | string | Yes | The responsive ad display url path 2 |
| In-feed Video Thumbnail | Yes for In-feed Video | string | Yes | The video thumbnail to use for video discovery ads
|
| In-feed Video Headline | Yes for In-feed Video | string | Yes | The headline text for a discovery or responsive ad |
| In-feed Video Description 1 | Yes for In-feed Video | string | Yes | The discovery ad description 1 text or responsive ad description |
| In-feed Video Description 2 | Yes for In-feed Video | string | Yes | The discovery ad description 2 text |
| In-feed Video Landing Page | Yes for In-feed Video | string | Yes | The discovery ad landing page |