關鍵詞記錄 - 大量

發行項
02/01/2024

定義可在大量檔案中下載及上傳的關鍵詞。

您可以在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服務要求中包含 Keywords 的 DownloadEntity 值，以下載帳戶中的所有關鍵詞記錄。此外，下載要求必須包含 EntityData 範圍。若要在下載的行銷活動記錄中包含關鍵詞相關性、登陸頁面相關性、登陸頁面用戶體驗和品質分數字段，您也必須包含QualityScoreData範圍。如果您也包含 BidSuggestionsData 範圍，大量檔案也可以包含個別的關鍵詞最佳位置標定、關鍵詞主線標示，以及對應至每個下載關鍵詞的關鍵詞關鍵詞的第一頁標示。如需大量服務的詳細資訊，包括最佳做法，請參閱大量下載和上傳。

如果提供有效的父標識碼值，下列大量 CSV 範例會新增關鍵詞。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Keyword,Match Type,Bid,Param1,Param2,Param3,Name,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter,Bid Strategy Type
Format Version,,,,,,,,,,,,,,6.0,,,,,,
Keyword,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,red shoes,Broad,0.5,,,,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,,{_promoCode}=PROMO1; {_season}=summer,ManualCpc

如果您使用適用於 .NET、Java 或 Python 的 Bing Ads SDK ，您可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkKeyword 物件，而不是直接呼叫服務作業，並撰寫自定義程式代碼來剖析大量檔案中的每個字段。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkKeyword
var bulkKeyword = new BulkKeyword
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // Keyword object of the Campaign Management service.
    Keyword = new Keyword
    {
        // 'Bid' column header in the Bulk file
        Bid = new Bid
        {
            Amount = 0.50,
        },
        // 'Bid Strategy Type' column header in the Bulk file
        BiddingScheme = new ManualCpcBiddingScheme { },
        // 'Destination Url' column header in the Bulk file
        DestinationUrl = null,
        // 'Mobile Final Url' column header in the Bulk file
        FinalMobileUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://mobile.contoso.com/womenshoesale"
        },
        // 'Final Url' column header in the Bulk file
        FinalUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://www.contoso.com/womenshoesale"
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Match Type' column header in the Bulk file
        MatchType = MatchType.Broad,
        // 'Param 1 column header in the Bulk file
        Param1 = null,
        // 'Param 2' column header in the Bulk file
        Param2 = null,
        // 'Param 3' column header in the Bulk file
        Param3 = null,
        // 'Status' column header in the Bulk file
        Status = KeywordStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "red shoes",
        // 'Tracking Template' column header in the Bulk file
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
    },
};

uploadEntities.Add(bulkKeyword);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

針對 關鍵詞 記錄，大量檔案架構中提供下列屬性欄位。

廣告群組
出價
中標策略類型
行銷活動
用戶端識別碼
自定義參數
目的地 URL
編輯訴求狀態
編輯位置
編輯原因代碼
編輯狀態
編輯詞彙
最終 URL
最終 URL 後綴
Id
繼承的中標策略類型
關鍵字
關鍵詞相關性
登陸頁面相關性
登陸頁面用戶體驗
比對類型
行動裝置最終 URL
修改時間
Param1
Param2
Param3
父項識別碼
發行者國家/地區
質量分數
狀態
追蹤範本

廣告群組

包含關鍵詞的廣告組名。

添加： 唯讀和必要
更新： 唯讀和必要
刪除： 唯讀和必要

注意事項

若要新增、更新和刪除，您必須指定 [父標識符 ] 或 [ 廣告群組] 字段。

出價

每次有人按下您的廣告時，您想要支付的最大金額。

您使用相同的關鍵詞來向其他廣告商進行報價，因此一般而言，較高的報價有助於讓您的廣告顯示在搜尋結果頁面上更理想的位置。

您可以為每個關鍵詞設定自定義的報價，而不是使用預設的廣告群組層級的約定。關鍵詞的自定義標示會覆寫這些特定關鍵詞的廣告群組默認報價。透過自定義的報價，您可以將時間和金錢放在最獲利的關鍵詞上，但需要花更多時間來管理個別的報價。

如果未設定關鍵詞層級的約定，則會使用廣告群組的「徵用」。如需詳細資訊，請參閱預算和中標策略。

添加： 選
更新： 選。如果未設定更新的值，則此設定不會變更。如果您將此欄位設定為 delete_value 字串，則會移除先前的設定。
刪除： 唯讀

中標策略類型

您要如何管理您的報價的中標策略類型。

廣告群組和關鍵詞的中標策略類型為「InheritFromParent」。。

注意事項

自 2021 年 4 月起，您無法為廣告群組或關鍵詞設定任何報價策略。如果您嘗試設定廣告群組或關鍵詞的報價策略，則會忽略要求而不會發生錯誤。廣告群組和關鍵詞會繼承其營銷活動的報價策略。

添加： 選
更新： 選。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

行銷活動

包含關鍵詞的營銷活動名稱。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

用戶端識別碼

用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。它可以是長度上限為100的任何有效字串。

添加： 選
更新： 選
刪除： 唯讀

自定義參數

用於 URL 追蹤的自訂索引鍵和值參數集合。

在大量檔案中，自定義參數清單的格式如下。

將每個自定義參數位格式化為 Key=Value，例如 {_promoCode}=PROMO1。
Microsoft Advertising 會接受您包含的前 8 個自定義參數索引鍵和值組，如果您包含超過 8 個自定義參數，則會傳回錯誤。每個索引鍵和值組都會以分號和空格 ( 分隔」;“) ，例如 {_promoCode}=PROMO1;{_season}=summer。
索引鍵不能包含分號。如果 Value 包含分號，則必須以 '\;' 逸出。此外，如果 Value 包含反斜杠，也必須以『\』逸出。
密鑰不能超過 16 UTF-8 位元組，而且值不能超過 250 UTF-8 位元組。索引鍵是必要的，而 Value 是選擇性的。密鑰的大小上限不包含大括弧和底線，也就是 '{'、'_' 和 '}'。

注意事項

使用大量服務時，密鑰必須以括弧和前置底線格式化，例如，如果 Key 為 promoCode，則必須格式化為 {_promoCode}。使用行銷活動管理服務時，您無法指定括弧和底線。

添加： 選
更新： 選。如果未設定更新的值，則此設定不會變更。若要移除所有自定義參數，請將此字段設定 為 delete_value。 delete_value關鍵詞會移除先前的設定。若要移除自定義參數的子集，請指定您想要保留的自定義參數，並省略任何您不想要保留的參數。新的自定義參數集將取代任何先前的自定義參數集。
刪除： 唯讀

目的地 URL

當使用者按兩下廣告時，要帶使用者前往的網頁URL。如果指定，則會使用關鍵詞的目的地 URL;否則會使用廣告的目的地 URL。

重要事項

自 2018 年 11 月起，無法新增或更新關鍵詞目的地 URL。您可以改用最終 URL ，否則 Microsoft Advertising 會使用廣告的最終 URL。如需詳細資訊，請參閱將關鍵詞目的地 URL 移轉至最終 URL。

添加： 不允許
更新： 不允許
刪除： 唯讀

編輯訴求狀態

判斷您是否可以對編輯檢閱所發現的問題發出意見反應。

下表說明可能的值。

值	描述
上訴	編輯問題很吸引人。
訴求附加	編輯問題是可訴求的，而且已提交訴求。
NotAppealable	編輯問題無法吸引人。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

編輯位置

編輯檢閱失敗之關鍵詞的元件或屬性。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

編輯原因代碼

識別失敗原因的程序代碼。如需可能的原因代碼清單，請參閱編輯原因代碼。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

編輯狀態

關鍵詞的編輯狀態。

下表說明可能的值。

值	描述
作用中	關鍵詞已通過編輯檢閱。
ActiveLimited	關鍵詞已在一或多個市場中通過編輯檢閱，而關鍵詞的一或多個元素正在另一個市場中進行編輯檢閱。例如，關鍵詞已通過加拿大的編輯檢閱，而且仍在美國中暫止檢閱。
反對	關鍵詞失敗的編輯檢閱。
非作用中	關鍵詞的一或多個元素正在進行編輯檢閱。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

編輯詞彙

失敗的編輯檢閱詞彙。

如果字詞組合造成失敗，或失敗是以原則違規為基礎，則不會設定此字段。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

最終 URL

登陸頁面 URL。如果指定，則會使用關鍵詞的最終URL;否則，會使用廣告的最終 URL。

下列驗證規則適用於最終 URL 和最終行動 URL。

URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。
您最多可以為最終 URL 和最終行動 URL 指定 10 個專案;不過，只有每個清單中的第一個專案會用於傳遞。此服務最多可允許 10 個，以取得潛在的向前相容性。
每個 URL 都會以分號和空格分隔 (」;“) 。
僅允許使用 '{' 和 '}' 來描述標記，例如 “{lpurl}”。
每個 URL 都必須是格式正確的 URL，開頭為 http:// 或 https://。
如果您指定 [最終行動 URL]，則也必須指定 [最終 URL]。

另請注意，如果已設定 [追蹤範本 ] 或 [ 自定義參數] 字 段，則需要 [最終 URL] 字 段。

最終 URL 後綴

最終的 URL 後綴可以包含將附加至登陸頁面 URL 結尾的追蹤參數。建議您在最後的 URL 後綴中放置登陸頁面所需的追蹤參數，讓您的客戶一律傳送至您的登陸頁面。如需詳細資訊和驗證規則，請參閱技術指南中的最終 URL 後綴。

Id

系統產生的關鍵詞標識碼。

添加： 選。您必須將此欄位保留空白，或指定負識別碼。接著，您可以在相依記錄類型的 [ 父標識符] 字段中參考關鍵詞的負標識符集，例如關鍵詞標籤。如果您要在相同的大量檔案中新增新關鍵詞和新的相依記錄，建議您這麼做。如需詳細資訊，請參閱大量檔案架構參考密鑰。
更新： 唯讀和必要
刪除： 唯讀和必要

繼承的中標策略類型

如果關鍵詞的 Bid 策略類型設定為 InheritFromParent，則為繼承自父行銷活動或廣告群組的中標策略類型。此值等於上層行銷活動或廣告群組的 [ 標定策略類型] 字 段。可能的值為 EnhancedCpc、 ManualCpc、 MaxClicks、 MaxConversions、 TargetCpa 和 TargetRoas。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

關鍵字

關鍵詞文字。

文字最多可以包含100個字元。

您應該在為關鍵詞所屬的廣告群組指定之 Language 值的地區設定中指定關鍵詞。

添加： 必填
更新： 唯讀
刪除： 唯讀

關鍵詞相關性

數值分數，指出您的廣告被點選的可能性，以及關鍵詞與其他以相同流量為目標的關鍵詞競爭的程度。此分數會預測您的關鍵詞是否可能導致單擊您的廣告，並考慮關鍵詞在過去相對於廣告位置的執行效能。

注意事項

關鍵詞相關性相當於 Microsoft Advertising Web 應用程式中所使用的 預期 Click-Through 速率 標籤。

分數為 3 高於平均;分數為2是平均;而分數為 1 會被視為低於平均值。

如果您指定跨越多個天的時間週期，則該時間週期中每天的分數會相同，且值是最新的計算分數。

此數據行的數據通常會在UTC日結束後的14-18小時更新。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

登陸頁面相關性

數值分數，指出您的廣告和登陸頁面與客戶的搜尋查詢或其他輸入有何關聯。

注意事項

登陸頁面相關性相當於 Microsoft Advertising Web 應用程式中使用的 廣告相關性 標籤。

分數為 3 高於平均;分數為2是平均;而分數為 1 會被視為低於平均值。

如果您指定跨越多個天的時間週期，則該時間週期中每天的分數會相同，且值是最新的計算分數。

此數據行的數據通常會在UTC日結束後的14-18小時更新。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

登陸頁面用戶體驗

數值分數，指出登陸頁面是否可能為單擊您的廣告並登陸網站的客戶提供良好的體驗。

注意事項

登陸頁面用戶體驗相當於 Microsoft Advertising Web 應用程式中使用的 登陸頁面體驗 標籤。

分數為 3 高於平均;分數為2是平均;而分數為 1 會被視為低於平均值。

如果您指定跨越多個天的時間週期，則該時間週期中每天的分數會相同，且值是最新的計算分數。

此數據行的數據通常會在UTC日結束後的14-18小時更新。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

比對類型

要比較關鍵詞和用戶搜尋字詞的相符類型。

關鍵詞支援的相符類型值為 Broad、 Exact 和 Phrase。

注意：如果您已為搜尋活動啟用預測性目標，則比對類型為 “Predictive”。在此情況下，您無法新增、更新和刪除比對類型，因為我們使用預測性目標來比對您的廣告與相關的搜尋查詢。

添加： 必填
更新： 選。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

行動裝置最終 URL

行動登陸頁面 URL。如果指定，則會使用關鍵詞的最終行動URL;否則，會使用廣告的最終行動URL。

下列驗證規則適用於最終 URL 和最終行動 URL。

URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。
您最多可以為最終 URL 和最終行動 URL 指定 10 個專案;不過，只有每個清單中的第一個專案會用於傳遞。此服務最多可允許 10 個，以取得潛在的向前相容性。
每個 URL 都會以分號和空格分隔 (」;“) 。
僅允許使用 '{' 和 '}' 來描述標記，例如 “{lpurl}”。
每個 URL 都必須是格式正確的 URL，開頭為 http:// 或 https://。
如果您指定 [最終行動 URL]，則也必須指定 [最終 URL]。

另請注意，如果已設定 TrackingUrlTemplate 或 UrlCustomParameters 元素，則至少需要一個最終 URL。

修改時間

上次更新實體的日期和時間。值為國際標準時間 (UTC)。

注意事項

日期和時間值會反映伺服器上的日期和時間，而不是用戶端。如需日期和時間格式的相關信息，請參閱基本 XML 數據類型中的 dateTime 專案。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

Param1

如果廣告的標題、文字、顯示 URL 或目的地 URL 包含 {Param1} 動態替代字串，則要作為廣告替代值的字串串。

注意事項

雖然您可以使用 {Param1} 來指定廣告的目的地 URL，但建議您不要這麼做。相反地，您應該設定關鍵詞的 DestinationUrl 元素。

字串最多可以包含 1,022 個字元。實際的限制取決於參考替代字串的項目長度。例如，文字廣告標題的長度最多可以包含 25 個字元。

在廣告復本中實作動態文字時，您應該提供預設字串，例如{Param1：default}，如果關鍵詞的 Param1 為 Null 或空白，或包含 Param1 替代值，則會造成展開的字符串超過元素的限制;否則，廣告將不會與這個關鍵詞一起使用。如需詳細資訊，請參閱 Microsoft Advertising 說明文章使用動態文字參數自動自定義您的廣告。

另請注意，如果廣告群組只有一個廣告，而且該廣告使用 {Param1}，但未提供預設字串，例如 {Param1：default}，則您必須為該替代提供有效的 Param1 值。否則無法新增或更新這個關鍵詞。

Param2

如果標題、文字、顯示 URL 或目的地 URL 包含 {Param2} 動態替代字串，則要作為廣告替代值的字串。

一般而言，您會在廣告的標題或文字中使用 {Param2} 替代字串 (廣告複製描述) 元素。

字串最多可以包含 70 個字元。實際的限制取決於參考替代字串的項目長度。例如，文字廣告標題的長度最多可以包含 25 個字元。

在廣告復本中實作動態文字時，您應該提供預設字串串，例如{Param2：default}，如果關鍵詞的 Param2 為 Null 或空白，或包含 Param2 替代值，則會造成展開的字符串超過元素的限制;否則，廣告將不會與這個關鍵詞一起使用。如需詳細資訊，請參閱 Microsoft Advertising 說明文章使用動態文字參數自動自定義您的廣告。

另請注意，如果廣告群組只有一個廣告，而且該廣告使用 {Param2}，但未提供預設字串，例如 {Param2：default}，則您必須為該替代提供有效的 Param2 值。否則無法新增或更新這個關鍵詞。

Param3

如果標題、文字、顯示 URL 或目的地 URL 包含 {Param3} 動態替代字串，則要作為廣告替代值的字串。

一般而言，您會在廣告的標題或文字 (廣告複製描述) 元素中使用 {Param3} 替代字串。

字串最多可以包含 70 個字元。實際的限制取決於參考替代字串的項目長度。例如，文字廣告標題的長度最多可以包含 25 個字元。

在廣告復本中實作動態文字時，您應該提供預設字串串，例如{Param3：default}，如果關鍵詞的 Param3 為 Null 或空白，或包含 Param3 替代值，則會造成展開的字符串超過元素的限制;否則，廣告將不會與這個關鍵詞一起使用。如需詳細資訊，請參閱 Microsoft Advertising 說明文章使用動態文字參數自動自定義您的廣告。

另請注意，如果廣告群組只有一個廣告，而且該廣告使用 {Param3}，但未提供預設字串，例如 {Param3：default}，則您必須為該替代提供有效的 Param3 值。否則無法新增或更新這個關鍵詞。

父項識別碼

系統產生的標識碼，包含關鍵詞的廣告群組。

此大量欄位會對應至廣告群組記錄的 [標識符] 欄位。

添加： 唯讀和必要。您必須指定現有的廣告群組標識符，或指定等於父代 Ad Group 記錄之 [標識符] 字段的負標識符。如果您要將新關鍵詞新增至相同大量檔案中的新廣告群組，則建議您這麼做。如需詳細資訊，請參閱大量檔案架構參考密鑰。
更新： 唯讀
刪除： 唯讀

注意事項

若要新增、更新和刪除，您必須指定 [父標識符 ] 或 [ 廣告群組] 字段。

發行者國家/地區

發行者國家或地區的清單，其編輯指導方針不允許指定的詞彙。

在大量檔案中，發行者國家或地區的清單會以分號分隔 (;) 。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

質量分數

數值分數會測量關鍵詞和登陸頁面與客戶搜尋詞彙的關聯性，以顯示廣告在市集上的競爭力。品質分數是由 Microsoft Advertising 使用關鍵詞相關性、登陸頁面相關性和登陸頁面用戶體驗子分數來計算。如果有的話，品質分數的範圍可以從低 1 到高 10。

品質分數是以擁有和操作的搜尋流量過去 30 天為依據。如果關鍵詞的報價未贏得任何廣告，則可以指派品質分數，而不會有任何曝光。同步網路的流量不會影響品質分數。如果未計算分數，檔案中的值會是 “” (空字串) 。如果關鍵詞在 30 天以上沒有曝光，就可能發生這種情況。

品質分數通常會在UTC日結束後的14-18小時更新。所有時區中的關鍵詞都會被指派對應UTC日的品質分數。

如果您在一天中多次執行報表，品質分數值可能會根據您執行報表時相對於計算分數的時間，從報表變更為報表。

如果您指定跨越多天的時段，品質分數是目前和最近計算的分數，而且在該期間的每一天都會報告為相同。使用歷史品質分數來瞭解品質分數可能會隨著時間變更。歷程記錄品質分數是滾動品質分數的每日快照集。如需歷史品質分數的詳細資訊，請參閱報表屬性和效能統計數據中的HistoricalQualityScore資料行。

添加： 唯讀
更新： 唯讀
刪除： 唯讀

狀態

關鍵詞的狀態。

可能的值為 Active、 Paused、 Inactive 或 Deleted。

添加： 選。預設值為 Active。
更新： 選。如果未設定更新的值，則此設定不會變更。
刪除： 必填。 [狀態] 必須設定為 [ 已刪除]。

追蹤範本

要作為使用 FinalUrls 所指定 URL 預設值的追蹤範本。

下列驗證規則適用於追蹤範本。如需支援的範本和參數的詳細資訊，請參閱 Microsoft Advertising 說明文章我可以使用哪些追蹤或 URL 參數？

針對較低層級實體定義的追蹤範本，例如廣告會覆寫針對較高層級實體所設定的範本，例如營銷活動。如需詳細資訊，請參閱實體限制。
追蹤範本的長度限製為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。
追蹤範本必須是格式正確的 URL，開頭為下列其中一項： http://、 https://、 {lpurl} 或 {unescapedlpurl}。
Microsoft Advertising 不會驗證自定義參數是否存在。如果您在追蹤範本中使用自定義參數，但它們不存在，則登陸頁面 URL 會包含自定義參數的索引鍵和值佔位元，而不需替代。例如，如果您的追蹤範本是 https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}，且 { _season} 或 {_promocode} 都未定義於行銷活動、廣告群組、準則、關鍵詞或廣告層級，則登陸頁面 URL 會相同。

共用方式為

關鍵詞記錄 - 大量

廣告群組

出價

中標策略類型

行銷活動

用戶端識別碼

自定義參數

目的地 URL

編輯訴求狀態

編輯位置

編輯原因代碼

編輯狀態

編輯詞彙

最終 URL

最終 URL 後綴

Id

繼承的中標策略類型

關鍵字

關鍵詞相關性

登陸頁面相關性

登陸頁面用戶體驗

比對類型

行動裝置最終 URL

修改時間

Param1

Param2

Param3

父項識別碼

發行者國家/地區

質量分數

狀態

追蹤範本

意見反應

其他資源