广告组再营销列表关联记录 - 批量

项目
11/13/2024

定义可在批量文件中上传和下载的广告组再营销列表关联。

受众目标不能同时设置市场活动级别和广告组级别。如果设置了任何可出价市场活动级别受众标准，则不能设置任何可出价广告组受众级别访问群体条件。受众排除可以在市场活动级别和广告组级别设置。 Microsoft Advertising 应用市场活动与广告组级别排除项的联合。

提示

有关访问群体的概述和详细信息，请参阅受众 API 技术指南。

通过在 DownloadCampaignsByAccountIds 或 DownloadCampaignsByCampaignIds 服务请求中包含 AdGroupRemarketingListAssociations 的 DownloadEntity 值，可以下载帐户中的所有 Ad Group 再营销列表关联记录。此外，下载请求必须包括 EntityData 范围。有关批量服务的更多详细信息（包括最佳做法），请参阅批量下载和上传。

如果提供了有效的父 ID 值，以下批量 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 的必应广告 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();

对于 广告组再营销列表关联 记录，批量文件架构中提供了以下属性字段。

广告组
受众
访问群体 ID
出价调整
市场活动
客户端 ID
Id
修改时间
父 ID
状态

广告组

与再营销列表关联的广告组的名称。

添加： 只读和必需
更新： 只读和必需
删除： 只读和必需

注意

若要添加、更新和删除，必须指定 “父 ID ”或 “广告组” 字段。

受众

再营销列表的名称。

此批量字段映射到再营销列表记录的“受众”字段。

添加： 对于某些用例，只读和必需。必须指定 “受众” 或“ 访问群体 ID” 字段。如果要在同一批量文件中添加新广告组再营销列表关联，并且未设置“受众 ID”字段，则必须将此受众字段设置为与再营销列表记录的“受众”字段相同的值的逻辑键。有关详细信息，请参阅批量文件架构引用密钥。
更新： 只读
删除： 只读

访问群体 ID

与广告组关联的再营销列表的 Microsoft Advertising 标识符。

此批量字段映射到再营销列表记录的 Id 字段。

添加： 对于某些用例，只读和必需。必须指定 “受众” 或“ 访问群体 ID” 字段。如果设置“受众 ID”字段，则必须指定现有的再营销列表标识符，或指定等于父再营销列表记录的 Id 字段的负标识符。如果未设置“受众 ID”字段，则必须将“受众”字段设置为与再营销列表记录的“受众”字段相同的逻辑键。如果要在同一批量文件中添加新广告组再营销列表关联，则建议使用上述任何选项。有关详细信息，请参阅批量文件架构引用密钥。
更新： 只读
删除： 只读

出价调整

要增加/减少再营销列表的出价金额的百分比。

支持的值为负 90 (-90.00) 到正 900 (900.00) 。

重要

如果未指定，则默认出价调整值为 0。默认值可能会更改。

重要

在关联的再营销列表至少有 1,000 个用户之前，Microsoft Advertising 不会应用任何竞价提升。如果某人有资格成为多个再营销列表的一部分，并且再营销列表与具有不同出价调整的同一广告组相关联，则会应用最高出价调整。有关付费搜索中的再营销的详细信息，请参阅接触受众。

添加： 选
更新： 选。如果未为更新设置任何值，则不会更改此设置。
删除： 只读

Campaign

包含广告组的市场活动的名称。

添加： 只读
更新： 只读
删除： 只读

客户端 ID

用于将批量上传文件中的记录与结果文件中的记录相关联。服务器不使用或存储此字段的值;它只是从上传的记录复制到相应的结果记录。它可以是长度最大为 100 的任何有效字符串。

添加： 选
更新： 选
删除： 只读

Id

广告组与再营销列表之间关联的系统生成的标识符。

添加： 只读
更新： 只读和必需
删除： 只读和必需

修改时间

上次更新实体的日期和时间。该值以协调世界时 (UTC) 表示。

注意

日期和时间值反映服务器的日期和时间，而不是客户端。有关日期和时间格式的信息，请参阅基元 XML 数据类型中的 dateTime 条目。

添加： 只读
更新： 只读
删除： 只读

父 ID

与再营销列表关联的广告组的系统生成标识符。

此批量字段映射到广告组记录的 Id 字段。

添加： 只读和必需。必须指定现有广告组标识符，或指定等于父广告组记录的 Id 字段的负标识符。如果将再营销列表关联到同一批量文件中的新广告组，则建议这样做。有关详细信息，请参阅批量文件架构引用密钥。
更新： 只读和必需
删除： 只读和必需

注意

若要添加、更新和删除，必须指定 “父 ID ”或 “广告组” 字段。

状态

关联状态。

可能的值为 Active、 Paused 或 Deleted。

添加： 选。默认状态值为 “活动”。
更新： 选
删除： 必填。 “状态”必须设置为 “已删除”。

通过