市场受众关联记录中的广告组 - 批量

项目
11/13/2024

定义可在批量文件中上传和下载的“市场受众关联”广告组。

注意

此功能在澳大利亚、加拿大、法国、德国、英国和美国可用。

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

提示

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

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

如果提供了有效的父 ID 值，以下批量 CSV 示例将在市场受众关联中添加新广告组。

Type,Status,Id,Parent Id,Ad Group,Client Id,Modified Time,Bid Adjustment,Name,Audience Id,Audience
Format Version,,,,,,,,,6.0,,
Ad Group In Market Audience Association,Paused,,-1111,,ClientIdGoesHere,,10,,InMarketAudienceIdHere,My In Market Audience

如果使用用于 .NET、Java 或 Python 的必应广告 SDK ，则可以使用 BulkServiceManager 来节省时间来上传和下载 BulkAdGroupInMarketAudienceAssociation 对象，而无需直接调用服务操作并编写自定义代码来分析批量文件中的每个字段。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupInMarketAudienceAssociation
var bulkAdGroupInMarketAudienceAssociation = new BulkAdGroupInMarketAudienceAssociation
{
    // '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 = inMarketAudienceIdKey,
        },
        // '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
    },
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Audience' column header in the Bulk file
    AudienceName = null,
};

uploadEntities.Add(bulkAdGroupInMarketAudienceAssociation);

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 ”或 “广告组” 字段。

受众

市场内受众的名称。

此批量字段映射到“市场受众 ”记录的 “受众” 字段。

批量 API 下载将返回所有市场内受众关联，无论市场内受众处于活动状态还是已删除。如果关联针对已删除的市场内受众，则此字段将设置为与 “访问群体 ID” 字段相同的值。

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

访问群体 ID

与广告组关联的市场内受众的 Microsoft Advertising 标识符。

此批量字段映射到“市场受众”记录的“ID”字段。

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

出价调整

要增加/减少市场内受众的出价金额的百分比。

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

重要

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

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

客户端 ID

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

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

Id

广告组与市场内受众之间关联的系统生成的标识符。

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

修改时间

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

注意

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

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

父 ID

与市场内受众关联的广告组的系统生成的标识符。

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

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

注意

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

状态

关联状态。

可能的值为 Active、 Paused 或 Deleted。

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

通过