廣告群組位置意圖準則記錄 - 大量
定義可以在大量檔案中上傳和下載的廣告群組位置準則。
每個位置意圖準則都會為營銷活動或廣告群組的所有位置和半徑準則定義意圖選項。 沒有任何伴隨的準則比對調整。
您可以為每個行銷活動或廣告群組指定的位置意圖準則數目上限為一。
注意事項
每個廣告群組只能有一筆 廣告群組位置意圖準則 記錄，以決定適用於所有廣告群組廣告群組 位置準則 和 廣告群組半徑準則 記錄的位置意圖選項。 當您建立廣告群組的第一個準則時，也會自動新增 廣告群組位置意圖準則 記錄，並將默認 目標 設定為 PeopleInOrSearchingForOrViewingPages。 您可以新增或更新廣告群組的廣告群 組位置意圖準則，無論廣告群組是否有任何其他準則。 您無法刪除廣告群組的廣告群 組位置意圖準則，雖然沒有位置或半徑準則沒有任何目的。
PeopleSearchingForOrViewingPages 自 2024 年 4 月起已被取代。 如果您嘗試將 IntentOption 設定為 PeopleSearchingForOrViewingPages，它會改為設定為 PeopleInOrSearchingForOrViewingPages 。 我們將使用此設定自動將現有的活動轉換為 PeopleInOrSearchingForOrViewingPages。
重要事項
將 AIM 位置意圖準則設定為 PeopleIn ，而不是 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 Intent Criterion,Active,,-1111,,,,ClientIdGoesHere,,PeopleIn,,,,,,,,,,,
如果您使用適用於 .NET、Java 或 Python 的 Bing Ads SDK ，您可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkAdGroupLocationIntentCriterion 物件，而不是直接呼叫服務作業，並撰寫自定義程式代碼來剖析大量檔案中的每個字段。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkAdGroupLocationIntentCriterion
var bulkAdGroupLocationIntentCriterion = new BulkAdGroupLocationIntentCriterion
{
// '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 LocationIntentCriterion
{
// 'Target' column header in the Bulk file
IntentOption = IntentOption.PeopleIn
},
CriterionBid = null,
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = AdGroupCriterionStatus.Active,
}
};
uploadEntities.Add(bulkAdGroupLocationIntentCriterion);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
針對 廣告群組位置意圖準則 記錄， 大量檔案架構中提供下列屬性欄位。
廣告群組
套用或移除此準則的廣告組名。
添加： 唯讀
更新： 唯讀
刪除： 唯讀
行銷活動
包含套用或移除此準則之廣告群組的營銷活動名稱。
添加： 唯讀
更新： 唯讀
刪除： 唯讀
用戶端識別碼
用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為100的任何有效字串。
添加： 選
更新： 選
刪除： 選
識別碼
準則的標識碼。
注意事項
目前位置意圖準則標識碼等於父標識符，但您不應該對該關聯性採取相依性。 最佳做法是將位置意圖準則標識碼視為相異。
添加： 唯讀
更新： 唯讀
刪除： 唯讀
修改時間
上次更新實體的日期和時間。 值為國際標準時間 (UTC)。
注意事項
日期和時間值會反映伺服器上的日期和時間，而不是用戶端。 如需日期和時間格式的相關信息，請參閱 基本 XML 數據類型中的 dateTime 專案。
添加： 唯讀
更新： 唯讀
刪除： 唯讀
父項識別碼
套用或移除此準則之廣告群組的標識碼。
此大量欄位會對應至廣告群組記錄的 [標識符] 欄位。
添加： 唯讀和必要。 您必須指定現有的廣告群組標識符，或指定等於父代 Ad Group 記錄之 [標識符] 字段的負標識符。 如果您要將新準則新增至相同大量檔案中的新廣告群組，則建議您這麼做。 如需詳細資訊，請 參閱大量檔案架構參考密鑰。
更新： 唯讀和必要
刪除： 唯讀和必要
狀態
表示廣告群組與準則之間的關聯狀態。 如果為廣告群組設定準則，則此字段的值為 Active。 若要刪除準則，請將狀態設定為 [已刪除]。
添加： 唯讀。 當您新增準則時，狀態一律會設定為 [作用 中]。 如果您上傳另一個值，例如 Foo ，結果檔案會包含相同的值，雖然準則為使用中。
更新： 選
刪除： 必填。 [狀態] 必須設定為 [ 已刪除]。 若要刪除特定的位置意圖準則，您必須上傳 狀態 和 父標識碼。
Target
判斷某個人是否必須實際位於目標位置，才能顯示廣告。
支援下列值。 預設值為 PeopleInOrSearchingForOrViewingPages。
- 如果您想要向使用者顯示關於您目標位置的廣告、搜尋或檢視頁面，請使用 PeopleInOrSearchingForOrViewingPages 。
- 如果您想要向目標位置中的人員顯示廣告，請使用 PeopleIn 。
添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。 如果您設定此欄位，則必須將它設定為有效的值，也就是 PeopleInOrSearchingForOrViewingPages 或 PeopleIn。
刪除： 唯讀