展開的文字廣告記錄 - 大量

發行項
12/21/2023

定義可在大量檔案中下載及上傳的擴充文字廣告。

此廣告格式可順暢地在行動裝置、平板電腦和桌面裝置上運作，因此您可以更專注于製作較長的廣告複本，並將廣告文字優化，以便在客戶按一下您的廣告之前，更有效地吸引客戶。

注意事項

在 2023 年 2 月 1 日前，將擴充的文字廣告升級至回應式搜尋廣告。在此日期之後，您將無法再建立新的或編輯現有的展開文字廣告。如需詳細資訊，請參閱關於回應式搜尋廣告。
現有的展開文字廣告將會繼續提供，而且您將能夠檢視其效能的報告。
您仍然可以暫停、啟用或移除展開的文字廣告。否則，嘗試新增或更新展開的文字廣告會導致 CampaignServiceAdTypeInvalid 錯誤。
深入瞭解這項變更。

注意事項

展開的文字廣告只能在廣告群組類型設定為「SearchStandard」的搜尋活動中建立。如果廣告群組類型設定為「SearchDynamic」，則廣告群組不支援展開的文字廣告。

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

如果提供有效的父標識符值，下列大量 CSV 範例會新增新的展開文字廣告。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Text Part 2,Display Url,Destination Url,Promotion,Device Preference,Ad Format Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter,Title Part 1,Title Part 2,Title Part 3,Path 1,Path 2
Format Version,,,,,,,,,,,,,,,,6.0,,,,,,,,,,,,,
Expanded Text Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,Find New Customers & Increase Sales!,Start Advertising on Contoso Today.,,,,,False,,,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,,{_promoCode}=PROMO1; {_season}=summer,Contoso,Quick & Easy Setup,Seemless Integration,seattle,shoe sale

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkExpandedTextAd
var bulkExpandedTextAd = new BulkExpandedTextAd
{
    // '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 
    // ExpandedTextAd object of the Campaign Management service.
    ExpandedTextAd = new ExpandedTextAd
    {
        // 'Ad Format Preference' column header in the Bulk file
        AdFormatPreference = "All",
        // '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,
        // '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!",
        // 'Text Part 2' column header in the Bulk file
        TextPart2 = "Start Advertising on Contoso Today.",
        // 'Title Part 1' column header in the Bulk file
        TitlePart1 = "Contoso",
        // 'Title Part 2' column header in the Bulk file
        TitlePart2 = "Quick & Easy Setup",
        // 'Title Part 3' column header in the Bulk file
        TitlePart3 = "Seemless Integration",
        // '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(bulkExpandedTextAd);

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

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

針對 展開的文字廣告 記錄，大量檔案架構中提供下列屬性欄位。 [最終 URL]、[路徑 1]、[路徑2]、[文字]、[文字第 2 部分]、[標題第 1 部分]、[標題第 2 部分] 和 [標題第 3 部分] 欄位的組合，讓展開的文字廣告成為唯一的。

廣告格式喜好設定
廣告群組
行銷活動
用戶端識別碼
自訂參數
網域
編輯訴求狀態
編輯位置
編輯原因代碼
編輯狀態
編輯詞彙
最終 URL
最終 URL 尾碼
Id
行動裝置最終 URL
修改時間
父項識別碼
路徑 1
路徑 2
發行者國家/地區
狀態
文字
文字第 2 部分
標題第 1 部分
標題第 2 部分
標題第 3 部分
追蹤範本

廣告格式喜好設定

[ 廣告格式喜好設定 ] 欄位可用來指出您是否偏好將廣告複本顯示給使用者做為搜尋或物件廣告。搜尋廣告通常會撰寫為動作的呼叫，而物件廣告應該以更多資訊樣式撰寫。雖然您可以選擇使用擴充的文字廣告作為物件廣告，但將廣告指定為物件廣告慣用格式，可讓您優化其傳訊以進行原生傳遞。

重要事項

您必須為每個不偏好物件廣告的廣告群組定義至少一個展開的文字廣告，否則所有展開文字廣告的廣告複本都符合搜尋和物件廣告的資格。

可能的值為 Audience Ad 和 All。如果設定為 [全部]，廣告將符合搜尋和物件廣告格式的資格。如果設定為 [物件廣告]，則廣告將僅符合物件廣告格式的資格。

添加： 選。如果您在建立展開的文字廣告時未設定此欄位，預設會將廣告格式喜好設定設定為 [全部]。
更新： 選。如果未設定更新的值，則此設定不會變更。如果您將此欄位設定為 delete_value 字串，則會移除先前的設定。如果您將此欄位設定 為 [delete_value]，則廣告格式喜好設定會有效地設定為預設值，也就是 [全部]。
刪除： 唯讀

廣告群組

包含廣告的廣告組名。

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

注意事項

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

行銷活動

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

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

用戶端識別碼

用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。它可以是長度上限為 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。

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

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。

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

最終 URL 尾碼

最終的 URL 尾碼可以包含將附加至登陸頁面 URL 結尾的追蹤參數。建議您在最後的 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]。

注意事項

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

修改時間

上次更新實體的日期和時間。值為國際標準時間 (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 。

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

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

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

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

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

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

路徑 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 參數？。

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

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

發行者國家/地區

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

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

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

狀態

廣告的狀態。

可能的值為 Active、 Paused或 Deleted。

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

文字

可以在您的廣告中顯示之廣告描述的第一個部分。

若要讓所有廣告格式的曝光數最大化，描述不一定會顯示在您的廣告中。

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

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

如果您包含動態文字字串，則輸入長度上限為 1,000 個字元。不能輸入超過 90 個最終 (不是動態文字) 字元。如果兩個文字部分的長度在動態文字替換之後超過 180 個字元，廣告將無法顯示或使用預設文字。

對於具有雙寬字元的語言，例如繁體中文，如果您包含動態文字字串，輸入長度上限為 500 個字元。不能輸入超過 45 個最終 (不是動態文字) 字元。如果兩個文字部分的長度在動態文字替換之後超過 90 個字元，廣告將無法顯示或使用預設文字。雙寬字元取決於您使用的字元，而不是行銷活動或廣告群組語言設定的字元集。雙角字元包括韓文、日文和中文字元，以及 Emoji。

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

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

文字第 2 部分

可以在您的廣告中顯示之廣告描述的第二個部分。

若要讓所有廣告格式的曝光數最大化，描述不一定會顯示在您的廣告中。

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

標題第 1 部分

廣告標題的第一個部分。三個標題部分會自動以空格、垂直線和空格 ( 分隔|顯示廣告時 ) 。

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

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

如果您包含動態文字字串，則輸入長度上限為 1,000 個字元。不能輸入超過 30 個最終 (不是動態文字) 字元。如果在動態文字替換之後，所有三個標題部分的長度都超過 90 個字元，則廣告將無法顯示或使用預設文字。

對於具有雙寬字元的語言，例如繁體中文，如果您包含動態文字字串，輸入長度上限為 500 個字元。不能輸入超過 15 個最終 (不是動態文字) 字元。廣告將無法顯示，或者，如果在動態文字替換之後，所有三個標題部分的長度都超過 45 個字元，則會使用預設文字。雙寬字元取決於您使用的字元，而不是行銷活動或廣告群組語言設定的字元集。雙角字元包括韓文、日文和中文字元，以及 Emoji。

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

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

標題第 2 部分

廣告標題的第二個部分。三個標題部分會自動以空格、垂直線和空格 ( 分隔|顯示廣告時 ) 。

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

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

標題第 3 部分

廣告標題的第三個部分。三個標題部分會自動以空格、垂直線和空格 ( 分隔|顯示廣告時 ) 。

標題不能包含分行符號 (\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 會相同。

共用方式為

展開的文字廣告記錄 - 大量

廣告格式喜好設定

廣告群組

行銷活動

用戶端識別碼

自訂參數

網域

編輯訴求狀態

編輯位置

編輯原因代碼

編輯狀態

編輯詞彙

最終 URL

最終 URL 尾碼

識別碼

行動裝置最終 URL

修改時間

父項識別碼

路徑 1

路徑 2

發行者國家/地區

狀態

文字

文字第 2 部分

標題第 1 部分

標題第 2 部分

標題第 3 部分

追蹤範本

其他資源