行銷活動半徑準則記錄 - 大量
定義可在大量檔案中上傳和下載的行銷活動半徑準則。
使用半徑準則,您可以選擇在郵遞區號、座標、地標或區域周圍,向潛在客戶顯示廣告、搜尋或檢視有關指定半徑的頁面。
每個半徑準則都會為隨附的準則比對調整定義半徑、緯度和經度。
您可以為每個行銷活動或廣告群組指定的半徑準則數目上限為 2,000。
注意事項
每個行銷活動只能有一筆 行銷活動位置意圖準則 記錄,以判斷適用于所有行銷 活動之行銷活動位置準則 和行銷活動 半徑準則 記錄的位置意圖選項。 當您建立行銷活動的第一個準則時,也會自動新增 行銷活動位置意圖準則 記錄,並將預設 目標 設定為 PeopleInOrSearchingForOrViewingPages。 無論行銷活動是否有任何其他準則,您都可以新增或更新行銷活動的行銷活動 位置意圖準則。 您無法刪除行銷 活動的行銷活動位置意圖準則,因為它沒有位置或半徑準則的目的。
如果指定廣告群組層級半徑準則,則會忽略該廣告群組的行銷活動層級半徑準則。 換句話說,廣告群組半徑準則會覆寫行銷活動半徑準則,而且不會套用為聯集。
另請注意,您必須將位置、負位置和半徑準則視為一組 地理準則。 如果廣告群組有任何地理準則,則不會繼承任何行銷活動的地理準則。 如果廣告群組沒有任何地理準則,則會繼承行銷活動的所有地理準則。 即使廣告群組具有位置意圖準則,也可以從行銷活動繼承地理準則。 如果使用廣告群組的地理準則,則會使用廣告群組的位置意圖準則;如果繼承行銷活動的地理準則,則會使用行銷活動的位置意圖準則,並忽略廣告群組的位置意圖準則。 您無法刪除行銷活動或廣告群組的位置意圖準則,雖然沒有位置或半徑準則沒有任何目的。
提示
如需如何使用目標準則的概觀,請參閱 向目標物件顯示廣告。
您可以在DownloadCampaignsByAccountIds或DownloadCampaignsByCampaignIds服務要求中包含CampaignTargetCriterions的DownloadEntity值,以下載帳戶中的所有行銷活動半徑準則記錄。 此外,下載要求必須包含 EntityData 範圍。 如需大量服務的詳細資訊,包括最佳做法,請參閱 大量下載和上傳。
如果提供有效的 父標識 符值,下列大量 CSV 範例會新增行銷活動半徑準則。
Type,Status,Id,Parent Id,Sub Type,Campaign,Client Id,Modified Time,Target,Bid Adjustment,Name,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,6.0,,,,,,,,
Campaign Radius Criterion,Active,,-111,,,ClientIdGoesHere,,RadiusName,20,,10,Kilometers,,,,,10.5,40.5
如果您使用適用于 .NET、JAVA 或 Python 的 Bing Ads SDK ,您可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkCampaignRadiusCriterion 物件,而不是直接呼叫服務作業,並撰寫自訂程式碼來剖析大量檔案中的每個欄位。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkCampaignRadiusCriterion
var bulkCampaignRadiusCriterion = new BulkCampaignRadiusCriterion
{
// '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
// BiddableCampaignCriterion object of the Campaign Management service.
CampaignCriterion = new BiddableCampaignCriterion
{
// 'Parent Id' column header in the Bulk file
CampaignId = campaignIdKey,
Criterion = new RadiusCriterion
{
// 'Latitude' column header in the Bulk file
LatitudeDegrees = 10.5,
// 'Longitude' column header in the Bulk file
LongitudeDegrees = 40.5,
// 'Name' column header in the Bulk file
Name = "RadiusName",
// 'Radius' column header in the Bulk file
Radius = 10,
// 'Unit' column header in the Bulk file
RadiusUnit = DistanceUnit.Kilometers,
},
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 = CampaignCriterionStatus.Active,
}
};
uploadEntities.Add(bulkCampaignRadiusCriterion);
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 唯一識別碼。
添加: 唯讀
更新: 唯讀和必要
刪除: 唯讀和必要
緯度
位置準則的緯度,以度為單位。
緯度必須大於或等於 -85.0,且小於或等於 +85.0。
您可以將緯度和經度指定為十進位值。 例如,一個 Redmond Way,Redmond, WA 的緯度和經度分別為 47.755367 和 -122.091827。 若要取得這些值,您可以將地理位置的位址輸入Bing 地圖服務,而座標會顯示在位址下方。
添加: 必填
更新: 必填
刪除: 唯讀
經度
位置準則的經度,以度為單位。
經度必須大於或等於 -180.0,且小於或等於 +180.0。
您可以將緯度和經度指定為十進位值。 例如,一個 Redmond Way,Redmond, WA 的緯度和經度分別為 47.755367 和 -122.091827。 若要取得這些值,您可以將地理位置的位址輸入Bing 地圖服務,而座標會顯示在位址下方。
添加: 必填
更新: 必填
刪除: 唯讀
修改時間
上次更新實體的日期和時間。 值為國際標準時間 (UTC)。
注意事項
日期和時間值會反映伺服器上的日期和時間,而不是用戶端。 如需日期和時間格式的相關資訊,請參閱 基本 XML 資料類型中的 dateTime 專案。
添加: 唯讀
更新: 唯讀
刪除: 唯讀
名稱
目標地理位置的名稱。
名稱最多可以包含 50 個字元。
添加: 選
更新: 唯讀
刪除: 唯讀
父項識別碼
套用或移除此準則之行銷活動的識別碼。
此大量欄位會對應至行銷活動記錄的 [標識符] 欄位。
添加: 唯讀和必要。 您必須指定現有的行銷活動識別碼,或指定等于父活動記錄之 [標識符] 欄位的負識別碼。 如果您要將新準則新增至相同大量檔案中的新行銷活動,則建議您這麼做。 如需詳細資訊,請 參閱大量檔案架構參考金鑰。
更新: 唯讀和必要
刪除: 唯讀和必要
Radius
半徑,指定地理位置周圍要設為目標的區域。
如果 Radius Unit 欄位設定為 Miles,則接受從 1 到 500 的正整數值。
如果 [ 半徑單位 ] 欄位設定為 [公里],則接受從 1 到 800 的正整數值。
注意事項
資料類型為雙精度浮點數,未來版本可能支援。 服務目前只接受並傳回整數值。
添加: 必填
更新: 必填
刪除: 唯讀
狀態
表示行銷活動與準則之間的關聯狀態。 如果準則套用至行銷活動,則此欄位的值為 Active。 若要刪除準則,請將狀態設定為 [已刪除]。
添加: 唯讀。 當您新增準則時,狀態一律會設定為 [作用 中]。 如果您上傳另一個值,例如 Foo ,結果檔案會包含相同的值,雖然準則為使用中。
更新: 選
刪除: 必填。 [狀態] 必須設定為 [ 已刪除]。 若要刪除特定的位置準則比對,您必須上傳 狀態、 識別碼和 父識別碼。
Unit
指定之半徑的度量單位。
支援的值為 英吋 (預設) 和 公里。
添加: 選。 如果未指定,則會設定 Miles 的預設值。
更新: 必填
刪除: 唯讀