產品廣告記錄 - 大量
定義可以在大量檔案中下載及上傳的產品廣告。
產品廣告不會直接用於傳遞的廣告復本。 相反地，傳遞引擎會從客戶Microsoft商業中心商店目錄中找到的產品詳細數據產生產品廣告。
您可以在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服務要求中包含 ProductAds 的 DownloadEntity 值，以下載帳戶中的所有產品廣告記錄。 此外，下載要求必須包含 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,,,,,,,,,,
Product Ad,Active,,-1112,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,,,,Find New Customers & Increase Sales!,,,,,,,,,,,,,
如果您使用適用於 .NET、Java 或 Python 的 Bing Ads SDK ，您可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkProductAd 物件，而不是直接呼叫服務作業，並撰寫自定義程式代碼來剖析大量檔案中的每個字段。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkProductAd
var bulkProductAd = new BulkProductAd
{
// '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
// ProductAd object of the Campaign Management service.
ProductAd = new ProductAd
{
// 'Id' column header in the Bulk file
Id = null,
// 'Promotion' column header in the Bulk file
PromotionalText = "Find New Customers & Increase Sales!",
// 'Status' column header in the Bulk file
Status = AdStatus.Active,
},
};
uploadEntities.Add(bulkProductAd);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
針對 產品廣告 記錄， 大量檔案架構中提供下列屬性欄位。
廣告群組
包含廣告的廣告組名。
加： 唯讀和必要
更新： 唯讀和必要
刪除： 唯讀和必要
行銷活動
包含廣告群組和廣告的營銷活動名稱。
加： 唯讀
更新： 唯讀
刪除： 唯讀
用戶端識別碼
用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為100的任何有效字串。
加： 自選
更新： 自選
刪除： 唯讀
編輯訴求狀態
判斷您是否可以對編輯檢閱所發現的問題發出意見反應。
下表說明可能的值。
| 值 | 描述 |
|---|---|
| 上訴 | 編輯問題很吸引人。 |
| 訴求附加 | 編輯問題是可訴求的，而且已提交訴求。 |
| NotAppealable | 編輯問題無法吸引人。 |
加： 唯讀
更新： 唯讀
刪除： 唯讀
編輯位置
編輯檢閱失敗的廣告元件或屬性。
加： 唯讀
更新： 唯讀
刪除： 唯讀
編輯原因代碼
識別失敗原因的程序代碼。 如需可能的原因代碼清單，請參閱 編輯原因代碼。
加： 唯讀
更新： 唯讀
刪除： 唯讀
編輯狀態
廣告的編輯狀態。
下表說明可能的值。
| 值 | 描述 |
|---|---|
| 作用中 | 廣告通過編輯檢閱。 |
| ActiveLimited | 廣告在一或多個市場中通過編輯檢閱，而廣告的一或多個元素正在另一個市場中進行編輯檢閱。 例如，廣告已通過加拿大的編輯檢閱，且仍在 美國 中擱置檢閱。 |
| 反對 | 廣告失敗的編輯檢閱。 |
| 非作用中 | 廣告的一或多個元素正在進行編輯檢閱。 |
加： 唯讀
更新： 唯讀
刪除： 唯讀
編輯詞彙
失敗的編輯檢閱詞彙。
如果字詞組合造成失敗，或失敗是以原則違規為基礎，則不會設定此字段。
加： 唯讀
更新： 唯讀
刪除： 唯讀
識別碼
系統產生的廣告標識碼。
加： 自選。 您必須將此欄位保留空白，或指定負識別碼。 接著可以在相依記錄類型的 [ 父 標識符] 字段中參考廣告的負標識符集，例如 產品廣告標籤。 如果您要在同一個大量檔案中新增廣告和新的相依記錄，建議您這麼做。 如需詳細資訊，請 參閱大量檔案架構參考密鑰。
更新： 唯讀和必要
刪除： 唯讀和必要
修改時間
上次更新實體的日期和時間。 值為國際標準時間 (UTC)。
注意事項
日期和時間值會反映伺服器上的日期和時間，而不是用戶端。 如需日期和時間格式的相關信息，請參閱 基本 XML 數據類型中的 dateTime 專案。
加： 唯讀
更新： 唯讀
刪除： 唯讀
父項識別碼
包含廣告之廣告群組的系統產生標識碼。
此大量欄位會對應至廣告群組記錄的 [標識符] 欄位。
加： 唯讀和必要。 您必須指定現有的廣告群組標識符，或指定等於父代 Ad Group 記錄之 [標識符] 字段的負標識符。 如果您要將新廣告新增至相同大量檔案中的新廣告群組，建議您這麼做。 如需詳細資訊，請 參閱大量檔案架構參考密鑰。
更新： 唯讀
刪除： 唯讀
發行者國家/地區
發行者國家或地區的清單，其編輯指導方針不允許指定的 詞彙。
在大量檔案中，發行者國家或地區的清單會以分號分隔 (;) 。
加： 唯讀
更新： 唯讀
刪除： 唯讀
狀態
廣告的狀態。
注意事項
自 2024 年 12 月 3 日起，大量 API 將不再支援產品廣告記錄的刪除作業。 這是因為產品廣告實體是系統產生的。
可能的值為 Active、 Paused 或 Deleted。
加： 自選。 預設值為 Active。
更新： 自選。 如果未設定更新的值，則此設定不會變更。
刪除： 必填。 [狀態] 必須設定為 [ 已刪除]。