Microsoft Advertising 腳本的版本資訊

如需每個版本所包含變更的相關資訊，請參閱下列各節。

2021 年 3 月 31 日

Microsoft Advertising 不再提供平均位置。

getAveragePosition方法會從Stats物件中移除。

AveragePosition 資料行會移除為具有下列選取器的條件。

2021 年 3 月 5 日

新增對絕對最高曝光率和最高曝光率的支援，以總曝光數的百分比表示。

已將下列方法新增至 Stats 物件。

已新增 AbsoluteTopImpressionRate 可 TopImpressionRate 使用下列選取器指定的 和 可能的資料行。

2021 年 2 月 23 日

已新增回應式搜尋廣告的支援。

  • 新增了 ResponsiveSearchAd 物件，以定義回應式搜尋廣告。

  • 新增了 ResponsiveSearchAdBuilder 物件，用來將展開的文字廣告新增至廣告群組。

  • 已將 responsiveSearchAdBuilder 方法新增至 AdBuilderSpace 物件。 如果您想要建置回應式搜尋廣告，請呼叫 responsiveSearchAdBuilder 方法來取得 ResponsiveSearchAdBuilder 物件。

  • 新增 AdTextAsset 物件，其中包含回應式搜尋廣告描述和標題的屬性。

  • responsiveSearchAd將 方法新增至AdTypeSpace物件，其中包含用來測試廣告是否為指定類型的方法。 例如，測試廣告是否為回應式搜尋廣告。

  • 已將 responsiveSearchAd 方法新增至 AdViewSpace 物件，該物件可用來將廣告轉換成特定類型。 例如，將基底廣告物件轉換成回應式搜尋廣告。

2021 年 1 月 21 日

已新增對目標和排除物件的支援。

這項變更新增了下列物件：

2020 年 12 月 10 日

已新增對目標和排除位置的支援。

這項變更新增了下列物件：

已新增 ExcludedLocationOperation 物件，用來判斷腳本是否成功新增排除的位置。

已新增 TargetedLocationOperation 物件，您可以用來判斷腳本是否已成功新增目標位置。

2020 年 3 月 31 日

新增下列衍生自 ProductGroup的物件：

已將下列方法新增至 ProductGroup：

  • asChannel()
  • asChannelExclusivity()

已從某些腳本範例中移除 對 Logger.Log () 的呼叫。 由於記錄在效能方面是耗費資源的呼叫，因此除了提供問題通知之外，指引是謹慎使用記錄，而且可能不在大量迴圈內。 此外，不要使用多個 Log() 呼叫來寫入多行，而是使用單一呼叫並包含分行符號 ('\n') 。

2020 年 1 月 16 日

已新增產品群組的支援。 支援僅限於列舉產品群組和更新其報價。 如需範例，請參閱 腳本範例。

這項變更新增了下列物件：

新增下列衍生自 ProductGroup的物件：

已將下列方法新增至 AdsApp：

已將下列方法新增至 AdGroup：

已將下列方法新增至 Cammpaign：

已將 CampaignType 新增為 AdGroupSelector 物件的 withCondition 方法的可能資料行。

已將 Type 新增為 CampaignSelector 物件的 withCondition 方法的可能資料行。

2019 年 10 月 18 日

將 資料 Id 行新增至 withCondition()AdSelector 和 KeywordSelector 物件的 方法。 您可以使用此資料行來檢查識別碼大於指定識別碼 (的廣告或關鍵字， withCondition('Id > 1234') 例如，) 。

已新增 Check ad 和關鍵字 URL 腳本解決方案，可用來檢查帳戶中的廣告或關鍵字是否包含損毀的 URL。

2019 年 10 月 7 日

已新增 CombinedApprovalStatus 為您在選取關鍵字時可指定的可能資料行。 例如，您可以使用 資料行來選取因編輯原因而取消核准的關鍵字。 請參閱 KeywordSelector.withCondition。

2019 年 9 月 13 日

新增 ExecutionInfo 物件，其中包含腳本目前正在執行之環境的相關資訊。 例如，如果腳本以預覽模式執行，或允許腳本繼續執行的時間量。

已將 getExecutionInfo 方法新增至 AdsApp 物件。 使用這個方法來取得 ExecutionInfo 物件。

已將 getRemainingDailyQuota 方法新增至 UrlFetchApp 物件。 使用此方法來取得使用者目前可以執行的 fetch() 剩餘呼叫數目。

2019 年 8 月 20 日

以下是僅限檔的變更。

  • 請厘清腳本會使用帳戶的時區，如同 Microsoft Advertising 中的其他地方一樣。 例如，如果您使用選取器的 .forDateRange () 方法，則腳本會使用帳戶的時區來判斷要傳回的資料。 深入瞭解
  • 請厘清腳本中的資料延遲與 Microsoft Advertising 中的其他位置相同。 深入瞭解

以下是支援標籤的非中斷性 API 變更。

  • 已將下列方法新增至 AdsApp 物件。
    • createLabel - 建立標籤
    • 標籤 — 取得用來篩選此帳戶中標籤清單的選取器
  • 已新增下列標籤相關物件。
  • 已將下列方法新增至 Keyword 物件。
    • applyLabel — 將標籤套用至 關鍵字
    • labels — 取得選取器，用來篩選套用至這個關鍵字的標籤清單
    • removeLabel - 從這個關鍵字移除標籤
  • 已將 LabelNames 資料行新增至 KeywordSelector 物件的 withCondition 方法。
  • 已將下列方法新增至 Ad 和 ExpandedTextAd 物件。
    • applyLabel — 將標籤套用至廣告
    • 標籤 — 取得選取器，用來篩選套用至此廣告的標籤清單
    • removeLabel - 從此廣告中移除標籤
  • 已將 LabelNames 資料行新增至 AdSelector 物件的 withCondition 方法。
  • 已將下列方法新增至 AdGroup 物件。
    • applyLabel — 將標籤套用至廣告群組
    • 標籤 — 取得用來篩選套用至此廣告群組之標籤清單的選取器
    • removeLabel - 從此廣告群組移除標籤
  • 已將 LabelNames 資料行新增至 AdGroupSelector 物件的 withCondition 方法。
  • 已將下列方法新增至 Campaign 物件。
    • applyLabel — 將標籤套用至行銷活動
    • labels - 取得選取器，用來篩選套用至此行銷活動的標籤清單
    • removeLabel - 從此行銷活動中移除標籤
  • 已將 LabelNames 資料行新增至 CampaignSelector 物件的 withCondition 方法。

2019 年 4 月 30 日

以下是僅限檔的變更。

  • Bing 廣告現在是 Microsoft Advertising。 我們的新名稱反映我們如何拓展廣告解決方案，以協助您觸及更多客戶。 檔中 Bing 廣告平臺的所有參考都已變更為 Microsoft Advertising。

以下是支援品牌更新的非中斷性 API 變更。

  • 已新增 AdsApp 物件。 為了回溯相容性，腳本將繼續支援 BingAdsApp 物件;不過，建議您更新腳本，以儘早使用新的物件。

2019 年 3 月 25 日

以下是僅限檔的變更。

2019 年 2 月 11 日

已將下列方法新增至 BingAdsAccountStats 物件。

注意事項

如果您使用 getClickConversionRate () 和 getConvertedClicks () 方法，您應該更新腳本以改用 getConversionRate () 和 getConversions () 方法。

已將下列方法新增至 Stats 物件。

注意事項

如果您使用 getClickConversionRate () 和 getConvertedClicks () 方法，您應該更新腳本以改用 getConversionRate () 和 getConversions () 方法。

2018 年 11 月 27 日

以下是僅限檔的變更。

2018 年 11 月 7 日

以下是僅限檔的變更。

  • 已變更預覽附注，以指出腳本目前為開放式 Beta，可供所有 Microsoft Advertising 使用者使用。

2018 年 10 月 4 日

這是腳本的 Beta 版本。 如需參與計畫的相關資訊，請連絡您的帳戶管理員。 腳本類別和檔可能會變更。

已新增下列物件以支援 URL 擷取。

  • 已新增 UrlFetchApp 物件，這是您用來從 Web 擷取資源的最上層物件。

  • 已新增 HTTPResponse，其中包含存取所擷取資源內容的方法。

  • 已新增 UrlFetch 限制 主題，其中列出從 Web 擷取資源的限制。

新增下列主題：

2018 年 10 月 2 日

已新增下列物件和方法來支援多重帳戶。

  • 已將 currentAccount 方法新增至 BingAdsApp。 使用此方法來取得 Account 物件，其中包含腳本目前正在處理之帳戶的相關資訊。

  • 已新增 AccountsApp 物件。 如果您要管理其他人的帳戶，這是您所使用的最上層物件。 使用它來取得您有權存取的帳戶清單，並選取要管理的帳戶。

  • 已新增 BingAdsAccount 物件。 使用它來取得受管理帳戶的帳戶資訊，例如名稱、客戶識別碼和帳戶層級效能資料。

  • 已新增 BingAdsAccountIterator 物件。 使用它來逐一查看您選取的受管理帳戶清單。

  • 已新增 BingAdsAccountSelector 物件。 使用它來選取您想要取得的受控帳戶清單。

  • 已新增 BingAdsAccountStats 物件。 使用它來存取受管理帳戶的效能資料。

  • 已新增 ExecutionResult 物件。 使用它來取得您在選取器方法中 executeInParallel 指定之函式的結果和傳回值 (請參閱 BingAdsAccountSelector) 。

已將下欄欄位新增至 Budget 物件，以支援共用預算。

  • 活動 - 取得選取器，傳回共用此預算的所有活動。
  • getEntityType - 取得物件的類型。
  • getId — 取得可唯一識別共用預算的識別碼。
  • getName - 取得共用預算的名稱。
  • getStats - 取得共用此預算之行銷活動的效能資料。
  • getType - 取得預算的類型 (例如 DAILY) 。
  • isExplicitlyShared - 取得布林值，指出此預算是否為共用預算。

getId、 getName 和 getStats 方法只會傳回共用預算的資料; getNamegetId 和 方法會針對未共用的 (個別行銷活動) 預算傳回 null。

已將下欄欄位新增至 BingAdsApp 物件。

  • budgets — 取得帳戶中的所有共用預算。 使用選取器來篩選共用預算的清單。

新增下列物件，用來篩選和迴圈共用預算清單。

  • BudgetSelector - 包含篩選和排序共用預算清單的方法。

  • BudgetIterator - 包含迴圈查看共用預算清單的方法。 選取器的 get 方法會傳回反覆運算器。

選取器只會傳回共用預算，不包含未共用的 (個別行銷活動) 預算。 若要判斷行銷活動是否使用個別預算，請呼叫行銷活動的 getBudget 方法來取得預算。 然後，呼叫預算的 isExplicitlyShared 方法來判斷是否共用預算。 如果 isExplicitlyShared 傳回 true，則會共用預算。

2018 年 10 月 1 日

已將下列方法新增至 Keyword 物件。

  • getQualityScore - 取得關鍵字的品質分數。 分數的範圍是 1 到 10 (最高) 。 分數會藉由測量關鍵字和登陸頁面與客戶搜尋詞彙的相關性，顯示廣告在市集上的競爭力。

2018 年 9 月 12 日

已新增下列方法來取得實體的父實體和子實體。

2018 年 9 月 9 日

新增廣告支援。

  • 已將 newAd 方法新增至 AdGroup。 方法會傳回 AdBuilderSpace 物件，用來取得廣告產生器。

  • 已新增 AdBuilderSpace 物件。 物件包含取得廣告產生器的方法。 例如，如果您想要建置展開的文字廣告，則會呼叫物件的 expandedTextAdBuilder 方法來取得 ExpandedTextAdBuilder 物件。

  • 新增 ExpandedTextAdBuilder 物件，用來將展開的文字廣告新增至廣告群組。

  • 已新增 AdOperation 物件，您可以用來判斷腳本是否已成功新增廣告。

  • 新增 AdViewSpace 物件，其中包含用來將廣告轉換成特定類型的方法。 例如，將基底廣告物件轉換成展開的文字廣告。

  • 新增 AdTypeSpace 物件，其中包含用來測試廣告是否為指定類型的方法。 例如，測試廣告是否為展開的文字廣告。

  • 新增 Ad 物件，這是基底廣告類型。 它也會定義文字廣告。

  • 已新增 AdUrls 物件，其中包含取得廣告 URL、追蹤範本和自訂參數的方法。

  • 新增 ExpandedTextAd 物件，定義展開的文字廣告。

  • 已新增 AdSelector 物件，您可以使用此物件來指定選取廣告的篩選準則。

  • 已新增 AdIterator 物件，您可以用來逐一查看篩選的廣告清單。

  • 已將 ads 方法新增至 BingAdsApp。 方法會傳回 AdSelector 物件，用來指定在帳戶中選取廣告的篩選準則。

  • 已將 ads 方法新增至 AdGroup。 方法會傳回 AdSelector 物件，用來指定在廣告群組中選取廣告的篩選準則。

  • 已將 ads 方法新增至 Campaign。 方法會傳回 AdSelector 物件，用來指定在行銷活動中選取廣告的篩選準則。

2018 年 6 月 15 日

已關閉 Beta 版本。 此版本的 Microsoft Advertising 腳本僅供選取參與者使用。 如需參與預覽發行計畫的資訊，請連絡您的帳戶管理員。 腳本類別和檔可能會變更。

此初始版本包含下列功能：

  • 核心行銷活動管理 (活動、廣告群組、關鍵字)
  • 實體層級 (活動、廣告群組、關鍵字)
  • 共用負數關鍵字清單
  • Last updated on