公告淘汰

時間表：

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

建議採取的行動：

• 立即停止使用手動觸發條件，開始及停止放送委刊項。
• 停止向 advertisers.manualTriggers 服務提出要求。
• 使用手動觸發條件，更新所有委刊項的 flight.flightDateType 和 flight.triggerId 欄位。

時間表：

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

建議執行的工作：

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

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

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

這些新限制可讓您更彈性地使用 API，並為廣告主平行處理要求。如要瞭解這項異動的詳細資訊，請參閱現有的配額限制說明文件。

自 2023 年 6 月 21 日起，LIST request 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 邏輯運算子，以免服務中斷。

更新初始生效日期

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 日前，移除使用這兩個欄位的所有篩選器和排序邏輯，以免服務中斷。

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

• flight.triggerId
• targetedChannelId
• targetedNegativeKeywordListId
• warningMessages

請在 2023 年 6 月 21 日前，移除使用這四個欄位的所有篩選器邏輯，以免服務中斷。

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

這項變更會影響下列要求：

• 嘗試使用 advertisers.insertionOrders.create 建立採用依據結果採購的廣告訂單時，系統會傳回 400 錯誤
• 嘗試使用 advertisers.lineItems.create、advertisers.lineItems.duplicate 或 advertisers.lineItems.generateDefault，在依據結果採購的廣告訂單下建立委刊項時，系統會傳回 400 錯誤
• 由於封存的資源預設不會納入 LIST 要求，受影響的資源預設不會再由 advertisers.insertionOrders.list 和 advertisers.lineItems.list 方法傳回。

自 2024 年 6 月 26 日起，publisherReviewStatuses 欄位將停用，擷取 Creative 資源時會顯示空白。

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

• TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION：
• CONTENT_RATING_TIER_UNRATED
• CONTENT_RATING_TIER_GENERAL
• CONTENT_RATING_TIER_PARENTAL_GUIDANCE
• CONTENT_RATING_TIER_TEENS
• CONTENT_RATING_TIER_MATURE
• CONTENT_RATING_TIER_FAMILIES
• TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION：
• SENSITIVE_CATEGORY_EMBEDDED_VIDEO
• SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO

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

為避免服務中斷，請在淘汰日期前，從所有現有的 YouTube 與合作夥伴委刊項中移除這項指定目標。

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

為避免服務中斷，請在淘汰日期前，從現有目標對象指定目標和合併目標對象中找出並移除所有 Oracle 目標對象。

自 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。

為避免服務中斷，請更新並確認使用這些出價策略的委刊項未開啟最佳化指定目標對象功能。

2024 年 11 月 5 日起，設定廣告訂單 pacing 欄位時，PACING_TYPE_ASAP 將不再與 PACING_PERIOD_FLIGHT 相容。系統會將所有現有廣告訂單的 pacingType 更新為 PACING_TYPE_AHEAD。

為避免服務中斷，請使用 PACING_TYPE_ASAP 和 PACING_PERIOD_FLIGHT 更新現有任何插入單的 pacing。

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 天。

2025 年 3 月 6 日：

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

為避免服務中斷：

• 更新同時使用固定出價和最佳化指定目標的現有委刊項資源。
• 使用 Display & Video 360 API 或結構化資料檔案建立或更新委刊項資源時，請確認整合功能未設定固定出價策略和已最佳化的指定目標。

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

為避免服務中斷，請更新整合，將 firstAndThirdPartyAudiences.list 要求的 pageSize 查詢參數設為偏好的網頁大小。

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

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

• SDF v6和v7不再支援使用 Subtype 值「觸及」建立新的委刊項檔案項目。
• 如果結構化資料檔案 Line Item 中的新項目具有 Subtype 值「觸及」，則 TrueView Video Ad Formats 欄必須使用「多媒體」值。如果現有項目的 Subtype 值為「觸及」，則無法更新 TrueView Video Ad Formats 欄值。
• 在結構化資料檔案的委刊項檔案中，如果新項目的 Subtype 值為「觸及」，則必須填入 TrueView Video Ad Inventory Control 欄。

2025 年 4 月 1 日：

• 嘗試設定 ConversionCountingConfig 物件的 floodlightActivityConfigs 欄位，以及不使用相符 Floodlight 活動的 MaximizeSpendBidStrategy 或 PerformanceGoalBidStrategy 物件的 customBiddingAlgorithmId 欄位時，advertisers.lineItems.create 要求會傳回 400 錯誤。
• 如果 MaximizeSpendBidStrategy 或 PerformanceGoalBidStrategy 物件的 customBiddingAlgorithmId 欄位已設定，嘗試更新 ConversionCountingConfig 物件的 floodlightActivityConfigs 欄位時，advertisers.lineItems.patch 要求會傳回 400 錯誤。
• 如果「演算法 ID」欄位已設定，則嘗試更新「轉換 Floodlight 活動 ID」欄位的委刊項結構化資料檔案項目，將無法在檔案上傳時更新。
• 如果為委刊項指派 CustomBiddingAlgorithm 資源，則對 customBiddingAlgorithms.patch、customBiddingAlgorithms.rules.create、customBiddingAlgorithms.scripts.create 資源提出的要求會傳回錯誤。

為避免服務中斷，請將整合服務更新為：

• 請先確認相關 Floodlight 活動已指派給委刊項，再指派自訂出價演算法，或同時進行這兩項作業。
• 更新前，系統會先從所有委刊項取消指派現有的自訂出價演算法。

自 2025 年 4 月 7 日起，FirstAndThirdPartyAudience 資源將不再允許無限期目標對象成員資格。如果 firstAndThirdPartyAudiences.create 和 firstAndThirdPartyAudiences.patch 要求將 membershipDurationDays 欄位值設為 10,000，系統會傳回 400 錯誤。membershipDurationDays 欄位值為 10,000 的現有目標對象將更新為 540，且新的會籍期限將追溯適用於現有會籍。系統會將所有超過 540 天的成員資格設為無效。

為避免服務中斷：

• 確認整合功能未將新目標對象或現有目標對象的 membershipDurationDays 欄位值設為 10,000。
• 使用 firstAndThirdPartyAudiences.editCustomerMatchMembers 重新整理現有目標顧客比對目標對象的成員資格。
• 定期更新目標顧客比對目標對象的成員資格，確保目標對象名單大小不會無意間縮小。

在第 4 版中，這項變更會反映在 FirstPartyAndPartnerAudience 資源中。

2025 年 4 月 22 日起，您將無法再使用結構化資料檔案，為影片行動廣告活動建立委刊項，因為這類廣告活動將升級為需求開發廣告活動。如果嘗試上傳的委刊項項目，其 Subtype 欄值為「Action」，且 Type 欄值為「TrueView」，系統就會顯示錯誤訊息。

為避免服務中斷，請更新整合，改用需求開發廣告活動，而非影片行動廣告活動。

自 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 年 6 月 12 日起，您將無法再修改個別 YouTube 與合作夥伴委刊項的內容類別設定。內容類別設定將改為僅在廣告主層級控管。為配合這項異動，Display & Video 360 API 和結構化資料檔案將進行下列變更：

• YouTube 與合作夥伴 LineItem 資源的 YoutubeAndPartnersSettings 物件中，contentCategory 欄位將不再更新。並於稍後完全移除。
• 委刊項 SDF 中的「TrueView Content Filter」欄位將無法再寫入。

• 在 API 中查看 YouTube 與合作夥伴委刊項時，請改為擷取 effectiveContentCategory 欄位，而非 contentCategory 欄位。
• 更新結構化資料檔案委刊項項目時，請停止修改 TrueView Content Filter 欄。建立新委刊項時，請將這個資料欄留空。

自 2025 年 6 月 12 日起，如果父項廣告訂單已設為使用自動出價策略進行最佳化，您就無法再更新委刊項的預算設定。

• 在 API 中：檢查委刊項的上層 InsertionOrder 是否已設定 bidStrategy.maximizeSpendAutoBid 或 bidStrategy.performanceGoalAutoBid。如果是，請勿嘗試使用 advertisers.lineItems.patch 更新 LineItem 預算欄位。
• 在結構化資料檔案中：檢查委刊項父項廣告訂單的結構化資料檔案項目，確認 Insertion Order Optimization 欄是否設為 TRUE。如果是，請勿嘗試更新委刊項 SDF 項目中的 Budget Type 或 Budget Amount 欄。

自 2025 年 6 月 12 日起，我們將移除結構化資料檔案 (SDF) 項目中指定網址的現有限制，不再排除較新的網站。SDF 會改為比照 API 和使用者介面行為，只要網址格式正確，就能指定網址。

自 2025 年 9 月 8 日起，使用 Display & Video 360 API 或 SDF 建立新委刊項時，您必須聲明委刊項是否會放送歐盟政治廣告。您可以透過下列方式進行聲明：

• 使用 Display & Video 360 API LineItem 資源中的 containsEuPoliticalAds 欄位。您也可以使用 advertisers.lineItems.duplicate 和 advertisers.lineItems.generateDefault 要求中的新欄位進行這項聲明。
• 使用結構化資料檔案第 9 版的Contains EU Political Ads資料欄，檔案類型為「委刊項」。

如果上層廣告主不會包含任何放送歐盟政治廣告的委刊項，您可以使用 Display & Video 360 API Advertiser 資源中的 containsEuPoliticalAds 欄位，在廣告主層級進行聲明。如果這個欄位設為 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING，則廣告主下的所有新委刊項都會指派相同的值 (除非另有指定)，且廣告主下的所有現有委刊項都會更新為使用相同的值 (如果尚未設定值)。建立委刊項後，隨時可以透過使用者介面、API 或結構化資料檔案更新聲明。

如果您無法在廣告主層級聲明，或已聲明廣告主可能會放送歐盟政治廣告，請在 2025 年 9 月 8 日前更新 Display & Video 360 API 和 SDF 整合，以免服務中斷：

• 提出 advertisers.lineItems.create 要求時，請在新 LineItem 資源中設定 containsEuPoliticalAds 欄位。
• 在任何 advertisers.lineItems.duplicate 和 advertisers.lineItems.generateDefault 要求的請求主體中，設定 containsEuPoliticalAds 欄位。
• 改用結構化資料檔案第 9 版，並在上傳任何新委刊項時，將 Contains EU Political Ads 欄設為 Yes 或 No。如需逐步操作說明，請參閱 v9 遷移指南。
• 使用 Display & Video 360 API 或 SDF 更新現有委刊項的指定地理區域前，請先更新委刊項以提供聲明。