[null,null,["最后更新时间 (UTC):2025-07-25。"],[[["\u003cp\u003eThis version of the Structured Data File (SDF) is no longer supported, and users should transition to SDF v7 to continue using structured data files.\u003c/p\u003e\n"],["\u003cp\u003eThis documentation is only relevant for previously-generated files and should not be used for new file creation.\u003c/p\u003e\n"],["\u003cp\u003eThe documentation provides a table outlining the fields required for defining Ads within an SDF file, including their descriptions, data types, and whether they are required or writable.\u003c/p\u003e\n"],["\u003cp\u003eSpecific fields and requirements may vary depending on the Ad type, such as In-stream, Bumper, Video Discovery, or Mobile App Install.\u003c/p\u003e\n"],["\u003cp\u003eUsers can manage existing Ads by specifying an Ad ID or create new Ads, which will be automatically assigned unique IDs.\u003c/p\u003e\n"]]],["This SDF version is deprecated; users must migrate to SDF v7. The file format includes fields for ad management, such as `Ad Id`, `Ad Group Id`, `Name`, and `Status`. Video ads require `Video Id`, `Display URL`, and `Landing Page URL`. DCM tracking data includes `Placement Id`, `Ad Id`, and `Creative Id`. Additional fields manage video discovery and mobile app install ads with respective `Video Thumbnail`, `Headline`, `Description`, and `Mobile App Id` fields.\n"],null,["# Structured Data - v4 - YouTube Ad\n\n| This SDF version has been sunset. Users should migrate to SDF [v7.1](/display-video/api/structured-data-file/v7-1/Campaign) in order to continue using structured data files. Only use this documentation when referring to previously-generated files.\n\nSee the [overview](/display-video/api/structured-data-file/format) for an explanation of format.\n\n| Field | Required | Type | Writable | Description |\n|---------------------------------|---------------------------------------------|-----------------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 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. |\n| 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. |\n| Name | Yes | string | Yes | The name of the entry. |\n| Status | Yes | string | Yes | The status setting for the entry. - Active - Paused - Deleted |\n| Video Id | Yes | string | Yes | The YouTube video ID |\n| Display URL | Yes for In-stream and Bumper | string | Yes | The ad display URL |\n| Landing Page URL | Yes for In-stream and Bumper | string | Yes | The ad landing page URL |\n| 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. |\n| 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. |\n| 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. |\n| Click Tracker URL | No | string | Yes | The ad click tracker URL |\n| In-stream Custom Parameters | No | string, list of lists | Yes | The click tracker URL custom parameters. Format = (name1; value1;); (name2; value2;); etc. |\n| Video Discovery Video Thumbnail | Yes for Video Discovery | string | Yes | The video thumbnail to use for video discovery ads - 0 - 1 - 2 - 3 |\n| Video Discovery Headline | Yes for Video Discovery | string | Yes | The discovery ad headline text |\n| Video Discovery Description 1 | Yes for Video Discovery | string | Yes | The discovery ad description 1 text |\n| Video Discovery Description 2 | Yes for Video Discovery | string | Yes | The discovery ad description 2 text |\n| Video Discovery Landing Page | Yes for Video Discovery | string | Yes | The discovery ad landing page |\n| Mobile App Id | Yes for Mobile App Install subtype | string | Yes | The mobile app used for mobile app install ads. Format:com.google.android.gm or 422689480 |"]]