| 功能 |
初始生效日期 |
说明 |
| 定位范围扩展 |
2023 年 3 月 25 日 |
优化型定位功能取代定位范围扩展功能,从 2023 年 3 月 25 日到 2023 年 5 月初逐步推出。我们已在博文中公布了 Display & Video 360 API 和结构化数据文件行为的相关变更以及建议采取的行动。 |
| 手动触发器 |
2023 年 5 月 17 日 |
时间安排:
建议采取的措施:
|
已安装的应用和新移动设备GoogleAudience类型 |
2023 年 5 月 20 日 |
时间安排:
建议执行的任务:
-
我们建议您在日后更新订单项定位条件时,立即停止使用受影响的受众群体。
-
从现有订单项和广告订单定位中移除所有受影响的受众群体。如需了解如何更新受众群体定位,请参阅我们的目标受众群体指南。
|
基于活动和频次上限的FirstAndThirdPartyAudience类型 |
2023 年 5 月 20 日 |
时间安排:
建议执行的任务:
-
我们建议您在日后更新订单项定位条件时,立即停止使用受影响的受众群体。
-
从现有订单项和广告订单定位中移除所有受影响的受众群体。如需了解如何更新受众群体定位,请参阅我们的目标受众群体指南。
|
| 现有 API 配额限制 |
2023 年 5 月 30 日 |
自 2023 年 5 月 30 日起,现有使用量限制将替换为混合配额结构,该结构具有以下特点:
-
取消了每个项目每天的请求数配额。
-
针对符合条件的方法,为每个广告客户每个项目设置了每分钟请求数配额。
这些新限制将提高 API 使用的灵活性,并允许跨广告客户并行处理请求。如需详细了解此变更,请参阅我们现有的配额限制文档。
|
LIST 过滤条件中不同字段的限制之间的 OR 运算符用法
|
2023 年 6 月 21 日 |
自 2023 年 6 月 21 日起,LIST 请求 filter 参数将不再允许在不同字段的限制之间使用 OR 逻辑运算符。
例如,使用过滤条件字符串 lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" 标识的资源必须改为使用两个 LIST 请求进行检索,这两个请求的过滤条件字符串如下所示:
lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
insertionOrderId="123"
如需详细了解逻辑运算符的限制,请参阅我们的有关过滤 LIST 请求的操作指南。
请在 2023 年 6 月 21 日之前查看所有现有 LIST 调用的 filter 查询参数,并验证它们是否正确使用了 OR 逻辑运算符,以免服务中断。
|
能够按 budget.budget_segments.date_range.end_date 和 flight.dateRange.endDate 字段过滤或排序列表请求
更新了初始生效日期
|
2023 年 6 月 21 日 |
自 2023 年 6 月 21 日起,budget.budget_segments.date_range.end_date 和 flight.dateRange.endDate 将不再是 advertisers.insertionOrders.list 和 advertisers.lineItems.list filter 和 orderBy 查询参数中接受的字段。在此日期之后,如果请求在 filter 和 orderBy 查询参数中使用这些字段,系统将返回错误。
请在 2023 年 6 月 21 日之前移除使用这两个字段的所有过滤和排序逻辑,以免服务中断。
|
能够按另外四个字段过滤 advertisers.lineItems.list 请求 |
2023 年 6 月 21 日 |
自 2023 年 6 月 21 日起,advertisers.lineItems.list 将不再支持按以下字段进行过滤:
flight.triggerId
targetedChannelId
targetedNegativeKeywordListId
warningMessages
请在 2023 年 6 月 21 日之前移除使用这四个字段的所有过滤条件逻辑,以免服务中断。
|
| 按结果付费 |
2023 年 8 月 1 日 |
自 2023 年 8 月 1 日起,采用基于效果的购买方式(由 billableOutcome 字段值 BILLABLE_OUTCOME_PAY_PER_CLICK 或 BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION 定义)的插单及其子订单项将被归档。
此变更将影响以下请求:
|
广告素材资源中的 publisherReviewStatuses 字段 |
2024 年 6 月 26 日 |
自 2024 年 6 月 26 日起,publisherReviewStatuses 字段将被弃用,并且在检索 Creative 资源时为空。
|
| YouTube 及合作伙伴订单项的内容定位 |
2024 年 9 月 30 日 |
自 2024 年 9 月 30 日起,YouTube 及合作伙伴订单项将不再支持以下已确定的定位类型值:
系统会自动从现有订单项定位中移除已停用的定位选项。这些值仍可用于广告客户级定位。
为避免服务中断,请在停用日期之前从所有现有的 YouTube 及合作伙伴订单项中移除此定位条件。
|
| Oracle 第一方和第三方受众群体 |
2024 年 9 月 30 日 |
2024 年 9 月 30 日,Oracle 的 FirstAndThirdPartyAudience 资源来源将停用。在功能停用后,这些受众群体将从所有现有的资源定位和组合受众群体中移除。如果某个订单项仅定位到已弃用的受众群体,或者排除任何已弃用的受众群体,此更新会自动暂停该订单项。
为避免服务中断,请在终止日期之前,从现有订单项受众群体定位和组合受众群体中识别并移除所有 Oracle 受众群体。
|
| 针对部分出价策略的订单项优化型定位 |
2024 年 9 月 30 日 |
自 2024 年 9 月 30 日起,使用部分出价策略的LineItem资源将不再与优化型定位兼容。在此次更改后,LineItem 资源(如果 targetingExpansion.enableOptimizedTargeting 设置为 True,且 bidStrategy.maximizeSpendAutoBid.performanceGoalType 设置为 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA、BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN 或 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED,或者 bidStrategy.performanceGoalAutoBid.performanceGoalType 设置为 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM)将更新为将 targetingExpansion.enableOptimizedTargeting 设置为 False。
为避免服务中断,请更新并验证使用这些出价策略的订单项是否未启用优化型定位。
|
广告订单的“排期 - 尽快”Pacing |
2024 年 11 月 5 日 |
自 2024 年 11 月 5 日起,在设置广告订单的 pacing 字段时,PACING_TYPE_ASAP 将不再与 PACING_PERIOD_FLIGHT 兼容。所有采用此配置的现有广告订单的 pacingType 将更新为 PACING_TYPE_AHEAD。
为避免服务中断,请使用 PACING_TYPE_ASAP 和 PACING_PERIOD_FLIGHT 更新所有现有插单的 pacing。
|
| 频次上限周期超过 30 天 |
2025 年 2 月 28 日 |
2025 年 2 月 28 日:
为避免服务中断,请执行以下操作:
- 将使用超过 30 天的频次上限周期的现有广告系列、广告订单和订单项资源更新为 30 天或更短。
- 验证您的集成在通过 Display & Video 360 API 或结构化数据文件创建或更新广告系列、广告订单或订单项资源时,是否未设置超过 30 天的频次上限周期。
|
| 使用固定出价的订单项的优化型定位 |
2025 年 3 月 6 日 |
2025 年 3 月 6 日:
为避免服务中断,请执行以下操作:
- 更新同时使用固定出价和优化型定位的现有订单项资源。
- 验证您的集成在通过 Display & Video 360 API 或结构化数据文件创建或更新订单项资源时,是否未设置固定的出价策略和优化后的定位条件。
|
更新为 firstAndThirdPartyAudiences.list 默认页面大小 |
2025 年 3 月 6 日 |
自 2025 年 3 月 6 日起,firstAndThirdPartyAudiences.list 请求的默认页面大小将从 100 更新为 5,000。
为避免服务中断,请更新您的集成,将 firstAndThirdPartyAudiences.list 请求的 pageSize 查询参数设置为您所需的页面大小。
|
新增了 sdfdownloadtasks.create 合作伙伴/广告客户不匹配错误 |
2025 年 3 月 6 日 |
自 2025 年 3 月 6 日起,使用父实体过滤器按非 partnerId 集合的子级的广告客户进行过滤的 sdfdownloadtasks.create 请求将开始返回 400 错误。
|
| SDF 中的 YouTube 覆盖面订单项限制 |
2025 年 3 月 24 日 |
自 2025 年 3 月 24 日起,在创建或更新订单项时,结构化数据文件将要求使用更广泛的广告格式。这有以下含义:
- SDF v6 和 v7 不再支持创建具有
Subtype 值“覆盖面”的新订单项文件条目。
- 如果 SDF 订单项文件中的新条目的
Subtype 值为“覆盖面”,则必须在 TrueView Video Ad Formats 列中使用“自适应”值。Subtype 值为“覆盖面”的现有条目无法更新其 TrueView Video Ad Formats 列值。
- 如果结构化数据文件 (SDF) 订单项文件中的新条目的
Subtype 值为“覆盖面”,则需要填充 TrueView Video Ad Inventory Control 列。
|
| 自定义出价算法与 Floodlight 活动不匹配 |
2025 年 4 月 1 日 |
2025 年 4 月 1 日:
为避免服务中断,请将您的集成更新为:
- 在分配自定义出价算法之前或同时,验证相关 Floodlight 活动是否已分配给订单项。
- 在尝试更新之前,系统会先从所有订单项中取消分配现有的自定义出价算法。
|
| 第一方受众群体的会员期限为无限期 |
2025 年 4 月 7 日 |
自 2025 年 4 月 7 日起,FirstAndThirdPartyAudience 资源将不再允许无限期受众群体成员资格。如果 firstAndThirdPartyAudiences.create 和 firstAndThirdPartyAudiences.patch 请求将 membershipDurationDays 字段值设置为 10,000,则会返回 400 错误。membershipDurationDays 字段值为 10,000 的现有受众群体将更新为 540,并且新的会员时长将追溯应用于现有会员。此操作会使所有有效期超过 540 天的会员资格失效。
为避免服务中断,请执行以下操作:
在 v4 中,此更改反映在 FirstPartyAndPartnerAudience 资源中。
|
| 结构化数据文件中的行动号召视频广告系列 |
2025 年 4 月 22 日 |
自 2025 年 4 月 22 日起,您将无法再使用结构化数据文件为行动号召视频广告系列制作订单项,因为此类广告系列即将升级为需求开发广告系列。尝试上传的Subtype列值为“Action”且Type列值为“TrueView”的订单项条目将失败。
为避免服务中断,请更新您的集成,以使用需求开发广告系列而不是行动号召视频广告系列。
|
| 在结构化数据文件中,需求开发广告订单项需要视频广告合作伙伴广告资源来源 |
2025 年 4 月 22 日 |
自 2025 年 4 月 22 日起,对于 Type 列值为“需求开发广告系列”的订单项条目,您必须在 TrueView Inventory Source Targeting 列中添加值“视频合作伙伴”。开始强制执行此要求后,系统会为现有订单项回填该值,并在下载新的结构化数据文件时包含该值。
为避免服务中断,请执行以下操作:
- 更新您的集成,以在所有需求开发广告系列的订单项条目中包含“视频合作伙伴”值。
- 更新集成,以使用 SDF v8.1 广告组列
Demand Gen Inventory Source Strategy 和 Demand Gen Enabled Inventory Sources 在广告组级管理需求开发广告资源来源。
|
| “出价倍增系数”列(位于订单项结构化数据文件中) |
2025 年 5 月 1 日 |
2025 年 5 月 1 日,尝试在订单项结构化数据文件中设置“出价调节系数”列的条目将无法在上传文件时创建或更新资源。
|
| YouTube 及合作伙伴订单项的内容类别设置 |
2025 年 6 月 12 日 |
自 2025 年 6 月 12 日起,我们将更新品牌适宜性体验,届时您将无法再在订单项级修改各个 YouTube 及合作伙伴订单项的内容分类配置。内容类别设置将仅在广告客户级进行控制。为适应此项变更,我们将对 Display & Video 360 API 和结构化数据文件进行以下变更:
为避免服务中断:
|
| 通过广告订单优化功能更新订单项预算 |
2025 年 6 月 12 日 |
自 2025 年 6 月 12 日起,您将无法再更新父广告订单设置为使用自动出价策略进行优化的订单项目的预算设置。
为避免服务中断,请执行以下操作:
|
| 结构化数据文件的网站限制 |
2025 年 6 月 12 日 |
自 2025 年 6 月 12 日起,我们将移除针对 SDF 条目中定位的网址的现有限制,该限制之前会阻止纳入较新的网站。相反,SDF 将与 API 和界面行为保持一致,并允许定位网址,前提是这些网址的格式正确。
这与广告订单和订单项文件中的 Site Targeting - Include 和 Site Targeting - Exclude 列相关。
|
| 声明订单项是否投放欧盟政治广告 |
2025 年 9 月 8 日 |
自 2025 年 9 月 8 日起,在使用 Display & Video 360 API 或 SDF 创建新订单项时,您必须声明相应订单项是否会投放欧盟政治广告。您可以通过以下方式进行声明:
如果您的父广告客户不会包含任何投放欧盟政治广告的订单项,那么您可以使用 Display & Video 360 API Advertiser 资源中的 containsEuPoliticalAds 字段在广告客户一级进行声明。如果此字段设置为 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING,则广告客户下的所有新订单项都将分配相同的值(除非另有指定),并且广告客户下的所有现有订单项都将更新为使用相同的值(如果尚未设置值)。创建订单项后,您可以随时使用界面、API 或 SDF 更新订单项的声明。
如果您无法在广告客户一级进行声明,或者已声明您的广告客户可能会投放欧盟政治广告,请在 2025 年 9 月 8 日之前更新您的 Display & Video 360 API 和 SDF 集成,以免服务中断:
|
| Display & Video 360 API 和结构化数据文件中的广告订单和广告系列定位管理 |
2026 年 2 月 |
2026 年 2 月,Display & Video 360 将停用广告订单和广告系列定位。我们将对 Display & Video 360 API 和结构化数据文件 (SDF) 进行更改,以与此变更保持一致。在 Display & Video 360 API 中,一部分方法将弃用,如果调用这些方法,系统会返回错误。在 SDF 中,下载订单和广告系列文件时,定位列将不再填充,并且在上传时必须为空。建议用户在创建订单项时直接为订单项分配定位条件。
如果调用以下 Display & Video 360 API 方法,系统将返回 404 错误:
如果广告系列结构化数据文件条目为以下列分配了值,则上传时会失败:
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
此条目将在日后更新为确切日期。
|