廣告群組位置準則記錄 - 大量
定義可以在大量檔案中上傳和下載的廣告群組位置準則。
使用位置準則,您可以選擇向潛在客戶顯示廣告、搜尋或檢視下列相關頁面:
- 所有可用的國家/地區
- 選取的城市、郵遞區區編碼、 (美國) 、縣、州/省和國家/地區的 Microsoft 市場區域
每個位置準則都會為隨附的準則比對調整定義位置代碼。
您可以為每個行銷活動或廣告群組指定的合併位置和負位置準則數目上限為 10,000。
注意事項
每個廣告群組只能有一筆 廣告群組位置意圖準則 記錄,以決定適用於所有廣告群組廣告群組 位置準則 和 廣告群組半徑準則 記錄的位置意圖選項。 當您建立廣告群組的第一個準則時,也會自動新增 廣告群組位置意圖準則 記錄,並將默認 目標 設定為 PeopleInOrSearchingForOrViewingPages。 您可以新增或更新廣告群組的廣告群 組位置意圖準則,無論廣告群組是否有任何其他準則。 您無法刪除廣告群組的廣告群 組位置意圖準則,雖然沒有位置或半徑準則沒有任何目的。
如果指定廣告群組層級位置準則 (正或負) ,則會忽略該廣告群組的營銷活動層級位置準則。 換句話說,廣告群組位置準則會覆寫營銷活動位置準則,而且不會套用為聯集。
另請注意,您必須將位置、負位置和半徑準則視為一組 地理準則。 如果廣告群組有任何地理準則,則不會繼承任何營銷活動的地理準則。 如果廣告群組沒有任何地理準則,則會繼承行銷活動的所有地理準則。 即使廣告群組具有位置意圖準則,也可以從營銷活動繼承地理準則。 如果使用廣告群組的地理準則,則會使用廣告群組的位置意圖準則;如果繼承行銷活動的地理準則,則會使用營銷活動的位置意圖準則,並忽略廣告群組的位置意圖準則。 您無法刪除行銷活動或廣告群組的位置意圖準則,雖然沒有位置或半徑準則沒有任何目的。
提示
如需如何使用目標準則的概觀,請參閱 向目標對象顯示廣告。
您可以在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服務要求中包含 AdGroupTargetCriterions 的 DownloadEntity 值,以下載帳戶中的所有廣告群組位置準則記錄。 此外,下載要求必須包含 EntityData 範圍。 如需大量服務的詳細資訊,包括最佳做法,請參閱 大量下載和上傳。
如果提供有效的 父標識 碼值,下列大量 CSV 範例會新增廣告群組位置準則。
Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Target,Bid Adjustment,Name,OS Names,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,,6.0,,,,,,,,,
Ad Group Location Criterion,Active,,-1111,Country,,,ClientIdGoesHere,,190,20,,,,,,,,,,
如果您使用適用於 .NET、Java 或 Python 的 Bing 廣告 SDK ,您可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkAdGroupLocationCriterion 物件,而不是直接呼叫服務作業,並撰寫自定義程式代碼來剖析大量檔案中的每個字段。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkAdGroupLocationCriterion
var bulkAdGroupLocationCriterion = new BulkAdGroupLocationCriterion
{
// 'Ad Group' column header in the Bulk file is read-only
AdGroupName = null,
// 'Campaign' column header in the Bulk file is read-only
CampaignName = null,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// BiddableAdGroupCriterion object of the Campaign Management service.
BiddableAdGroupCriterion = new BiddableAdGroupCriterion
{
// 'Parent Id' column header in the Bulk file
AdGroupId = adGroupIdKey,
Criterion = new LocationCriterion
{
// 'Target' column header in the Bulk file
LocationId = 190,
// 'Sub Type' column header in the Bulk file
LocationType = "Country"
},
CriterionBid = new BidMultiplier
{
// 'Bid Adjustment' column header in the Bulk file
Multiplier = 20,
},
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = AdGroupCriterionStatus.Active,
}
};
uploadEntities.Add(bulkAdGroupLocationCriterion);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
針對 廣告群組位置準則 記錄, 大量檔案架構中提供下列屬性欄位。
廣告群組
套用或移除此準則的廣告組名。
添加: 唯讀
更新: 唯讀
刪除: 唯讀
中標調整
您想要調整對應 目標之報價的百分比金額。
支援的值為負 90 (-90) 到正 900 (900) 。
添加: 選。 如果未包含,則會將中標調整設定為預設 值 0 。
更新: 必填
刪除: 唯讀
行銷活動
包含套用或移除此準則之廣告群組的營銷活動名稱。
添加: 唯讀
更新: 唯讀
刪除: 唯讀
用戶端識別碼
用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為100的任何有效字串。
添加: 選
更新: 選
刪除: 選
識別碼
準則的 Microsoft Advertising 唯一標識符。
添加: 唯讀
更新: 唯讀和必要
刪除: 唯讀和必要
修改時間
上次更新實體的日期和時間。 值為國際標準時間 (UTC)。
注意事項
日期和時間值會反映伺服器上的日期和時間,而不是用戶端。 如需日期和時間格式的相關信息,請參閱 基本 XML 數據類型中的 dateTime 專案。
添加: 唯讀
更新: 唯讀
刪除: 唯讀
父項識別碼
套用或移除此準則之廣告群組的標識碼。
此大量欄位會對應至廣告群組記錄的 [標識符] 欄位。
添加: 唯讀和必要。 您必須指定現有的廣告群組標識符,或指定等於父代 Ad Group 記錄之 [標識符] 字段的負標識符。 如果您要將新準則新增至相同大量檔案中的新廣告群組,則建議您這麼做。 如需詳細資訊,請 參閱大量檔案架構參考密鑰。
更新: 唯讀和必要
刪除: 唯讀和必要
狀態
表示廣告群組與準則之間的關聯狀態。 如果準則套用至廣告群組,則此字段的值為 Active。 若要刪除準則,請將狀態設定為 [已刪除]。
添加: 唯讀。 當您新增準則時,狀態一律會設定為 [作用 中]。 如果您上傳另一個值,例如 Foo ,結果檔案會包含相同的值,雖然準則為使用中。
更新: 選
刪除: 必填。 [狀態] 必須設定為 [ 已刪除]。 若要刪除特定的位置準則比對,您必須上傳 狀態、 標識碼和 父標識符。
子類型
您要設為目標的位置子類型。 例如,如果記錄代表 城市 位置準則,則值為 City。
注意事項
鄰近位置即將推出。 子類型會是 [鄰近地區]。
您可以隨時新增位置子類型。 指定位置識別碼的位置類型很少會變更。
添加: 唯讀
更新: 唯讀
刪除: 唯讀
Target
您想要以對應的 「標定調整」為目標之位置的識別碼。
如需可能的值,請參閱地理位置檔案的 [位置標識符] 字段。 您可以呼叫 GetGeoLocationsFileUrl 作業來下載檔。
重要事項
請先檢查地理位置檔案中的 [狀態] 字段,再新增或更新位置準則。 如果狀態為 PendingDeprecation,則位置準則不再用於目標或排除專案。 您仍然可以擷取已被取代的位置準則,但您無法新增或更新已被取代的位置準則。
添加: 必填
更新: 必填
刪除: 唯讀