廣告群組產品數據分割記錄 - 大量
定義可以在大量檔案中上傳和下載的廣告群組產品分割區。
只要符合驗證規則,您可以在同一個大量檔案中上傳多個廣告群組的產品 分割記錄 ,如下所述。
您至少必須指定產品資料分割群組樹狀結構的根節點。 產品分割區群組的根節點必須將其 [產品條件 1 ] 字段設定為 [全部] 和 [產品值 1 ] 為 Null 或空白。 如果您同樣地對目錄中的所有產品都抱抱心,請將 [子類型 ] 字段設定為 [單位]。 如果您要根據更特定的產品條件來分割報價,請將 [子類型 ] 字段設定為 [細分]、將 [父準則標識 符] 設定為 null 或空白,並將 [ 標識符] 設定為負值。 對於任何子節點,您都會使用負值作為 父準則標識 符。
根節點會被視為層級 0,而樹狀結構最多可以有 7 層深的分支。
根據上傳要求,每個廣告群組最多可以包含 20,000 個產品分割樹狀節點。 廣告群組的整個產品分割樹狀節點計數不能超過 20,000。
相同樹狀結構的產品分割樹狀節點 (相同的廣告群組) 必須在檔案中群組在一起。
在下載期間不保證產品數據分割節點的順序,而且父節點可能會在子節點之後提供;不過,相同廣告群組的所有節點都會群組在檔案中。
如果您要建立或修改樹狀結構,則父產品數據分割樹狀節點必須在子產品分割樹狀節點之前排序;不過,順序對於非結構化變更並不重要,例如更新報價。 例如,如果您想要在不新增、刪除或更新樹狀結構的情況下更新約定,則只需要上傳 [ 標識符]、[ 父標識符] 和 [ 標示] 字段。
若要更新 [產品條件 1]、[ 產品值 1 ] 或 [ 已排除 ] 欄位,您必須刪除現有的產品分割樹節點,並上傳新的產品分割樹節點,以取得新的標識符。
如果有任何動作失敗,可能已成功的所有剩餘動作也會失敗。
所有產品分割區節點新增和刪除動作都必須產生完整的樹狀結構。
從根節點到分支結尾的每個路徑都必須以分葉節點終止, (子類型=單位) 。 除非 [已 排除 ] 欄位為 TRUE,否則每個單位都必須有一個報價,這表示節點是負廣告群組準則。
每個細分必須至少有一個分葉節點在子分割條件的其餘部分進行比對,也就是使用與其同層級單位相同的操作數 (的) ,並設定其 產品值 1 null 或空白。
如果您要在父系或子系都不存在的多個層級中加入分割區,請使用負 int 值作為參考來識別父系。 例如,將父系的 [標識符] 和子系的 [ 父準則標識 符] 字段設定為相同的負值。 負數標識碼只在呼叫期間有效。 上傳結果檔案中會傳回每個成功新增廣告群組準則的唯一系統標識碼。
只有當 [已排除] 欄位為 FALSE 時,才適用 [Bid] 和 [目的地 URL] 字段,這表示節點是可比對的廣告群組準則。 不過, 細分 分割節點會忽略這些欄位。 這些元素只與數據分割節點) 單元 (分葉相關。
若要暫停任何產品分割區,您必須將廣告群組的 [ 狀態 ] 字段更新為 [暫停],以暫停整個 廣告群組 。 您可以將 [營銷活動] 的 [ 狀態] 字 段更新為 [暫停],以暫停整個 營銷活動 。
針對 [已刪除] 動作,您只需要指定 [標識符 ] 和 [父標識符]。
如果您刪除父系產品分割區,也會刪除其所有子系和子系。
您不能在分支中指定重複的產品條件。
您可以在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服務要求中包含 AdGroupProductPartitions 的 DownloadEntity 值,以下載帳戶中的所有 Ad Group Product Partition 記錄。 此外,下載要求必須包含 EntityData 範圍。 如需大量服務的詳細資訊,包括最佳做法,請參閱 大量下載和上傳。
如果提供有效的 父標識 碼值,下列大量 CSV 範例會新增廣告群組產品分割區。
Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Bid,Name,Product Condition 1,Product Value 1,Is Excluded,Parent Criterion Id,Tracking Template,Final Url Suffix,Custom Parameter
Format Version,,,,,,,,,,6.0,,,,,,,
Ad Group Product Partition,Paused,,-1112,,,,ClientIdGoesHere,,0.5,,All,,FALSE,,,,{_promoCode}=PROMO1; {_season}=summer
如果您使用適用於 .NET、Java 或 Python 的 Bing 廣告 SDK ,您可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkAdGroupProductPartition 物件,而不是直接呼叫服務作業,並撰寫自定義程式代碼來剖析大量檔案中的每個字段。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkAdGroupProductPartition
var bulkAdGroupProductPartition = new BulkAdGroupProductPartition
{
// Map properties in the Bulk file to the BiddableAdGroupCriterion or
// NegativeAdGroupCriterion object of the Campaign Management service.
// Use the BiddableAdGroupCriterion to set the 'Is Excluded' field in the Bulk file to True,
// and otherwise use the NegativeAdGroupCriterion to set the 'Is Excluded' field to False.
BiddableAdGroupCriterion = new BiddableAdGroupCriterion
{
// 'Parent Id' column header in the Bulk file
AdGroupId = adGroupIdKey,
Criterion = new ProductPartition {
Condition = new ProductCondition
{
// 'Product Value 1' column header in the Bulk file
Attribute = null,
// 'Product Condition 1' column header in the Bulk file
Operand = "All",
},
// 'Parent Criterion Id' column header in the Bulk file
ParentCriterionId = null
},
CriterionBid = new FixedBid
{
// 'Bid' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
Amount = 0.50
},
// 'Destination Url' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
DestinationUrl = null,
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = AdGroupCriterionStatus.Paused,
// 'Tracking Template' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
TrackingUrlTemplate = null,
// 'Custom Parameter' column header in the Bulk file is only applicable for BiddableAdGroupCriterion
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"
},
}
},
},
// 'Ad Group' column header in the Bulk file
AdGroupName = null,
// 'Campaign' column header in the Bulk file
CampaignName = null,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
};
uploadEntities.Add(bulkAdGroupProductPartition);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
針對 廣告群組產品數據分割 記錄, 大量檔案架構中提供下列屬性欄位。
廣告群組
包含產品分割區的廣告組名。
加: 唯讀和必要
更新: 唯讀和必要
刪除: 唯讀和必要
出價
要在銀場中進行成交的金額。
加: 如果 [排除] 為 FALSE 且 子類型 為 [單位],則為必要專案,否則不允許進行中標。
更新: 自選。 如果未設定更新的值,則此設定不會變更。
刪除: 唯讀
中標調整
百分比 (大於零的) 可讓您的贊助產品申請彈性。
例如,假設您的合作夥伴透過 [) ] 字段 ( ,在其產品群組中申請了 5 美元。 如果您的報價調整 (此字段) 會設定為 20 (%) ,而廣告群組的 「最高報價 」為 0.50 (50 分) ,則您的共用會是 50 美元,而不是 $1 美元。
只有當廣告群組的 Bid 選項 設定為 BidBoost 時,才適用此字段。 如果廣告群組的 Bid 選項 設定為 BidValue,則廣告會使用產品群組的 Bid。
支援的值為負 90 (-90) 到正 900 (900) 。
注意事項
此設定僅適用於針對贊助產品設定Microsoft購物活動中的廣告群組。 贊助產品僅適用於 美國,目前處於開放式 Beta 狀態。
加: 自選。 如果未包含,則會將中標調整設定為預設 值 0 。
更新: 必填
刪除: 唯讀
行銷活動
包含廣告群組和產品分割區的營銷活動名稱。
加: 唯讀
更新: 唯讀
刪除: 唯讀
用戶端識別碼
用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為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。
URL 可以包含動態參數,例如 {MatchType}。 如需支持的參數清單,請參閱 Microsoft Advertising 說明文章 我可以使用哪些追蹤或 URL 參數?。
URL 最多可以包含 1,024 個字元。 如果 URL 未指定通訊協定,系統會在使用者按下廣告時使用 HTTP 通訊協定。 如果 URL 在您新增廣告時指定 HTTP 通訊協定,服務會移除 http:// 通訊協定字串, (HTTP 通訊協定字串不會計入 1,024 個字元的限制) ;不過,服務不會從 URL 移除 HTTPs://) (HTTPS 通訊協定字串。
注意事項
如果指定,則會使用此目的地 URL;否則,目的地 URL 取決於您在Microsoft商家中心目錄中為產品供應專案指定之 『Link』 的對應值。
加: 自選
更新: 自選。 如果未設定更新的值,則此設定不會變更。 如果您將此欄位設定為 delete_value 字串,則會移除先前的設定。
刪除: 唯讀
最終 URL 後綴
最終的 URL 後綴可以包含將附加至登陸頁面 URL 結尾的追蹤參數。 建議您在最後的 URL 後綴中放置登陸頁面所需的追蹤參數,讓您的客戶一律傳送至您的登陸頁面。 如需詳細資訊和驗證規則,請參閱技術指南中的 最終 URL 後綴 。
加: 自選
更新: 自選。 如果未設定更新的值,則此設定不會變更。 如果您將此欄位設定為 delete_value 字串,則會移除先前的設定。
刪除: 唯讀
識別碼
系統產生的產品數據分割標識碼。
加: 唯讀
更新: 唯讀和必要
刪除: 唯讀和必要
已排除
判斷產品分割區代表可比對或負值準則。
如果設定為 TRUE ,則為負準則,否則為 FALSE ,則為可比對的準則。
加: 必填
更新: 唯讀
刪除: 唯讀
修改時間
上次更新實體的日期和時間。 值為國際標準時間 (UTC)。
注意事項
日期和時間值會反映伺服器上的日期和時間,而不是用戶端。 如需日期和時間格式的相關信息,請參閱 基本 XML 數據類型中的 dateTime 專案。
加: 唯讀
更新: 唯讀
刪除: 唯讀
父準則標識碼
父產品分割區的準則標識碼。
注意事項
此欄位不適用於沒有父系的樹狀根產品數據分割節點。
加: 唯讀和必要
更新: 唯讀
刪除: 唯讀
父項識別碼
系統產生的標識碼,包含產品數據分割的廣告群組。
此大量欄位會對應至廣告群組記錄的 [標識符] 欄位。
加: 唯讀和必要。 您必須指定現有的廣告群組標識符,或指定等於父代 Ad Group 記錄之 [標識符] 字段的負標識符。 如果您要將新的產品分割區新增至相同大量檔案中的新廣告群組,建議您這麼做。 如需詳細資訊,請 參閱大量檔案架構參考密鑰。
更新: 唯讀和必要
刪除: 唯讀和必要
產品條件 1
條件的操作數。 操作數隱含包含等號運算符。 例如,您可以將 Brand 讀取為 Brand=。
您可以為每個Microsoft購物活動和廣告群組指定多個產品條件。 如果產品的屬性值等於操作數的屬性值,就會符合每個條件。 例如,如果操作數設定為 Brand,且 屬性設定為 Contoso,則如果產品目錄的 Brand 屬性值等於 Contoso,就會符合條件。
在購物活動中,可以在營銷活動和廣告群組層級設定產品條件。 下表說明產品條件 (操作數) 和產品值 (屬性) 行銷活動產品範圍 和 廣告群組產品數據分割 記錄的商務規則。
產品條件 (操作數) | 產品值 (屬性) 描述 | 營銷活動產品範圍規則 | 廣告群組產品分割規則 |
---|---|---|---|
全部 | 必須是 null。 | 不適用。 | 針對廣告群組的產品分割區,根節點必須將操作數設定為 「All」,並將屬性設定為 Null 或空白。 |
品牌 | 產品的製造商、品牌或發行者。 最多 1,000 個字元。 |
每個營銷活動產品範圍篩選只能指定品牌操作數一次。 | Brand 操作數可用於多個分支,但每個分支只能指定一次。 |
CategoryL1-5 有五個類別操作數值可供使用,例如 CategoryL1、CategoryL2、CategoryL3、CategoryL4 和 CategoryL5。 |
Microsoft商家中心商店所定義的產品類別。 CategoryL0 是最高層級的類別,而 CategoryL4 是最低層級或最細微的類別。 最多100個字元。 |
每個營銷活動產品範圍篩選可以使用每個 CategoryL 操作數一次。 如果您指定將操作數設為 1 到 5 之產品類別的產品條件, 它們必須以遞增順序指定。 例如,如果前述產品條件的操作數 「CategoryL1」 屬性為 「Pet Supplies」,則您可以將操作數設定為 「CategoryL2」,其屬性為 「Pet & Supplies」。 |
每個 CategoryL 操作數都可以在多個分支中使用,但每個分支只能指定一次。 例如,一個分支可能包含 CategoryL1 和 CategoryL2,但不能包含具有 CategoryL2 操作數的另一個節點。 如果您將操作數設定為從 1 到 5 的產品類別,則必須以遞增順序指定。 例如,如果較高層級的產品分割區具有具有屬性 「CategoryL1」 且屬性為 「Pet & Supplies」 的操作數 「CategoryL1」,則操作數可以設定為 「CategoryL2」,而屬性為 “Pet Supplies”。 不需要在直接父數據分割中指定先前層級的產品類別操作數。 例如,如果其父系的父系指定 CategoryL1 條件,則可以為產品分割區指定 CategoryL2 條件。 |
通道 | 本機清查廣告 (LIA) 頻道。 可能的值包括「本地商店」和「在線」。 如果營銷活動尚未選擇加入 本機清查廣告,則所有供應項目預設只會 (Channel=Online) 和單一頻道 (ChannelExclusivity=Single-channel) 。 如需詳細資訊,請參閱 本機清查廣告 說明頁面。 |
通道操作數只能針對每個營銷活動產品範圍篩選指定一次。 | 通道操作數可用於多個分支,但每個分支只能指定一次。 |
ChannelExclusivity | 本機清查廣告 (LIA) 頻道包容性。 可能的值包括 「Single-channel」 和 「Multi-channel」。。 如果營銷活動尚未選擇加入 本機清查廣告,則所有供應項目預設只會 (Channel=Online) 和單一頻道 (ChannelExclusivity=Single-channel) 。 如需詳細資訊,請參閱 本機清查廣告 說明頁面。 |
每個營銷活動產品範圍篩選只能指定 ChannelExclusivity 操作數一次。 | ChannelExclusivity 操作數可用於多個分支,但每個分支只能指定一次。 |
條件 | 產品的條件。 如果操作數設定為 Condition,您可以指定的支持屬性值為 New、 Used 和 已修改。 |
條件操作數只能針對每個營銷活動產品範圍篩選指定一次。 | Condition 操作數可用於多個分支,但每個分支只能指定一次。 |
CustomLabel0-4 有五個自定義標籤操作數值可供使用,例如 CustomLabel0、CustomLabel1、CustomLabel2、CustomLabel3 和 CustomLabel4。 |
由商家定義的自定義標籤。 自定義標籤,例如 CustomLabel0 和 CustomLabel4,不會根據任何階層進行驗證。 最多100個字元。 此操作數不適用於 贊助產品。 |
每個營銷活動產品範圍篩選器都可以使用每個 CustomLabel 操作數一次。 | 每個 CustomLabel 操作數都可以在多個分支中使用,但每個分支只能指定一次。 例如,一個分支可能包含 CustomLabel0 和 CustomLabel1,但不能包含另一個具有 CustomLabel1 操作數的節點。 |
GTIN | 商家所定義的全域交易項目編號。 GTIN 欄位的限制為 50 個字元,每個 GTIN 值最多有 14 個數位。 此操作數僅適用於 贊助產品。 |
每個營銷活動產品範圍篩選只能指定 GTIN 操作數一次。 | GTIN 操作數可用於多個分支,但每個分支只能指定一次。 |
識別碼 | 商家所定義的產品標識碼。 最多 1,000 個字元。 |
每個營銷活動產品範圍篩選只能指定Id操作數一次。 | Id 操作數可用於多個分支,但每個分支只能指定一次。 |
MPN | 商家所定義的全域交易項目編號。 最多 70 個字元。 此操作數僅適用於 贊助產品。 |
每個營銷活動產品範圍篩選只能指定 MPN 操作數一次。 | MPN 操作數可用於多個分支,但每個分支只能指定一次。 |
ProductType1-5 有五個產品類型操作數值可供使用,例如 ProductType1、ProductType2、ProductType3、ProductType4 和 ProductType5。 |
由商家定義的產品類型或類別。 ProductType1 是最高層級的產品類型,而 ProductType5 是最低層級或最細微的產品類型。 最多100個字元。 此操作數不適用於 贊助產品。 |
每個產品類型操作數可以在每個營銷活動產品範圍篩選中使用一次。 如果您指定的產品條件,且操作數設定為 1 到 5 的產品類型, 它們必須以遞增順序指定。 例如,如果上述產品條件的操作數 “ProductType1” 屬性為 “Pet Supplies”,則您可以將操作數設定為 “ProductType2”,且屬性為 “Pet Supplies &” 。 |
每個 ProductType 操作數都可以在多個分支中使用,但每個分支只能指定一次。 例如,一個分支可能包含 ProductType1 和 ProductType2,但不能包含另一個具有 ProductType2 操作數的節點。 如果您將操作數設定為從 1 到 5 的產品類型,則必須以遞增順序指定。 例如,如果較高層級的產品磁碟分區具有具有屬性 「ProductType1」 的操作數 「ProductType1」,則操作數可以設定為 「ProductType2」,且屬性為 “Pet & Supplies”,則為 “Pet Supplies”。 不需要在直接父數據分割中指定先前層級的產品類型操作數。 例如,如果 ProductType2 條件的父系指定 ProductType1 條件,則可以為產品分割區指定 ProductType2 條件。 |
加: 必填
更新: 唯讀。 您無法更新條件或值欄位。 若要更新條件,您必須刪除產品磁碟分區,並新增一個新的分割區。
刪除: 唯讀
產品值 1
條件的屬性值。
屬性的值必須完全符合客戶Microsoft商家中心目錄檔案中指定的值。
加: 必填
更新: 唯讀。 您無法更新條件或值欄位。 若要更新條件,您必須刪除產品磁碟分區,並新增一個新的分割區。
刪除: 唯讀
狀態
產品分割區的狀態。
可能的值為 [作用中 ] 或 [已刪除]。
加: 自選。 唯一可能的狀態是 [作用中]。 如果您將狀態設定為 [已刪除] ,則會忽略該狀態,且傳回的記錄的狀態會設定為 [作用中]。
更新: 自選
刪除: 必填。 [狀態] 必須設定為 [ 已刪除]。
子類型
產品分割區的類型。
可能的值為 [細分 ] 和 [ 單位]。
加: 必填
更新: 唯讀
刪除: 唯讀
追蹤範本
追蹤範本可以與您透過 內容 API 提交之產品供應專案的 [連結] 欄位中指定的 URL 搭配使用。 藉由結合摘要 URL 與追蹤範本,登陸頁面 URL 會組合在按兩下廣告之後引導使用者的位置。 當您使用 [追蹤範本] 字 段來更新 URL 參數,而不是在摘要 URL 中更新它們時,摘要 URL 不需要經過編輯檢閱,而且您的廣告會繼續不間斷地提供。 例如,如果您在目錄摘要中的產品供應專案 URL 是 https://contoso.com/,您可以指定下列追蹤範本: {lpurl}?matchtype={matchtype}&device={device}。
下列驗證規則適用於追蹤範本。 如需支援的範本和參數的詳細資訊,請參閱 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 字串,則會移除先前的設定。
刪除: 唯讀