廣告群組重新行銷清單關聯記錄 - 大量
定義可在大量檔案中上傳和下載的廣告群組重新行銷清單關聯。
無法同時設定行銷活動和廣告群組層級的物件目標。 如果您設定任何可參加的行銷活動層級物件準則，則無法設定任何可申請的廣告群組層級物件準則。 您可以在行銷活動和廣告群組層級設定物件排除專案。 Microsoft Advertising 會同時套用行銷活動和廣告群組層級排除的聯集。
提示
如需物件的概觀和詳細資訊，請參閱 物件 API 技術指南。
您可以在DownloadCampaignsByAccountIds或DownloadCampaignsByCampaignIds服務要求中包含AdGroupRemarketingListAssociations的DownloadEntity值，以下載帳戶中的所有廣告群組重新行銷清單關聯記錄。 此外，下載要求必須包含 EntityData 範圍。 如需大量服務的詳細資訊，包括最佳做法，請參閱 大量下載和上傳。
如果提供有效的 父標識 符值，下列大量 CSV 範例會新增廣告群組重新行銷清單關聯。
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid Adjustment,Name,Audience Id,Audience
Format Version,,,,,,,,,6.0,,
Ad Group Remarketing List Association,Paused,,-1111,,,ClientIdGoesHere,,10,,RemarketingListIdHere,My Remarketing List
如果您使用適用于 .NET、JAVA 或 Python 的 Bing Ads SDK ，您可以使用 BulkServiceManager 來節省時間來上傳和下載 BulkAdGroupRemarketingListAssociation 物件，而不是直接呼叫服務作業，並撰寫自訂程式碼來剖析大量檔案中的每個欄位。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkAdGroupRemarketingListAssociation
var bulkAdGroupRemarketingListAssociation = new BulkAdGroupRemarketingListAssociation
{
// 'Ad Group' column header in the Bulk file
AdGroupName = null,
// 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 AudienceCriterion
{
// 'Audience Id' column header in the Bulk file
AudienceId = remarketingListIdKey,
},
// 'Bid Adjustment' column header in the Bulk file
CriterionBid = new BidMultiplier
{
Multiplier = 10
},
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = AdGroupCriterionStatus.Paused
},
// 'Campaign' column header in the Bulk file
CampaignName = null,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Audience' column header in the Bulk file
AudienceName = null,
};
uploadEntities.Add(bulkAdGroupRemarketingListAssociation);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
針對 廣告群組重新行銷清單關聯 記錄， 大量檔案架構中提供下列屬性欄位。
廣告群組
與重新行銷清單相關聯的廣告組名。
添加： 唯讀和必要
更新： 唯讀和必要
刪除： 唯讀和必要
對象
重新行銷清單的名稱。
此大量欄位會對應至重新行銷清單記錄的 [物件] 欄位。
添加： 某些使用案例的唯讀和必要。 您必須指定 [ 物件 ] 或 [ 物件識別碼] 欄位。 如果您要在相同的大量檔案中新增新的廣告群組重新行銷清單與新的重新行銷清單關聯，而且如果您未設定 [物件標識符] 欄位，則此 [物件] 欄位必須設定為與[重新行銷清單] 記錄的 [物件] 欄位相同的值邏輯索引鍵。 如需詳細資訊，請 參閱大量檔案架構參考金鑰。
更新： 唯讀
刪除： 唯讀
物件識別碼
與廣告群組相關聯之重新行銷清單的 Microsoft Advertising 識別碼。
此大量欄位會對應至重新行銷清單記錄的 [標識符] 欄位。
添加： 某些使用案例的唯讀和必要。 您必須指定 [ 物件 ] 或 [ 物件識別碼] 欄位。 如果您設定 [物件標識符] 欄位，則必須指定現有的重新行銷清單識別碼，或指定等於父代重新行銷清單記錄之 [標識符] 欄位的負識別碼。 如果未設定 [物件標識符] 欄位，則您必須將 [物件] 欄位設定為與[重新行銷清單] 記錄的 [物件] 欄位相同的邏輯索引鍵。 如果您要將新的廣告群組重新行銷清單關聯與相同大量檔案中的新重新行銷清單建立關聯，則建議使用上述任何選項。 如需詳細資訊，請 參閱大量檔案架構參考金鑰。
更新： 唯讀
刪除： 唯讀
中標調整
您想要增加/減少重新行銷清單的約定金額百分比。
支援的值為負 90 (-90.00) 到正 900 (900.00) 。
重要事項
如果未指定，預設的中標調整值為 0。 預設值可能會變更。
重要事項
在相關聯的重新行銷清單至少有 1,000 位使用者之前，Microsoft Advertising 不會套用任何報價提升。 如果有人有資格成為多個重新行銷清單的一部分，且重新行銷清單與具有不同報價調整的相同廣告群組相關聯，則會套用最高的報價調整。 如需付費搜尋中重新行銷的詳細資訊，請參閱 觸達您的物件。
添加： 選
更新： 選。 如果未設定更新的值，則此設定不會變更。
刪除： 唯讀
行銷活動
包含廣告群組的行銷活動名稱。
添加： 唯讀
更新： 唯讀
刪除： 唯讀
用戶端識別碼
用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為 100 的任何有效字串。
添加： 選
更新： 選
刪除： 唯讀
識別碼
系統產生的識別碼，用於廣告群組與重新行銷清單之間的關聯。
添加： 唯讀
更新： 唯讀和必要
刪除： 唯讀和必要
修改時間
上次更新實體的日期和時間。 值為國際標準時間 (UTC)。
注意事項
日期和時間值會反映伺服器上的日期和時間，而不是用戶端。 如需日期和時間格式的相關資訊，請參閱 基本 XML 資料類型中的 dateTime 專案。
添加： 唯讀
更新： 唯讀
刪除： 唯讀
父項識別碼
與重新行銷清單相關聯之廣告群組的系統產生識別碼。
此大量欄位會對應至廣告群組記錄的 [標識符] 欄位。
添加： 唯讀和必要。 您必須指定現有的廣告群組識別碼，或指定等於父代Ad Group記錄之 [標識符] 欄位的負識別碼。 如果您要將重新行銷清單與相同大量檔案中的新廣告群組建立關聯，則建議您這麼做。 如需詳細資訊，請 參閱大量檔案架構參考金鑰。
更新： 唯讀和必要
刪除： 唯讀和必要
狀態
關聯狀態。
可能的值為 Active、 Paused或 Deleted。
添加： 選。 預設狀態值為 Active。
更新： 選
刪除： 必填。 [狀態] 必須設定為 [ 已刪除]。