已封存的淘汰功能

下表列出已公布的淘汰功能，這些功能會影響已停用的 Display & Video 360 API 或結構化資料檔案版本。當中會提供初始生效日期、淘汰說明、建議做法，以及相關說明文件的連結：

功能 初始生效日期 說明
結構化資料檔案中的 YouTube 觸及率委刊項限制 2025 年 3 月 24 日

自 2025 年 3 月 24 日起，使用結構化資料檔案建立或更新委刊項時，必須採用更廣泛的廣告格式。也就是遵守下列規範：

  • SDF v6 和 v7 不再支援使用 Subtype 值「觸及」建立新的委刊項檔案項目。
  • 在結構化資料檔案的委刊項檔案中，如果新項目的 Subtype 值為「觸及」，則 TrueView Video Ad Formats 欄必須使用「多媒體」值。如果現有項目的「Subtype」值為「觸及」，則無法更新「TrueView Video Ad Formats」資料欄值。
  • 在結構化資料檔案的委刊項檔案中，如果新項目的 Subtype 值為「觸及」，則必須填入 TrueView Video Ad Inventory Control 欄。
新的 sdfdownloadtasks.create 合作夥伴/廣告主不符錯誤 2025 年 3 月 6 日

2025 年 3 月 6 日起，如果 sdfdownloadtasks.create 要求使用父項實體篩選器，依據非 partnerId 子項的廣告主進行篩選，就會開始傳回 400 錯誤。
更新為firstAndThirdPartyAudiences.list預設頁面大小 2025 年 3 月 6 日

自 2025 年 3 月 6 日起，firstAndThirdPartyAudiences.list 要求的預設頁面大小將從 100 更新為 5000。

為避免服務中斷，請更新整合功能，將 firstAndThirdPartyAudiences.list 要求的 pageSize 查詢參數設為偏好的頁面大小。
使用固定出價的委刊項最佳化指定目標對象 2025 年 3 月 6 日

2025 年 3 月 6 日：

  • 建立或更新 LineItem 資源，將 BiddingStrategy 欄位 fixedBid 和 TargetingExpansionConfig 欄位 enableOptimizedTargeting 設為 true 的要求，會傳回 400 錯誤。
  • 如果委刊項結構化資料檔案的「出價策略類型」欄值為「固定」，且「已最佳化目標對象」欄值為「True」，則上傳檔案時，系統將無法建立或更新項目。
  • 使用固定出價的現有委刊項將更新，以停用最佳化指定目標。

為避免服務中斷：

  • 更新同時使用固定出價和最佳化指定目標的現有委刊項資源。
  • 使用 Display & Video 360 API 或結構化資料檔案建立或更新委刊項資源時，請確認整合功能未設定固定出價策略和最佳化目標對象。
展示頻率上限時間範圍超過 30 天 2025 年 2 月 28 日

2025 年 2 月 28 日：

  • 要求建立或更新 LineItem、InsertionOrder 和 Campaign 資源，以使用 FrequencyCap 物件，並將 timeUnit 欄位設為 TIME_UNIT_LIFETIME，或將 timeUnit 欄位設為 TIME_UNIT_MONTH，且將 timeUnitCount 欄位設為 2，將會傳回 400 錯誤。
  • 如果委刊項、廣告訂單和廣告活動結構化資料檔案的「頻率週期」欄值為「整個生命週期」，或「頻率週期」欄值為「月」，且「頻率金額」欄值為「2」，則上傳檔案時會無法建立或更新項目。
  • 現有廣告活動、廣告訂單和委刊項的展示頻率上限週期將更新為 30 天以內。

為避免服務中斷：

  • 請將使用超過 30 天展示頻率上限週期的現有廣告活動、廣告訂單和委刊項資源，更新為 30 天或更短。
  • 使用 Display & Video 360 API 或結構化資料檔案建立或更新廣告活動、廣告訂單或委刊項資源時，請確認整合功能未將展示頻率上限週期設為超過 30 天。
廣告訂單的「檔期盡快」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。
部分出價策略的委刊項最佳化指定目標 2024 年 9 月 30 日

自 2024 年 9 月 30 日起，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 的 LineItem 資源更新為將 targetingExpansion.enableOptimizedTargeting 設為 False。

為避免服務中斷，請更新並確認使用這些出價策略的委刊項未開啟最佳化指定目標對象功能。
Oracle 第一方和第三方目標對象 2024 年 9 月 30 日

2024 年 9 月 30 日，Oracle 的 FirstAndThirdPartyAudience 資源來源將停止服務。淘汰後，這些目標對象會從現有的資源指定目標和合併目標對象中移除。如果委刊項只指定即將淘汰的目標對象，或排除任何即將淘汰的目標對象，系統會自動暫停該委刊項。

為避免服務中斷，請在淘汰日期前，從現有目標對象指定目標和合併目標對象中找出並移除所有 Oracle 目標對象。
YouTube 與合作夥伴委刊項的內容指定目標 2024 年 9 月 30 日

自 2024 年 9 月 30 日起，YouTube 與合作夥伴委刊項將不再支援下列指定目標類型的值：

系統會自動從現有委刊項指定目標中移除淘汰的指定目標選項。這些值仍可用於廣告主層級指定目標。

為避免服務中斷，請在淘汰日期前，從所有現有的 YouTube 與合作夥伴委刊項中移除這項指定目標。
廣告素材資源中的 publisherReviewStatuses 欄位 2024 年 6 月 26 日

自 2024 年 6 月 26 日起，publisherReviewStatuses 欄位將停用，擷取 Creative 資源時會顯示空白。
依據結果採購 2023 年 8 月 1 日

自 2023 年 8 月 1 日起，系統會封存使用依據結果採購的廣告訂單 (由 billableOutcome 欄位值 BILLABLE_OUTCOME_PAY_PER_CLICK 或 BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION 定義)，以及這些廣告訂單的子項委刊項。

這項變更會影響下列要求：
可依四個額外欄位篩選 advertisers.lineItems.list 要求 2023 年 6 月 21 日

2023 年 6 月 21 日起，advertisers.lineItems.list將不再支援依下列欄位篩選：

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

請在 2023 年 6 月 21 日前，移除使用這四個欄位的所有篩選器邏輯，以免服務中斷。
可依 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 日前，移除使用這兩個欄位的所有篩選器和排序邏輯，以免服務中斷。
OR 篩選器中不同欄位限制之間的 OR 運算子用法 LIST

 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 日前，檢查所有現有 filterLIST呼叫的查詢參數，確認這些參數正確使用 OR 邏輯運算子，以免服務中斷。
現有 API 配額限制 2023 年 5 月 30 日

2023 年 5 月 30 日，現有的用量限制將改為混合配額結構，具備下列功能：

  1. 取消每項專案每日要求配額。
  2. 針對符合資格的方法，為每項專案的每個廣告主設定每分鐘要求數配額。

這些新限制可讓您更彈性地使用 API，並讓廣告主平行處理要求。如要瞭解這項異動的詳細資訊，請參閱現有的配額限制說明文件。
以活動為依據和展示頻率上限FirstAndThirdPartyAudience類型 2023 年 5 月 20 日

時間表：

  • 2023 年 5 月 20 日：您將無法再將FirstAndThirdPartyAudience資源指派給委刊項或廣告訂單的目標對象指定目標，這些資源的AudienceType為 ACTIVITY_BASED 或 FREQUENCY_CAP。如果要求將這些目標對象指派給委刊項的目標對象指定，系統會傳回錯誤。如果建立的委刊項會在指定目標對象中納入已淘汰的目標對象，系統就會拒絕 advertisers.lineItems.duplicate 和 advertisers.lineItems.generateDefault 要求。
  • 2023 年 6 月 8 日：系統會從所有委刊項和刊登訂單指定目標，以及所有合併目標對象中，移除受影響的目標對象。如果移除這些目標對象後，委刊項無法放送廣告，系統就會暫停委刊項。自該日起，也無法再使用 firstAndThirdPartyAudiences 服務擷取這些目標對象。

建議工作：

  • 日後更新委刊項指定目標時，建議您立即停止使用受影響的目標對象。
  • 從現有委刊項和廣告訂單指定目標中，移除所有受影響的目標對象。如要瞭解如何更新目標對象指定條件，請參閱目標對象指南。
已安裝的應用程式和新行動裝置 GoogleAudience 類型 2023 年 5 月 20 日

時間表：

  • 2023 年 5 月 20 日：您將無法再將GoogleAudience資源指派給委刊項或廣告訂單的目標對象指定目標，這些資源的GoogleAudienceType為 GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS 或 GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES。如果要求將這些目標對象指派給委刊項的目標對象指定，系統會傳回錯誤。如果建立的委刊項會在指定目標對象中納入已淘汰的目標對象，系統就會拒絕 advertisers.lineItems.duplicate 和 advertisers.lineItems.generateDefault 要求。
  • 2023 年 6 月 8 日：系統會從所有委刊項和刊登訂單指定目標，以及所有合併目標對象中，移除受影響的目標對象。如果移除這些目標對象後，委刊項無法放送廣告，系統就會暫停委刊項。自該日起，也無法再使用 googleAudiences 服務擷取這些目標對象。

建議工作：

  • 日後更新委刊項指定目標時，建議您立即停止使用受影響的目標對象。
  • 從現有委刊項和廣告訂單指定目標中，移除所有受影響的目標對象。如要瞭解如何更新目標對象指定條件，請參閱目標對象指南。
手動觸發條件 2023 年 5 月 17 日

時間表：

  • 2023 年 5 月 17 日：Display & Video 360 將停止放送使用手動觸發條件的委刊項。如果在此日期後啟用與有效委刊項連結的手動觸發條件，委刊項就不會放送廣告。
  • 2023 年 8 月 1 日：DV360 API 第 1 版和第 2 版的 advertisers.manualTriggers 服務、DV360 API 第 1 版的 LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER 列舉值，以及 DV360 API 第 1 版的 LineItemFlight.triggerId 欄位將停用。屆時對這些服務或欄位提出的要求，將會傳回錯誤。

建議採取的行動：
擴展指定目標 2023 年 3 月 25 日 自 2023 年 3 月 25 日至 2023 年 5 月初，最佳化指定目標功能將逐步取代擴展指定目標功能。我們已在這篇網誌文章中，說明 Display & Video 360 API 和結構化資料檔案的相關異動，以及建議採取的行動。