文字廣告記錄 - 大量

發行項
11/13/2024

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

重要事項

自 2020 年 4 月開始，不支援將獨立文字廣告顯示 (STA) 。

標準文字廣告已被取代，改用擴充文字廣告 (EXDA) 。 (STA) 新增和更新標準文字廣告的支援已于 2017 年 7 月 31 日結束。現在，廣告商可以取得和刪除，但無法再新增 STA 或更新現有的標準文字廣告。規則的一個例外是您仍然可以更新 STA 狀態，例如從 [作用 中] 更新為 [暫停]。否則，嘗試新增或更新 STA 會導致 CampaignServiceAdTypeInvalid 錯誤。

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

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

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

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkTextAd
var bulkTextAd = new BulkTextAd
{
    // '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 
    // TextAd object of the Campaign Management service.
    TextAd = new TextAd
    {
        // 'Ad Format Preference' column header in the Bulk file
        AdFormatPreference = "All",
        // 'Destination Url' column header in the Bulk file
        DestinationUrl = null,
        // 'Device Preference' column header in the Bulk file
        DevicePreference = 0,
        // 'Display Url' column header in the Bulk file
        DisplayUrl = "contoso.com",
        // '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,
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "Find New Customers & Increase Sales!",
        // 'Title' column header in the Bulk file
        Title = "Contoso Quick Setup",
        // '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(bulkTextAd);

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
修改時間
父項識別碼
發行者國家/地區
狀態
文字
Title
追蹤範本

廣告格式喜好設定

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

重要事項

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

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

添加： 不支援
更新： 不支援
刪除： 唯讀

廣告群組

包含廣告的廣告組名。

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

注意事項

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

行銷活動

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

添加： 不支援
更新： 唯讀
刪除： 唯讀

用戶端識別碼

用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。它可以是長度上限為 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}。使用行銷活動管理服務時，您無法指定括弧和底線。

添加： 不支援
更新： 不支援
刪除： 唯讀

裝置喜好設定

此欄位會決定喜好設定是要在所有裝置上顯示文字廣告，還是只在行動裝置上顯示。

可能的值為 All 和 Mobile，這與行銷活動管理服務中使用的值不同。

SixMonths

在大量下載和上傳結果檔案中，此欄位永遠不會是空的。如果您未指定裝置喜好設定，則會傳回預設值 All 。

重要事項

您必須為非行動裝置慣用的每個廣告群組定義至少一個文字廣告，否則所有文字廣告的廣告複本都符合所有裝置的資格。

添加： 不支援
更新： 不支援
刪除： 唯讀

顯示 URL

要在廣告中顯示的 URL。

顯示 URL 的子目錄可以包含動態文字字串，例如 {keyword};不過，URL 主機名稱不能包含動態文字。如需詳細資訊，請參閱 Microsoft Advertising 說明文章使用動態文字參數自動自訂您的廣告。

URL 的最大輸入長度是 200 個字元，而且可以包含動態文字字串。不過，如果在動態文字替換之後 URL 超過 35 個字元，廣告將無法顯示。

添加： 不支援
更新： 不支援
刪除： 唯讀

編輯訴求狀態

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

下表說明可能的值。

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

添加： 不支援
更新： 唯讀
刪除： 唯讀

編輯位置

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

添加： 不支援
更新： 唯讀
刪除： 唯讀

編輯原因代碼

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

添加： 不支援
更新： 唯讀
刪除： 唯讀

編輯狀態

廣告的編輯狀態。

下表說明可能的值。

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

添加： 不支援
更新： 唯讀
刪除： 唯讀

編輯詞彙

失敗的編輯檢閱詞彙。

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

添加： 不支援
更新： 唯讀
刪除： 唯讀

最終 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 和最終行動 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 專案。

添加： 不支援
更新： 唯讀
刪除： 唯讀

父項識別碼

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

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

添加： 不支援
更新： 唯讀
刪除： 唯讀

注意事項

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

發行者國家/地區

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

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

添加： 不支援
更新： 唯讀
刪除： 唯讀

狀態

廣告的狀態。

可能的值為 Active、 Paused或 Deleted。

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

文字

廣告複本。

文字必須至少包含一個字，而且可以包含動態文字字串，例如 {keyword}。如需詳細資訊，請參閱 Microsoft Advertising 說明文章使用動態文字參數自動自訂您的廣告。

複製的最大輸入長度為 300 個字元，而且可以包含動態文字字串。廣告將無法顯示，如果在動態文字替換之後長度超過 80 個字元，則會使用預設文字。請注意，對於使用繁體中文的廣告群組，複本的最大輸入長度為 150 個字元，而文字在替換後限制為 40 個字元。

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

添加： 不支援
更新： 不支援
刪除： 唯讀

標題

廣告的標題。

標題必須至少包含一個字。廣告的複本和標題組合必須至少有三個字組。

標題可以包含動態文字字串，例如 {keyword}。如需詳細資訊，請參閱 Microsoft Advertising 說明文章使用動態文字參數自動自訂您的廣告。

標題的最大輸入長度為 80 個字元，而且可以包含動態文字字串。廣告將無法顯示，如果在動態文字替換之後長度超過 25 個字元，則會使用預設文字。請注意，對於使用繁體中文的廣告群組，標題在替換後限制為 15 個字元。

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

修改時間

父項識別碼

發行者國家/地區

狀態

文字

標題

追蹤範本

意見反應

其他資源