共用方式為


營銷活動曝光式重新行銷清單關聯記錄 - 大量

定義可在大量檔案中上傳和下載的營銷活動曝光式重新營銷清單關聯。

無法同時設定營銷活動和廣告群組層級的對象目標。 如果您設定任何可參加的營銷活動層級物件準則,則無法設定任何可申請的廣告群組層級物件準則。 您可以在行銷活動和廣告群組層級設定物件排除專案。 Microsoft Advertising 會同時套用營銷活動和廣告群組層級排除的聯集。

提示

如需物件的概觀和詳細資訊,請參閱 物件 API 技術指南。

您可以在 DownloadCampaignsByAccountIdsDownloadCampaignsByCampaignIds 服務要求中包含 CampaignImpressionBasedRemarketingListAssociationsDownloadEntity 值,以下載帳戶中的所有行銷曝光式重新營銷列表關聯記錄。 此外,下載要求必須包含 EntityData 範圍。 如需大量服務的詳細資訊,包括最佳做法,請參閱 大量下載和上傳

如果提供有效的 父標識 碼值,下列大量 CSV 範例會新增以營銷活動曝光為基礎的重新行銷清單關聯。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid Adjustment,Name,Audience Id,Audience
Format Version,,,,,,,,,6.0,,
Campaign Impression Based Remarketing List Association,Paused,,-1111,,,ClientIdGoesHere,,10,,ImpressionBasedRemarketingListIdHere,My Impression Based Remarketing List

如果您使用適用於 .NET、Java 或 Python 的 Bing Ads SDK ,您可以使用 BulkServiceManager 來節省時間,以上傳和下載 BulkCampaignImpressionBasedRemarketingListAssociation 物件,而不是直接呼叫服務作業,並撰寫自定義程式代碼來剖析大量檔案中的每個字段。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignImpressionBasedRemarketingListAssociation
var bulkCampaignImpressionBasedRemarketingListAssociation = new BulkCampaignImpressionBasedRemarketingListAssociation
{
    // Map properties in the Bulk file to the 
    // BiddableCampaignCriterion object of the Campaign Management service.
    BiddableCampaignCriterion = new BiddableCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        Criterion = new AudienceCriterion
        {
            // 'Audience Id' column header in the Bulk file
            AudienceId = impressionBasedRemarketingListIdKey,
        },
        // '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 = CampaignCriterionStatus.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(bulkCampaignImpressionBasedRemarketingListAssociation);

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。 預設值可能會變更。

加: 自選
更新: 自選。 如果未設定更新的值,則此設定不會變更。
刪除: 唯讀

行銷活動

與以曝光為基礎的重新行銷清單相關聯的營銷活動名稱。

加: 唯讀和必要
更新: 唯讀和必要
刪除: 唯讀和必要

注意事項

若要新增、更新和刪除,您必須指定 [父標識符 ] 或 [ 營銷活動 ] 字段。

用戶端識別碼

用來將大量上傳檔案中的記錄與結果檔中的記錄產生關聯。 伺服器不會使用或儲存此欄位的值;它只會從上傳的記錄複製到對應的結果記錄。 它可以是長度上限為100的任何有效字串。

加: 自選
更新: 自選
刪除: 唯讀

識別碼

系統產生的標識碼,用於營銷活動與以曝光為基礎的重新行銷清單之間的關聯。

加: 唯讀
更新: 唯讀和必要
刪除: 唯讀和必要

修改時間

上次更新實體的日期和時間。 值為國際標準時間 (UTC)。

注意事項

日期和時間值會反映伺服器上的日期和時間,而不是用戶端。 如需日期和時間格式的相關信息,請參閱 基本 XML 數據類型中的 dateTime 專案。

加: 唯讀
更新: 唯讀
刪除: 唯讀

父項識別碼

系統產生的營銷活動標識碼,與以曝光為基礎的重新行銷清單相關聯。

此大量欄位會對應至營銷活動記錄的 [標識符] 欄位。

加: 唯讀和必要。 您必須指定現有的行銷活動標識碼,或指定等於父活動記錄之 [標識符] 字段的負標識符。 如果您要將以曝光為基礎的重新行銷清單與相同大量檔案中的新行銷活動建立關聯,則建議您這麼做。 如需詳細資訊,請 參閱大量檔案架構參考密鑰
更新: 唯讀和必要
刪除: 唯讀和必要

注意事項

若要新增、更新和刪除,您必須指定 [父標識符 ] 或 [ 營銷活動 ] 字段。

狀態

關聯狀態。

可能的值為 ActivePausedDeleted

加: 自選。 默認狀態值為 Active
更新: 自選
刪除: 必填。 [狀態] 必須設定為 [ 已刪除]