回應式搜尋廣告記錄 - 大量

定義搜尋網路中文字廣告的回應式搜尋廣告格式，可在大量檔案中下載並上傳。

注意事項

相同廣告群組中允許重複的回應式搜尋廣告。

回應式搜尋廣告可讓您在 3-15 個唯一廣告標題之間設定， (名稱「標題」) 和單一廣告內的 2-4 個廣告描述。 從該處，Bing 會為每個指定的查詢和對應的搜尋用戶選取最相關的標題和描述組合。 藉由允許 Bing AI 為每個查詢選取最相關的標題和描述，我們確保正確的訊息會在正確的時間到達您每個潛在客戶的所有可能意圖訊號。

向使用者顯示的回應式廣告看起來與展開的文字廣告相同，也就是透過展開的文字廣告) 最多 3 個標題 (標題元件，以及透過展開的文字廣告) (文字元件的 2 個描述。 不過，視螢幕大小而定，您的廣告可能會在沒有第三個標題或第二個描述的情況下顯示。

當您建立回應式搜尋廣告時， [描述 ] 和 [ 標題 ] 列表會儲存為文字資產，可供帳戶內任何回應式搜尋廣告共用。 例如，如果「無縫整合」是文字資產，您會發現它在連結至相同 Microsoft Advertising 帳戶中「無縫整合」的所有廣告上都有相同的資產標識符。 上傳文字資產之後，結果檔案會包含資產標識符，例如 ， ""id:""123不論資產是新的還是已經存在於帳戶的資產庫中。

注意事項

回應式搜尋廣告只能在 廣告群組類型 設定為 「SearchStandard」 的搜尋活動中建立。 如果 廣告群組類型 設定為 「SearchDynamic」，則廣告群組不支持回應式搜尋廣告。

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

如果提供有效的 父標識 碼值，下列大量 CSV 範例會新增回應式搜尋廣告。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Ad Format Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter,Description,Path 1,Path 2,Domain,Headline
Format Version,,,,,,,,,6.0,,,,,,,,,,,,
Responsive Search Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,False,,,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,,{_promoCode}=PROMO1; {_season}=summer,"[{""text"":""Find New Customers & Increase Sales!"",""pinnedField"":""Description1""},{""text"":""Start Advertising on Contoso Today.""}]",seattle,shoe sale,,"[{""text"":""Contoso"",""pinnedField"":""Headline1""},{""text"":""Quick & Easy Setup""},{""text"":""Seamless Integration""}]"

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkResponsiveSearchAd
var bulkResponsiveSearchAd = new BulkResponsiveSearchAd
{
    // '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 
    // ResponsiveSearchAd object of the Campaign Management service.
    ResponsiveSearchAd = new ResponsiveSearchAd
    {
        // 'Description' column header in the Bulk file
        Descriptions = new AssetLink[]
        {
            // Each AssetLink is represented as a JSON list item in the Bulk file.
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Find New Customers & Increase Sales!"
                },
                PinnedField = "Description1"
            },
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Start Advertising on Contoso Today."
                },
            },
        },
        // '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"
        },
        // 'Headline' column header in the Bulk file
        Headlines = new AssetLink[]
        {
            // Each AssetLink is represented as a JSON list item in the Bulk file.
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Contoso"
                },
                PinnedField = "Headline1"
            },
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Quick & Easy Setup"
                },
            },
            new AssetLink
            {
                Asset = new TextAsset
                {
                    Text = "Seamless Integration"
                },
            },
        },
        // 'Id' column header in the Bulk file
        Id = responsiveSearchAdIdKey,
        // '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,
        // '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(bulkResponsiveSearchAd);

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

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

對於 回應式搜尋廣告 記錄， 大量檔案架構中提供下列屬性欄位。

• 廣告群組
• 行銷活動
• 用戶端識別碼
• 自定義參數
• 描述
• 網域
• 編輯訴求狀態
• 編輯位置
• 編輯原因代碼
• 編輯狀態
• 編輯詞彙
• 最終 URL
• 標題
• 最終 URL 後綴
• Id
• 行動裝置最終 URL
• 修改時間
• 父項識別碼
• 路徑 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關鍵詞會移除先前的設定。 若要移除自定義參數的子集，請指定您想要保留的自定義參數，並省略任何您不想要保留的參數。 新的自定義參數集將取代任何先前的自定義參數集。
刪除： 唯讀

描述

Bing 可用來優化廣告版面配置的描述清單。

為了將所有廣告格式的曝光率最大化，描述不一定會顯示在您的廣告中。

除非您將其中一個描述釘選到特定位置，否則 Bing 會以使用者搜尋查詢的最佳標題和描述動態優化廣告版面配置。

從數據模型的觀點來看，描述會儲存為文字資產。 多個廣告可以使用相同的資產。 例如，如果「無縫整合」是文字資產，則在相同 Microsoft Advertising 帳戶中的所有廣告上都會有相同的資產標識符。

您必須設定 2-4 個描述。 這些描述會在大量檔案中以 JSON 字串表示。 下列範例 JSON 包含兩個描述，第一個描述會釘選到特定位置。 和 idtext 是資產的屬性，而 editorialStatus 和 pinnedField 是資產鏈接的屬性，也就是資產與廣告之間的關聯性。 如需詳細資訊，請參閱下方 的編輯狀態、 標識符、 pinnedField 和 文字 。

[{
	"text": "Find New Customers & Increase Sales!",
	"pinnedField": "Description1"
},
{
	"text": "Start Advertising on Contoso Today."
}]

注意事項

在逗號分隔的大量檔案中，您必須以一組額外的雙引號括住資產連結清單、每個屬性索引鍵，以及每個屬性字串值，例如，上述 JSON 字串會寫成 “[{”“text”“：”“Find New Customers & Increase Sales！”“，”“pinnedField”“：”“Description1”“}，{”“text”“：”“Start Advertising on Contoso Today.”“}]”。

以下是大量下載範例，您也會在其中取得唯讀屬性， id 例如 和 editorialStatus：

[{
	"id": 1,
	"text": "Contoso",
	"pinnedField": "Description1",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 2,
	"text": "Seamless Integration",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

添加： 必填。 需要 2-4 個描述的清單。 只接受 pinnedField 和 文字 。 即使資產已經存在於您的帳戶中，如果您包含標識符、assetPerformanceLabel 和編輯狀態，也會忽略它們。
更新： 選。 若要保留所有現有的資產連結，請將此字段設定或保留空白。 如果您設定此欄位，則會取代先前連結至此廣告的任何描述。 如果您指定此欄位，則需要 2-4 個描述的清單。 只接受 pinnedField 和 文字 。 即使資產已經存在於您的帳戶中，如果您包含標識符、assetPerformanceLabel 和編輯狀態，也會忽略它們。
刪除： 唯讀

assetPerformanceLabel

這可讓您知道資產的執行效能。

當 assetPerformanceLabel 您下載回應式搜尋廣告時，屬性是唯讀的。 下表說明可能的值。

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

編輯狀態

當 editorialStatus 您下載回應式搜尋廣告時，屬性是唯讀的。 下表說明可能的值。

值	描述
作用中	資產通過編輯檢閱。
ActiveLimited	資產已在一或多個市場中通過編輯檢閱，而資產的一或多個元素正在另一個市場中進行編輯檢閱。 例如，資產已通過加拿大的編輯檢閱，而且在美國仍擱置檢閱。
反對	資產失敗的編輯檢閱。
非作用中	資產的一或多個元素正在進行編輯檢閱。
Unknown	保留供日後使用。

id

屬性 id 是 Microsoft Advertising 帳戶中資產的唯一 Microsoft Advertising 識別符。

多個廣告可以使用相同的資產。 例如，如果「無縫整合」是文字資產，則在相同 Microsoft Advertising 帳戶中的所有廣告上都會有相同的資產標識符。 上傳文字資產之後，結果檔案會包含資產標識符，例如 ， ""id:""123不論資產是新的還是已經存在於帳戶的資產庫中。

pinnedField

若要將資產釘選到特定的描述位置，請將 屬性設定 pinnedField 為 「Description1」 或 「Description2」。 除非您有文字資產的特定需求，否則請勿釘選它，並讓 Bing AI 將文字放置優化。

每個描述位置至少必須有一個合格的文字資產可用，因此您無法將所有資產釘選到相同的位置。 例如，您可以將 3 個文字資產釘選到 Description1，只要您在回應式搜尋廣告的 [ 描述 ] 清單中至少有一個未釘選或釘選到 Description2 的文字資產。

當您下載未釘選的資產時， pinnedField 不會傳回 屬性。

文字

每個描述的 text 屬性至少必須包含一個字。 為了有效率地使用資源，建議您使用動態文字字串，例如 {keyword}，而不是為每個關鍵詞建立新的廣告複本。 如需詳細資訊，請參閱 Microsoft Advertising 說明文章 使用動態文字參數自動自定義您的廣告。

每個描述屬性的 text 輸入長度上限為 1,000 個字元，包括動態文字字串，而在這 1,000 個字元中，替代之後不允許超過 90 個最終字元。 廣告將無法顯示，如果在動態文字替換之後長度超過 90 個字元，則會使用 預設 文字。 對於具有雙寬字元的語言，例如繁體中文，輸入長度上限為 500 個字元，包括動態文字字串，而在這 500 個字元中，取代之後不允許超過 45 個最終字元。 廣告將無法顯示，如果在動態文字替換之後長度超過 45 個字元，則會使用 預設 文字。 雙寬字元取決於您使用的字元，而不是營銷活動或廣告群組語言設定的字元集。 雙角字元包括韓文、日文和中文字元，以及 Emoji。

屬性 text 不能包含換行符 (\n) 字元。

網域

將顯示的 URL，而不是最後一個 URL。 最終 URL 仍會用於登陸頁面 URL。

保留給有限的試驗使用量，例如，藥物客戶。

URL 的網域部分結合路徑 1 和路徑 2 字串不能超過 67 個字元。

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

編輯訴求狀態

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

下表說明可能的值。

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

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

編輯位置

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

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

編輯原因代碼

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

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

編輯狀態

廣告的編輯狀態。

下表說明可能的值。

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

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

編輯詞彙

失敗的編輯檢閱詞彙。

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

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

最終 URL

登陸頁面 URL。

URL 的網域部分結合路徑 1 和路徑 2 字串不能超過 67 個字元。

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

• URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。

• 您最多可以為最終 URL 和最終行動 URL 指定 10 個專案;不過，只有每個清單中的第一個專案會用於傳遞。 此服務最多可允許 10 個，以取得潛在的向前相容性。

• 每個 URL 都會以分號和空格分隔 (」;“) 。

• 僅允許使用 '{' 和 '}' 來描述標記，例如 “{lpurl}”。

• 每個 URL 都必須是格式正確的 URL，開頭為 http:// 或 https://。

• 如果您指定 [最終行動 URL]，則也必須指定 [最終 URL]。

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

注意事項

只有在 關鍵詞未指定最終 URL 時，才會使用此 URL。

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

標題

Bing 可用來優化廣告版面配置的廣告標題清單。

除非您將其中一個標題釘選到特定位置，否則 Bing 會以使用者搜尋查詢的最佳標題和描述動態優化廣告版面配置。

從數據模型的觀點來看，標題會儲存為文字資產。 多個廣告可以使用相同的資產。 例如，如果「無縫整合」是文字資產，則在相同 Microsoft Advertising 帳戶中的所有廣告上都會有相同的資產標識符。

您必須設定 3-15 個標題。 標題會在大量檔案中以 JSON 字串表示。 下列範例 JSON 包含三個標題，只有第一個標題釘選到特定位置。 和 idtext 是資產的屬性，而 editorialStatus 和 pinnedField 是資產鏈接的屬性，也就是資產與廣告之間的關聯性。 如需詳細資訊，請參閱下方 的編輯狀態、 標識符、 pinnedField 和 文字 。

[{
	"text": "Contoso",
	"pinnedField": "Headline1"
},
{
	"text": "Quick & Easy Setup"
},
{
	"text": "Seamless Integration"
}]

注意事項

在逗號分隔的大量檔案中，您必須括住資產連結清單， 每個屬性索引鍵，以及具有一組額外雙引號的每個屬性字串值，例如，上述 JSON 字串會寫成 “[{”“text”“”：“”Contoso“”，“”pinnedField“”：“”Title1“”}，{“”text“”：“”Quick & Easy Setup“”}，{“”text“”：“”Seamless Integration“”}]“。

以下是大量下載範例，您也會在其中取得唯讀屬性， id 例如 和 editorialStatus：

[{
	"id": 3,
	"text": "Contoso",
	"pinnedField": "Headline1",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 4,
	"text": "Quick & Easy Setup",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
},
{
	"id": 5,
	"text": "Seamless Integration",
	"editorialStatus": "Active",
	"assetPerformanceLabel": "Learning"
}]

添加： 必填。 需要 3-15 個標題的清單。 只接受 pinnedField 和 文字 。 即使資產已經存在於您的帳戶中，如果您包含標識符、assetPerformanceLabel 和編輯狀態，也會忽略它們。
更新： 選。 若要保留所有現有的資產連結，請將此字段設定或保留空白。 如果您設定此欄位，則會取代先前連結至此廣告的任何標題。 如果您指定此欄位，則需要 3-15 個標題的清單。 只接受 pinnedField 和 文字 。 即使資產已經存在於您的帳戶中，如果您包含標識符、assetPerformanceLabel 和編輯狀態，也會忽略它們。
刪除： 唯讀

assetPerformanceLabel

這可讓您知道資產的執行效能。

當 assetPerformanceLabel 您下載回應式搜尋廣告時，屬性是唯讀的。 下表說明可能的值。

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

編輯狀態

當 editorialStatus 您下載回應式搜尋廣告時，屬性是唯讀字串。 下表說明可能的值。

值	描述
作用中	資產通過編輯檢閱。
ActiveLimited	資產已在一或多個市場中通過編輯檢閱，而資產的一或多個元素正在另一個市場中進行編輯檢閱。 例如，資產已通過加拿大的編輯檢閱，而且在美國仍擱置檢閱。
反對	資產失敗的編輯檢閱。
非作用中	資產的一或多個元素正在進行編輯檢閱。
Unknown	保留供日後使用。

id

屬性 id 是 Microsoft Advertising 帳戶中資產的唯一 Microsoft Advertising 識別符。

多個廣告可以使用相同的資產。 例如，如果「無縫整合」是文字資產，則在相同 Microsoft Advertising 帳戶中的所有廣告上都會有相同的資產標識符。 上傳文字資產之後，結果檔案會包含資產標識符，例如 ， ""id:""123不論資產是新的還是已經存在於帳戶的資產庫中。

pinnedField

若要將資產釘選到特定的標題位置，請將字串值設定 pinnedField 為 「標題1」、“標題2” 或 “標題3”。 除非您有文字資產的特定需求，否則請勿釘選它，並讓 Bing AI 將文字放置優化。

每個標題位置至少必須有一個合格的文字資產可用，因此您無法將所有資產釘選到相同的位置。 例如，您可以有 3 個文字資產釘選到 標題 1,3 個文字資產釘選到 標題 2，只要您在回應式搜尋 廣告的標題 清單中至少有一個文字資產未釘選或釘選到 標題 3。

當您下載未釘選的資產時， pinnedField 不會傳回 屬性。

文字

每個標題的 text 屬性至少必須包含一個字。 為了有效率地使用資源，建議您使用動態文字字串，例如 {keyword}，而不是為每個關鍵詞建立新的廣告複本。 如需詳細資訊，請參閱 Microsoft Advertising 說明文章 使用動態文字參數自動自定義您的廣告。

每個標題 text 屬性的最大輸入長度是 1,000 個字元，包括動態文字字串，而在這 1,000 個字元中，取代之後不允許超過 30 個最終字元。 廣告將無法顯示，如果在動態文字替換之後長度超過 30 個字元，則會使用 預設 文字。 對於具有雙寬字元的語言，例如繁體中文，輸入長度上限為 500 個字元，包括動態文字字串，而在這 500 個字元中，取代之後不允許超過 15 個最終字元。 廣告將無法顯示，如果在動態文字替換之後長度超過 15 個字元，則會使用 預設 文字。 雙寬字元取決於您使用的字元，而不是營銷活動或廣告群組語言設定的字元集。 雙角字元包括韓文、日文和中文字元，以及 Emoji。

屬性 text 不能包含換行符 (\n) 字元。

最終 URL 後綴

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

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

識別碼

系統產生的廣告標識碼。

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

行動裝置最終 URL

行動登陸頁面 URL。

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

• URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。

• 您最多可以為最終 URL 和最終行動 URL 指定 10 個專案;不過，只有每個清單中的第一個專案會用於傳遞。 此服務最多可允許 10 個，以取得潛在的向前相容性。

• 每個 URL 都會以分號和空格分隔 (」;“) 。

• 僅允許使用 '{' 和 '}' 來描述標記，例如 “{lpurl}”。

• 每個 URL 都必須是格式正確的 URL，開頭為 http:// 或 https://。

• 如果您指定 [最終行動 URL]，則也必須指定 [最終 URL]。

注意事項

只有在 關鍵詞未指定Mobile Final URL時，才會使用此URL。

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

修改時間

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

注意事項

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

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

父項識別碼

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

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

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

注意事項

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

路徑 1

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

路徑可以包含動態參數，例如 {MatchType}。 如需支持的參數清單，請參閱 Microsoft Advertising 說明文章 我可以使用哪些追蹤或 URL 參數？。

如果您包含動態文字字串，則輸入長度上限為1,000個字元。 不能輸入超過15個最終 (不是動態文字) 字元。 如果最終 URL 網域的長度和合併的路徑超過 67 個字元，則廣告將無法顯示或使用 預設文字 。

對於具有雙寬字元的語言，例如繁體中文，如果您包含動態文字字串，輸入長度上限為1,000個字元。 不能輸入超過 7 個最終 (不是動態文字) 字元。 如果最終 URL 網域的長度和合併的路徑超過 33 個字元，則廣告將無法顯示或使用 預設文字 。 雙寬字元取決於您使用的字元，而不是營銷活動或廣告群組語言設定的字元集。 雙角字元包括韓文、日文和中文字元，以及 Emoji。

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

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

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

路徑 2

選擇性路徑的第二個部分，將附加至顯示URL的網域部分。 顯示 URL 的網域部分，例如 https://www.contoso.com ，會從 [最終 URL] ([ 最終 URL ] 字段) 的網域產生。 然後，如果您已指定 Path 1 的值，它會附加至顯示URL。 如果您也指定 了 Path 2 的值，則它也會附加至 Path 1 之後的顯示 URL。 例如，如果您 的最終 URL 包含 https://www.contoso.com， 則路徑 1 設為 subdirectory1，而 Path 2 設為 subdirectory2，則顯示的 URL 會是 https://www.contoso.com/subdirectory1/subdirectory2。

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

路徑可以包含動態參數，例如 {MatchType}。 如需支持的參數清單，請參閱 Microsoft Advertising 說明文章 我可以使用哪些追蹤或 URL 參數？。

如果您包含動態文字字串，則輸入長度上限為1,000個字元。 不能輸入超過15個最終 (不是動態文字) 字元。 如果最終 URL 網域的長度和合併的路徑超過 67 個字元，則廣告將無法顯示或使用 預設文字 。

對於具有雙寬字元的語言，例如繁體中文，如果您包含動態文字字串，輸入長度上限為1,000個字元。 不能輸入超過 7 個最終 (不是動態文字) 字元。 如果最終 URL 網域的長度和合併的路徑超過 33 個字元，則廣告將無法顯示或使用 預設文字 。 雙寬字元取決於您使用的字元，而不是營銷活動或廣告群組語言設定的字元集。 雙角字元包括韓文、日文和中文字元，以及 Emoji。

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

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

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

發行者國家/地區

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

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

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

狀態

廣告的狀態。

可能的值為 Active、 Paused 或 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 會相同。

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