已宣布的弃用

2026 年 2 月 23 日，Display & Video 360 将停用广告订单和广告系列定位。我们将对 Display & Video 360 API 和结构化数据文件 (SDF) 进行更改，以与此变更保持一致。在 Display & Video 360 API 中，部分方法将弃用，如果调用这些方法，系统会返回错误。在 SDF 中，广告订单和广告系列文件中的定位条件列在下载时将不再填充，并且在上传时必须为空。建议用户在创建订单项时直接为订单项分配定位条件。

如果调用以下 Display & Video 360 API 方法，系统将返回 404 错误：

• advertisers.campaigns.listAssignedTargetingOptions
• advertisers.campaigns.targetingTypes.assignedTargetingOptions.get
• advertisers.campaigns.targetingTypes.assignedTargetingOptions.list
• advertisers.insertionOrders.listAssignedTargetingOptions
• advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.create
• advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.delete
• advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.get
• advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list
• advertisers.lineItems.generateDefault

如果广告系列结构化数据文件条目为以下列分配了值，则上传时会失败：

• Demographic Targeting Gender
• Demographic Targeting Age
• Demographic Targeting Household Income
• Demographic Targeting Parental Status
• Geography Targeting - Include
• Geography Targeting - Exclude
• Language Targeting - Include
• Language Targeting - Exclude
• Digital Content Labels - Exclude
• Brand Safety Sensitivity Setting
• Brand Safety Custom Settings
• Third Party Verification Services
• Third Party Verification Labels
• Viewability Targeting Active View
• Position Targeting - Display On Screen
• Position Targeting - Video On Screen
• Position Targeting - Display Position In Content
• Position Targeting - Video Position In Content
• Inventory Source Targeting - Authorized Seller Options
• Inventory Source Targeting - Include
• Inventory Source Targeting - Exclude
• Inventory Source Targeting - Target New Exchanges
• Environment Targeting

如果插单 SDF 条目为以下列分配了值，则上传时会失败：

• Geography Targeting - Include
• Geography Targeting - Exclude
• Proximity Targeting
• Proximity Location List Targeting
• Language Targeting - Include
• Language Targeting - Exclude
• Device Targeting - Include
• Device Targeting - Exclude
• Browser Targeting - Include
• Browser Targeting - Exclude
• Digital Content Labels - Exclude
• Brand Safety Sensitivity Setting
• Brand Safety Custom Settings
• Third Party Verification Services
• Third Party Verification Labels
• Channel Targeting - Include
• Channel Targeting - Exclude
• Site Targeting - Include
• Site Targeting - Exclude
• App Targeting - Include
• App Targeting - Exclude
• App Collection Targeting - Include
• App Collection Targeting - Exclude
• Category Targeting - Include
• Category Targeting - Exclude
• Content Genre Targeting - Include
• Content Genre Targeting - Exclude
• Keyword Targeting - Include
• Keyword Targeting - Exclude
• Keyword List Targeting - Exclude
• Audience Targeting - Include
• Audience Targeting - Exclude
• Affinity & In Market Targeting - Include
• Affinity & In Market Targeting - Exclude
• Custom List Targeting
• Inventory Source Targeting - Authorized Seller Options
• Inventory Source Targeting - Include
• Inventory Source Targeting - Exclude
• Inventory Source Targeting - Target New Exchanges
• Daypart Targeting
• Daypart Targeting Time Zone
• Environment Targeting
• Viewability Omid Targeting Enabled
• Viewability Targeting Active View
• Position Targeting - Display On Screen
• Position Targeting - Video On Screen
• Position Targeting - Display Position In Content
• Position Targeting - Video Position In Content
• Position Targeting - Audio Position In Content
• Video Player Size Targeting
• Content Duration Targeting
• Content Stream Type Targeting
• Audio Content Type Targeting
• Demographic Targeting Gender
• Demographic Targeting Age
• Demographic Targeting Household Income
• Demographic Targeting Parental Status
• Connection Speed Targeting
• Carrier Targeting - Include
• Carrier Targeting - Exclude

自 2025 年 9 月 8 日起，在使用 Display & Video 360 API 或 SDF 创建新订单项时，您必须声明相应订单项是否会投放欧盟政治广告。您可以通过以下方式进行声明：

• 使用 Display & Video 360 API LineItem 资源中的 containsEuPoliticalAds 字段。您还可以使用 advertisers.lineItems.duplicate 和 advertisers.lineItems.generateDefault 请求中的新字段进行此声明。
• 在 SDF v9 订单项文件类型中使用 Contains EU Political Ads 列。

如果您的父广告客户不会包含任何投放欧盟政治广告的订单项，那么您可以使用 Display & Video 360 API Advertiser 资源中的 containsEuPoliticalAds 字段在广告客户一级进行声明。如果此字段设置为 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING，则广告客户下的所有新订单项都将分配相同的值（除非另有指定），并且广告客户下的所有现有订单项都将更新为使用相同的值（如果尚未设置值）。创建订单项后，您可以随时使用界面、API 或 SDF 更新订单项的声明。

如果您无法在广告客户一级进行声明，或者已声明您的广告客户可能会投放欧盟政治广告，请在 2025 年 9 月 8 日之前更新您的 Display & Video 360 API 和 SDF 集成，以免服务中断：

• 发出 advertisers.lineItems.create 请求时，在新 LineItem 资源中设置 containsEuPoliticalAds 字段。
• 在任何 advertisers.lineItems.duplicate 和 advertisers.lineItems.generateDefault 请求的正文中设置 containsEuPoliticalAds 字段。
• 迁移为使用结构化数据文件 v9，并在上传时将所有新订单项的 Contains EU Political Ads 列设置为 Yes 或 No。如需查看分步说明，请参阅我们的 v9 迁移指南。
• 在使用 Display & Video 360 API 或 SDF 更新现有订单项的地理位置定位之前，请先更新该订单项以提供声明。

自 2025 年 6 月 12 日起，我们将更新品牌适宜性体验，届时您将无法再在订单项级修改各个 YouTube 及合作伙伴订单项的内容分类配置。内容分类设置将仅在广告客户级进行控制。为适应此项变更，我们将对 Display & Video 360 API 和结构化数据文件进行以下变更：

• YouTube 及合作伙伴 LineItem 资源的 YoutubeAndPartnersSettings 对象中的 contentCategory 字段将不再更新。我们将在日后完全移除此功能。
• 订单项 SDF 中的 TrueView Content Filter 列将不再可写入。

• 在 API 中查看 YouTube 及合作伙伴订单项时，检索 effectiveContentCategory 字段，而不是 contentCategory 字段。
• 更新 SDF 订单项条目时，停止修改 TrueView Content Filter 列。创建新订单项时，请将此列留空。

自 2025 年 6 月 12 日起，您将无法再更新父广告订单设置为使用自动出价策略进行优化的订单项目的预算设置。

• 在 API 中：检查订单项的父级 InsertionOrder 是否已设置 bidStrategy.maximizeSpendAutoBid 或 bidStrategy.performanceGoalAutoBid。如果是，请勿尝试使用 advertisers.lineItems.patch 更新 LineItem 预算字段。
• 在 SDF 中：检查相应订单项的父级广告订单的 SDF 条目的 Insertion Order Optimization 列是否设置为 TRUE。如果是，请勿尝试更新订单项 SDF 条目的 Budget Type 或 Budget Amount 列。

自 2025 年 6 月 12 日起，我们将移除针对 SDF 条目中定位的网址的现有限制，该限制之前会阻止纳入较新的网站。相反，SDF 将与 API 和界面行为保持一致，并允许定位网址，前提是这些网址的格式正确。

2025 年 5 月 1 日，尝试在订单项结构化数据文件中设置“出价调节系数”列的条目在上传文件时将无法创建或更新资源。

自 2025 年 4 月 22 日起，对于 Type 列值为“需求开发广告系列”的订单项条目，您必须在 TrueView Inventory Source Targeting 列中添加值“视频合作伙伴”。此强制执行措施开始实施后，系统会为现有订单项回填该值，并在下载新的结构化数据文件时包含该值。

为避免服务中断，请执行以下操作：

• 更新您的集成，以在所有需求开发广告订单项条目中包含“视频合作伙伴”值。
• 更新集成，以使用 SDF v8.1 广告组列 Demand Gen Inventory Source Strategy 和 Demand Gen Enabled Inventory Sources 在广告组级管理需求开发广告系列的广告资源来源。

自 2025 年 4 月 22 日起，您将无法再使用结构化数据文件为行动号召视频广告系列制作订单项，因为此类广告系列将升级为需求开发广告系列。尝试上传的订单项条目如果包含值为“Action”的 Subtype 列值和值为“TrueView”的 Type 列值，则会失败。

为避免服务中断，请更新您的集成，以改用需求开发广告系列，而不是行动号召视频广告系列。

自 2025 年 4 月 7 日起，FirstAndThirdPartyAudience 资源将不再允许无限期受众群体成员资格。如果 firstAndThirdPartyAudiences.create 和 firstAndThirdPartyAudiences.patch 请求将 membershipDurationDays 字段值设置为 10,000，则会返回 400 错误。membershipDurationDays 字段值为 10,000 的现有受众群体将更新为 540，并且新的成员资格有效期将追溯应用于现有成员资格。此操作会使所有有效期超过 540 天的会员资格失效。

为避免服务中断，请执行以下操作：

• 验证您的集成是否未将新受众群体或现有受众群体的 membershipDurationDays 字段值设置为 10,000。
• 使用 firstAndThirdPartyAudiences.editCustomerMatchMembers 刷新现有目标客户匹配受众群的成员资格。
• 定期刷新目标客户匹配受众群体的成员资格，确保受众群体的名单规模不会意外缩小。

在 v4 中，此更改反映在 FirstPartyAndPartnerAudience 资源中。

2025 年 4 月 1 日：

• 尝试设置 ConversionCountingConfig 对象的 floodlightActivityConfigs 字段以及 MaximizeSpendBidStrategy 或 PerformanceGoalBidStrategy 对象的 customBiddingAlgorithmId 字段的 advertisers.lineItems.create 请求（如果这些对象未使用匹配的 Floodlight 活动）将返回 400 错误。
• 如果尝试更新 ConversionCountingConfig 对象的 floodlightActivityConfigs 字段，同时设置了 MaximizeSpendBidStrategy 或 PerformanceGoalBidStrategy 对象的 customBiddingAlgorithmId 字段，则 advertisers.lineItems.patch 请求将返回 400 错误。
• 如果 Line Item 结构化数据文件中的条目尝试在设置了“Algorithm Id”列的情况下更新“Conversion Floodlight Activity Ids”列，则在上传文件时更新会失败。
• 针对分配给订单项的 CustomBiddingAlgorithm 资源的 customBiddingAlgorithms.patch、customBiddingAlgorithms.rules.create、customBiddingAlgorithms.scripts.create 请求将返回错误。

为避免服务中断，请将您的集成更新为：

• 在分配自定义出价算法之前或同时，验证相关 Floodlight 活动是否已分配给订单项。
• 在尝试更新之前，系统会先从所有订单项中取消分配现有的自定义出价算法。