公告淘汰

時間表：

• 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 要求 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 邏輯運算子，以免服務中斷。

已更新初始生效日期

自 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

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

為避免服務中斷，請在停用日期前，從現有的 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.enableOptimizedTargetingFalse

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

自 2024 年 11 月 5 日起，PACING_TYPE_ASAP 在設定廣告訂單 pacing 欄位時，將不再與 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 錯誤。
• 如果「委刊項」結構化資料檔案中的「出價策略類型」欄值為「固定」，且「最佳化指定目標」欄值為「是」，則在上傳檔案時，系統將無法建立或更新這些項目。
• 使用固定出價的現有委刊項將更新為關閉最佳化指定目標對象功能。

為避免服務中斷，請採取下列行動：

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

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

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

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

2025 年 4 月 1 日：

• advertisers.lineItems.create 要求嘗試設定 ConversionCountingConfig 物件的 floodlightActivityConfigs 欄位，以及 MaximizeSpendBidStrategy 或 PerformanceGoalBidStrategy 物件 (不使用相符的 Floodlight 活動) 的 customBiddingAlgorithmId 欄位，會傳回 400 錯誤。
• 當 MaximizeSpendBidStrategy 或 PerformanceGoalBidStrategy 物件的 customBiddingAlgorithmId 欄位已設值時，advertisers.lineItems.patch 要求嘗試更新 ConversionCountingConfig 物件的 floodlightActivityConfigs 欄位時，會傳回 400 錯誤。
• 在「Line Item」結構化資料檔案中，如果設定了「Algorithm Id」欄，則嘗試更新「Conversion Floodlight Activity Ids」欄的項目，在檔案上傳時就會失敗。
• 針對指派給委刊項的 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 更新現有目標顧客比對對象的會員資格。
• 定期更新目標顧客比對目標對象會員資格，確保目標對象名單不會不小心變小。

自 2025 年 5 月 1 日起，如果委刊項結構化資料檔案中的項目嘗試設定「出價乘數」欄，則在上傳檔案時無法建立或更新資源。