回應式廣告記錄 - 大量

發行項
07/27/2024

定義可在大量檔案中下載及上傳的回應式廣告。

回應式廣告會自動調整以容納對象廣告格式的大小和形狀。這些廣告最適合使用資訊文字，而不是動作呼叫。

注意事項

這項功能目前適用於美國、加拿大、英國和澳大利亞。如果您在美國、加拿大、英國或澳大利亞中公告，並想要選擇加入對象廣告，請連絡支持人員。

注意事項

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

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

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

Type,Status,Id,Parent Id,Campaign,Ad Group,Sync Time,Client Id,Modified Time,Tracking Template,Final Url Suffix,Custom Parameter,Final Url,Mobile Final Url,Text,Business Name,Device Preference,Ad Format Preference,Name,Call To Action,Headline,Long Headline,Images
Format Version,,,,,,,,,,,,,,,,,,6.0,,,,
Responsive Ad,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,,{_promoCode}=PROMO1; {_season}=summer,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,Find New Customers & Increase Sales! Start Advertising on Contoso Today.,Contoso,,,,,Short Headline Here,Long Headline Here,"[{""id"":1234567890000,""subType"":""LandscapeImageMedia""}]"

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkResponsiveAd
var bulkResponsiveAd = new BulkResponsiveAd
{
    // '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 
    // ResponsiveAd object of the Campaign Management service.
    ResponsiveAd = new ResponsiveAd
    {
        // 'Call To Action' column header in the Bulk file
        CallToAction = CallToAction.AddToCart,
        // '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
        Headline = "Short Headline Here",
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Images' column header in the Bulk file
        Images = new[]
        {
            // Each AssetLink is represented as a JSON list item in the Bulk file.
            new AssetLink
            {
                Asset = new ImageAsset
                {
                    CropHeight = null,
                    CropWidth = null,
                    CropX = null,
                    CropY = null,
                    Id = landscapeImageMediaId,
                    SubType = "LandscapeImageMedia"
                },
            },
        },
        // 'Long Headline' column header in the Bulk file
        LongHeadlineString = "Long Headline Here",
        // '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(bulkResponsiveAd);

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
Images
曝光追蹤URL
橫向影像媒體標識碼
橫向標誌媒體標識碼
長標題
長標題
長標題字串
行動裝置最終 URL
修改時間
父項識別碼
發行者國家/地區
狀態
方形圖像媒體標識碼
方形標誌媒體標識碼
文字
追蹤範本

廣告群組

包含廣告的廣告組名。

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

注意事項

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

商務名稱

企業名稱。

視您的物件廣告位置而定，您的企業名稱可能會出現在您的廣告中。

字串的長度限制為 25 個字元。

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

呼叫動作

讓客戶立即按下您廣告的簡短、吋笛原因。

以下是搜尋多媒體廣告可用的動作呼叫：

行動呼籲
立即採取行動
立即套用
立即下注
立即申請
預約汽車
預訂旅館
立即預約
立即建置
立即購買
立即聊天
Compare
連絡我們
轉銷商
方向
捐
下載
立即寄送電子郵件
立即註冊
立即檔案
尋找作業
尋找存放區
免費播放
免費報價
免費試用
取得優待券
取得交易
取得示範
立即取得
取得供應專案
取得報價
移至示範
現在加入
深入瞭解
立即接聽
登錄
立即訂購
玩遊戲
立即播放
Post Job
登錄
立即更新
租車
立即出租
重新安排
儲備
立即儲存
排程
請參閱示範
查看功能表
請參閱模型
請參閱供應專案
請參閱供應專案
請參閱銷售
立即銷售
立即購物
Showtimes
登入
註冊
立即開始
訂閱
試用產品
立即試用
檢視汽車
檢視示範
檢視方案
造訪商店
立即投票
觀看
觀看更多資訊
立即觀看

加：不適用於物件廣告。
更新： 唯讀
刪除： 唯讀

呼叫動作語言

將用來提供動作呼叫的語言。

不論營銷活動的語言設定為何，動作的呼叫一律會以這種語言提供。

以下是適用於搜尋多媒體廣告的動作語言呼叫：

行動呼籲
Language.這是一種語言
Language.Arabic
Language.波士尼亞文
Language.這是一種語言
Language.克羅埃西亞文
Language.Czech
Language.Danish
Language.Dutch
Language.English
Language.愛沙尼亞文
Language.芬蘭文
Language.French
Language.German
Language.Greek
Language.Hebrew
Language.Hungarian
Language.並行
Language.Italian
Language.Japanese
Language.拉脫維亞文
Language.立陶宛文
Language.Macedonian
Language.Maltese
Language.Norwegian
Language.Polish
Language.Portuguese
Language.Microsoft
Language.Russian
Language.Serbian
Language.Slovak
Language.斯洛維尼亞文
Language.Spanish
Language.Swedish
Language.TraditionalChinese
Language.Turkish

加：不適用於物件廣告;多媒體廣告的必要專案。
更新： 自選。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

行銷活動

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

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

用戶端識別碼

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

描述

視您對象廣告的位置而定，此文字會出現在您廣告的長標題或簡短標題下方或相鄰。

您在廣告文字中使用的字元空間比在標題中要處理的更多。因此，一旦影像和標題有潛在客戶的注意，廣告文字就必須讓他們能夠按兩下它。哪些專案會將您的產品或服務分開？

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

描述的上限為 5。字串的長度限制為90個字元。標題的數據格式包含在下列範例 JSON 中。

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

加：對象廣告和多媒體廣告的必要專案。不適用於影片廣告。 更新： 自選。如果未設定更新的值，則此設定不會變更。 刪除： 唯讀

編輯訴求狀態

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

下表說明可能的值。

值	描述
上訴	編輯問題很吸引人。
訴求附加	編輯問題是可訴求的，而且已提交訴求。
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 後綴。

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

標題

這是可能出現在影片廣告中的兩個可能標題之一。

因為影片廣告有回應性，所以我們需要多個標題，讓它們可以彈性地跨各種發行者和位置提供服務。

字串的長度限制為30個字元。

加：影片廣告的必要專案。不適用於多媒體廣告和對象廣告。 更新： 自選。多媒體和物件廣告已被取代。請改用標題。
刪除： 唯讀

標題

由於觀眾廣告有回應，因此我們需要多個標題，讓它們可以彈性地跨各種發行者和位置提供服務。

標題的上限為 15。而且每個標題的長度限制為30個字元。標題的數據格式包含在下列範例 JSON 中。

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

加：多媒體廣告和對象廣告的必要專案。不適用於影片廣告。 更新： 自選。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

識別碼

系統產生的廣告標識碼。

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

影像

由於觀眾廣告有回應，因此您可以建立具有不同大小和外觀比例的多個影像資產，讓它們可以在各種發行者和位置之間靈活顯示。

注意事項

到目前為止，SubType OriginalImage 會取代 LandscapeImageMedia 的角色作為 Audience Campaign 的 ResponsiveAd 的預設影像。

您只需要提供 OriginalImage 資產，也就是此字段必須包含一個子類型設定為 OriginalImage 的影像資產。 OriginalImage 的建議維度是 1200 寬度 x 628 高度。您可以選擇性地包含其他資產連結，也就是針對每個支援的子類型包含一個映像資產。對於未明確設定的任何映射資產子類型，Microsoft Advertising 會藉由裁剪 OriginalImage 自動建立影像資產連結。

注意事項

如果此欄位設定 (不是空的) ，則會同時忽略橫向影像媒體標識碼和方形圖像媒體標識碼。

影像資產會在大量檔案中以 JSON 字串表示。下列範例 JSON 包含九個影像，而且只會裁剪 OriginalImage subType 。 id是資產的屬性，而cropHeight、cropWidthcropX、、 cropY和 subType 是資產連結的屬性，也就是資產與廣告之間的關聯性。如需詳細資訊，請參閱下方的 cropHeight、 cropWidth、 cropX、 cropY、 id和 subType 。

[{
	"id": 1234567890000,
	"subType": "OriginalImage"
},
{
	"id": 1234567890000,
	"subType": "LandscapeLogoMedia",
	"cropX": 0,
	"cropY": 0,
	"cropWidth": 512,
	"cropHeight": 128
},
{
	"id": 1234567890000,
	"subType": "SquareLogoMedia",
	"cropX": 0,
	"cropY": 0,
	"cropWidth": 128,
	"cropHeight": 128
},
{
	"id": 1234567890000,
	"subType": "SquareImageMedia",
	"cropX": 286,
	"cropY": 0,
	"cropWidth": 628,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia169X100",
	"cropX": 70,
	"cropY": 0,
	"cropWidth": 1061,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia93X100",
	"cropX": 308,
	"cropY": 0,
	"cropWidth": 584,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia15X10",
	"cropX": 129,
	"cropY": 0,
	"cropWidth": 942,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia155X100",
	"cropX": 114,
	"cropY": 0,
	"cropWidth": 973,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia133X100",
	"cropX": 183,
	"cropY": 0,
	"cropWidth": 835,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia178X100",
	"cropX": 41,
	"cropY": 0,
	"cropWidth": 1118,
	"cropHeight": 628
},
{
	"id": 1234567890000,
	"subType": "ImageMedia172X100",
	"cropX": 60,
	"cropY": 0,
	"cropWidth": 1080,
	"cropHeight": 628
}]

注意事項

在逗號分隔的大量檔案中，您必須用一組額外的雙引號括住資產連結清單、每個屬性索引鍵，以及每個屬性字串值，例如上述 JSON 字串會寫入為 “[{”“id”“：1234567890000，”“subType”“：”“OriginalImage”“}，{”“id”“：1234567890000，”“subType”“：”“LandscapeLogoMedia”“，”“cropX”“：0，”“cropY”“：0，”“cropWidth”“：512，”“cropHeight”“：128}，{”“id”“：1234567890000，“”subType“”：“”SquareLogoMedia“”，“”cropX“：0，”“cropY”“：0，”“cropWidth”“：128，”“cropHeight”“：128}，{”“id”“：1234567890000，”“” subType“”：“”SquareImageMedia“，”“cropX”“：286，”“cropY”“：0，”“cropWidth”“：628，”“cropHeight”“：628}，{”“id”“：1234567890000 ，”“subType”“：”“ImageMedia169X100”“，”“cropX”“：70，”“cropY”“：0，”“cropWidth”“：1061，”“cropHeight”“：628}，{”“id”“：1234567890000，”“subType”“：”“ImageMedia93X100”“，”“cropX”“：308，”“cropY”“：0，”“cropWidth”“：584，”“cropHeight”“：628}，{“id”“：1234567890000，”“subType”“：”“ImageMedia15X10”“，”“cropX”“：129，”“cropY”“：0，”“cropWidth”“：942，”“cropHeight”“：： 628}，{”id“”：1234567890000，“”subType“”：“”ImageMedia155X100“”，“”cropX“”：114，“”cropY“”：0，“”cropWidth“”：973，“” “cropHeight”“：628}，{”“id”“：1234567890000，”“subType”“：”“ImageMedia133X100”“，”“cropX”“：183，”“cropY”：0，“”cropWidth“”“：835，”“cropHeight”“：628}，{”“id”“：1234567890000，”“subType”“：”“ImageMedia178X100”“，”“cropX”“：41，”“cropY”“：0，””cropWidth“”：1118，“”cropHeight“”：628}，{“id”“：1234567890000，”“subType”“：”“ImageMedia172X100”“，”“cropX”“：60，”“cropY”：0，“”cropWidth“：1080，”“cropHeight”“：628}]”。

假設上述的上傳回應 JSON 範例，請記下下列事項：

相同的映像資產標識碼 (例如，1234567890000) 用于所有自动产生的映像资产子类型。無論您是否讓 Microsoft Advertising 自動產生裁剪的影像，標識碼在連結至相同廣告的影像資產中都不需要是唯一的。
由於此範例中的廣告是在未針對 OriginalImage 映射資產子類型進行裁剪設定的情況下建立的，因此除了 OriginalImage 相關聯的影像以外，會裁剪所有影像資產。
無論 OriginalImage 是否有自己的裁剪設定，Microsoft Advertising 會針對所有預設裁剪設定使用 OriginalImage 相關聯影像的實際高度。在此範例中，所有系統產生影像資產的裁剪高度為628，而且我們可以推斷OriginalImage (OriginalImage子類型) 1.91：1外觀比例的寬度和高度為1200x628。即使已使用裁剪設定建立 OriginalImage 資產連結，例如 703x368，自動產生的影像資產的裁剪設定還是會以 OriginalImage (的完整維度為基礎，在此範例中會是 1200x628) 。
雖然在 Bing 廣告 API 第 12 版中，您可以使用橫向影像媒體標識碼和方形影像媒體標識碼，但這些字段已被取代，將在未來的版本中移除。您可以透過 [影像] 欄位，更靈活地控制裁剪的影像。

cropHeight

要從影像資產來源使用的像素數目，從cropY位置開始向上移動。

cropWidth

要從影像資產來源使用的像素數目，從cropX位置開始，然後向右移動。

cropX

從影像資產來源的左下角開始，這是套用 cropWidth 之前要略過 X 軸右側的像素數目。

cropY

從影像資產來源的左下角開始，這是套用 cropHeight 之前，要在 Y 軸上向上略過的像素數目。

id

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

相同的影像資產標識碼可以在相同廣告中多次用於不同的外觀比例，也可以由相同廣告帳戶中的多個廣告使用Microsoft廣告。將 SubType 設定為 LandscapeImageMedia 的影像資產識別碼會用於相同廣告內所有自動產生的影像資產子類型。無論您是否讓 Microsoft Advertising 自動產生裁剪的影像，標識碼在連結至相同廣告的影像資產中都不需要是唯一的。

您可以透過影像大量錄製來建立回應式廣告的影像。然後，您可以使用傳回的媒體標識碼作為映像資產標識碼。您新增的影像外觀比例必須支援映像資產 subType。

亞

屬性 subType 代表此映像資產的外觀比例。

儲存在帳戶層級媒體櫃中影像的實際外觀比例可能會有所不同，只要產生的維度導致每個子類型的預期外觀比例即可。如果您未指定裁剪設定，服務會自動從影像中心向上裁剪到可能的最大區域。例如，假設 1000x1000 像素影像的 1.91：1 外觀比例，自動裁剪設定會是 cropWidth=1000、 cropHeight=524、 cropX=0 和 cropY=238。

如果影像與廣告關聯為「LandscapeLogoMedia」或「SquareLogoMedia」，則子類型必須設定為「Logo」。

可能的子類型值包括 OriginalImage、 LandscapeLogoMedia、SquareLogoMedia、LandscapeImageMedia、SquareImageMedia、ImageMedia4x1、ImageMedia1x2、ImageMedia169X100、ImageMedia201X100、ImageMedia120X100、ImageMedia200X100、ImageMedia124X100 和 ImageMedia153X100。未來可能會新增新的子類型，因此您不應該對一組固定的值採取任何相依性。

子類型	縱橫比	以像素為單位的最小維度
OriginalImage	不適用	703 寬度 x 368 高度
LandscapeLogoMedia	4:1	512 寬度 x 128 高度
SquareLogoMedia	1:1	128 寬度 x 128 高度
LandscapeImageMedia	1.91:1	300 寬度 x 157 高度
SquareImageMedia	1:1	114 寬度 x 114 高度
ImageMedia4x1	4:1	608 寬度 x 152 高度
ImageMedia1x2	1:2	470 寬度 x 940 高度
ImageMedia201X100	2.01:1	612 寬度 x 304 高度
ImageMedia120X100	1.2:1	300 寬度 x 250 高度
ImageMedia200X100	2:1	200 寬 x 100 高度
ImageMedia169X100	1.69:1	628 寬度 x 372 高度
ImageMedia124X100	1.24:1	104 寬度 x 84 高度
ImageMedia153X100	1.53:1	306 寬度 x 200 高度

加：如果橫向影像媒體標識碼是空的，則為必要專案。每個資產連結只需要 id 和 subType 。
更新： 自選。若要保留所有現有的資產連結，請將此字段設定或保留空白。如果您設定此欄位，則會取代先前連結至此廣告的任何影像。如果您設定此欄位，則每個資產連結只需要 id 和 subType 。
刪除： 唯讀

曝光追蹤URL

1x1 曝光追蹤圖元的 URL。每個像素都會向您的第三方廣告報告工具報告Microsoft對象網路曝光數。

每個回應式廣告最多可以包含 2 個曝光追蹤 URL。每個 URL 都會以分號和空格分隔 (」;“) 。

每個 URL 都必須可供存取。 URL 的長度限制為 2,048 個字元。 HTTP 或 HTTPS 通訊協定字串確實會計入 2,048 個字元的限制。

針對每個Microsoft對象網路曝光，Microsoft會 ping URL，以在第三方廣告報告工具中啟用曝光追蹤。不支援進階層級用戶追蹤，例如根據 Cookie 或 IP 位址進行轉換追蹤或追蹤。

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

橫向影像媒體標識碼

影像資產的標識碼，用於在您的觀眾廣告中顯示 1.91：1 外觀比例的橫向影像。

儲存影像媒體的外觀比例可能會有所不同，只要影像資產裁剪設定導致此字段的支持外觀比例即可。若要使用裁剪設定來確認有效的外觀比例，請使用 [ 影像 ] 字段。

注意事項

雖然在 Bing 廣告 API 第 12 版中，您可以使用橫向影像媒體標識碼和 SquareImageMediaId，但這些字段已被取代，將在未來的版本中移除。您可以透過 [影像] 欄位，更靈活地控制裁剪的影像。

加：如果未設定影像，則為必要專案。如果設定 [影像 ]，則會忽略此欄位。
更新： 自選。如果設定 [影像 ]，則會忽略此欄位。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

橫向標誌媒體標識碼

此欄位保留供內部使用，並會從未來版本的 Bing 廣告 API 中移除。

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

長標題

這是可能出現在您觀眾廣告中的兩個可能標題之一。

由於觀眾廣告有回應，因此我們需要多個標題，讓它們可以彈性地跨各種發行者和位置提供服務。

字串的長度限制為90個字元。

加：必填
更新： 荒廢的。請改用長標題。
刪除： 唯讀

長標題

由於觀眾廣告有回應，因此我們需要多個標題，讓它們可以彈性地跨各種發行者和位置提供服務。

長標題的上限為 5。而且每個標題的長度限制為90個字元。長標題的數據格式包含在下列範例 JSON 中。

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

加：多媒體廣告和對象廣告的必要專案。不適用於影片廣告。 更新： 自選。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

長標題字串

標題是您廣告中顯示的最醒目提示文字，因此您應該充分利用可用的字元。由於觀眾廣告有回應，因此我們需要多個標題，讓它們可以彈性地跨各種發行者和位置提供服務。

每個標題的長度限制為90個字元。長標題的數據格式包含在下列範例 JSON 中。

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

加：對象廣告和影片廣告的必要專案。不適用於多媒體廣告。 更新： 自選。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

行動裝置最終 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 記錄之 [標識符] 字段的負標識符。如果您要將新廣告新增至相同大量檔案中的新廣告群組，建議您這麼做。如需詳細資訊，請參閱大量檔案架構參考密鑰。
更新： 唯讀
刪除： 唯讀

注意事項

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

發行者國家/地區

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

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

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

狀態

廣告的狀態。

可能的值為 Active、 Paused 或 Deleted。

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

方形圖像媒體標識碼

用於方形影像的影像資產標識碼，其外觀比例為 1：1，可能會出現在您的物件廣告中。

注意事項

加：自選。如果設定 Images ，則會忽略此欄位，Microsoft Advertising 會藉由裁剪 LandscapeImageMedia 影像資產來自動建立新的方形影像資產。如果未設定 Images ，而且您未設定此字段，Microsoft Advertising 會藉由裁剪 [橫向影像媒體標識符] 自動建立新的方形影像資產。
更新： 自選。如果設定 Images ，則會忽略此欄位，Microsoft Advertising 會藉由裁剪 LandscapeImageMedia 影像資產來自動建立新的方形影像資產。如果未設定 Images ，而且您未設定此字段，Microsoft Advertising 會藉由裁剪 [橫向影像媒體標識符] 自動建立新的方形影像資產。如果未設定更新的值，則此設定不會變更。
刪除： 唯讀

方形標誌媒體標識碼

此欄位保留供內部使用，並會從未來版本的 Bing 廣告 API 中移除。

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

Text

視您的影片廣告位置而定，此文字會顯示在您廣告的長標題或簡短標題下方或旁邊。

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

字串的長度限制為90個字元。

文字不能包含換行符 (\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 字串，則會移除先前的設定。
刪除： 唯讀

共用方式為

回應式廣告記錄 - 大量

廣告群組

商務名稱

呼叫動作

呼叫動作語言

行銷活動

用戶端識別碼

自定義參數

描述

編輯訴求狀態

編輯位置

編輯原因代碼

編輯狀態

編輯詞彙

最終 URL

最終 URL 後綴

標題

標題

識別碼

影像

cropHeight

cropWidth

cropX

cropY

id

亞

曝光追蹤URL

橫向影像媒體標識碼

橫向標誌媒體標識碼

長標題

長標題

長標題字串

行動裝置最終 URL

修改時間

父項識別碼

發行者國家/地區

狀態

方形圖像媒體標識碼

方形標誌媒體標識碼

Text

追蹤範本

意見反應

其他資源