共用方式為

Bing 廣告 API 版本資訊

  • 發行項

如需 Bing 廣告 API 版本 13 每月變更的相關信息，請參閱下方。

注意事項

最佳做法是，建議您在尖峰季節以外完成重要的開發工作。

最近和即將推出的) (重大變更

重要事項

下列即將進行的變更可能需要您採取動作，以避免服務中斷或功能遺失。

多重要素驗證 API 注意事項

重要事項

在 2022 年 6 月，我們引進了 多重要素驗證 作為 Bing 廣告的需求。 您可能仍然需要變更程序代碼，才能符合這項需求。 Microsoft Advertising 會在 10 月初執行技術強制檢查。

此部落格文章 概述您應該採取以確保合規性的步驟。

如需詳細資訊，請參閱 多重要素驗證需求 指南。

2024年11月

請參閱下方的 Bing 廣告 API 更新。

REST API 檔更新

我們很高興宣佈我們的 API 檔已更新為包含新的 REST API。 您將能夠在檔案中的 REST 和 SOAP API 之間切換。 若要深入瞭解，請參閱我們有關新 REST API 的 部落格文章 。

Bing 廣告 API SDK 匯報

Bing 廣告 .NET 和 Java SDK 會更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java SDK 13.0.22 版的版本資訊。

2024 年 9 月

請參閱下方的 Bing 廣告 API 更新。

新的 API 介面

大量服務

Bing 廣告 API SDK 匯報

Bing 廣告 Java SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising Java SDK 13.0.21.2 版的版本資訊。

2024年7月

請參閱下方的 Bing 廣告 API 更新。

新的 API 介面

大量服務

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.21 版的版本資訊。

2024 年 3 月

請參閱下方的 Bing 廣告 API 更新。

新的 API 介面

大量服務

  • 在 BulkCampaign 中 停用 VerifiedTrackingSettings 。 BulkCampaign 中適用於 Perfromance Max 的新字段 AutoGeneratedImageOptOut 和 AutoGeneratedTextOptOut 。
  • 針對帳戶層級負關鍵詞清單新增大量對應 BulkAccountNegativeKeywordList、 BulkAccountNegativeKeywordListAssociation 和 BulkAccountSharedNegativeKeyword 。
  • 支援 BulkCampaign 中效能上限的 PageFeedIds。
  • 新增 TargetCostPerSale 的大量對應。
  • 新增 AutoBidding、 BulkSeasonalityAdjustment 和 BulkDataExclusion 的大量對應。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.19 版的版本資訊。

2023 年 11 月

請參閱下方的 Bing 廣告 API 更新。

新的 API 介面

大量服務

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.18 版的版本資訊。

2023 年 8 月

請參閱下方的 Bing 廣告 API 更新。

新的 API 介面

  • 營銷活動管理 API：適用於 AdGroup 層級的 GenreCriterion、行銷活動層級的 DealCriterion。
  • 大量 API：LogoAdExtensions。

大量服務

  • 大量支援 AdGroupGenreCriterion 和 CampaignDealCriterion。
  • BulkCampaign 中的新字段 DestinationChannel 和 IsMultiChannelCampaign、BulkResponsiveAds 中的 VerifiedTrackingData。
  • 已新增 ImageAsset 的 TargetWidth 和 TargetHeight 對應。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.17 版的版本資訊。

2023 年 6 月

請參閱下方的 Bing 廣告 API 更新。

新的 API 介面

大量服務

  • PMax 活動的大量支援：AssetGroup、AssetGroupListingGroup、AudienceGroup、AudienceGroupAssetGroupAssociation、CampaignNegativeWebPage。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.16 版的版本資訊。

2022 年 12 月

請參閱下方的 Bing 廣告 API 更新。

新的 API 介面

大量服務

  • OnlineConversionAdjustment 的大量支援

  • 大量支援 Hotel Ad 實體，例如 HotelAdvanceBookingWindowCriterion、HotelCheckInDayCriterion、HotelCheckInDateCriterion、HotelDateSelectionTypeCriterion、HotelLengthOfStayCriterion 和 HotelListingGroup

  • BulkAdGroup 中 UseOptimizedTargeting、HotelAdGroupType、SecRate 和 PercentCpcBid 的大量支援

重要事項

UseOptimizedTargeting 將會被取代。 請改 用 UsePredictiveTargeting 。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.15 版的版本資訊。

2022 年 6 月

請參閱下方的 Bing 廣告 API 更新。

新的 API 介面

大量服務

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.14 版的版本資訊。

2022 年 1 月

請參閱下方的 Bing 廣告 API 更新。

新的 API 介面

大量服務

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.13 版的版本資訊。

2021 年 11 月

請參閱下方的 Bing 廣告 API 更新。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.12 版的版本資訊。

2021 年 8 月

請參閱下方的 Bing 廣告 API 更新。

Google Ads 匯入實體對應

營銷活動管理 GetImportEntityIdsMapping 服務作業現在支援從 Google Ads 到 Microsoft Advertising 的廣告群組、廣告和關鍵詞標識符對應。 先前只有營銷活動標識碼對應可供使用。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.11 版的版本資訊。

2021 年 7 月

請參閱下方的 Bing 廣告 API 更新。

多媒體廣告

活動管理 回應式Ad 物件支援多媒體廣告。

ResponsiveAd 對象用於搜尋網路中的多媒體廣告，以及Microsoft對象網路中的物件廣告。

大部分支持的屬性都相同，但有一些索引鍵差異變數。 如需詳細資訊，請參閱回應式廣告 備註。

無限制和開放式插入順序

客戶帳單 InsertionOrder 物件支援無限制和開放式插入訂單。

針對開放式插入順序，您可以設定 EndDate 元素 nil 或空白。

針對無限制的預算插入順序，您可以設定 SpendCapAmount 元素 nil 或空白。

2021 年 6 月

請參閱下方的 Bing 廣告 API 更新。

頁面訪客規則一般窗體展開

如果您已經使用 頁面訪客規則 來重新行銷清單，請閱讀本節以瞭解必要的變更。

重新營銷規則是用來判斷要將誰新增至重新行銷清單的條件。 您可以為自定義事件、頁面訪客、未造訪其他頁面的頁面訪客，以及造訪另一個頁面的頁面訪客建立規則。

針對頁面訪客規則，先前Microsoft Advertising 僅支持分離一般窗體 (DNF) 。 首先，在每個規則專案群組中，會使用邏輯 AND 運算符聯結相同頁面的規則項目條件。 然後，規則專案群組清單中的每個結果都會使用邏輯 OR 運算符聯結。 換句話說，如果在任何規則專案群組內符合所有指定的規則專案條件，使用者就會新增至您的重新營銷清單。

  • 規則 1 或規則 2
  • (規則 1 和規則 2) 或規則 3
  • (規則 1 和規則 2) 或 (規則 3 和規則 4)

我們引進了聯結一般窗體 (CNF) 的支援。 首先，在每個規則專案群組中，會使用邏輯 OR 運算符聯結相同頁面的規則項目條件。 然後，規則專案群組清單中的每個結果都會使用邏輯 AND 運算符聯結。 換句話說，如果符合所有規則專案群組內任何指定的規則專案條件，使用者就會新增至您的重新行銷清單。

  • 規則 1 和規則 2
  • (規則 1 或規則 2) 和規則 3
  • (規則 1 或規則 2) 和 (規則 3 或規則 4)

新增僅適用於 PageVisitorsRule，不包含 CustomEventsRule、PageVisitorsWhoDidNotVisitAnotherPageRule 或 PageVisitorsWhoVisitedAnotherPageRule。

重要事項

新頁面訪客規則的預設一般窗體會維持 DNF。 不過，您必須確定您的應用程式可以適當地讀取及區分 CNF 和 DNF。 您的應用程式不應該再假設規則是分離的。

如需如何取得和設定新標準表單屬性的詳細資訊，請參閱參考檔。

  • 營銷活動管理 API：PageVisitorsRule 的 NormalForm 元素可以設定為 Conjunctive 或 Disjunctive。
  • 大量 API：繼續在大量檔案中使用 重新行銷規則 數據行。 若要上傳，您可以選擇將字串格式化為 CNF 或 DNF。 若要下載，您的應用程式必須讀取相同數據行中的字串，並區分 CNF 和 DNF。

必要的轉換目標類別

如果您已經使用轉換目標，請閱讀本節中的必要變更。

不過，您可以將轉換目標分類為適合您的業務。 目標類別不會影響效能 - 這些類別可協助您分割目標及其效能計量。

先前 Bing 廣告 API 不需要轉換目標類別。 根據目標類型，默認類別設定為 [下載]、[無]、[其他] 或 [購買]。

現在 (自 2021 年 6 月起) 當您新增或更新自定義事件、離線轉換或 URL 目標時，您必須設定目標類別目錄，否則行銷活動管理服務會傳回錯誤。 其他目標類型的預設類別沒有變更，如表格所示。

目標類型 預設之前 預設後
EventGoal
OfflineConversionGoal
UrlGoal		 無 無預設值;服務傳回錯誤
DurationGoal
PagesViewedPerVisitGoal		 其他 其他
InStoreTransactionGoal 購買 購買
AppInstallGoal 下載 下載

如需詳細資訊，請參閱有關 轉換目標類別的 API 檔。

減少大量下載的回頭查閱

使用大量 API 下載活動 時，您只能要求取得自特定日期和時間起 (新增、更新、刪除) 的設定。

先前，如果您設定的日期和時間超過90天，則會傳回錯誤。

最大回查期間從 2021 年 9 月 1 日的 90 天減少為 30 天。 現在，如果您設定的日期和時間超過 30 天，將會傳回錯誤。

RSA 的資產效能標籤

當您取得或下載回應式搜尋廣告時，資產效能標籤會以唯讀屬性提供。

這可讓您知道您為回應式搜尋廣告設定的標題和描述資產的執行效能。

下表說明可能的值。

值 描述
低 此資產的效能很低，建議您取代此資產以改善廣告效能。
良好 此資產的效能良好。 建議您保留此資產並新增更多資產，以改善您的廣告效能。
最佳 此資產的效能是最佳的其中之一，建議您新增更類似的資產。
未分級 此資產沒有任何效能評等。 這可能是因為資產處於非作用中狀態、沒有足夠的資訊來判斷其效能，或是沒有足夠的類似資產可與其進行比較。
學習 正在主動評估資產的效能。 評估完成後，資產評等會是低、良好、最佳或未分級。

如需詳細資訊，請參閱回應 式搜尋廣告 記錄 (大量 API) 和 AssetLink (活動管理 API) 。

動態搜尋廣告

您無法再新增、更新或擷取僅支援動態搜尋廣告的活動。 您現有行銷活動的行銷活動類型已從 「DynamicSearchAds」 更新為 「Search」。 廣告群組現在被視為「動態」廣告群組，但沒有任何結構化變更，也就是它們包含與之前相同的自動目標和動態搜尋廣告。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.10 版的版本資訊。

2021 年 5 月

請參閱下方的 Bing 廣告 API 更新。

動態搜尋廣告

您無法再使用 DynamicSearchAds 行銷活動類型新增活動。 營銷活動類型會在 5 月和 6 月期間從 「DynamicSearchAds」 更新為 “Search”。 您仍然可以在營銷活動類型更新前後檢視和編輯這些活動。

2021 年 4 月

請參閱下方的 Bing 廣告 API 更新。

公事包的中標策略

注意事項

並非每個人都有這項功能。 如果沒有，別擔心，很快就會推出！

產品組合參與策略是一項自動化的全面性功能，可管理跨多個營銷活動之間的互動，而這些活動都致力於達成相同的目標。

我們會自動調整您的參與，以平衡共用相同策略的效能不足和過度執行的活動，不論是要最大化轉換、點選、目標曝光共用或其他效能目標。 對於想要確保有效率地花費整個預算的廣告商而言，組合的報價策略可能是不錯的選擇。

您只需要選擇一種參與策略類型，並在組合中包含具有互補預算的活動。 Microsoft Advertising 會根據整個組合的效能來調整您的報價。 如果您的組合包含任何具有共用預算的活動，則您應該包含所有共用相同預算的活動。

組合的參與策略最適合使用一個目標，使用互補營銷活動和評定策略類型。 您無法變更組合的中標策略類型。 如果您想要讓組合中的營銷活動使用不同的參與策略，您可以將它移至另一個組合。 一旦您選擇營銷活動類型，組合就只能包含該類型的活動。

營銷活動管理 BidStrategy 物件和大量評定策略記錄支援組合 的參與策略 。

目標曝光數共用

注意事項

並非每個人都有這項功能。 如果沒有，別擔心，很快就會推出！

目標曝光共用是一種自動化的繼承策略，可用來取得您想要顯示廣告之廣告位置的目標曝光分享。

透過營銷活動管理 BidStrategy、 Campaign 和 TargetImpressionShareBiddingScheme 物件，以及大量 評定策略 和 行銷活動 記錄，支援目標曝光數共用。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.9 版的版本資訊。

2021 年 3 月

請參閱下方的 Bing 廣告 API 更新。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.8 版的版本資訊。

2020 年 12 月

請參閱下方的 Bing 廣告 API 更新。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.7 版的版本資訊。

2020 年 11 月

請參閱下方的 Bing 廣告 API 更新。

分析深入解析頁面速率的絕對頂端

頁面速率的絕對頂端定義為廣告顯示為組織搜尋結果上方第一個廣告的次數，除以實際收到的曝光數。 頁面絕對頂端的廣告通常會收到更多點選。

根據預設，不會傳回 AbsoluteTopOfPageRate 元素。 如需詳細資訊，請參閱 將InsightInsightKpiAdditionalField 值集合。

回應式廣告的曝光追蹤 URL

1x1 曝光追蹤圖元的 URL。 每個像素都會向您的第三方廣告報告工具報告Microsoft對象網路曝光數。 每個回應式廣告最多可以包含 2 個曝光追蹤 URL。

針對每個Microsoft對象網路曝光，Microsoft會 ping URL，以在第三方廣告報告工具中啟用曝光追蹤。 不支援進階層級用戶追蹤，例如根據 Cookie 或 IP 位址進行轉換追蹤或追蹤。

廣告活動管理 回應式Ad 物件和大量 響應式廣告 記錄支援曝光追蹤 URL。

當您使用營銷活動管理服務取得廣告時，預設不會傳回 ImpressionTrackingUrls 元素。 如需詳細資訊，請參閱 AdAdditionalField 值集。

Flyer Ad Extensions

飛出視窗延伸模組可讓廣告商將產品或商店目錄散發 () 給潛在客戶。 他們可以在廣泛查詢上明顯顯示，例如「每週交易」或「每周銷售」，因此鼓勵顧客按兩下您的廣告，而不是競賽。 根據其本質，它們有助於更妥善地通知搜尋人員，因此增加用戶參與度，例如按下速率。

活動管理 FlyerAdExtension 物件和大量 飛出機廣告擴充功能記錄支援飛出視窗擴充功能 。

注意事項

在功能試驗 (GetCustomerPilotFeatures 會傳回 802) ，讓客戶可以使用飛出視窗擴充功能。

強調度量

透過顯著的計量，您可以更全面地檢視廣告在搜尋結果頁面上的顯示位置。 這些清楚的深入解析可協助您更妥善地優化您的策略。

AbsoluteTopImpressionRatePercent 和 TopImpressionRatePercent 數據行會新增至下列報表數據行值集。

2020 年 10 月

請參閱下方的 Bing 廣告 API 更新。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.6 版的版本資訊。

2020年 8月

請參閱下方的 Bing 廣告 API 更新。

報表格式版本

FormatVersion 元素會加入至 ReportRequest 數據物件。

某些欄位的數據格式可以在目前的 API 版本內更新，而不會中斷現有的用戶端應用程式。 如需 1.0 版和 2.0 版格式之間的差異，請參閱 報表格式版本 技術指南。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.5 版的版本資訊。

2020 年 7 月

請參閱下方的 Bing 廣告 API 更新。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.4 版的版本資訊。

2020 年 6 月

請參閱下方的 Bing 廣告 API 更新。

客戶清單

客戶清單是您已編譯以啟用客戶比對的一組客戶聯繫人資訊。

注意事項

客戶清單可供功能試驗中的客戶使用 (GetCustomerPilotFeatures 傳回 579) 。

客戶清單可透過大量 API 取得，但尚未透過行銷活動管理 API 提供。 透過大量 API，您可以針對客戶清單目標或排除專案使用下列記錄類型。

如需物件的概觀和詳細資訊，請參閱 物件 API 技術指南。

2020 年 5 月

請參閱下方的 Bing 廣告 API 更新。

合併清單

合併清單是從多個現有物件組合建立的物件。

注意事項

合併清單可供功能試驗中的客戶使用 (GetCustomerPilotFeatures 傳回 618) 。

使用大量 API，您可以針對合併的清單目標或排除專案使用下列記錄類型。

透過營銷活動管理 API，您可以使用 CombinedList 物件。

如需物件的概觀和詳細資訊，請參閱 物件 API 技術指南。

平行追蹤

在 2020 年 5 月 31 日之後建立的所有帳戶都需要平行追蹤。 在 2020 年 11 月之前，您可以針對在 2020 年 6 月 1 日之前建立的帳戶啟用和停用此功能，也就是將 account 屬性 設定為 true 或 false。 在 2020 年 11 月底之前，所有帳戶都會啟用平行追蹤，且值只能設定為 true。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.3 版的版本資訊。

2020 年 4 月

請參閱下方的 Bing 廣告 API 更新。

促銷廣告延伸模組

促銷延伸模組會醒目提示文字廣告中的特殊銷售和供應專案。 藉由讓供應項目脫穎而出，潛在客戶更可能按下您的廣告，協助為您產生更多銷售。

您可以將促銷廣告延伸模組與帳戶建立關聯，或與帳戶中的營銷活動和廣告群組建立關聯。 每個實體 (帳戶、行銷活動或廣告群組) 最多可以與 20 個促銷廣告延伸模組相關聯。

注意事項

升級延伸模組適用於功能試驗中的客戶 (GetCustomerPilotFeatures 傳回 720) 。

適用於促銷廣告延伸模組的大量 API

使用大量 API 時，請使用下列記錄類型來管理促銷廣告延伸模組。

促銷廣告延伸模組的營銷活動管理 API

透過營銷活動管理 API 使用 PromotionAdExtension 物件，例如透過 AddAdExtensions 服務作業。

放置排除清單

針對帳戶層級網站排除項目的支援會新增至營銷活動管理 API。 您可以在 PlacementExclusionList) (共用網站排除清單中新增和刪除 negativeSite (NegativeSite) 的負網站。 網站排除清單可以與多個廣告帳戶共用或關聯。

注意事項

您只能透過 [工具 -> 共享連結庫 -> 網站排除清單] 檢視重新設計Microsoft Advertising UI 中的網站排除清單。 如果您沒有看到，請在登入時尋找「試用新Microsoft廣告」提示。 若要使用重新設計的 Microsoft Advertising，您也必須在 UI 試驗中 (GetCustomerPilotFeatures 會傳回 522) 。

您可以透過共用實體和共用清單作業來管理新的網站排除清單，例如 AddSharedEntity 和 AddListItemsToSharedList。 先前這些作業是專門用於負關鍵詞清單，而現有的應用程式應該可在不變更任何程式代碼的情況下運作。 如需詳細資訊，請參閱 負面網站 技術指南。

適用於Microsoft對象網路的曝光共用

AudienceImpressionLostToBudgetPercent、AudienceImpressionLostToRankPercent 和 AudienceImpressionSharePercent 數據行會新增至下列值集。

2020 年 3 月

請參閱下方的 Bing 廣告 API 更新。

依帳戶時區的廣告排程

在試驗中，客戶可以使用依帳戶排程的廣告時區 (GetCustomerPilotFeatures 會傳回 655) 。 在今年稍後，所有客戶都會提供此功能。

AdScheduleUseSearcherTimeZone 元素可在 Campaign 和 Ad Group Campaign Management 物件中使用。 [ 廣告排程使用搜尋程式時區] 字 段可在 [營銷活動 ] 和 [廣告群組 大量記錄] 中取得。

每個營銷活動和廣告群組的新屬性會決定要使用可傳遞廣告之搜尋使用者的帳戶時區或時區。

注意事項

如果您未指定此元素或將它保留為 Null，則會設定 true 的預設值，並使用搜尋使用者的時區。 在 Q2 結束或 2020 年第 3 季開始之後，將會設定新的預設值 false ，並使用帳戶時區。

2020 年 2 月

請參閱下方的 Bing 廣告 API 更新。

報表中的目標和目標類型

Goal 和 GoalType 資料行會新增至下列值集。

這些數據行已在 GoalsAndFunnelsReportColumn 值集內提供。

目標是您為想要轉換所設定的目標名稱，這表示客戶在按下您的廣告之後所採取的動作。 目標類型是轉換目標的類型。 可能的值包括 AppInstall、 Duration、 Event、 InStoreTransaction、 OfflineConversion、 PagesViewedPerVisit 和 Url。

2020 年 1 月

請參閱下方的 Bing 廣告 API 更新。

取代加速預算傳遞

自 2020 年 1 月起，所有 DynamicSearchAds、購物和搜尋活動的共用和未共用預算預算類型都是唯讀的，而且您嘗試設定的任何預算類型值都會被忽略，而不會傳回錯誤。 先前的預算設定將從加速移轉至標準，而 API 只會針對 DynamicSearchAds、Shopping 和 Search 活動以及所有共用預算傳回 “DailyBudgetStandard”。 您仍然可以搭配物件營銷活動使用加速預算。 未共享的物件行銷活動層級預算不會移轉預算類型數據。 不過，如果對象活動使用共用預算，預算傳遞可能會如上所述變更。

動作廣告延伸模組類型

從 2020 年 1 月開始，有九種動作類型已被取代。 例如，如果您將動作類型設定為 「Browse」，則不會傳回任何錯誤，但 「LearnMore」 是擷取動作廣告延伸模組時將儲存並傳回的有效值。 您的應用程式應該使用取代值，而不是已被取代的值。

已被取代的動作類型 取代動作類型
瀏覽 LearnMore
探索 LearnMore
郵件 ContactUs
NewCars ViewCars
SeeMore LearnMore
StartFree FreeTrial
UsedCars ViewCars
ViewNow LearnMore
VisitSite LearnMore

此外，從 2020 年 1 月開始，會新增兩個新的動作類型，也就是 RenewNow 和 Reorder。 請注意，如果您使用營銷活動管理 API，根據預設，傳回的動作類型為 Unknown。 (設計目標是要避免具有嚴格值集相依性之用戶端的重大變更。) 若要判斷有效的動作類型，例如 RenewNow 或 Reorder，請在呼叫 GetAdExtensionsAssociations 和 GetAdExtensionsByIds 作業時包含 ActionTypesPhase3。

從 2020 年 1 月開始的最後一個更新，所有支援的語言都只會將銷售和優待券的當地語系化文字分別更新為「查看銷售」和「取得優待券」。 這些動作類型的 API 值集不會變更。 如需目前的當地語系化文字，請參閱 動作廣告延伸模組的動作文字。

2019 年 12 月

請參閱下方的 Bing 廣告 API 更新。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.2 版的版本資訊。

2019 年 11 月

請參閱下方的 Bing 廣告 API 更新。

最終 URL 後綴和自定義參數擴充

最終 URL 後綴現在可在所有客戶的帳戶、行銷活動、廣告群組、廣告群組準則、廣告和關鍵詞層級取得。 最終 URL 後綴可在第 3 階段試驗客戶的動作、價格和網站鏈接廣告延伸層級取得， (GetCustomerPilotFeatures 會傳回 636) 。

所有客戶的帳戶、行銷活動、廣告群組、廣告群組準則、廣告和關鍵詞層級現在最多可以使用8個自定義參數和較長的自定義參數值。 自定義參數限制增加階段 3 試驗的動作、價格和網站連結廣告延伸層級最多可使用 8 個自定義參數和較長的自定義參數值 (GetCustomerPilotFeatures 會傳回 635) 。

如需詳細資訊，請參閱 使用升級的URL進行URL追蹤。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 13.0.1 版的版本資訊。

2019 年 10 月

請參閱下方的 Bing 廣告 API 更新。

透過轉換包含檢視

檢視轉換是使用者在看到您的廣告之後所做的轉換，即使他們未按下廣告也一樣。

如果您在功能試驗中 (GetCustomerPilotFeatures 會傳回 616) 預設會啟用此功能，這表示效能報表的 [全部] 轉換數據行中的值將包含檢視轉換。 如果您不想要包含檢視轉換，您可以選擇停用它。

您可以透過大量和行銷活動管理 API 啟用或停用每個帳戶的功能。

您可以使用行銷活動管理 API 透過轉換視窗來管理檢視，也就是取得或設定 DurationGoal、EventGoal、PagesViewedPerVisitGoal 或 UrlGoal 的 ViewThroughConversionWindowInMinutes 屬性。 呼叫 GetConversionGoalsByIds 和 GetConversionGoalsByTagIds 時，請務必明確要求 ViewThroughConversionWindowInMinutes 做為其他欄位。

注意事項

檢視轉換需要 UETTag，因此這個屬性不適用於 AppInstallGoal、 InStoreTransactionGoal 和 OfflineConversionGoal。

已啟用配置檔擴充

決定是否要跨您的帳戶擴充LinkedIn配置檔目標，以觸及與您目前目標類似的其他客戶。

啟用配置檔目標擴充可讓Microsoft Advertising 向其他客戶顯示您的廣告，類似於您目前的目標廣告。 例如，如果您以特定LinkedIn物件區段為目標，我們也會以沒有已確認LinkedIn帳戶，但與該區段中LinkedIn用戶共用相同特性的 Bing 用戶為目標。

您可以透過大量和行銷活動管理 API 啟用或停用每個帳戶的功能。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 12.13.6 版的版本資訊。

2019 年 9 月

請參閱下方的 Bing 廣告 API 更新。

實驗類型

您現在可以透過實驗活動管理物件中的 ExperimentType 元素，或透過實驗大量記錄中的 [實驗類型] 字段來設定實驗分割類型。

實驗分割類型會決定要隨機顯示來自實驗和原始營銷活動的個別客戶廣告，或只顯示其中一個廣告。

可能的值包括 TrafficBased 和 CookieBased。

TrafficBased：這也稱為搜尋型選項。 每次客戶搜尋時，都會隨機顯示來自您實驗的廣告或原始營銷活動的廣告。 這表示，如果個別客戶搜尋多次，就可以看到來自這兩個來源的廣告。

CookieBased：當個別客戶搜尋時，我們會顯示來自您實驗或原始行銷活動的廣告，並使用 Cookie 來確保他們之後只會看到來自此來源的廣告。 Cookie 型選項有一個重要的取捨要考慮：一方面，您可能會取得更精確的數據，因為您要確保個別客戶只回應一個或另一個來源。 另一方面，相較於以搜尋為基礎的選項，您可能需要較長的時間來建立統計顯著的比較數據。

報表中的最終 URL 後綴

FinalUrlSuffix 數據行會新增至 AdPerformanceReportColumn 值集。 FinalUrlSuffix 數據行也可以透過 AdGroupPerformanceReportColumn、 CampaignPerformanceReportColumn、 DestinationUrlPerformanceReportColumn 和 KeywordPerformanceReportColumn 值集取得。

最後一個 URL 後綴是您最終 URL 中的位置，您可以在其中新增將附加至登陸頁面 URL 結尾的參數。

產品負數關鍵詞報告

已針對Microsoft購物活動新增 ProductNegativeKeywordConflictReportRequest 。 使用此報告來確認套用至購物活動的負面關鍵詞不會過度限制營銷活動效能。 您可以要求負面關鍵詞，以及它們無法在購物活動中顯示的對應產品。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 12.13.5 版的版本資訊。

2019 年 8 月

請參閱下方的 Bing 廣告 API 更新。

報表中的物件關聯層級

AssociationLevel 數據行會新增至 AudiencePerformanceReportColumn 值集。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 12.13.4 版的版本資訊。

2019 年 7 月

請參閱下方的 Bing 廣告 API 更新。

包含在轉換中

啟用 [包含在轉換中] 功能的客戶 (GetCustomerPilotFeatures 會傳回 574) 可以選擇從轉換報表數據中排除特定轉換目標。

任何轉換目標的 ExcludeFromBidding 屬性設定為 true 時，都會從 Conversions、ConversionRateCostPerConversionReturnOnAdSpendRevenuePerConversion、 和 Revenue 報表數據行中排除數據。 此外，如果您使用自動化的申請策略，將此屬性設定為 true 會導致目標的轉換不再納入自動化計算。

新) (、、、、 和 AllRevenue 數據行會包含所有轉換目標的數據，而不論其 ExcludeFromBidding 設定為何。AllConversionsAllCostPerConversionAllConversionRateAllRevenuePerConversionAllReturnOnAdSpend

如需詳細資訊，請參閱 轉換目標：「轉換」與「所有轉換」的說明文章。

在 7 月服務更新之後，下表摘要說明每個報表類型的所有可用轉換相關報表效能統計數據。

報告值集 可用的轉換數據行
AccountPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdDynamicTextPerformanceReportColumn AllConversions
AllConversionRate
AllCostPerConversion
轉換
ConversionRate
CostPerConversion
AdExtensionByAdReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdExtensionByKeywordReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdExtensionDetailReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdGroupPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AdPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
AgeGenderAudienceReportColumn AllConversions
AllRevenue
轉換
收入
AudiencePerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
CampaignPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ConversionPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
DestinationUrlPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
DSAAutoTargetPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
DSACategoryPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
DSASearchQueryPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
GeographicPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
GoalsAndFunnelsReportColumn AllConversions
AllRevenue
轉換
收入
KeywordPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ProductDimensionPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ProductPartitionPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ProductPartitionUnitPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ProductSearchQueryPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
RevenuePerConversion
ProfessionalDemographicsAudienceReportColumn AllConversions
AllRevenue
轉換
收入
PublisherUsagePerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
SearchQueryPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion
ShareOfVoiceReportColumn AllConversions
AllConversionRate
AllCostPerConversion
轉換
ConversionRate
CostPerConversion
UserLocationPerformanceReportColumn AllConversions
AllRevenue
AllConversionRate
AllCostPerConversion
AllReturnOnAdSpend
AllRevenuePerConversion
轉換
收入
ConversionRate
CostPerConversion
ReturnOnAdSpend
RevenuePerConversion

報表中的基底營銷活動標識碼

BaseCampaignId 數據行會新增至下列值集。

報表中的平均位置

AveragePosition 數據行會新增至 ProfessionalDemographicsAudienceReportColumn 值集。

報表中的物件關聯標識碼

AssociationId 數據行會新增至 AudiencePerformanceReportColumn 值集。

2019 年 6 月

請參閱下方的 Bing 廣告 API 更新。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 12.13.3 版的版本資訊。

最終 URL 後綴和自定義參數更新

最終 URL 後綴和自定義參數更新現在已在所有客戶的帳戶、行銷活動、廣告群組和關鍵詞層級正式推出。 廣告、廣告延伸模組和廣告群組準則的類似更新仍然僅適用於試驗客戶。

  • 最終 URL 後綴現在可在所有客戶的帳戶、行銷活動、廣告群組和關鍵詞層級取得。 最終 URL 後綴適用於第 2 階段試驗客戶的廣告、廣告延伸模組和廣告群組準則， (GetCustomerPilotFeatures 會傳回 566) 。 今年稍後，「最終 URL」後綴將適用於所有客戶的廣告、廣告延伸模組和廣告群組準則。
  • 針對營銷活動、廣告群組和關鍵詞，所有客戶的自定義參數限制已從 3 個增加到 8 個。 Microsoft Advertising 會接受您包含的前 8 個自定義參數索引鍵和值組，而且如果您包含超過 8 個自定義參數，則會傳回錯誤。 針對自定義參數限制增加階段 2 試驗的客戶 (GetCustomerPilotFeatures 會針對廣告、廣告延伸模組和廣告群組準則傳回 565) ，Microsoft Advertising 會接受您包含的前 8 個自定義參數索引鍵和值組，如果您包含超過 8 個自定義參數，則會傳回錯誤。 在 2019 日曆年度，所有客戶的廣告、廣告延伸模組和廣告群組準則限制將從 3 增加到 8。

星期一到星期日報表匯總

報告 API 會更新為支援星期一到星期日的每周匯總。 先前，您只能每周從星期日到星期六匯總。

WeeklyStartingMonday 值會新增至 ReportAggregation 值集。

ThisWeekStartingMonday、LastWeekStartingMonday 和 LastFourWeeksStartingMonday 值會新增至 ReportTimePeriod 值集。

強調度量

有了全新且改良的顯著度量，您現在可以更全面地檢視廣告在搜尋結果頁面上出現的位置。 這些更清楚的深入解析可協助您更妥善地優化您的策略。

AbsoluteTopImpressionRatePercent、AbsoluteTopImpressionShareLostToBudgetPercent、AbsoluteTopImpressionShareLostToRankPercent、TopImpressionRatePercent、TopImpressionShareLostToBudgetPercent、TopImpressionShareLostToRankPercent 和 TopImpressionSharePercent 數據行會新增至下列報表數據行值集。

依工具變更歷程記錄報告

變更歷程記錄報表現在可以使用 [ 工具 ] 資料行。 您可以判斷帳戶、行銷活動或廣告屬性的變更方式，例如透過Web用戶端、編輯器、大量上傳或營銷活動管理 API。

透過大量 API 的摘要

新增摘要和摘要專案大量記錄，以支援大量下載和上傳廣告自定義工具摘要和頁面摘要。

[頁面摘要標識符] 字段會新增至頁面摘要的營銷活動記錄。

2019 年 5 月

請參閱下方的 Bing 廣告 API 更新。

輔助轉換

輔助轉換是透過點選您的廣告而產生的轉換，這些廣告已收到製造商合作夥伴的共同報價。 此效能統計數據僅適用於Microsoft購物活動中的贊助產品。 AssistedConversions 數據行會新增至下列報表數據行值集。

動態搜尋廣告文字第 2 部分

動態搜尋廣告文字第 2 部分適用於試驗客戶， (GetCustomerPilotFeatures 傳回 600) 。 在今年稍後，所有客戶都會提供此功能。

TextPart2 元素可在 DynamicSearchAd Campaign Management 物件中取得。 [ 文字第 2 部分 ] 字段可在 動態搜尋廣告 大量記錄中取得。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 12.13.2 版的版本資訊。

2019 年 4 月

請參閱下方的 Bing 廣告 API 更新。

新增生產環境 OAuth 端點

適用於開發人員的 Microsoft 身分識別平台 端點現已可供使用。 Microsoft 身分識別平台 端點允許來自 Azure AD 的公司或學校帳戶，以及 MSA) (個人Microsoft帳戶，例如 hotmail.com、outlook.com 和 msn.com。 Live Connect 端點只允許使用個人帳戶進行驗證。

重要事項

即使您的用戶沒有公司或學校帳戶，即使您未使用 Bing 廣告 API SDK，我們仍建議您在 2019 年日曆年度更新授權 URL，因為 Live Connect 端點不再是Microsoft Advertising 用戶的建議方法。

Bing 廣告 API SDK 匯報

Bing Ads .NET、Java、Php 和 Python SDK 已更新，並支援第 13 版。 如需詳細資訊，請參閱 Microsoft Advertising .NET、 Java、 Php 和 Python SDK 12.13.1 版的版本資訊。

第 13 版正式運作

Bing 廣告 API 第 13 版現已正式推出。 隨著 Bing 廣告 API 版本 13 的可用性，第 12 版已被取代，並將於 2019 年 10 月 31 日停用。 如需詳細資訊，請 參閱移轉至第 13 版。

2019 年 3 月

請參閱下方的 Bing 廣告 API 更新。

版本 13 預覽

Bing 廣告 API 第 13 版可供預覽。 如需從第 12 版移轉的詳細資訊，請參閱 移轉至第 13 版。