Bạn có thể phải di chuyển sang phiên bản 9 để tải Tệp dữ liệu có cấu trúc lên sau ngày 8 tháng 9 năm 2025. Hãy xem trang ngừng sử dụng của chúng tôi để biết thêm thông tin chi tiết và hướng dẫn di chuyển sang phiên bản 9 để biết hướng dẫn từng bước.
Di chuyển sang Tệp dữ liệu có cấu trúc phiên bản 9
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Lần cập nhật gần đây nhất: ngày 21 tháng 8 năm 2025
Hướng dẫn này sẽ hướng dẫn bạn thực hiện các quy trình sau:
Cập nhật phiên bản Tệp dữ liệu có cấu trúc đã chọn thành phiên bản 9 bằng cách sử dụng giao diện người dùng hoặc API Display & Video 360.
Di chuyển chế độ tích hợp của bạn từ các phiên bản Tệp dữ liệu có cấu trúc không dùng nữa (v7, v7.1, v8 hoặc v8.1) sang phiên bản 9. Thông báo này sẽ chuyển bạn đến các trang trình bày chi tiết về những thay đổi giữa phiên bản hiện tại và phiên bản 9 có thể ảnh hưởng đến quá trình tích hợp của bạn. Trong một số trường hợp, bạn sẽ phải sử dụng phiên bản 9 để tải SDF lên kể từ ngày 8 tháng 9 năm 2025.
Để sử dụng phiên bản 9, bạn phải cập nhật các tài nguyên và hành động tạo SDF để sử dụng phiên bản 9 khi tải Tệp dữ liệu có cấu trúc xuống và tải lên.
Cập nhật phiên bản Tệp dữ liệu có cấu trúc
Để sử dụng phiên bản mới của Tệp dữ liệu có cấu trúc, hãy cập nhật phiên bản được chỉ định trong tài nguyên Đối tác và Nhà quảng cáo mẹ, đồng thời sử dụng phiên bản mới khi tạo các tác vụ tải xuống riêng lẻ trong Display & Video 360 API.
Cập nhật chế độ cài đặt tài nguyên mẹ
Bạn đặt phiên bản mặc định của tệp dữ liệu có cấu trúc ở cấp độ tài nguyên đối tác và nhà quảng cáo. Phiên bản này được dùng làm phiên bản mặc định khi tải Tệp dữ liệu có cấu trúc xuống thông qua giao diện hoặc API.
Thiết lập trong giao diện
Ở cấp đối tác:
Chuyển đến đối tác mà bạn muốn.
Chuyển đến trang Thông tin cơ bản trong trình đơn Cài đặt đối tác ở trình đơn điều hướng bên trái.
Cập nhật cấu hình phiên bản SDF trong phần Tệp dữ liệu có cấu trúc thành phiên bản 9.
Ở cấp nhà quảng cáo:
Chuyển đến nhà quảng cáo mà bạn muốn.
Chuyển đến trang Thông tin cơ bản trong trình đơn Cài đặt của nhà quảng cáo ở trình đơn điều hướng bên trái.
Cập nhật cấu hình phiên bản SDF trong phần Tệp dữ liệu có cấu trúc thành phiên bản 9. Nếu phiên bản mặc định được đặt ở cấp Đối tác, thì bạn có thể không chỉnh sửa được chế độ cài đặt này.
Thiết lập trong API
Ở cấp đối tác: Bạn không thể đặt phiên bản SDF mặc định ở cấp Đối tác trong API.
Cập nhật các yêu cầu sdfdownloadtasks.create trong API
Khi đưa ra yêu cầu sdfdownloadtasks.create bằng Display & Video 360 API, hãy đặt trường version của nội dung yêu cầu thành SDF_VERSION_9.
Di chuyển từ phiên bản SDF hiện tại
Các trang sau đây sẽ hướng dẫn bạn thực hiện những nội dung cập nhật cần thiết cho hoạt động tích hợp khi di chuyển từ phiên bản hiện tại sang phiên bản 9 và cung cấp danh sách đầy đủ về tất cả các thay đổi giữa các phiên bản:
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-08-21 UTC."],[],[],null,["# Migrate to Structured Data Files v9\n\n*Last update: 2025-08-21*\n\nThis guide leads you through these processes:\n\n- Update your selected Structured Data Files version to v9 using the Display \\& Video 360 UI or API.\n- Migrate your integration from deprecated Structured Data Files versions (v7, v7.1, v8, or v8.1) to v9. It points you to pages detailing the changes between your current version and v9 that may impact your integration. In some cases, you will have to use v9 to upload SDFs starting on September 8, 2025.\n\nSee the [migration pages specific to each version](#migrate_from_your_current_sdf_version) for an\nexhaustive list of differences between your version and v9.\n\nUpdate your Structured Data Files version\n-----------------------------------------\n\nTo use v9, you must update your resources and SDF generation actions to use v9\nwhen downloading and uploading Structured Data Files.\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/guides/getting-started/overview).\n\n#### Update parent resource settings\n\nYou set the default Structured Data Files version 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. Go to the **Basic Details** page under the **Partner Settings** menu in the left-hand navigation.\n3. Update the **SDF version** configuration in the Structured Data Files section to **v9**.\n\n**At the advertiser level:**\n\n1. Navigate to the intended advertiser.\n2. Go to the **Basic Details** page under the **Advertiser Settings** menu in the left-hand navigation.\n3. Update the **SDF version** configuration in the **Structured Data Files** section to **v9**. If the default version is set at the Partner level, this setting may not be editable.\n\n#### Set in the API\n\n**At the partner level:** You cannot set the default SDF version at the Partner\nlevel in the API.\n\n**At the advertiser level:** Make an [`advertisers.patch`](/display-video/api/reference/rest/current/advertisers/patch) request to\nupdate the\n[`dataAccessConfig.sdfConfig.sdfConfig.version`](/display-video/api/reference/rest/current/SdfConfig#FIELDS.version) to\n`SDF_VERSION_9` and, if needed,\n[`dataAccessConfig.sdfConfig.overridePartnerSdfConfig`](/display-video/api/reference/rest/current/advertisers#AdvertiserSdfConfig.FIELDS.override_partner_sdf_config)\nto 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 request body to\n`SDF_VERSION_9`.\n\nMigrate from your current SDF version\n-------------------------------------\n\n| **Important:** The only new feature in v9 is the ability to declare whether a line item will serve EU political ads. This column will be required starting **September 8, 2025**.\n\nThe following pages walk you through the necessary updates to make to your\nintegration when migrating from your current version to v9 and provide a\ncomprehensive list of all changes between the versions:\n\n- [Migrate from v7](/display-video/api/structured-data-file/v7/migrate-to-v9)\n- [Migrate from v7.1](/display-video/api/structured-data-file/v7-1/migrate-to-v9)\n- [Migrate from v8](/display-video/api/structured-data-file/v8/migrate-to-v9)\n- [Migrate from v8.1](/display-video/api/structured-data-file/v8-1/migrate-to-v9)"]]