您可能需要在
2025 年 9 月 8 日之后迁移到 v9 才能上传结构化数据文件。如需了解详情,请参阅我们的
弃用页面;如需获取分步说明,请参阅我们的
v9 迁移指南。
从 v8 迁移到 v9
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
本页详细介绍了从 v8 迁移到 v9 时需要对结构化数据文件集成进行的必要更新,并全面列出了这两个版本之间的所有变化。
如需详细了解如何更新所选的 SDF 版本,请参阅我们的常规 v9 迁移指南。
更新
请对集成进行以下更新,以便使用 v9。
声明订单项是否会投放欧盟政治广告
您必须使用订单项文件类型中的新 Contains EU Political Ads
列来声明新的订单项是否会投放欧盟政治广告。
创建新订单项或更新现有订单项的以下任何列时,此字段是必需的:
Geography Targeting - Include
Geography Targeting - Exclude
Geography Regional Location List Targeting - Include
Geography Regional Location List Targeting - Exclude
Proximity Targeting
Proximity Location List Targeting
如果您已声明父广告客户不投放欧盟政治广告,则如果未设置相应列,新订单项将被分配 No
值。
更新了“TrueView 内容过滤条件”列的订单项名称
订单项文件类型中的 TrueView Content Filter
列已重命名为 Inventory Mode
。无需对列内容进行其他更改。
添加了“广告组需求开发广告资源来源策略”列
已向广告组文件添加新的 Demand Gen Inventory Source Strategy
和 Demand Gen Enabled Inventory
Sources
列。
对于 Video Ad Format
列值为 Demand Gen
的广告组,Demand Gen Inventory Source Strategy
列是必需的。
全面的变更列表
状态 | 实体 | 字段 | 属性 | 值 |
已添加 | 订单项 QA | 包含欧盟政治广告 | | |
TrueView 视频广告资源控制系统 | | |
已添加 | 订单项 | 包含欧盟政治广告 | | |
已添加 | 广告组质量检查 | 启用需求开发广告系列的广告资源来源 | | |
需求开发广告系列的广告资源来源策略 | | |
已添加 | 广告组 | 启用需求开发广告系列的广告资源来源 | | |
需求开发广告系列的广告资源来源策略 | | |
已更改 | 订单项 QA | TrueView 内容过滤器 | 名称 | 广告资源模式 |
已更改 | 订单项 | TrueView 内容过滤器 | 名称 | 广告资源模式 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-08-21。
[null,null,["最后更新时间 (UTC):2025-08-21。"],[],[],null,["# Migrate from v8 to v9\n\nThis page details the necessary updates to make to your Structured Data Files\nintegration when migrating from v8 to v9 and provides a comprehensive list of\nall changes between the two versions.\n\nFor details on how to update your selected SDF version, see our [general v9\nmigration guide](/display-video/api/structured-data-file/v9-migration-guide).\n\nUpdates\n-------\n\nMake these updates to your integration to use v9.\n\n### Declare whether line items will serve EU political ads\n\nYou must declare whether a new line item will serve EU political ads using a new\n`Contains EU Political Ads` column in the [Line Item](/display-video/api/structured-data-file/v9/LineItem) file type.\n\nThis field is required when creating new line items or updating any of the\nfollowing columns for an existing line item:\n\n- `Geography Targeting - Include`\n- `Geography Targeting - Exclude`\n- `Geography Regional Location List Targeting - Include`\n- `Geography Regional Location List Targeting - Exclude`\n- `Proximity Targeting`\n- `Proximity Location List Targeting`\n\nIf you have declared that the parent advertiser does not serve EU political ads,\nnew line items will be assigned the `No` value if the column is not set.\n\n### Update name of Line Item \"TrueView Content Filter\" column\n\nThe `TrueView Content Filter` column in the [Line Item](/display-video/api/structured-data-file/v9/LineItem) file type has\nbeen renamed `Inventory Mode`. No other changes need to be made to the column\ncontent.\n\n### Add Ad Group Demand Gen Inventory Source Strategy columns\n\nNew `Demand Gen Inventory Source Strategy` and `Demand Gen Enabled Inventory\nSources` columns have been added to [Ad Group](/display-video/api/structured-data-file/v9/AdGroup) files.\n\nThe `Demand Gen Inventory Source Strategy` column is required for Ad Groups with\na `Video Ad Format` column value of `Demand Gen`.\n\nComprehensive list of changes\n-----------------------------\n\n| Status | Entity | Field | Property | Value(s) |\n|---------|--------------|--------------------------------------|----------|----------------|\n| Added | Line Item QA | Contains EU Political Ads | | |\n| Added | Line Item QA | TrueView Video Ad Inventory Control | | |\n| Added | Line Item | Contains EU Political Ads | | |\n| Added | Ad Group QA | Demand Gen Enabled Inventory Sources | | |\n| Added | Ad Group QA | Demand Gen Inventory Source Strategy | | |\n| Added | Ad Group | Demand Gen Enabled Inventory Sources | | |\n| Added | Ad Group | Demand Gen Inventory Source Strategy | | |\n| Changed | Line Item QA | TrueView Content Filter | Name | Inventory Mode |\n| Changed | Line Item | TrueView Content Filter | Name | Inventory Mode |"]]