v8에서는 광고 파일에 Ad Type 열을 추가하여 각 행으로 표시되는 광고 유형을 표시합니다. 이 새 열은 필수이며 v8 광고 파일을 다운로드할 때 기존 리소스에 채워집니다.
기존 광고를 업데이트할 때는 이 열의 값을 변경하면 안 됩니다.
새 광고를 만들 때는 이 열을 열 설명에 나열된 값 중 하나로 채워야 합니다.
디맨드젠 리소스 로직 업데이트
v8은 광고 항목, 광고 그룹, 광고 파일을 사용하여 디맨드젠 캠페인을 생성, 검색, 업데이트하는 기능을 지원합니다. 수요 생성 리소스는 타임스탬프 확인에 다른 로직을 사용하고, 추가 열을 채워야 하며, 세 가지 파일 유형에 걸쳐 새로운 제한사항이 적용됩니다.
타임스탬프 확인
디맨드젠 캠페인 이외의 모든 광고 항목의 경우 광고 항목 파일의 Timestamp 열은 다운로드 시 광고 항목이 마지막으로 수정된 시간으로 채워집니다. 이 값은 SDF를 사용하여 광고 항목을 업데이트할 때 원본 파일이 다운로드된 이후 광고 항목이 업데이트되지 않았는지 확인하는 데 사용됩니다. 이 경우 업데이트가 실패합니다.
디맨드젠 캠페인 광고 항목의 경우 Timestamp 열과 함께 제공되는 인증이 다르게 작동합니다. 디맨드젠 캠페인 광고 항목 항목의 경우 다운로드 시 현재 시간이 열에 채워집니다. 업로드 시 Display & Video 360은 지정된 타임스탬프 이후 24시간이 지났는지 확인합니다. 24시간이 지났다면 원본 파일 항목이 비활성 상태로 간주되어 업데이트가 실패합니다. 이 경우 파일을 다시 다운로드하고 최신 버전을 기반으로 업데이트합니다. 이 새로운 인증 방법은 지난 24시간 동안 적용된 변경사항을 덮어쓰는 것을 방지하지는 않습니다. 실수로 덮어쓰지 않도록 업로드하는 파일에 업데이트하려는 디맨드젠 캠페인 광고 항목만 포함하세요.
필수 열
다음 파일 형식에는 해당 파일 형식의 모든 항목에 필요한 열 외에도 특정 디맨드젠 리소스에 필요한 열이 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eThis guide explains how to migrate from Structured Data Files v7.1 to v8, outlining key changes and impacts on integration.\u003c/p\u003e\n"],["\u003cp\u003eMigrating involves updating resource and SDF generation actions to v8, adding Ad resource type identification logic, and implementing Demand Gen resource handling.\u003c/p\u003e\n"],["\u003cp\u003eYou can set the default SDF version at the partner and advertiser level through the interface or API, and individual download tasks need version specification in API requests.\u003c/p\u003e\n"],["\u003cp\u003eVersion 8 introduces an \u003ccode\u003eAd Type\u003c/code\u003e column for Ads, requiring it to be populated when creating new ads and preventing changes to existing ads.\u003c/p\u003e\n"],["\u003cp\u003eDemand Gen resources in v8 have specific logic for timestamp verification, require additional columns in Line Item and Ad files, and have new restrictions detailed in the v8 reference documentation.\u003c/p\u003e\n"]]],[],null,["# Migrate to Structured Data Files v8\n\n*Last update: 2024-11-12*\n\nThis guide leads you through the process of migrating from using Structured Data\nFiles v7.1 to v8 and explains the changes between the two versions that may\nimpact your integration.\n\nSee the [release notes](/display-video/api/structured-data-file/rel-notes#version_8_beta) for an exhaustive list of differences\nbetween v7.1 and v8.\n\nMigrate your Structured Data Files version\n------------------------------------------\n\nTo migrate to Structured Data Files (SDFs) v8 from a previous version:\n\n1. Update your resources and SDF generation actions to use v8.\n2. Update Ad resource logic to identify a type upon creation.\n3. Add new logic for reading, creating, and updating Demand Gen resources.\n\n### Update Structured Data Files version\n\nTo use a new Structured Data Files version, update the assigned version in your\nparent Partner and Advertiser resources and use the new version when creating\nindividual download tasks in the [Display \\& Video 360 API](/display-video/api).\n\n#### Update parent resource settings\n\nA default Structured Data Files version is set at the partner and advertiser\nresource level. This version is used as the default when downloading Structured\nData Files through the interface or API.\n\n##### Set in the interface\n\n**At the partner level**\n\n1. Navigate to the intended partner.\n2. Expand the **Partner settings** menu in the left-hand navigation and navigate to the **Basic details** page.\n3. Update the **SDF version** configuration in the **Structured Data Files** section to **v8**.\n\n**At the advertiser level**\n\n1. Navigate to the intended advertiser.\n2. Expand the **Advertiser settings** menu in the left-hand navigation and navigate to the **Basic details** page.\n3. Update the **SDF version** configuration in the **Structured Data Files** section to **v8**. If the default version is set at the Partner level, this setting may not be editable.\n\n##### Set in the API\n\nAt the partner level\n: You cannot set the default SDF version at the Partner level in the API.\n\nAt the advertiser level\n: Make an [`advertisers.patch`](/display-video/api/reference/rest/current/advertisers/patch) request to update the\n [`dataAccessConfig.sdfConfig.sdfConfig.version`](/display-video/api/reference/rest/current/SdfConfig#FIELDS.version) to\n `SDF_VERSION_8` and, if needed,\n [`dataAccessConfig.sdfConfig.overridePartnerSdfConfig`](/display-video/api/reference/rest/current/advertisers#AdvertiserSdfConfig.FIELDS.override_partner_sdf_config)\n to `True`.\n\n#### Update `sdfdownloadtasks.create` requests in the API\n\nWhen making a [`sdfdownloadtasks.create`](/display-video/api/reference/rest/current/sdfdownloadtasks/create) request using the\nDisplay \\& Video 360 API, set the [`version`](/display-video/api/reference/rest/current/sdfdownloadtasks/create#body.request_body.FIELDS.version) field of the\nrequest body to `SDF_VERSION_8`.\n\n### Specify type in Ad resources\n\nv8 adds an `Ad Type` column to [Ad](/display-video/api/structured-data-file/v8/AdGroupAd) files, which surfaces the type of\nAd represented by each row. This new column is required and will be populated\nfor existing resources when downloading v8 Ad files.\n\nWhen updating existing Ads, the value of this column shouldn't be changed.\n\nWhen creating new Ads, you must populate this column with one of the values\nlisted in the column description.\n\n### Update logic for Demand Gen resources\n\nv8 supports the creation, retrieval, and updating of Demand Gen campaigns using\n[Line Item](/display-video/api/structured-data-file/v8/LineItem), [Ad Group](/display-video/api/structured-data-file/v8/AdGroup), and [Ad](/display-video/api/structured-data-file/v8/AdGroupAd) files. Demand\nGen resources use different logic for timestamp verification, require the\npopulation of additional columns, and are limited by new restrictions across the\nthree file types.\n\n#### Timestamp verification\n\nFor all non-Demand-Gen line items, the `Timestamp` column of a [Line\nItem](/display-video/api/structured-data-file/v8/LineItem) file is populated at download with the last time a line item\nwas modified. This value is used when updating a line item using SDF to verify\nthat a line item has not been updated since the original file was downloaded. If\nso, the update fails.\n\nFor Demand Gen line items, the `Timestamp` column and the accompanying\nverification works differently. For Demand Gen line item entries, the column is\npopulated with the current time at download. On upload, Display \\& Video 360\nchecks if it has been more than 24 hours since the given timestamp. If it has\nbeen more than 24 hours, the original file entry is considered stale and the\nupdate fails. If this happens, download the file again and make your updates\nbased on the more recent version. *This new verification method does not prevent\nyou from overwriting changes made in the last 24 hours. To avoid accidental\noverwrites, only include Demand Gen line items that you want to update in files\nthat you upload.*\n\n#### Required columns\n\nThe following file types have columns that are now required for certain Demand\nGen resources, in addition to the columns that are required for all entities of\nthat file type.\n| **Note:** Other columns not listed here may be required when *updating* Demand Gen resources. See the v8 reference documentation for [Line Item](/display-video/api/structured-data-file/v8/LineItem), [Ad\n| Group](/display-video/api/structured-data-file/v8/AdGroup), and [Ad](/display-video/api/structured-data-file/v8/AdGroupAd) file types for an exhaustive list of requirements for each column.\n\n##### Line Item\n\n| Required columns for the following [Line Item](/display-video/api/structured-data-file/v8/LineItem) `Type` column values ||\n|------------|-----------------------------------------------------------------------------------------------------------------------------------------|\n| Demand Gen | |-------------------------------| | `Pacing Amount` | | `TrueView Bid Strategy Type` | | `TrueView Bid Strategy Value` | |\n\n##### Ad\n\n| Required columns for the following [Ad](/display-video/api/structured-data-file/v8/AdGroupAd) `Ad Type` column values ||\n|---------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Demand Gen Carousel | |--------------------------| | `Business Name` | | `Call to Action` | | `Demand Gen Cards` | | `Description 1` | | `Headline` | | `In-feed Video Headline` | | `Landing Page URL` | | `Logo Asset IDs` | |\n| Demand Gen Image | |----------------------------| | `Business Name` | | `Call to Action` | | `Description 1` | | `Headline` | | `In-feed Video Headline` | | `Landing Page URL` | | `Logo Asset IDs` | | `Marketing Image Asset Id` | |\n| Demand Gen Product | |--------------------------| | `Business Name` | | `Description 1` | | `Headline` | | `In-feed Video Headline` | | `Landing Page URL` | | `Logo Asset IDs` | |\n| Demand Gen Video | |--------------------------| | `Business Name` | | `Call to Action` | | `Description 1` | | `Headline` | | `In-feed Video Headline` | | `Landing Page URL` | | `Logo Asset IDs` | | `Video Id` | |\n\n#### Updated restrictions\n\nIn addition to the new required columns for certain Demand Gen Line Items and\nAds, multiple columns across [Line Item](/display-video/api/structured-data-file/v8/LineItem), [Ad Group](/display-video/api/structured-data-file/v8/AdGroup), and\n[Ad](/display-video/api/structured-data-file/v8/AdGroupAd) file types have new use restrictions that apply to Demand Gen\nresources.\n\nThese restrictions are numerous and specific to the columns in question, so this\nguide doesn't provide an exhaustive list of restrictions. We recommend that you\nclosely read the v8 reference documentation for [Line Item](/display-video/api/structured-data-file/v8/LineItem), [Ad\nGroup](/display-video/api/structured-data-file/v8/AdGroup), and [Ad](/display-video/api/structured-data-file/v8/AdGroupAd) file types before creating or updating\nDemand Gen resources using SDF upload."]]
