共用方式為

動態搜尋廣告記錄 - 大量

  • 發行項

定義可在大量檔案中下載並上傳的動態搜尋廣告。

使用動態搜尋廣告時，標題和顯示 URL 會根據您想要設為目標的網站網域和語言自動產生。 Path1、Path2 和 Text 元素的組合讓動態搜尋廣告成為唯一的。 您可以選擇性地使用 頁面摘要來提供靜態標題。

注意事項

這項功能目前適用于下列國家/地區： (AL) 、Andorra (AD) 、 阿根廷 (AR) 、Aruba、Australia (AU) 、奧地利 (AT) 、巴哈馬 (BS) 、孟加拉國 (BD) 、比利時 (BE) 、加勒 (BO) 、波士尼亞和赫塞哥維尼亞 (BA) 、巴西 (BR) 、 汶萊 (BN) 、保加利亞 (BG) 、加拿大 (CA) 、開曼群島 (KY) 、 挪威 (CL) 、哥倫比亞 (CO) 、加西亞 (CR) 、克羅埃西亞 (HR) 、 (CY) 、捷克 (CZ) 、丹麥 (DK) 、亞馬亞 (DM) 、挪威共和國 (DO) 、 愛沙尼亞 (EC) 、El France (SV) 、愛沙尼亞 (EE) 、愛沙尼亞 (FJ) 、芬蘭 (FI) 、法國 (FR) 、 法屬 guiana (GF) 、法屬 Polynesia (PF) 、德國 (DE) 、希臘 (GR) 、關島 (GU) 、 (GT) 、Guyana (GY) 、 (HT) 、 匈牙利 (HN) 、匈牙利 (HU) 、印度 (IS) 、印度 (IN) 、印尼 (識別碼) 愛爾蘭 (IE) 、義大利 (IT) 、拉脫維亞 (LV) 、列支敦斯登 (LI) 、立陶宛 (LT) 、盧森堡 (LU) 、馬來西亞 (MY) 、Maldives (MV) 、 (MT) 、 馬提尼 (MQ) 、墨西哥 (MX) 、 (MC) 、蒙古 (MN) 、蒙特內哥羅 (ME) 、 Montserrat (MS) ， Republic (NP) ， 荷蘭 (NL) ， New Caledonia (NC) ， 紐西蘭 (NZ) ， 北馬其頓共和國 (MK) ， 挪威 (NO) ， (PA) ， 幾內亞 (PY) 、巴布亞紐幾內亞 (PG) 、秘魯 (PE) 、幾內亞 (PH) 、 波蘭 (PO) 、葡萄牙 (PT) 、波多黎各、羅馬尼亞 (RO) 、San Marino (SM) 、塞爾維亞 (RS) 、新加坡 (SG) 、斯洛伐克 (SK) 、斯洛維尼亞 (SI) 、南非 (ZA) 西班牙 (ES) 、西班牙 (ES) 、斯拉西亞 (LK) 、瑞典 (SE) 、瑞士 (CH) 、 泰國 (TH) 、Trinidad 和 Tobago (TT) 、Türkiye (TR) 、 (VA) 、越南 (VN) 、英國 (UK) 、美國 (US) 、 (UY) 、 和[和安全 (VE) 。

動態搜尋廣告記錄只能在具有有效動態搜尋廣告設定的搜尋活動中建立， (由 [ 網域語言]、[ 已啟用動態描述]、[ 頁面摘要標識符]、[ 來源] 和 [ 網站] 欄位) 組成。 必須設定行銷活動的 實驗標識 符，而且 廣告群組類型 必須設定為 「SearchDynamic」。

注意事項

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

您可以在DownloadCampaignsByAccountIds或DownloadCampaignsByCampaignIds服務要求中包含DynamicSearchAds的DownloadEntity值，以下載帳戶中的所有動態搜尋 Ad記錄。 此外，下載要求必須包含 EntityData 範圍。 如需大量服務的詳細資訊，包括最佳做法，請參閱 大量下載和上傳。

如果提供有效的 父標識 符值，下列大量 CSV 範例會新增動態搜尋廣告。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter,Title Part 1,Title Part 2,Path 1,Path 2
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,,
Dynamic Search Ad,Active,,-1113,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,Find New Customers & Increase Sales! Start Advertising on Contoso Today.,,,,,,,,,,,,{_promoCode}=PROMO1; {_season}=summer,,,seattle,shoe sale

如果您使用適用于 .NET、JAVA 或 Python 的 Bing 廣告 SDK ，您可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkDynamicSearchAd 物件，而不是直接呼叫服務作業，並撰寫自訂程式碼來剖析大量檔案中的每個欄位。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkDynamicSearchAd
var bulkDynamicSearchAd = new BulkDynamicSearchAd
{
    // '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 
    // DynamicSearchAd object of the Campaign Management service.
    DynamicSearchAd = new DynamicSearchAd
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Path 1' column header in the Bulk file
        Path1 = "seattle",
        // 'Path 2' column header in the Bulk file
        Path2 = "shoe sale",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "Find New Customers & Increase Sales! Start Advertising on Contoso Today.",
        // '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(bulkDynamicSearchAd);

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

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

針對 動態搜尋廣告 記錄， 大量檔案架構中提供下列屬性欄位。 [路徑 1]、[路徑 2] 和 [文字] 欄位的組合，讓動態搜尋廣告成為唯一的。

廣告群組

包含廣告的廣告組名。

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

注意事項

若要新增、更新和刪除，您必須指定 [父識別碼 ] 或 [ 廣告群組] 欄位。

行銷活動

包含廣告群組和廣告的行銷活動名稱。

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

用戶端識別碼

用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為 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關鍵字會移除先前的設定。 若要移除自訂參數的子集，請指定您想要保留的自訂參數，並省略任何您不想要保留的參數。 新的自訂參數集將取代任何先前的自訂參數集。
刪除： 唯讀

編輯訴求狀態

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

下表說明可能的值。

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

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

編輯位置

編輯檢閱失敗的廣告元件或屬性。

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

編輯原因代碼

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

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

編輯狀態

廣告的編輯狀態。

下表說明可能的值。

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

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

編輯詞彙

失敗的編輯檢閱詞彙。

如果字片語合造成失敗，或失敗是以原則違規為基礎，則不會設定此欄位。

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

最終 URL 尾碼

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

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

識別碼

系統產生的廣告識別碼。

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

修改時間

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

注意事項

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

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

父項識別碼

包含廣告之廣告群組的系統產生識別碼。

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

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

注意事項

若要新增、更新和刪除，您必須指定 [父識別碼 ] 或 [ 廣告群組] 欄位。

路徑 1

選擇性路徑的第一個部分，將附加至顯示 URL 的網域部分。 顯示 URL，例如 www.contoso.com 會從顯示 URL 的網域產生。 然後，如果您已指定 Path 1 的值，它會附加至顯示 URL。 如果您也指定 了 Path 2的值，則它也會附加至 Path 1之後的顯示 URL。 例如，如果您的網域 contoso.com， 路徑 1 設定為 subdirectory1， 而 Path 2 設為 subdirectory2，則顯示的 URL 將會 www.contoso.com/subdirectory1/subdirectory2。

路徑的最大輸入長度為 15 個字元。 請注意，對於具有雙寬字元的語言，例如繁體中文，路徑的最大輸入長度為 7 個字元。

路徑可以包含 IF 和 倒數函式 。 不論所有未命名倒數參數的總長度為何，最終顯示的倒數計時一律會使用可用字元總數中的 8 個字元。 如需詳細資訊，請參閱 倒數自訂工具。

路徑不能包含正斜線 (/) 或分行符號 (\n) 字元。

如果路徑包含空格，則會在廣告顯示時以底線 (_) 取代。

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

路徑 2

選擇性路徑的第二個部分，將附加至顯示 URL 的網域部分。 顯示 URL，例如 www.contoso.com 會從動態搜尋廣告行銷活動層級設定的網域產生。 然後，如果您已指定 Path 1 的值，它會附加至顯示 URL。 如果您也指定 了 Path 2的值，則它也會附加至 Path 1之後的顯示 URL。 例如，如果您的網域 contoso.com， 路徑 1 設定為 subdirectory1， 而 Path 2 設為 subdirectory2，則顯示的 URL 將會 www.contoso.com/subdirectory1/subdirectory2。

如果也已設定路徑 1，您只能指定Path 2。

路徑的最大輸入長度為 15 個字元。 請注意，對於具有雙寬字元的語言，例如繁體中文，路徑的最大輸入長度為 7 個字元。

路徑可以包含 IF 和 倒數函式 。 不論所有未命名倒數參數的總長度為何，最終顯示的倒數計時一律會使用可用字元總數中的 8 個字元。 如需詳細資訊，請參閱 倒數自訂工具。

路徑不能包含正斜線 (/) 或分行符號 (\n) 字元。 如果路徑包含空格，則會在廣告顯示時以底線 (_) 取代。

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

發行者國家/地區

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

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

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

狀態

廣告的狀態。

可能的值為 Active、 Paused或 Deleted。

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

文字

廣告描述的第一個部分。

文字必須至少包含一個字。

複製的最大輸入長度為 90 個字元。 請注意，對於使用繁體中文的廣告群組，複本的最大輸入長度為 45 個字元。

文字可以包含 IF 和 倒數函式 。 不論所有未命名倒數參數的總長度為何，最終顯示的倒數計時一律會使用可用字元總數中的 8 個字元。 如需詳細資訊，請參閱 倒數自訂工具。

文字不能包含分行符號 (\n) 字元。

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

文字第 2 部分

廣告描述的第二個部分。

文字必須至少包含一個字。

複製的最大輸入長度為 90 個字元。 請注意，對於使用繁體中文的廣告群組，複本的最大輸入長度為 45 個字元。

文字可以包含 IF 和 倒數函式 。 不論所有未命名倒數參數的總長度為何，最終顯示的倒數計時一律會使用可用字元總數中的 8 個字元。 如需詳細資訊，請參閱 倒數自訂工具。

文字不能包含分行符號 (\n) 字元。

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

追蹤範本

要作為使用 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 會相同。

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